最近更新时间：2023.11.20 19:38:34
首次发布时间：2022.07.01 09:23:41
调用 DescribeImageSharePermission 接口查询自定义镜像已经共享的所有用户。
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeImageSharePermission | 要执行的操作，取值：DescribeImageSharePermission。 |
| Version | String | 是 | 2020-04-01 | 接口的版本，取值：2020-04-01。 |
| ImageId | String | 是 | image-ebgy1og99tfct0gw**** | 镜像ID。您可以调用DescribeImages接口并传入Visibility=private参数，查询获取自定义镜像ID。 |
NextToken | String | 否 | - | 分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的 |
MaxResults | Integer | 否 | 10 | 分页查询时设置的每页行数：
|
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| ImageId | String | image-ebgy1og99tfct0gw**** | 镜像ID。 |
| Accounts | Array of struct | - | 镜像共享的账户，具体请参见下表“ Accounts 结构 ”。 |
NextToken | String | bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq****** | 本次调用返回的查询凭证值，返回为空表示该页为末页。 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| AccountId | String | 210005**** | 账户ID。 |
GET /?Action=DescribeImageSharePermission&Version=2020-04-01&ImageId=image-ebgy1og99tfct0gw**** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecs
{ "ResponseMetadata": { "RequestId": "202106111445100102252431000052****", "Action": "DescribeImageSharePermission", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "NextToken":"bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******", "ImageId": "image-ebgy1og99tfct0gw****", "Accounts": [ { "AccountId": "210005****" } ] } }
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidArgument | The specified argument is invalid. | 指定的参数不合法。 |
400 | MissingParameter.ImageId | The required parameter ImageId is not supplied. | 镜像ID不能为空。 |
| 404 | InvalidImage.NotFound | The specified image does not exist. | 指定的镜像不存在。 |
| 500 | InternalError | An internal error has occurred. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |