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 的更多信息，请参阅以下内容：