本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ListVirtualMachines
列出您的虚拟机。
请求语法
{
"HypervisorArn": "string
",
"MaxResults": number
,
"NextToken": "string
"
}
请求参数
有关所有操作共用参数的信息,请参阅常用参数。
请求接受采用 JSON 格式的以下数据。
- HypervisorArn
-
连接到您的虚拟机的 Amazon 资源名称 (ARN)。
类型:字符串
长度限制:最小长度为 50。长度上限为 500。
模式:
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$
必需:否
- MaxResults
-
要列出的最大虚拟机数量。
类型:整数
有效范围:最小值为 1。
必需:否
- NextToken
-
返回资源的部分列表之后的下一项。例如,如果请求返回资源
maxResults
数量,则NextToken
允许您从下一个令牌所指向的位置开始返回列表中的更多项目。类型:字符串
长度限制:最小长度为 1。长度上限为 1000。
模式:
^.+$
必需:否
响应语法
{
"NextToken": "string",
"VirtualMachines": [
{
"HostName": "string",
"HypervisorId": "string",
"LastBackupDate": number,
"Name": "string",
"Path": "string",
"ResourceArn": "string"
}
]
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- NextToken
-
返回资源的部分列表之后的下一项。例如,如果请求返回资源
maxResults
数量,则NextToken
允许您从下一个令牌所指向的位置开始返回列表中的更多项目。类型:字符串
长度限制:最小长度为 1。长度上限为 1000。
模式:
^.+$
- VirtualMachines
-
您的
VirtualMachine
对象的列表,按其 Amazon 资源名称 (ARN) 排序。类型:VirtualMachine 对象数组
错误
有关所有操作常见错误的信息,请参阅常见错误。
- InternalServerException
-
由于发生了内部错误,操作未成功。请稍后重试。
HTTP 状态代码:500
- ThrottlingException
-
已对 TPS 进行了限制,以防止有意或无意的高请求量。
HTTP 状态代码:400
- ValidationException
-
由于出现验证错误,操作未成功。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: