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

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

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 SDK 中使用此 API 的更多信息,请参阅以下内容: