調用DescribeVirtualNodes批量查詢虛擬節點的詳細信息。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| eci:DescribeVirtualNodes | get | *VirtualNode acs:eci:{#regionId}:{#accountId}:virtualnode/{#virtualnodeId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 ID。 | cn-hangzhou |
| VirtualNodeName | string | 否 | 虛擬節點名稱。 | testNode |
| VirtualNodeIds | string | 否 | 虛擬節點 ID 序列。最多 20 個，字符串需按照 JSON 格式傳入。 | ["vnd-2ze960zkdqrldeaw****","vnd-3ebzcviqbwt25dsz****"] |
| ClientToken | string | 否 | 保證請求冪等性。從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。只支持 ASCII 字符，且不能超過 64 個字符。更多詳情，請參閱如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
| Status | string | 否 | 虛擬節點狀態。取值范圍：
| Ready |
| ResourceGroupId | string | 否 | 資源組 ID。 | rg-uf66jeqopgqa9hdn**** |
| NextToken | string | 否 | 下一個查詢開始的 Token，NextToken 為空表示沒有下一個。 首次查詢時無需設置該參數，后續查詢的 Token 從返回結果中獲取。 | d78f2dd8-5979-42fe-****-b16db43be5bc |
| Limit | long | 否 | 限制本次查詢返回的資源數量。默認返回 20 個，最大不能超過 20 個。 說明
返回結果可能小于指定的數量，但不會多于指定的數量。
| 20 |
| Tag | array<object> | 否 | 虛擬節點綁定的標簽列表。 | |
| object | 否 | 虛擬節點綁定的標簽列表。 | ||
| Key | string | 否 | 標簽鍵。 | name |
| Value | string | 否 | 標簽值。 | test |
返回參數
示例
正常返回示例
JSON格式
{
"TotalCount": 1,
"NextToken": "d78f2dd8-5979-42fe-****-b16db43be5bc",
"RequestId": "9C9B9917-ED22-50D5-ADE6-9FA9D58AD05F",
"VirtualNodes": [
{
"Status": "Ready",
"CreationTime": "2021-09-08T15:00:00Z",
"VpcId": "vpc-1vzjjflab6wvjox****",
"InternetIp": "192.0.XX.XX",
"Tags": [
{
"Key": "name",
"Value": "test"
}
],
"Events": [
{
"Type": "Normal",
"LastTimestamp": "2021-09-08T02:24:52Z",
"Message": "Successfully",
"Name": "test",
"Reason": "Created",
"Count": 1,
"FirstTimestamp": "2021-09-08T02:24:48Z"
}
],
"VirtualNodeId": "vnd-2ze960zkdqrldeaw****",
"IntranetIp": "10.19.XX.XX",
"RegionId": "cn-hangzhou",
"VirtualNodeVSwitchId": "vsw-2ze23nqzig8inprou****",
"VirtualNodeSecurityGroupId": "sg-2zeeyaaxlkq9sppl****",
"ResourceGroupId": "rg-uf66jeqopgqa9hdn****",
"VirtualNodeName": "testNode"
}
]
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Account.Arrearage | Your account has an outstanding payment. | 賬號已經欠費。 |
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | 此次DryRun預檢請求合格。 |
| 400 | InvalidParameter.CPU.Memory | The specified cpu and memory are not allowed | - |
| 400 | InvalidParameter.DuplicatedName | The container group include containers with duplicate names. | 容器組內有重復名字的容器。 |
| 400 | InvalidParameter.DuplicatedVolumeName | The container group includes volumes with duplicate names. | 容器組內有重復名字的數據卷。 |
| 400 | IncorrectStatus | %s | 指定的實例狀態不正確。 |
| 400 | ServiceNotEnabled | %s | 該次請求所依賴的服務沒有開通，請開通后再試。 |
| 400 | ImageSnapshot.IncorrectStatus | %s | 用于鏡像緩存的快照狀態不正確。 |
| 400 | ImageSnapshot.NotSupport | %s | 基于數據盤快照的鏡像緩存功能暫未全網開放，如有需要請聯系我們。 |
| 400 | DiskVolume.NotSupport | The disk volume is not supported. | 云盤卷暫不支持，如有需要請聯系我們。 |
| 400 | RamRole.NotSupport | The RAM role is not supported. | ram實例角色不支持。 |
| 400 | DiskNumber.LimitExceed | The maximum number of disks in an instance is exceeded. | 實例下云盤數目超過限制。 |
| 400 | InvalidPaymentMethod.InsufficientBalance | No payment method is specified for your account. We recommend that you add a payment method or add funds to the prepayment balance. | 您的賬戶暫無有效支付方式，請添加支付方式或保持預付款余額充足。 |
| 400 | DiskVolume.NotInSameZone | The instance to be created and the disk are not in the same zone. | 即將創建的實例和云盤不在同一可用區。 |
| 400 | NoPermission | You are not authorized to use the "Product on ECI" feature. | - |
| 400 | HighCpuMemConfigRequired | You need to apply to be added to the whitelist of the specified CPU and memory. | 您需要申請CPU高配白名單。 |
| 400 | RecommendEmpty.InstanceTypeFamilyNotMatched | The recommended instance type is unavailable in the current zone. Try again later. | 當前可用區沒有推薦的規格可使用，請稍后重試或者到其他的可用區創建。 |
| 400 | LocalDiskAmountNotMatch | The number of local volumes does not match the instance type. | 本地盤數量跟實例規格不匹配 |
| 400 | Payfor.CreditPayInsufficientBalance | Your payment credit line is insufficient. | 您的付款信用額度不足。 |
| 400 | InvalidOperation.KMS.InstanceTypeNotSupport | The specified instance is invalid. Only I/O optimized instances support KMS key. | 指定的實例無效，只有 I/O 優化類型的實例支持設置“KMS Key”。 |
| 400 | InvalidParameter.Encrypted.KmsNotEnabled | KMS must be enabled for encrypted disks. | 加密磁盤需要啟用密鑰管理服務。 |
| 400 | InvalidParameter.KMS.EncryptedIllegal | After configuring the parameter KmsKeyId, you must enable encryption. | 設置參數“KmsKeyId”后，您必須開啟加密屬性。 |
| 400 | Ipv6AddressNotSupportVsw | IPv6 is not supported in the specified vSwitch. | 該交換機暫未開通ipv6地址。 |
| 403 | OperationDenied.VswZoneMisMatch | The specified VSwitchId is not in the specified Zone. | - |
| 403 | QuotaExceeded | %s quota exceeded. | 用戶允許創建的實例已經超過限制。 |
| 403 | Zone.NotOnSale | The specified zone is not available for purchase. | 創建實例的可用區已經關閉售賣，請更換其他可用區。或者無法在該可用區使用指定 VPC 的虛擬交換機。 |
| 403 | Forbidden.RiskControl | This operation has been identified as an abnormal operation and cannot be processed. | 此操作已被確定為一個操作異常，無法處理。 |
| 403 | Forbidden.SubUser | The specified action is not available for you. | 當前用戶無法執行該操作。 |
| 403 | Forbidden.OnlyForInvitedTest | Eci create action is only open to invited users during public beta. | Eci公測階段只對受邀的用戶開放。 |
| 403 | OperationDenied.SecurityGroupMisMatch | The specified VSwitchId and SecurityGroupId are not in the same VPC. | 指定的交換機和安全組不在同一個VPC下。 |
| 403 | InvalidVSwitchId.IpNotEnough | The specified VSwitch does not have enough IP addresses. | - |
| 403 | Forbidden.UserNotRealNameAuthentication | This operation is not allowed, because you have not passed the real-name verification. | 操作被禁止，因為用戶還未進行實名認證。 |
| 403 | InvalidUser.PassRoleForbidden | The RAM user is not authorized to assume a RAM role. | 子賬號用戶沒有權限使用RAM實例角色。 |
| 403 | NoPermission | The RAM role does not belong to ECS. | - |
| 403 | OperationDenied.NoStock | Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see http://bestwisewords.com/document_detail/157290.html | - |
| 403 | InvalidParameter.KMS.KeyId.Forbidden | You are not authorized to access the specified KMSKeyId. | 無權訪問指定的 KMSKeyId。 |
| 403 | NoPermission | The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again. | - |
| 403 | Forbidden.AccountClosed | The operation is forbidden. Your account has been closed. | 操作被禁止，因為用戶賬戶已注銷。 |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | The operation is forbidden. The security group has been managed by another cloud product. | 安全組由其他云產品管理，禁止操作。 |
| 403 | Spot.NotMatched | %s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see http://bestwisewords.com/document_detail/157290.html | - |
| 403 | SecurityRisk.3DVerification | We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. | 我們檢測到您的默認信用卡或借記卡存在安全風險。請通過電子郵件中的鏈接進行驗證。 |
| 403 | CreateServiceLinkedRole.Denied | Please make sure the account has ram:CreateServiceLinkedRole permission. | 請確保賬號擁有ram:CreateServiceLinkedRole權限。 |
| 404 | ImageSnapshot.NotFound | The specified snapshot does not exist. | 鏡像緩存，快照不存在。 |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的云盤不存在。 |
| 404 | InvalidParameter.KMS.KeyId.NotFound | The specified KMSKeyId does not exist. | 指定的參數“KMSKeyId”不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-08-30 | OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更 | 查看變更詳情 |
| 2023-07-03 | OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更 | 查看變更詳情 |
| 2021-09-06 | 新增 OpenAPI | 查看變更詳情 |