この操作では、専用ホストクラスターの名前や説明など、一部の属性を変更できます。

リクエストパラメーター

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

実行する操作です。 値をModifyDedicatedHostClusterAttributeに設定します。
DedicatedHostClusterId String 必須 dc-bp12wlf6am0vz9v2 ****

専用ホストクラスターのID。
RegionId String 必須 cn-hangzhou

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

DedicatedHostClusterName String 任意 newClusterName

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

説明 String 任意 newClusterDescription

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

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 11B55F58-D3A4-4A9B-9596-342420D02FF8

リクエストの ID です。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=ModifyDedicatedHostClusterAttribute
&RegionId=cn-hangzhou
&DedicatedHostClusterId=dc-bp12wlf6am0vz9v2 ****
&DedicatedHostClusterName=newClusterName
&<共通リクエストパラメーター>

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

XML 形式 

<ModifyDedicatedHostClusterAttributeResponse>
      <RequestId>11B55F58-D3A4-4A9B-9596-342420D02FF8</RequestId>
</ModifyDedicatedHostClusterAttributeResponse>

JSON 形式 

{
    "RequestId": "11B55F58-D3A4-4A9B-9596-342420D02FF8"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidDescription.Malformed 指定されたパラメータの説明が無効です。 指定された Description パラメーターが無効な場合に返されるエラーメッセージ。 説明は、長さが 2 文字から 256 文字とする必要があります。文頭に http:// または https:// を含めることはできません。
403 InvalidUser.Unauthorized ユーザーは承認されていません 該当の操作を実行する権限がない場合に返されるエラーメッセージです。

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