セキュリティグループを作成するには、 CreateSecurityGroup を呼び出します。 デフォルトでは、セキュリティグループ内のインスタンスのみにアクセス許可が付与されています。 インターネットからのリクエストまたは他のセキュリティグループのインスタンスからのリクエストを許可する場合は、 AuthorizeSecurityGroup を呼び出し、該当のインスタンスまたはグループにアクセス許可を付与してください。

説明

本インターフェイスを呼び出す場合は、次の点に留意してください。

  • 各リージョンに最大 100 件のセキュリティグループを作成できます。
  • VPC タイプのセキュリティグループの作成する場合は VpcId を指定する必要があります。

デバッグ

API を使用しやすくするため、Alibaba Cloud は OpenAPI Explorerを提供しています。 OpenAPI Explorer を使用して、APIの検索、APIの呼び出し、SDKサンプルコードの動的な生成等を行うことができます。

リクエストパラメーター

パラメーター データ型 必須 説明
RegionId String Yes cn-hangzhou-d

セキュリティグループの リージョンID DescribeRegionsを呼び出すと、最新のリージョンリストが表示されます。

Action String No CreateSecurityGroup

実行する操作です。 この値を CreateSecurityGroup に設定します。

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成することができます。値は、様々なリクエストにおいて固有の値である必要があります。 ClientToken には、ASCII 文字のみが使用可能で、長さは 64 文字以下である必要があります。 詳細は、「べき等性を確保する方法」をご参照ください。

Description String No FinanceDept

セキュリティグループの説明。 長さは 2 ~ 256 文字である必要があります。先頭文字列を http:// または https:// にすることはできません。 既定値 : NULL。

ResourceGroupId String No rg-resourcegrouid

セキュリティグループが属するリソースグループの ID 。

SecurityGroupName String No FinanceJoshua

セキュリティグループの名前。 長さは 2 ~ 128 文字である必要があります。 名前は英字で始まる必要があります。先頭文字列は http:// または https:// にすることはできません。 英字、数字、ピリオド (.)、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。 既定値 : NULL。

SecurityGroupType String No enterprise

セキュリティグループの名前。 有効な値:

Tag.n.Key String No FinanceDept

セキュリティグループの名前。 N の有効値:1 ~ 20。 タグキーに空の文字列を使用することはできません。 長さは最大 64 文字以内である必要があります。先頭文字列を aliyun または acs:にすることはできません。 http:// または https:// を含めることはできません。

Tag.n.Value String No FinanceDeptJoshua

セキュリティグループの名前。 N の有効値:1~20。 タグの値は空の文字列にすることも可能です。 長さは 128 文字以内である必要があります。先頭文字列を aliyun または acs:にすることはできません。 http:// または https:// を含めることはできません。

Tag.n.Key String No FinanceDept

セキュリティグループの名前。

このパラメーターは削除予定です。 今後、互換性を確保するために Tag.N.Key を使用することを推奨します。
Tag.n.Value String No FinanceDeptJoshua

セキュリティグループの名前。

このパラメーターは削除予定です。 今後、互換性を確保するために Tag.N.Key を使用することを推奨します。
VpcId String No vpc-vpcid1

セキュリティーグループが属する VPC の ID。

応答パラメーター

パラメーター データ型 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID。

SecurityGroupId String sg-F876FF7BA

セキュリティグループの ID。

リクエストの例

https://ecs.aliyuncs.com/?Action=CreateSecurityGroup
&RegionId=cn-hangzhou
&Description = for_demo
&<Common request parameters>

通常の応答例

XML 形式

<CreateSecurityGroupResponse>
  <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
  <SecurityGroupId>sg-securitygroupid</SecurityGroupId>
</CreateSecurityGroupResponse>

JSON 形式

{
	"SecurityGroupId":"sg-securitygroupid",
	"RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidDescription.Malformed 指定されたパラメーター "Description" は無効です。 指定された説明が無効な場合に表示されるエラーメッセージ。 長さは 2 ~ 256 文字である必要があります。先頭文字列を http:// または https:// にすることはできません。
403 QuotaExceed.SecurityGroup セキュリティグループの最大数に達しています。 セキュリティーグループの最大数に達した場合に表示されるエラーメッセージ。 チケットを起票してホワイトリストを申請してください。
404 InvalidVpcId.NotFound 指定された VPC は存在しません。 指定された VPC ID が存在しない場合に表示されるエラーメッセージ。
400 InvalidSecurityGroupName.Malformed 指定されたセキュリティグループ名は無効です。 指定されたセキュリティグループ名が無効である場合に表示されるエラーメッセージ。 名前がコンソールに表示されます。 デフォルトでは、セキュリティグループに名前は指定されていません。 名前の長さは 2 ~ 128 文字である必要があります。 先頭文字は英字である必要があります。英字、数字、コロン(:)、アンダースコア(_)、およびハイフン( - )が使用可能です。 先頭文字列を http:// または https:// にすることはできません。
400 InvalidSecurityGroupDiscription.Malformed 指定されたセキュリティグループの説明は無効です。 指定された説明が無効な場合に表示されるエラーメッセージ。
500 InternalError 不明なエラーが発生したため、リクエスト処理に失敗しました。 内部エラーが発生した場合に表示されるエラーメッセージ。 しばらくしてからもう一度お試しください。 問題が解決しない場合は、チケットを起票してください。
403 InvalidVpcId.NotFound vpc vm をサポートしている場合のみ、vpc id を省略することはできません。 指定された VPC ID が空の場合に表示されるエラーメッセージ。
400 IncorrectVpcStatus 現在の VPC のステータスでは、この操作を実行できません。 現行ステータスの VPC で該当の操作が実行できない場合に表示されるエラーメッセージ。
400 InvalidTagKey.Malformed 指定されたキーは無効です。 指定されたタグキーが無効な場合に表示されるエラーメッセージ。
400 InvalidTagValue.Malformed 指定された終了時刻は無効です。 指定されたタグ値が無効な場合に表示されるエラーメッセージ。
404 InvalidResourceGroup.NotFound 指定された ResourceGroup は履歴に存在しません。 履歴にリソースグループが存在しない場合に表示されるエラーメッセージ。
400 Duplicate.TagKey Tag.N.Key に重複するキーが含まれています。 指定されたタグキーが繰り返されている場合に表示されるエラーメッセージ。
400 InvalidTagKey.Malformed 指定された Tag.n.Key は無効です。 指定された Tag.N.Value が無効な場合に表示されるエラーメッセージ。
400 InvalidTagValue.Malformed 指定された Tag.n.Value は無効です。 指定された Tag.N.Value が無効な場合に表示されるエラーメッセージ。
403 IdempotentProcessing 前のべき等要リクエストが処理中です。 前のべき等リクエストが処理中の場合に表示されるエラーメッセージ。

エラーコードの表示