edit-icon download-icon

DescribeImageSharePermission

最終更新日: Mar 06, 2019

カスタムイメージのいずれかが共有されている全ての許可ユーザーを照会します。応答された情報は、複数のページに表示することができます。デフォルトでは、各ページに 10 件のレコードが表示されます。

リクエストパラメータ

名前必須かどうか説明
ActionStringはいこのインタフェースの名前。値:DescribeImageSharePermission 。
RegionId Stringはいカスタムイメージが属するリージョン ID 。
ImageId Stringいいえカスタムイメージの ID 。
ページ番号Integerいいえ応答された情報のページ番号。
初期値は 1 です。
デフォルト値:1
ページサイズIntegerいいえ応答された情報の各ページのエントリ数。
最大値: 50 。
デフォルト値:10 。

レスポンスパラメータ

名前説明
ImageId Stringカスタムイメージの ID 。
RegionId Stringカスタムイメージのリージョン ID 。
ShareGroups ShareGroupType 共有グループのタイプ。
Accounts AccountType Alibaba Cloud ユーザーアカウントの種類。
TotalCountIntegerエントリの総数。
PageNumberIntegerページ番号。
PageSizeInteger各ページのエントリの最大数。

リクエストの例

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

レスポンスの例

XML形式

  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形式

  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. }

エラーコード

このインタフェースに固有のエラーコードは次のとおりです。詳細については、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 指定の ImageId は存在しません。