ListCompatibleImages - Amazon Snowball
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

ListCompatibleImages

此操作将返回您的 Amazon Web Services 账户拥有并且支持在 Snow 设备上使用的多个与 Amazon EC2 兼容的 Amazon Machine Image (AMI) 的列表。目前,支持的 AMI 基于 Amazon Marketplace 上可用的 Amazon Linux-2、Ubuntu 20.04 LTS-Focal 或 Ubuntu 22.04 LTS-Jammy 映像。市场不再支持 Ubuntu 16.04 LTS - Xenial (HVM) 映像,但仍支持通过 Amazon EC2 虚拟机导入/导出在设备上使用,并在 AMI 中本地运行。

请求语法

{ "MaxResults": number, "NextToken": "string" }

请求参数

有关所有操作的通用参数的信息,请参阅通用参数

请求接受采用 JSON 格式的以下数据。

MaxResults

兼容映像列表的最大结果数量。目前,一台 Snowball Edge 设备可以存储 10 个 AMI。

类型:整数

有效范围:最小值为 0。最大值为 100。

必需:否

NextToken

HTTP 请求是无状态请求。要确定哪个对象出现在兼容映像列表中的“下一个”,您可以为 NextToken 指定一个值作为返回映像列表的起点。

类型:字符串

长度限制:最小长度为 1。长度上限为 1024。

模式:.*

必需:否

响应语法

{ "CompatibleImages": [ { "AmiId": "string", "Name": "string" } ], "NextToken": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

CompatibleImages

一个描述兼容 AMI 的 JSON 格式的对象,包括 Snow 设备 AMI 的 ID 和名称。

类型:CompatibleImage 对象数组

NextToken

由于 HTTP 请求是无状态请求,因此这是下一个返回的映像列表的起点。

类型:字符串

长度限制:最小长度为 1。长度上限为 1024。

模式:.*

错误

有关所有操作返回的常见错误的信息,请参阅 常见错误

Ec2RequestFailedException

您的用户缺乏执行尝试操作所必需的 Amazon EC2 权限。

HTTP 状态代码:400

InvalidNextTokenException

NextToken 字符串被意外更改,操作已停止。在不更改 NextToken 字符串的情况下运行操作,然后重试。

HTTP 状态代码:400

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: