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" } ] }

回應元素

如果動作成功,服務會傳回 200 HTTP 個回應。

服務會以 JSON 格式傳回下列資料。

NextToken

所傳回資源部分清單之後的下一個項目。例如,如果請求傳回 maxResults 個數量的資源,則 NextToken 允許您從下一個字符指向的位置開始傳回列表中的更多項目。

類型:字串

長度限制:長度下限為 1。長度上限為 1000。

模式:^.+$

VirtualMachines

物件清單VirtualMachine,依其 Amazon Resource Names () 排序ARNs。

類型:VirtualMachine 物件陣列

錯誤

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

InternalServerException

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

HTTP 狀態碼:500

ThrottlingException

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

HTTP 狀態碼:400

ValidationException

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

HTTP 狀態碼:400

另請參閱

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