edit-icon download-icon

CreateSecurityGroup

最終更新日: Mar 04, 2019

説明

セキュリティグループを作成します。 新しいセキュリティグループの場合、セキュリティグループ内のインスタンスのアクセス許可のみがデフォルトで許可され、グループ外の他のインスタンスへのアクセス許可は制限されます。 インターネットからの要求や他のセキュリティグループからのインスタンスの要求を受け入れる場合は、AuthorizeSecurityGroupを呼び出して要求を許可することができます。

このインターフェイスを呼び出すときは、次の点を考慮してください。

  • 最大100個のセキュリティグループを作成できます。

  • VPC接続のセキュリティグループを作成する場合は、「VpcId」を指定する必要があります。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい このインターフェースの名前です。値: CreateSecurityGroup
RegionId String はい セキュリティグループが属する地域ID。 詳細については、リージョンとゾーンを参照するか、DescribeRegionsを呼び出して最新の地域リストを取得してください。
SecurityGroupName String いいえ セキュリティグループの名前。デフォルト値は空白です。[2, 128] の英字または漢字で、先頭は大文字/小文字の英字または漢字を使う必要があります。数字、”.”、”_“、”-“ を含めることができます。http:// または https:// で始めることはできません。
Description String いいえ セキュリティグループの説明。2 ~ 256 文字の文字列です。http:// または https:// で始めることはできません。
VpcId String いいえ セキュリティグループが属する VPC の ID
ClientToken String いいえ 要求の冪等を保証する。 値はクライアントによって生成されます。 すべての要求で一意でなければならず、最大64文字のASCII文字が含まれています。
詳しくは、冪等の確保方法を参照してください。

レスポンスパラメーター

名前 説明
SecurityGroupId String セキュリティグループの ID

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=CreateSecurityGroup
  2. &RegionId=cn-hangzhou
  3. &Description=for_demo
  4. &<Common Request Parameters>

戻り値の例

XML 形式

  1. <CreateSecurityGroupResponse>
  2. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
  3. <SecurityGroupId>sg-F876FF7BA</SecurityGroupId>
  4. </CreateSecurityGroupResponse>

JSON 形式

  1. {
  2. "RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  3. "SecurityGroupId":"sg-F876FF7BA"
  4. }

エラーコード

エラーコード エラーメッセージ HTTP ステータスコード 意味
InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 404 指定された RegionId は存在しません。リージョンとゾーン を参照してください。
MissingParameter このリクエストの処理に必須の入力パラメーター RegionId が指定されていません。 400 RegionId の値が指定されていません (または、リージョンの使用をユーザーが許可されていない可能性があります)。リージョンとゾーン を参照してください。
InvalidSecurityGroupName.Malformed 指定されたセキュリティグループ名は無効です。 400 指定された SecurityGroupName の形式は無効です。
InvalidDescription.Malformed 指定されたパラメーター Description は無効です。 400 指定された DescriptionName の形式は無効です。
QuotaExceed.SecurityGroup セキュリティグループの最大数に達しています。 403 セキュリティグループの数がクォータを超過しています。
InvalidVpcId.NotFound 指定された VPC は存在しません。 403 指定された VPC は存在しません。