查詢一份自訂鏡像已經共用的所有使用者。返回結果支援分頁顯示,每頁的資訊條目預設為 10 條。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:DescribeImageSharePermission |
RegionId | String | 是 | 自訂鏡像所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
ImageId | String | 是 | 自訂鏡像 ID。 |
PageNumber | Integer | 否 | 查詢結果顯示的頁碼。起始值:1 預設值:1 |
PageSize | Integer | 否 | 查詢結果顯示的每頁的資訊條目數。最大值:50 預設值:10 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
ImageId | String | 自訂鏡像 ID |
RegionId | String | 鏡像所屬地域 ID |
ShareGroups | ShareGroupType | 共用群組類型 |
Accounts | AccountType | 阿里雲帳號類型 |
TotalCount | Integer | 記錄總數 |
PageNumber | Integer | 查詢結果顯示的頁碼 |
PageSize | Integer | 每頁的資訊條目數 |
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=DescribeImageSharePermission
&RegionId=cn-qingdao
&ImageId=m-282dzntc7
&<公共請求參數>
返回樣本
XML 格式
<DescribeImageSharePermissionResponse>
<ImageId>m-282dzntc7</ImageId>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<RegionId>cn-qingdao</RegionId>
<TotalCount>1</TotalCount>
<RequestId>441CF898-42FF-47CF-9348-3C3BFF557278</RequestId>
<ShareGroups>
<ShareGroup>
<Group>all</Group>
</ShareGroup>
</ShareGroups>
<Accounts>
<Account>
<AliyunId>1886508529898586</AliyunId>
</Account>
</Accounts>
</DescribeImageSharePermissionResponse>
JSON 格式
{
"ShareGroups": {
"ShareGroup": [
{
"Group": "all"
}
]
},
"Accounts": {
"Account": [
{
"AliyunId": "1886508529898586"
}
]
},
"ImageId": "m-282dzntc7",
"PageNumber": 1,
"PageSize": 10,
"RegionId": "cn-qingdao",
"TotalCount": 1,
"RequestId": "9AD96F49-0BE5-4868-A66A-224352549CEC"
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
MissingParameter | The input parameter “RegionId “ that is mandatory for processing this request is not supplied. | 400 | 您必須指定參數 RegionId 。 |
MissingParameter | The input parameter “ImageId “ that is mandatory for processing this request is not supplied. | 400 | 您必須指定參數 ImageId 。 |
InvalidRegionId.NotFound | The specified region does not exist. | 404 | 指定的 RegionId 不存在。 |
InvalidImageId.NotFound | The specified ImageId does not exist. | 404 | 指定的自訂鏡像不存在。 |