DescribeImageSharePermission

Last Updated: Feb 23, 2018

Description

Queries all the authorized users to whom one of your custom image is shared. The responded information can be displayed on several pages. By default, 10 entries of record are displayed on each page.

Request parameters

Name Type Required Description
Action String Yes The name of this interface. Value: DescribeImageSharePermission.
RegionId String Yes ID of the region to where the custom image belongs.
ImageId String No ID of your custom image.
PageNumber Integer No The page number of the responded information.
Initial value: 1.
Default value: 1.
PageSize Integer No The number of entries on each page for the responded information.
Maximum value: 50.
Default value: 10.

Response parameters

Name Type Description
ImageId String ID of the custom image.
RegionId String Region ID of the custom image.
ShareGroups ShareGroupType Type of the shared group.
Accounts AccountType Type of the Alibaba Cloud user account.
TotalCount Integer Total number of entries.
PageNumber Integer Page number.
PageSize Integer Maximum number of entries on each page.

Examples

Request example

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

Response example

XML format

  1. <DescribeImageSharePermissionResponse>
  2. <ImageId>m-282dzntc7</ImageId>
  3. <PageNumber>1</PageNumber>
  4. <PageSize>10</PageSize>
  5. <RegionId>cn-qingdao</RegionId>
  6. <TotalCount>1</TotalCount>
  7. <RequestId>441CF898-42FF-47CF-9348-3C3BFF557278</RequestId>
  8. <ShareGroups>
  9. <ShareGroup>
  10. <Group>all</Group>
  11. </ShareGroup>
  12. </ShareGroups>
  13. <Accounts>
  14. <Account>
  15. <AliyunId>1886508529898586</AliyunId>
  16. </Account>
  17. </Accounts>
  18. </DescribeImageSharePermissionResponse>

JSON format

  1. {
  2. "ShareGroups": {
  3. "ShareGroup": [
  4. {
  5. "Group": "all"
  6. }
  7. ]
  8. },
  9. "Accounts": {
  10. "Account": [
  11. {
  12. "AliyunId": "1886508529898586"
  13. }
  14. ]
  15. },
  16. "ImageId": "m-282dzntc7",
  17. "PageNumber": 1,
  18. "PageSize": 10,
  19. "RegionId": "cn-qingdao",
  20. "TotalCount": 1,
  21. "RequestId": "9AD96F49-0BE5-4868-A66A-224352549CEC"
  22. }

Error codes

Error code Error message HTTP status code Meaning
MissingParameter The input parameter "RegionId" that is mandatory for processing this request is not supplied. 400 You must specify the RegionId. For more information, see Regions and zones.
MissingParameter The input parameter "ImageId" that is mandatory for processing this request is not supplied. 400 You must specify the ImageId.
InvalidRegionId.NotFound The specified region does not exist. 404 The specified RegionId does not exist.
InvalidImageId.NotFound The specified ImageId does not exist. 404 The specified ImageId does not exist.
Thank you! We've received your feedback.