查詢共享單元中關聯資源或資源使用者的記錄。
接口說明
本文將提供一個示例，在cn-hangzhou地域，查詢當前賬號創建的共享單元中關聯的共享資源的記錄。返回結果顯示，當前賬號關聯過以下 2 個資源：
- 在共享單元
rs-6GRmdD3X****中，添加過VSwitch類型的共享資源vsw-bp1upw03qyz8n7us9****，該資源處于關聯中Associated狀態，即該資源正常共享中。 - 在共享單元
rs-6GRmdD3X****中，移除過VSwitch類型的共享資源vsw-bp183p93qs667muql****，該資源處于已分離Disassociated狀態，即該資源已停止共享。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
*全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ResourceId | string | 否 | 資源 ID。 說明
當 AssociationType為Target時，該參數不可用。
| vsw-bp183p93qs667muql**** |
| Target | string | 否 | 資源使用者 ID。 說明
當 AssociationType為Resource時，該參數不可用。
| 172050525300**** |
| AssociationType | string | 是 | 關聯類型：取值：
| Resource |
| AssociationStatus | string | 否 | 關聯狀態。取值：
說明
Failed和Disassociated狀態的記錄，會在 48~96 小時內被系統自動刪除。
| Associated |
| MaxResults | integer | 否 | 單次請求返回結果的最大條數。 取值范圍：1~100。默認值：20。 | 20 |
| NextToken | string | 否 | 當請求的返回結果被截斷時，您可以使用 | TGlzdFJlc291cm**** |
| ResourceShareIds | array | 否 | 共享單元 ID。 N 的取值范圍：1~5，即每次最多指定 5 個共享單元。 | |
| string | 否 | 共享單元 ID。 | rs-6GRmdD3X**** |
返回參數
示例
正常返回示例
JSON格式
{
"NextToken": "TGlzdFJlc291cm****",
"RequestId": "11BA57B5-7301-4E2F-BBA5-2AE4C2F4FCDB",
"ResourceShareAssociations": [
{
"UpdateTime": "2020-12-07T07:39:02.920Z",
"EntityId": "vsw-bp1upw03qyz8n7us9****",
"ResourceShareName": "example",
"CreateTime": "2020-12-07T07:39:01.818Z",
"EntityType": "VSwitch",
"ResourceShareId": "rs-6GRmdD3X****",
"AssociationStatusMessage": "The reason for the association failure. ",
"AssociationType": "Resource",
"AssociationStatus": "Failed",
"External": false,
"TargetProperty": "{\n \"timeRange\":{\n \"timeRangeType\":\"timeRange\",\n \"beginAtTime\":\"00:00\",\n \"timezone\":\"UTC+8\",\n \"endAtTime\":\"19:59\"\n }\n}",
"AssociationFailedDetails": [
{
"Status": "無",
"StatusMessage": "無",
"AssociateType": "無",
"EntityId": "172050525300****",
"EntityType": "Account",
"FailureReason": "Unavailable",
"FailureDescription": "You cannot access the specified resource at this time.",
"OperationType": "Associate"
}
]
}
]
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| AssociationType參數缺失。 | |||
| AssociationType參數錯誤。 | |||
| AssociationStatus參數錯誤。 | |||
| MaxResults參數錯誤。 | |||
| NextToken參數錯誤。 | |||
| NextToken長度超限（最大256個字符）。 | |||
| ResourceShareIds參數錯誤。 | |||
| ResourceShareIds有重復項。 | |||
| ResourceShareIds長度超限（最大5個）。 | |||
| 資源所有者傳參錯誤。 | |||
| ResourceId參數錯誤。 | |||
| 參數組合沖突：傳入參數與AssociationType選定項不符。 | |||
| 參數無效。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 查看變更詳情 | ||
| 查看變更詳情 |