DescribeVirtualNodes_弹性容器实例_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

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

请求参数

字段名称字段详情
RegionIdstring

地域 ID。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
VirtualNodeNamestring

虚拟节点名称。

示例值:testNode
VirtualNodeIdsstring

虚拟节点 ID 序列。最多 20 个,字符串需按照 JSON 格式传入。

示例值:["vnd-2ze960zkdqrldeaw****","vnd-3ebzcviqbwt25dsz****"]参考取值来源:
    CreateVirtualNode
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参阅如何保证幂等性

示例值:123e4567-e89b-12d3-a456-426655440000
Statusstring

虚拟节点状态。取值范围:展开详情

示例值:Ready
ResourceGroupIdstring

资源组 ID。

示例值:rg-uf66jeqopgqa9hdn****参考取值来源:
    DescribeContainerGroups
NextTokenstring

下一个查询开始的 Token,NextToken 为空表示没有下一个。展开详情

示例值:d78f2dd8-5979-42fe-****-b16db43be5bc
Limitinteger<int64>

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

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:20
Tagarray<object>

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

子级条数 <= 21

返回参数

字段名称字段详情
TotalCountinteger<int32>

查询到的虚拟节点数量。

示例值:1
NextTokenstring

下一个查询开始的 Token。

示例值:d78f2dd8-5979-42fe-****-b16db43be5bc
RequestIdstring

请求 ID。

示例值:9C9B9917-ED22-50D5-ADE6-9FA9D58AD05F
VirtualNodesarray<object>

虚拟节点信息集合。

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
Account.Arrearage
Your account has an outstanding payment.诊断
400
DryRunOperation
Request validation has been passed with DryRun flag set.诊断
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.诊断
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.诊断
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.诊断
400
InvalidParameter.Encrypted.KmsNotEnabled
KMS must be enabled for encrypted disks.诊断
400
InvalidParameter.KMS.EncryptedIllegal
After configuring the parameter KmsKeyId, you must enable encryption.诊断
400
Ipv6AddressNotSupportVsw
IPv6 is not supported in the specified vSwitch.诊断
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.诊断
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.诊断
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.诊断
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.诊断
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.诊断

变更历史

变更时间变更内容概要操作
2023-08-30
变更返回参数
2023-07-03
删除返回参数
2023-01-11
删除请求参数ZoneId
删除请求参数SecurityGroupId
删除请求参数VSwitchId
变更返回参数
2021-09-06
新增OpenAPI,批量查询虚拟节点信息

相关示例