すべてのプロダクト
Search

このプロダクト

    :ListResourceShareInvitations

    ドキュメントセンター

    :ListResourceShareInvitations

    最終更新日:Oct 13, 2025

    受信したリソース共有の招待を照会します。

    操作説明

    使用上の注意

    このトピックでは、cn-hangzhou リージョンで現在のアカウントのリソース共有の招待を照会する方法の例を示します。応答には、Pending 状態の招待が 1 つ表示されます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    resourcesharing:ListResourceShareInvitations

    list

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    MaxResults

    integer

    任意

    1 回のリクエストで返すエントリの最大数。

    有効な値: 1～100。デフォルト値: 20。

    20
    NextToken

    string

    任意

    出力が切り捨てられた場合は、NextToken を使用して結果の次のページを取得します。

    TGlzdFJlc291cm****
    ResourceShareIds

    array

    任意

    共有ユニットの ID。

    string

    任意

    共有ユニットの ID。

    rs-ysGRci9z****
    ResourceShareInvitationIds

    array

    任意

    リソース共有の招待の ID。

    string

    任意

    リソース共有の招待の ID。

    i-p6eRytrkjVvM****

    共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答オブジェクト。

    NextToken

    string

    出力が切り捨てられた場合は、NextToken を使用して結果の次のページを取得します。

    TGlzdFJlc291cm****
    RequestId

    string

    リクエスト ID。

    30EC8328-1BDE-51D5-BFAB-039508BD91A1
    ResourceShareInvitations

    array<object>

    リソース共有の招待に関する情報。

    object

    リソース共有の招待に関する情報。

    Status

    string

    招待のステータス。有効な値:

    • Pending: 招待は確認待ちです。

    • Accepted: 招待は承諾済みです。

    • Cancelled: 招待はキャンセル済みです。

    • Rejected: 招待は拒否済みです。

    • Expired: 招待は期限切れです。

    • AcceptFailed: 招待の承諾に失敗しました。

    Pending
    CreateTime

    string

    招待が作成された時刻。時刻は UTC で表示されます。

    2022-08-18T05:36:45.024Z
    ResourceShareId

    string

    共有ユニットの ID。

    rs-ysGRci9z****
    ResourceShareName

    string

    共有ユニットの名前。

    example
    SenderAccountId

    string

    招待を送信した Alibaba Cloud アカウントの ID。

    151266687691****
    ReceiverAccountId

    string

    招待を受信した Alibaba Cloud アカウントの ID。

    134254031178****
    ResourceShareInvitationId

    string

    リソース共有の招待の ID。

    i-p6eRytrkjVvM****
    InvitationFailedDetails

    array<object>

    共有ユニットへの招待を承諾するか、共有ユニットを終了するときに実行されるチェックの失敗に関する詳細。

    object

    共有ユニットへの招待を承諾するか、共有ユニットを終了するときに実行されるチェックの失敗に関する詳細。

    Status

    string

    このパラメーターは非推奨です。代わりに FailureReason を使用してください。

    None
    StatusMessage

    string

    このパラメーターは非推奨です。代わりに FailureDescription を使用してください。

    None
    AssociateType

    string

    このパラメーターは非推奨です。代わりに OperationType を使用してください。

    None
    ResourceArn

    string

    共有リソースの Alibaba Cloud リソースネーム (ARN)。

    acs:vpc:cn-shanghai:103755469187****:vswitch/vsw-uf62b11ue4m8oz2di****
    ResourceType

    string

    共有リソースのタイプ。

    共有できるリソースタイプの詳細については、「リソース共有をサポートする Alibaba Cloud サービス」をご参照ください。

    Snapshot
    FailureReason

    string

    招待の承諾または共有ユニットの終了のチェックが失敗した理由。有効な値:

    • Unavailable: リソースは共有できません。

    • LimitExceeded: リソースを共有できるアカウントの数がクォータを超えています。

    • ZonalResourceInaccessible: このリージョンではリソースにアクセスできません。

    • InternalError: チェック中にサーバーで内部エラーが発生しました。

    • UnsupportedOperation: この操作はサポートされていません。

    Unavailable
    FailureDescription

    string

    招待の承諾または共有ユニットの終了のチェックが失敗した理由の詳細な説明。

    You cannot access the specified resource at this time.
    OperationType

    string

    操作タイプ。有効な値:

    • Associate: 関連付け。

    • Disassociate: 関連付けの解除。

    Associate
    ResourceId

    string

    共有リソースの ID。

    s-7xvh46nx5oqlre0wv***

    例

    成功レスポンス

    JSONJSON

    {
  "NextToken": "TGlzdFJlc291cm****",
  "RequestId": "30EC8328-1BDE-51D5-BFAB-039508BD91A1",
  "ResourceShareInvitations": [
    {
      "Status": "Pending",
      "CreateTime": "2022-08-18T05:36:45.024Z",
      "ResourceShareId": "rs-ysGRci9z****",
      "ResourceShareName": "example",
      "SenderAccountId": "151266687691****",
      "ReceiverAccountId": "134254031178****",
      "ResourceShareInvitationId": "i-p6eRytrkjVvM****",
      "InvitationFailedDetails": [
        {
          "Status": "None",
          "StatusMessage": "None",
          "AssociateType": "None",
          "ResourceArn": "acs:vpc:cn-shanghai:103755469187****:vswitch/vsw-uf62b11ue4m8oz2di****",
          "ResourceType": "Snapshot",
          "FailureReason": "Unavailable",
          "FailureDescription": "You cannot access the specified resource at this time.",
          "OperationType": "Associate",
          "ResourceId": "s-7xvh46nx5oqlre0wv***"
        }
      ]
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter.MaxResults The MaxResults is invalid. The MaxResults is invalid.
    400 InvalidParameter.NextToken The NextToken is invalid. The NextToken is invalid.
    400 InvalidParameter.NextToken.Length The maximum length of NextToken exceeds 256 characters. The maximum length of NextToken exceeds 256 characters.
    400 InvalidParameter.ResourceShareIds The ResourceShareIds is invalid. The ResourceShareIds is invalid.
    400 InvalidParameter.ResourceShareIds.Duplicate The ResourceShareIds contains duplicate values. The ResourceShareIds contains duplicate values.
    400 InvalidParameter.ResourceShareIds.Length The maximum length of ResourceShareIds exceeds 5 characters. The maximum length of ResourceShareIds exceeds 5 characters.
    400 InvalidParameter.ResourceShareInvitationIds The ResourceShareInvitationIds is invalid.
    400 InvalidParameter.ResourceShareInvitationIds.Duplicate The ResourceShareInvitationIds duplicate values.
    400 InvalidParameter.ResourceShareInvitationIds.Length The maximum length of ResourceShareInvitationIds exceeds quota limit.

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

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。