インスタンスRAMロールのデタッチ - - Alibaba Cloud ドキュメントセンター

ECS インスタンスからインスタンス Resource Access Management (RAM) ロールをデタッチします。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	はい	DetachInstanceRamRole	実行する操作。値を DetachInstanceRamRole に設定します。
RegionId	String	はい	cn-hangzhou	リージョン ID。DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。
RamRoleName	String	いいえ	RamRoleTest	インスタンス RAM ロールの名前。 RAM が提供する ListRoles 操作を呼び出して、作成したインスタンス RAM ロールを照会できます。
InstanceIds	String	はい	["i-bp67acfmxazb4p**", "i-bp67acfmxazb5p", "i-bp67acfmxazb6p**"…]	インスタンスの ID。値は、最大 100 個のインスタンス ID で構成される JSON 配列です。インスタンス ID はカンマ (,) で区切ります。

レスポンスパラメーター

パラメーター	タイプ	例	説明
RamRoleName	String	RamRoleTest	インスタンス RAM ロールの名前。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	リクエストの ID。
TotalCount	Integer	1	インスタンス RAM ロールのデタッチを試みたインスタンスの総数。
FailCount	Integer	0	インスタンス RAM ロールのデタッチに失敗したインスタンスの数。
DetachInstanceRamRoleResults	DetachInstanceRamRoleResult の配列		インスタンスからインスタンス RAM ロールをデタッチした結果。
DetachInstanceRamRoleResult
Code	String	200	インスタンス RAM ロールがデタッチされたかどうかを示します。ステータスコード 200 は、リクエストが成功したことを示します。その他のステータスコードは、リクエストが失敗したことを示します。
Message	String	Success	インスタンス RAM ロールがデタッチされたかどうかを示します。ステータスコード Success は、リクエストが成功したことを示します。その他のステータスコードは、リクエストが失敗したことを示します。詳細については、このトピックの「エラーコード」セクションをご参照ください。
InstanceId	String	i-bp67acfmxazb4p****	インスタンス RAM ロールのデタッチを試みたインスタンスの ID。
Success	Boolean	true	インスタンス RAM ロールがデタッチされたかどうかを示します。
InstanceRamRoleSets	InstanceRamRoleSet の配列		インスタンスのインスタンス RAM ロール。
InstanceRamRoleSet
RamRoleName	String	RamRoleTest	インスタンス RAM ロールの名前。
InstanceId	String	i-bp67acfmxazb4p****	インスタンスの ID。

例

サンプルリクエスト

https://ecs.aliyuncs.com/?Action=DetachInstanceRamRole
&InstanceIds=["i-bp67acfmxazb4p****", "i-bp67acfmxazb5p****", "i-bp67acfmxazb6p****"…]
&RegionId=cn-hangzhou
&RamRoleName=RamRoleTest
&<Common request parameters>

サンプルの成功レスポンス

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<DetachInstanceRamRoleResponse>
    <TotalCount>1</TotalCount>
    <DetachInstanceRamRoleResults>
        <DetachInstanceRamRoleResult>
            <Message>success</Message>
            <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
            <Code>200</Code>
            <InstanceRamRoleSets>
                <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
                <RamRoleName>RamRoleTest</RamRoleName>
            </InstanceRamRoleSets>
        </DetachInstanceRamRoleResult>
    </DetachInstanceRamRoleResults>
    <RequestId>14D5B163-CE6C-4489-B979-DBE5D0495A63</RequestId>
    <RamRoleName/>
    <FailCount>0</FailCount>
</DetachInstanceRamRoleResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "DetachInstanceRamRoleResults" : {
    "DetachInstanceRamRoleResult" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp16qng6jnvt6g7t****",
      "Code" : "200",
      "InstanceRamRoleSets" : {
        "InstanceId" : "i-bp16qng6jnvt6g7t****",
        "RamRoleName" : "RamRoleTest"
      }
    } ]
  },
  "RequestId" : "14D5B163-CE6C-4489-B979-DBE5D0495A63",
  "RamRoleName" : "",
  "FailCount" : 0
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidInstanceIds.Malformed	The specified instanceIds are not valid.	指定されたインスタンス ID が無効です。
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	インスタンス RAM ロールは、クラシックネットワークのインスタンスではなく、仮想プライベートクラウド (VPC) のインスタンスにのみ使用できます。
403	InvalidUser.PassRoleForbidden	The RAM user does not have the privilege to pass a RAM role.	RAM ユーザーは、RAM ロールを渡す権限を持っていません。
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	指定されたインスタンス ID が見つかりません。

エラーコードの一覧については、サービスエラーコードをご参照ください。