指定したリージョンにデプロイメントセットを作成します。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい このインターフェイスの名前。値: CreateDeploymentSet.
RegionId String はい デプロイメントセットが配置されているリージョンの ID。 詳細については、 DescribeRegions を呼び出して最新のリージョンリストを取得してください。
DeploymentStrategy String はい デプロイメント戦略。オプションの値 Availability

Availabilityは高可用性戦略を表します。デプロイメントセット内のすべての ECS インスタンスは、リージョン内のさまざまな物理サーバーに厳密に分散されています。この設計は、サービスが使用できなくなる可能性を大幅に減らすために、複数の ECS インスタンスを互いに分離させる必要がある利用イメージに適用されます。

DeploymentSetName String いいえ デプロイメントセット名。名前は 2 から 128 文字の文字列です。アルファベット、漢字、平仮名、片仮名で始める必要があります。 A-Z、a-z、漢字、平仮名、片仮名、数字、ピリオド (.)、コロン (:)、アンダースコア (_)、およびハイフン (-) を含めることができます。
Description String いいえ デプロイメントセットの説明。http:// または https:// で始めることはできません。
OnUnableToRedeployFailedInstance String いいえ デプロイメントセット内のインスタンスをシャットダウンして移行した後は、インスタンスを物理サーバーに厳密に分散できない場合に備えて、緊急対策を設定する必要があります。オプションの値:
  • (デフォルト) CancelMembershipAndStart:インスタンスをデプロイメントセットから移動し、インスタンスをシャットダウンして移行した直後にインスタンスを起動できるようにします。ただし、インスタンスの仕様は変わる可能性があります。
  • KeepStopped: インスタンスをデプロイメントセットから移動することは許可されていません。インスタンスは、新しいリソースがそのリージョンで使用可能になるまで、異常な状態のままです。必要とするリソースが使用可能になったら、インスタンスを起動できます。
ClientToken String いいえ

リクエストのべき等性を保証します。値はクライアントによって生成され、グローバルに一意である必要があります。ASCII 文字のみ使用できます。最大 64 ASCII 文字を含めることができます。詳細については、「べき等性を確保する方法」 をご参照ください。

レスポンスパラメーター

名前 説明
DeploymentSetId String デプロイメントセット ID。

リクエストの例
  1. https://ecs.aliyuncs.com/?Action=CreateDeploymentSet&RegionId=cn-hangzhou&DeploymentStrategy=Availability&DeploymentSetName=AvailMySet&<共通リクエストパラメーター>
レスポンスの例

XML 形式

  1. <CreateDeploymentSetResponse> <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId> <DeploymentSetId>ds-bp1frxuzdg87zh4pzqkcm</DeploymentSetId></CreateDeploymentSetResponse>
JSON 形式
  1. { RequestId”: 04F0F334-1335-436C-A1D7-6C044FE73368 DeploymentSetId”: ds-bp1frxuzdg87zh4pzqkc”}

エラーコード

このインターフェイスに固有のエラーコードは次の通りです。詳しくは、 「API Error Center」 をご参照ください。

エラーコード エラーメッセージ HTTP ステータスコード 説明
InvalidDescription.Malformed The specified parameter Description is not valid. 400 指定された説明は無効です。
InvalidParameter.Strategy The specified parameter Strategy is not valid. 400 指定されたデプロイメント戦略は無効です。
MissingParameter The input parameter “RegionId” that is necessary for processing this request is not specified. 400 RegionId パラメーターを指定する必要があります。指定されたリージョンを使用する許可がありません。
DEPLOYMENTSET.QUOTA_FULL The deploymentSet quota is full. 403 作成できるデプロイメントセットの数が上限に達しました。
InvalidRegionId.NotFound The RegionId provided does not exist in our records. 404 指定された RegionId が存在しません。