查詢共享單元列表。
接口說明
本文將提供一個示例,查詢當前賬號在cn-hangzhou
地域創建的共享單元列表。返回結果顯示,當前賬號151266687691****
創建過以下 2 個共享單元:
- 共享單元
rs-hX9wC5jO****
,處于已刪除Deleted
狀態。 - 共享單元
rs-PqysnzIj****
,處于已啟用Active
狀態。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
*全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ResourceOwner | string | 是 | 共享單元歸屬者。取值:
| Self |
ResourceShareName | string | 否 | 共享單元名稱。 | test |
ResourceShareStatus | string | 否 | 共享單元狀態。取值:
說明
Deleted 狀態的共享單元記錄,會在 48~96 小時內被系統自動刪除。
| Active |
MaxResults | integer | 否 | 單次請求返回結果的最大條數。 取值范圍:1~100。默認值:20。 | 20 |
NextToken | string | 否 | 當請求的返回結果被截斷時,您可以使用 | TGlzdFJlc291cm**** |
ResourceShareIds | array | 否 | 共享單元 ID。 N 的取值范圍:1~5,即每次最多指定 5 個共享單元。 | |
string | 否 | 共享單元 ID。 | rs-PqysnzIj**** | |
PermissionName | string | 否 | 共享權限名稱。具體信息,請參見權限庫。 | AliyunRSDefaultPermissionVSwitch |
ResourceGroupId | string | 否 | 資源組 ID。 | rg-aekz5nlvlak**** |
Tag | array<object> | 否 | 標簽列表。 | |
object | 否 | 標簽列表。 | ||
Key | string | 否 | 標簽鍵。 說明
最多支持 128 個字符,不能以 aliyun 和acs: 開頭,不能包含http:// 或者https:// 。
| k1 |
Value | string | 否 | 標簽值。 說明
最多支持 128 個字符,不能以 acs: 開頭,不能包含http:// 或者https:// 。
| v1 |
返回參數
示例
正常返回示例
JSON
格式
{
"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 status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
ResourceOwner參數缺失。 | |||
ResourceOwner參數錯誤。 | |||
共享單元名稱無效。 | |||
共享單元名稱字數超長(最大50字符)。 | |||
ResourceShareStatus參數錯誤。 | |||
MaxResults參數錯誤。 | |||
NextToken參數錯誤。 | |||
NextToken長度超限(最大256個字符)。 | |||
ResourceShareIds參數錯誤。 | |||
ResourceShareIds有重復項。 | |||
ResourceShareIds長度超限(最大5個)。 | |||
參數無效。 | |||
當共享單元歸屬者設置為OtherAccounts時,不允許傳入標簽參數。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
查看變更詳情 | ||
查看變更詳情 |