本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListCompatibleImages
此操作会返回您Amazon Web Services 账户拥有的、支持在 Snow 设备上使用的不同兼容 Amazon EC2 的亚马逊系统映像 (AMI) 的列表。目前,支持的 AMI 基于市场上可用的亚马逊 Linux-2、Ubuntu 20.04 LTS-Focal 或 Ubuntu 22.04 LTS-Jammy 图片。Amazon市场上不再支持 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
-
一个 JSON 格式的对象,用于描述兼容的 AMI,包括 Snow 设备 AMI 的 ID 和名称。
类型:CompatibleImage 对象数组
- NextToken
-
由于 HTTP 请求是无状态的,因此这是您下一个返回图像列表的起点。
类型:字符串
长度限制:最小长度为 1。长度上限为 1024。
模式:
.*
错误
有关所有操作常见错误的信息,请参阅常见错误。
- Ec2RequestFailedException
-
您的用户缺乏执行尝试操作所必需的 Amazon EC2 权限。
HTTP 状态代码:400
- InvalidNextTokenException
-
字符
NextToken
串被意外更改,操作已停止。在不更改NextToken
字符串的情况下运行该操作,然后重试。HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: