DescribeImageSharePermission - Developer Guide| Alibaba Cloud Documentation Center

Description

This operation allows you to list users where a custom image is shared. It also supports querying by page. By default, ten results are displayed per page.

Request parameters

Name	Type	Required	Description
Action	String	Yes	Value: DescribeImageSharePermission.
RegionId	String	Yes	Indicates the RegionID of the image.
ImageId	String	No	Indicates the ID of an image.
PageNumber	Integer	No	Refers to the page number of the list. The start value is 1; the default value is 1.
PageSize	Integer	No	Sets the number of lines per page for queries per page. The maximum value is 50; the default value is 10.

Return parameters

Name	Type	Description
ImageId	String	Indicates the ID of the image.
RegionId	String	Indicates the region ID of the image.
ShareGroups	ShareGroupType	Indicates the type of the shared group.
Accounts	AccountType	Indicates the type of the Aliyun account.
TotalCount	Integer	Refers to the total number of records.
PageNumber	Integer	Refers to the page number.
PageSize	Integer	Indicates the maximum number of lines per page. The default value is 10; the maximum value is 50.

Error code

Error code	Description	Http status code	Meaning
InvalidRegionId.NotFound	The source region not found.	404	The specified regionId does not exist.
InvalidImageId.NotFound	The specified ImageId does not exist.	404	The specified ImageId does not exist.
IncorrectImageStatus	The image has completed copy.	400	The specified image has been replicated. The cancellation failed.
IncorrectImageStatus	The image is not from copied.	400	The specified image is not created by means of replication. The cancellation failed.

Examples

Request example

https://ecs.aliyuncs.com/?Action=DescribeImageSharePermission
&RegionId=cn-qingdao
&ImageId=m-282dzntc7
&<Public Request Parameters>

Return example

XML format

<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 format

{
    "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"
}