Skip to main content

DescribeInstanceTypeFamilies

Description

Call the DescribeInstanceTypeFamilies to query the list of instance specification families provided by ECS.

Request Method

POST

Request Path

/apsara/route/Ecs/DescribeInstanceTypeFamilies

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
GenerationBODYstringNoecs-3the series information of the instance specification family. Value range: ecs-1: series I instance type family, with earlier launch time and high cost performance. ecs-2: series II instance specification family, the second software and hardware upgrade, and the instance performance is enhanced. ecs-3: series III instance type family, which has excellent instance performance and can carry different business requirements. ecs-4: Series IV instance specification family, with strong scenario adaptability, can carry a large number of popular business requirements, and lower latency. ecs-5: series v instance specification family, including common enterprise instance specifications (g6, c6, r6, etc.) and elastic bare metal server instance specifications, etc., with faster response and better performance.
regionIdBODYstringYesNo sample value for this parameter.region id
RegionIdBODYstringYescn-qingdao-env17-d01region ID. You can call the DescribeRegions to view the latest Alibaba Cloud region list.
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
InstanceTypeFamilyIdstringecs.g6instance specification family ID.
Generationstringecs-5The algebra of the instance specification family.
RequestIdstring473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83Erequest ID.
InstanceTypeFamilyNo sample value for this parameter.No description for this parameter.
InstanceTypeFamiliesarray of instancetypefamilyNo sample value for this parameter.A collection of instance specification family InstanceTypeFamily.

Example

Successful Response example

{
"InstanceTypeFamilyId":"ecs.g6",
"Generation":"ecs-5",
"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"InstanceTypeFamily":"",
"InstanceTypeFamilies":""
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}