ListVirtualMachines - AWS Backup

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ListVirtualMachines

列出您的虛擬機器。

請求語法

{ "HypervisorArn": "string", "MaxResults": number, "NextToken": "string" }

請求參數

如需所有動作的一般參數資訊,請參閱《Common Parameters》。

請求接受採用 JSON 格式的下列資料。

HypervisorArn

連線至虛擬機器之 hypervisor的 Amazon Resource Name (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 Resource Name (ARN) 排序。

類型:VirtualMachine 物件陣列

錯誤

如需所有動作常見的錯誤資訊,請參閱《常見錯誤》。

InternalServerException

因為發生內部錯誤,所以操作未成功。請稍後再試。

ErrorCode

發生內部錯誤的描述。

HTTP 狀態碼:500

ResourceNotFoundException

找不到動作所需的資源。

ErrorCode

找不到哪些資源的描述。

HTTP 狀態碼:400

ThrottlingException

TPS 已受到限制,以防止有意或無意的大量請求。

ErrorCode

錯誤:TPS 受到限制,以防止有意或無意的高請求量。

HTTP 狀態碼:400

ValidationException

因為發生驗證錯誤,所以操作未成功。

ErrorCode

造成驗證錯誤的描述。

HTTP 狀態碼:400

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: