指定したリージョンにデプロイメントセットを作成します。
リクエストパラメーター
名前 | 型 | 必須かどうか | 説明 |
---|---|---|---|
Action | String | はい | このインターフェイスの名前。値: CreateDeploymentSet. |
RegionId | String | はい | デプロイメントセットが配置されているリージョンの ID。 詳細については、 DescribeRegions を呼び出して最新のリージョンリストを取得してください。 |
DeploymentStrategy | String | はい | デプロイメント戦略。オプションの値 Availability
|
DeploymentSetName | String | いいえ | デプロイメントセット名。名前は 2 から 128 文字の文字列です。アルファベット、漢字、平仮名、片仮名で始める必要があります。 A-Z、a-z、漢字、平仮名、片仮名、数字、ピリオド (.)、コロン (:)、アンダースコア (_)、およびハイフン (-) を含めることができます。 |
Description | String | いいえ | デプロイメントセットの説明。http:// または https:// で始めることはできません。 |
OnUnableToRedeployFailedInstance | String | いいえ | デプロイメントセット内のインスタンスをシャットダウンして移行した後は、インスタンスを物理サーバーに厳密に分散できない場合に備えて、緊急対策を設定する必要があります。オプションの値:
|
ClientToken | String | いいえ | リクエストのべき等性を保証します。値はクライアントによって生成され、グローバルに一意である必要があります。ASCII 文字のみ使用できます。最大 64 ASCII 文字を含めることができます。詳細については、「べき等性を確保する方法」 をご参照ください。 |
レスポンスパラメーター
名前 | 型 | 説明 |
---|---|---|
DeploymentSetId | String | デプロイメントセット ID。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=CreateDeploymentSet&RegionId=cn-hangzhou&DeploymentStrategy=Availability&DeploymentSetName=AvailMySet&<共通リクエストパラメーター>
レスポンスの例
XML 形式
JSON 形式
<CreateDeploymentSetResponse> <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId> <DeploymentSetId>ds-bp1frxuzdg87zh4pzqkcm</DeploymentSetId></CreateDeploymentSetResponse>
{ “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 が存在しません。 |