ListVirtualMachines - AWS Backup

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

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 资源名称排序 (ARNs)。

类型:VirtualMachine 对象数组

错误

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

InternalServerException

由于出现内部错误,因此操作未成功。请稍后重试。

HTTP状态码:500

ThrottlingException

TPS仅限于防范故意或无意的高请求量。

HTTP状态码:400

ValidationException

由于出现验证错误,因此操作未成功。

HTTP状态码:400

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs,请参阅以下内容: