调用API DescribeScalingConfigurations查询ECS类型伸缩配置的信息,包括实例规格、镜像等信息,方便您提前了解弹性扩张时使用的ECS实例模板详情。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ess:DescribeScalingConfigurations | get | *ScalingGroup acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId} |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 伸缩配置所属伸缩组的地域 ID。 | cn-qingdao |
PageNumber | integer | 否 | 伸缩配置列表的页码,起始值:1。 默认值:1。 | 1 |
PageSize | integer | 否 | 分页查询时设置的每页行数,最大值:50。 默认值:10。 | 50 |
ScalingGroupId | string | 否 | 伸缩组的 ID,您可以查询该伸缩组下所有的伸缩配置。 | asg-bp17pelvl720x3v7**** |
ScalingConfigurationIds | array | 否 | 待查询伸缩配置的 ID。 查询结果包括生效和未生效的伸缩配置,并通过返回参数 | |
string | 否 | 待查询伸缩配置的 ID。 查询结果包括生效和未生效的伸缩配置,并通过返回参数 | asc-bp17pelvl720x5ub**** | |
ScalingConfigurationNames | array | 否 | 待查询伸缩配置的名称。 查询结果会忽略失效的伸缩配置名称,并且不报错。 | |
string | 否 | 待查询伸缩配置的名称。 查询结果会忽略失效的伸缩配置名称,并且不报错。 | scalingcon**** |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"PageNumber": 1,
"PageSize": 50,
"TotalCount": 1,
"ScalingConfigurations": [
{
"DeploymentSetId": "ds-bp1frxuzdg87zh4p****",
"CreationTime": "2014-08-14T10:58Z",
"ScalingConfigurationName": "scalingconfigura****",
"SystemDiskDescription": "Test system disk.",
"KeyPairName": "keypair****",
"SecurityGroupId": "sg-bp18kz60mefs****",
"PrivatePoolOptions.Id": "eap-bp67acfmxazb4****",
"SystemDiskAutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
"SpotStrategy": "NoSpot",
"ScalingGroupId": "asg-bp17pelvl720x3v7****",
"Affinity": "default",
"Tenancy": "default",
"SystemDiskSize": 100,
"Ipv6AddressCount": 1,
"SpotDuration": 1,
"LifecycleState": "Active",
"InstanceName": "instance****",
"SecurityEnhancementStrategy": "Active",
"UserData": "echo hello ecs!\t\n",
"PrivatePoolOptions.MatchCriteria": "Open",
"DedicatedHostId": "dh-bp67acfmxazb4p****",
"InstanceGeneration": "ecs-3",
"HpcClusterId": "hpc-clus****",
"PasswordInherit": true,
"Memory": 16,
"ImageId": "centos6u5_64_20G_aliaegis_2014****.vhd",
"ImageFamily": "hangzhou-daily-update",
"ImageOwnerAlias": "system",
"LoadBalancerWeight": 1,
"SystemDiskCategory": "cloud",
"HostName": "LocalHost",
"SystemDiskName": "cloud_ssd_Test",
"InternetMaxBandwidthOut": 10,
"InternetMaxBandwidthIn": 10,
"InstanceType": "ecs.g6.large",
"InstanceDescription": "FinanceDept",
"IoOptimized": "none",
"RamRoleName": "ramrole****",
"SystemDiskPerformanceLevel": "PL1",
"Cpu": 2,
"ResourceGroupId": "rg-aekzn2ou7xo****",
"ZoneId": "cn-hangzhou-g",
"InternetChargeType": "PayByTraffic",
"ImageName": "centos6u5_64_20G_aliaegis_2014****.vhd\t\n",
"ScalingConfigurationId": "asc-bp1ezrfgoyn5kijl****",
"CreditSpecification": "Standard",
"SpotInterruptionBehavior": "Terminate",
"CustomPriorities": [
{
"InstanceType": "ecs.c6a.4xlarge",
"VswitchId": "vsw-bp14zolna43z266bq****\n"
}
],
"DataDisks": [
{
"PerformanceLevel": "PL1",
"Description": "FinanceDept",
"SnapshotId": "s-23f2i****",
"Device": "/dev/xvdb",
"Size": 200,
"DiskName": "cloud_ssdData",
"AutoSnapshotPolicyId": "sp-bp19nq9enxqkomib****",
"Category": "cloud",
"KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****",
"DeleteWithInstance": true,
"Encrypted": "false",
"Categories": [
"cloud_essd"
],
"ProvisionedIops": 100,
"BurstingEnabled": false
}
],
"Tags": [
{
"Key": "binary",
"Value": "alterTable"
}
],
"SpotPriceLimits": [
{
"InstanceType": "ecs.g6.large\t\n",
"PriceLimit": 0.125
}
],
"InstancePatternInfos": [
{
"MaxPrice": 2,
"Cores": 2,
"Memory": 4,
"InstanceFamilyLevel": "EnterpriseLevel",
"Architectures": [
"X86"
],
"BurstablePerformance": "Include",
"ExcludedInstanceTypes": [
"ecs.n1.small/ecs.n1.*/*7*"
],
"InstanceTypeFamilies": [
"ecs.g6"
],
"MinimumCpuCoreCount": 2,
"MaximumCpuCoreCount": 4,
"GpuSpecs": [
"NVIDIA V100"
],
"InstanceCategories": [
"Compute-optimized with GPU"
],
"CpuArchitectures": [
"X86"
],
"PhysicalProcessorModels": [
"Intel Xeon(Ice Lake) Platinum 8369B"
],
"MinimumEniQuantity": 2,
"MinimumEniPrivateIpAddressQuantity": 2,
"MinimumEniIpv6AddressQuantity": 1,
"MinimumInitialCredit": 12,
"MinimumBaselineCredit": 12,
"MinimumMemorySize": 4,
"MaximumMemorySize": 4,
"MinimumGpuAmount": 2,
"MaximumGpuAmount": 2
}
],
"SystemDiskCategories": [
"cloud"
],
"WeightedCapacities": [
4
],
"InstanceTypes": [
"ecs.g6.large"
],
"SecurityGroupIds": [
"sg-bp18kz60mefs****"
],
"SchedulerOptions": {
"ManagedPrivateSpaceId": "testManagedPrivateSpaceId"
},
"SystemDiskEncrypted": false,
"SystemDiskKMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****\t\n",
"SystemDiskEncryptAlgorithm": "AES-256\t\n",
"SystemDiskProvisionedIops": 100,
"SystemDiskBurstingEnabled": false,
"ImageOptionsLoginAsNonRoot": false,
"DeletionProtection": false,
"StorageSetId": "ss-bp67acfmxazb4p****",
"StorageSetPartitionNumber": 2,
"NetworkInterfaces": [
{
"InstanceType": "Primary",
"NetworkInterfaceTrafficMode": "HighPerformance",
"Ipv6AddressCount": 1,
"SecurityGroupIds": [
"sg-2vc3e1v7xxxxx"
]
}
],
"DedicatedHostClusterId": "dc-zm04u8r3lohsq****",
"PasswordSetted": false,
"SecurityOptions": {
"ConfidentialComputingMode": "TDX"
},
"HttpEndpoint": "enabled",
"HttpTokens": "optional"
}
]
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-11-08 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2024-10-10 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2024-06-12 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2024-04-23 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2024-03-20 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2024-01-29 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2023-11-24 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2023-08-23 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2023-04-12 | OpenAPI 返回结构发生变更 | 查看变更详情 |