ListResourceShares API を呼び出してリソース共有をクエリ - Resource Management

共有ユニットをクエリします。

操作説明

このトピックでは、API 操作を呼び出して、現在の Alibaba Cloud アカウントを使用して cn-hangzhou リージョンで作成された共有ユニットをクエリする方法の例を示します。レスポンスは、アカウント 151266687691**** 内に次の共有ユニットが作成されたことを示します。

Deleted 状態の rs-hX9wC5jO****
Active 状態の rs-PqysnzIj****

今すぐお試しください

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

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ResourceOwner	string	必須	共有ユニットのオーナー。有効な値： Self：現在のアカウント OtherAccounts：現在のアカウント以外のアカウント	Self
ResourceShareName	string	任意	共有ユニットの名前。	test
ResourceShareStatus	string	任意	共有ユニットのステータス。有効な値： Active Pending Deleting Deleted 説明共有ユニットを削除すると、`Deleted` 状態の共有ユニットのレコードは 48 時間から 96 時間以内にシステムによって自動的に削除されます。	Active
MaxResults	integer	任意	1 回のリクエストで返すエントリの最大数。有効な値：1～100。デフォルト値：20。	20
NextToken	string	任意	現在のリクエストのレスポンスが切り捨てられた場合に、次のリクエストを開始するために使用される `token`。このトークンを使用して別のリクエストを開始し、残りのレコードを取得できます。	TGlzdFJlc291cm****
ResourceShareIds	array	任意	共有ユニットの ID。 N の有効な値：1～5。これは、一度に最大 5 つの共有ユニットを指定できることを示します。	rs-PqysnzIj****
	string	任意	共有ユニットの ID。	rs-PqysnzIj****
PermissionName	string	任意	権限に関する情報。詳細については、「権限ライブラリ」をご参照ください。	AliyunRSDefaultPermissionVSwitch
ResourceGroupId	string	任意	リソースグループの ID。	rg-aekz5nlvlak****
Tag	array<object>	任意	タグ。
	object	任意	タグ。
Key	string	任意	タグキー。説明タグキーの長さは 128 文字までで、`acs:` または `aliyun` で始めることはできません。タグキーに `http://` または `https://` を含めることはできません。	k1
Value	string	任意	タグ値。説明タグ値の長さは 128 文字までで、`acs:` で始めることはできません。タグ値に `http://` または `https://` を含めることはできません。	v1

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

レスポンスフィールド

フィールド	型	説明	例
	object	返された結果。
NextToken	string	現在のリクエストのレスポンスが切り捨てられた場合に、次のリクエストを開始するために使用される `token`。このトークンを使用して別のリクエストを開始し、残りのレコードを取得できます。	TGlzdFJlc291cm****
RequestId	string	リクエスト ID。	2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA
ResourceShares	array<object>	共有ユニットに関する情報です。
	array<object>	共有ユニットに関する情報。
AllowExternalTargets	boolean	共有ユニット内のリソースをリソースディレクトリ外のアカウントと共有できるかどうかを示します。有効な値： false：共有ユニット内のリソースは、リソースディレクトリ内のアカウントとのみ共有できます。 true：共有ユニット内のリソースは、リソースディレクトリ内のアカウントとリソースディレクトリ外のアカウントの両方と共有できます。	false
CreateTime	string	共有ユニットが作成された時間。	2020-12-03T02:20:31.292Z
ResourceGroupId	string	リソースグループの ID。	rg-aekz5nlvlak****
ResourceShareId	string	共有ユニットの ID。	rs-PqysnzIj****
ResourceShareName	string	共有ユニットの名前。	test
ResourceShareOwner	string	共有ユニットのオーナー。	151266687691****
ResourceShareStatus	string	共有ユニットのステータス。有効な値： Active Pending Deleting Deleted 説明共有ユニットを削除すると、`Deleted` 状態の共有ユニットのレコードは 48 時間から 96 時間以内にシステムによって自動的に削除されます。	Active
Tags	array<object>	タグ。
	object	タグ。
Key	string	タグキー。	k1
Value	string	タグ値。	v1
UpdateTime	string	共有ユニットが更新された時間。	2020-12-03T08:01:43.638Z

例

成功レスポンス

JSONJSON

{
  "NextToken": "TGlzdFJlc291cm****",
  "RequestId": "2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA",
  "ResourceShares": [
    {
      "AllowExternalTargets": false,
      "CreateTime": "2020-12-03T02:20:31.292Z",
      "ResourceGroupId": "rg-aekz5nlvlak****",
      "ResourceShareId": "rs-PqysnzIj****",
      "ResourceShareName": "test",
      "ResourceShareOwner": "151266687691****",
      "ResourceShareStatus": "Active",
      "Tags": [
        {
          "Key": "k1",
          "Value": "v1"
        }
      ],
      "UpdateTime": "2020-12-03T08:01:43.638Z"
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	MissingParameter.ResourceOwner	You must specify ResourceOwner.
400	InvalidParameter.ResourceOwner	The ResourceOwner is invalid.
400	InvalidParameter.ResourceShareName	The ResourceShareName is invalid.
400	InvalidParameter.ResourceShareName.Length	The maximum length of ResourceShareName exceeds 50 characters.
400	InvalidParameter.ResourceShareStatus	The ResourceShareStatus is invalid.
400	InvalidParameter.MaxResults	The MaxResults is invalid.
400	InvalidParameter.NextToken	The NextToken is invalid.
400	InvalidParameter.NextToken.Length	The maximum length of NextToken exceeds 256 characters.
400	InvalidParameter.ResourceShareIds	The ResourceShareIds is invalid.
400	InvalidParameter.ResourceShareIds.Duplicate	The ResourceShareIds contains duplicate values.
400	InvalidParameter.ResourceShareIds.Length	The maximum length of ResourceShareIds exceeds 5 characters.
400	InvalidParameter	The specified parameter is invalid.
400	InvalidParameter.ResourceOwnerAndTag	You cannot use ResourceOwner set to OtherAccounts and tags in one request.

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

変更履歴

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