全部产品
Search
文档中心

弹性容器实例：DescribeVirtualNodes - 批量查询虚拟节点信息

更新时间：Oct 17, 2025

调用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}
  • eci:tag
 无

请求参数

名称

类型

必填

描述

示例值
RegionId

string

是

地域 ID。

cn-hangzhou
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

否

虚拟节点状态。取值范围：

  • Pending

  • Ready

  • Failed

Ready
ResourceGroupId

string

否

资源组 ID。

rg-uf66jeqopgqa9hdn****
NextToken

string

否

下一个查询开始的 Token，NextToken 为空表示没有下一个。

首次查询时无需设置该参数，后续查询的 Token 从返回结果中获取。

d78f2dd8-5979-42fe-****-b16db43be5bc
Limit

integer

否

限制本次查询返回的资源数量。默认返回 20 个，最大不能超过 20 个。

说明

返回结果可能小于指定的数量，但不会多于指定的数量。

20
Tag

array<object>

否

虚拟节点绑定的标签列表。

object

否

虚拟节点绑定的标签列表。

Key

string

否

标签键。

name
Value

string

否

标签值。

test

返回参数

名称

类型

描述

示例值

object

TotalCount

integer

查询到的虚拟节点数量。

1
NextToken

string

下一个查询开始的 Token。

d78f2dd8-5979-42fe-****-b16db43be5bc
RequestId

string

请求 ID。

9C9B9917-ED22-50D5-ADE6-9FA9D58AD05F
VirtualNodes

array<object>

虚拟节点信息集合。

array<object>

虚拟节点信息集合。

Status

string

虚拟节点状态。可能值：

  • Pending

  • Ready

  • Failed

Ready
CreationTime

string

虚拟节点创建时间。UTC 时间，RFC 3339 标准。

2021-09-08T15:00:00Z
VpcId

string

虚拟节点所属的 VPC ID。

vpc-1vzjjflab6wvjox****
InternetIp

string

虚拟节点的公网 IP。

192.0.XX.XX
Tags

array<object>

虚拟节点绑定的标签信息。

object

标签信息。

Key

string

标签键。

name
Value

string

标签值。

test
Events

array<object>

事件信息。

object

事件信息。

Type

string

事件类型。可能值：

  • Normal

  • Warning

Normal
LastTimestamp

string

事件结束时间。

2021-09-08T02:24:52Z
Message

string

事件消息。

Successfully
Name

string

事件的归属对象名。

test
Reason

string

事件名。

Created
Count

integer

事件数。

1
FirstTimestamp

string

事件开始时间。

2021-09-08T02:24:48Z
VirtualNodeId

string

虚拟节点 ID。

vnd-2ze960zkdqrldeaw****
IntranetIp

string

虚拟节点的内网 IP。

10.19.XX.XX
RegionId

string

虚拟节点所属的地域 ID。

cn-hangzhou
VirtualNodeVSwitchId

string

虚拟节点所属的交换机 ID。

vsw-2ze23nqzig8inprou****
VirtualNodeSecurityGroupId

string

虚拟节点所属的安全组 ID。

sg-2zeeyaaxlkq9sppl****
ResourceGroupId

string

虚拟节点所属的资源组 ID。

rg-uf66jeqopgqa9hdn****
VirtualNodeName

string

虚拟节点的名称。

testNode

示例

正常返回示例

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.
403 OperationDenied.SecurityGroupMisMatch The specified VSwitchId and SecurityGroupId are not in the same 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 https://help.aliyun.com/document_detail/157290.html
403 InvalidParameter.KMS.KeyId.Forbidden You are not authorized to access the specified KMSKeyId. 无权访问指定的 KMSKeyId。
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 https://help.aliyun.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”不存在。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。