この操作では、専用ホストクラスターを作成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 CreateDedicatedHostCluster

実行する操作です。 値をCreateDedicatedHostClusterに設定します。
RegionId String 必須 cn-hangzhou

専用ホストクラスターを作成するリージョンのID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。

DryRun Boolean 任意 false

実際にリクエストを行わずに、リクエストの有効性を確認するかどうかを指定します。 設定可能な値は以下のとおりです。

  • true: リクエストの有効性はチェックされますが、リクエストは行われません。 チェック項目には、AccessKeyペアが有効かどうか、RAMユーザーが許可されているかどうか、および必要なパラメーターが指定されているかどうかが含まれます。 チェックが失敗した場合、対応するエラーが返されます。 チェックが成功した場合、エラーコード DryRunOperation が返されます。
  • false: リクエストの有効性がチェックされます。 チェックが成功すると、2XX HTTPステータスコードが返され、リクエストが行われます。

既定値：false
Tag.N.Key String 任意 TestKey

専用ホストクラスターのタグNのキー。 N の有効値：1 ～ 20。 タグキーを空の文字列にすることはできません。 長さは最大64文字で、acs: またはaliyunで始めることはできません。 http:// またはhttps:// は使用できません。

Tag.N.Value String 任意 TestValue

専用ホストクラスターのタグNの値。 N の有効値：1 ～ 20。 タグ値を空の文字列にすることはできません。 長さは最大64文字で、acs: またはaliyunで始めることはできません。 http:// またはhttps:// は使用できません。

ResourceGroupId String 任意 rg-bp67acfmxazb4p****

専用ホストクラスターを割り当てるリソースグループのID。
ZoneId String 任意 cn-hangzhou-f

専用ホストクラスターを作成するゾーンのID。 DescribeZonesを呼び出して、最新のゾーンリストを照会できます。

DedicatedHostClusterName String 任意 myDDHCluster

専用ホストクラスターの名前。 名前は 2～128 文字で、英数字、ピリオド (.)、アンダースコア (_)、およびハイフン (-) を使用できます。 先頭は英字である必要があります。 http:// またはhttps:// は使用できません。

このパラメーターはデフォルトで空となります。
説明 String 任意 This-is-my-DDHCluster

専用ホストクラスターの説明。 長さは 2 文字から 256 文字である必要があります。 先頭をhttp:// またはhttps:// にすることはできません。

このパラメーターはデフォルトで空となります。

レスポンスパラメーター

パラメーター データ型 例 説明
DedicatedHostClusterId String dc-bp12wlf6bw0vz9v2 ****

専用ホストクラスターのID。
RequestId String E2A664A6-2933-4C64-88AE-5033D003EADF

リクエストの ID です。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=CreateDedicatedHostCluster
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-f
&DedicatedHostClusterName=myDDHCluster
&Description=This-is-my-DDHCluster
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<CreateDedicatedHostClusterResponse>
      <RequestId>214A2187-B06F-4E49-A081-4D053466A8C7</RequestId>
      <DedicatedHostClusterId>dc-bp12wlf6bw0vz9v2 ****</DedicatedHostClusterId>
</CreateDedicatedHostClusterResponse>

JSON 形式 

{
    "RequestId": "214A2187-B06F-4E49-A081-4D053466A8C7" 、
    "DedicatedHostClusterId": "dc-bp12wlf6bw0vz9v2 ****"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. 指定されたResourceGroupIdパラメーターが存在しない場合に返されるエラーメッセージ。
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. 指定された Tag.N.Key パラメーターが無効な場合に返されるエラーメッセージ。
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. 指定された Tag.N.Value パラメーターが無効な場合に返されるエラーメッセージ。
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. 指定されたタグキーが既に存在している場合に返されるエラーメッセージ。 タグキーは一意である必要があります。

エラーコードリストについては、「API エラーセンター」をご参照ください。