查詢一份自訂鏡像已經共用的所有使用者。返回結果支援分頁顯示,每頁的資訊條目預設為 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 指定的自訂鏡像不存在。