调用DescribeVirtualNodes批量查询虚拟节点信息_弹性容器实例(ECI)-阿里云帮助中心

调用DescribeVirtualNodes批量查询虚拟节点的详细信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
eci:DescribeVirtualNodes	Read	VirtualNode acs:eci:{#regionId}:{#accountId}:virtualnode/{#virtualnodeId}	eci:tag	无

请求参数

名称	类型	必填	描述	示例值
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	long	否	限制本次查询返回的资源数量。默认返回 20 个，最大不能超过 20 个。说明返回结果可能小于指定的数量，但不会多于指定的数量。	20
Tag	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	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	object []	虚拟节点绑定的标签信息。
Key	string	标签键。	name
Value	string	标签值。	test
Events	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.	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 https://help.aliyun.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 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”不存在。