すべてのプロダクト
Search

このプロダクト

    :DescribeInstanceRamRole

    ドキュメントセンター

    :DescribeInstanceRamRole

    最終更新日:Jun 19, 2025

    1 つ以上のインスタンスにアタッチされているインスタンス RAM ロール (Resource Access Management) をクエリします。

    説明

    Alibaba Cloud CLI を使用して API オペレーションを呼び出す場合は、必要なデータ型のすべてのリクエストパラメーター値を必須フォーマットで指定する必要があります。 詳細については、「パラメーターフォーマットの概要」をご参照ください。

    デバッグ

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

    リクエストパラメーター

    パラメーター

    データ型

    必須

    例

    説明

    Action

    String

    はい

    DescribeInstanceRamRole

    実行する操作。 値を DescribeInstanceRamRole に設定します。

    PageNumber

    Integer

    いいえ

    1

    返すページ番号。

    ページは 1 ページ目から始まります。

    デフォルト値: 1。

    PageSize

    Integer

    いいえ

    10

    各ページに返すエントリの数。

    最大値: 50。

    デフォルト値: 10。

    RegionId

    String

    はい

    cn-hangzhou

    インスタンス RAM ロールのリージョン ID。DescribeRegions オペレーションを呼び出して、最新のリージョンリストをクエリできます。

    InstanceIds

    String

    いいえ

    ["i-bp67acfmxazb1p****", "i-bp67acfmxazb2p****", "bp67acfmxazb3p****"…]

    インスタンスの ID。 1 つのリクエストで最大 100 個のインスタンス ID を指定できます。 InstanceIds パラメーターと RamRoleName パラメーターの少なくとも 1 つを指定する必要があります。

    RamRoleName

    String

    いいえ

    EcsServiceRole-EcsDocGuideTest

    インスタンス RAM ロールの名前。 RAM が提供する ListRoles オペレーションを呼び出して、作成したインスタンス RAM ロールをクエリできます。 InstanceIds パラメーターと RamRoleName パラメーターの少なくとも 1 つを指定する必要があります。

    レスポンスパラメーター

    パラメーター

    データ型

    例

    説明

    RequestId

    String

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    リクエストの ID。

    TotalCount

    Integer

    1

    返されたインスタンス RAM ロールの総数。

    RegionId

    String

    cn-hangzhou

    インスタンス RAM ロールのリージョン ID。

    InstanceRamRoleSets

    InstanceRamRoleSet の配列

    インスタンス RAM ロールの詳細。

    InstanceRamRoleSet

    RamRoleName

    String

    EcsServiceRole-EcsDocGuideTest

    インスタンス RAM ロールの名前。

    InstanceId

    String

    i-bp67acfmxazb4p****

    インスタンスの ID

    例

    リクエストの例

    https://ecs.aliyuncs.com/?Action=DescribeInstanceRamRole
&RegionId=cn-hangzhou
&InstanceIds=["i-bp67acfmxazb1p****", "i-bp67acfmxazb2p****", "bp67acfmxazb3p****"]
&PageNumber=1
&PageSize=1
&<共通リクエストパラメーター>

    正常なレスポンスの例

    XML 形式

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

<DescribeInstanceRamRoleResponse>
    <RequestId>8F4CAE3F-7892-4662-83A5-2C2FFD639553</RequestId>
    <InstanceRamRoleSets>
        <InstanceRamRoleSet>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <RamRoleName>EcsServiceRole-EcsDocGuideTest</RamRoleName>
        </InstanceRamRoleSet>
    </InstanceRamRoleSets>
    <TotalCount>1</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>1</PageSize>
</DescribeInstanceRamRoleResponse>

    JSON 形式

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

{
  "RequestId" : "8F4CAE3F-7892-4662-83A5-2C2FFD639553",
  "InstanceRamRoleSets" : {
    "InstanceRamRoleSet" : [ {
      "InstanceId" : "i-bp67acfmxazb4p****",
      "RamRoleName" : "EcsServiceRole-EcsDocGuideTest"
    } ]
  },
  "TotalCount" : 1,
  "PageNumber" : 1,
  "PageSize" : 1
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明

    400

    InvalidInstanceIds.Malformed

    指定された InstanceId が無効です。

    指定された InstanceIds パラメーターが無効なために返されるエラーメッセージ。

    500

    InternalError

    不明なエラーが原因でリクエストの処理に失敗しました。

    内部エラーが発生したために返されるエラーメッセージ。 後でもう一度お試しください。

    403

    InvalidNetworkType.MismatchRamRole

    RAM ロールはクラシックネットワークタイプのインスタンスに適用できません。

    インスタンス RAM ロールは、クラシックネットワークのインスタンスではなく、仮想プライベートクラウド (VPC) のインスタンスにのみ使用できるために返されるエラーメッセージ。

    403

    InvalidParameter.AllEmpty

    %s

    必須パラメーターが指定されていないために返されるエラーメッセージ。

    404

    InvalidInstanceId.NotFound

    指定された InstanceId は存在しません。

    指定されたインスタンスが存在しないために返されるエラーメッセージ。 インスタンス ID が正しいかどうかを確認してください。

    エラーコードのリストについては、「サービスエラーコード」をご参照ください。