tencent cloud

Cloud Virtual Machine

Release Notes and Announcements
Release Notes
Public Image Release Notes
Official End of Support Plan for the Operating System
Announcements
Product Introduction
CVM Overview
Strengths
Basic Concepts
Regions and Zones
Tutorial
Service Regions and Service Providers
Billing
Billing Overview
Billing Modes
Billing Items
Billing Mode Conversion Overview
Purchasing Instances
Configuration Adjustment Billing Guide
Overdue Payments
Getting Started
Purchasing a Customized Linux Instance
Purchasing a Customized Windows Instance
User Guide
Operation Guide Overview
Use Limits
Instances
Spot Instances
Reserved Instances
Images
Storage
Backup and Restoration
Network
Security
Passwords/Keys
Monitoring and Alarms
Ops Management
Convenience Features
Migrating a Server
Online Migration
Migration Consultation
Troubleshooting
CVM Login Failures
Windows Instance Login Failures
Linux Instance Login Failures
Other Login Failures
Instance Running Failures
Linux Instance Memory Failures
Network Failures
Use Cases
Suggestions on CVM Model Selection
Environment Building
Website Building
Application Building
Visual GUI Building
Uploading Local Files to CVM
Network Performance Test
Other Practical Tutorials
API Documentation
History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
Security and Compliance
CAM
Network
FAQs
Regions and Zones
Billing
Instances
Storage
Images
Server Migration
Network
Security
Operating Systems
Ops and Monitoring
CAM
NTP Service
Scenarios
Agreements
CVM Service Level Agreements
Red Hat Enterprise Linux Image Service Agreement
Public IP Service Level Agreement
Glossary

DescribeInstanceFamilyConfigs

PDF
Focus Mode
Font Size
Last updated: 2025-11-19 14:40:56

1. API Description

Domain name for API request: cvm.intl.tencentcloudapi.com.

This API is used to query a list of model families available to the current user in the current region.

A maximum of 10 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: DescribeInstanceFamilyConfigs.
Version Yes String Common Params. The value used for this API: 2017-03-12.
Region Yes String Common Params. For more information, please see the list of regions supported by the product. This API only supports: ap-bangkok, ap-beijing, ap-chengdu, ap-chongqing, ap-guangzhou, ap-hongkong, ap-jakarta, ap-nanjing, ap-seoul, ap-shanghai, ap-shanghai-fsi, ap-shenzhen-fsi, ap-singapore, ap-tokyo, eu-frankfurt, na-ashburn, na-siliconvalley, sa-saopaulo.

3. Output Parameters

Parameter Name Type Description
InstanceFamilyConfigSet Array of InstanceFamilyConfig List of instance model families
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Querying supported instance families

This example shows you how to query the supported instance families in the Guangzhou region.

Input Example

POST / HTTP/1.1
Host: cvm.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeInstanceFamilyConfigs
X-TC-Language: en-US
&<Common request parameters>

{}

Output Example

{
    "Response": {
        "InstanceFamilyConfigSet": [
            {
                "InstanceFamilyName": "Standard S1",
                "InstanceFamily": "S1"
            },
            {
                "InstanceFamilyName": "Network-optimized N1",
                "InstanceFamily": "N1"
            },
            {
                "InstanceFamilyName": "High IO I1",
                "InstanceFamily": "I1"
            },
            {
                "InstanceFamilyName": "MEM optimized M1",
                "InstanceFamily": "M1"
            },
            {
                "InstanceFamilyName": "Standard S2",
                "InstanceFamily": "S2"
            },
            {
                "InstanceFamilyName": "Standard network enhanced SN2",
                "InstanceFamily": "SN2"
            },
            {
                "InstanceFamilyName": "High IO I2",
                "InstanceFamily": "I2"
            },
            {
                "InstanceFamilyName": "MEM optimized M2",
                "InstanceFamily": "M2"
            },
            {
                "InstanceFamilyName": "Compute C2",
                "InstanceFamily": "C2"
            },
            {
                "InstanceFamilyName": "Compute Network-optimized CN2",
                "InstanceFamily": "CN2"
            },
            {
                "InstanceFamilyName": "Standard S3",
                "InstanceFamily": "S3"
            },
            {
                "InstanceFamilyName": "Compute C3",
                "InstanceFamily": "C3"
            },
            {
                "InstanceFamilyName": "FPGA FX2",
                "InstanceFamily": "FX2"
            },
            {
                "InstanceFamilyName": "GPU compute GN2",
                "InstanceFamily": "GN2"
            },
            {
                "InstanceFamilyName": "GPU rendering GA2",
                "InstanceFamily": "GA2"
            },
            {
                "InstanceFamilyName": "GPU compute GN8",
                "InstanceFamily": "GN8"
            },
            {
                "InstanceFamilyName": "Dedicated",
                "InstanceFamily": "CDH"
            },
            {
                "InstanceFamilyName": "Shared core",
                "InstanceFamily": "SHARED"
            }
        ],
        "RequestId": "b061782b-934a-4e53-b1eb-d5f2fed8130e"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
InternalServerError Internal error.
InvalidParameterValue Incorrect parameter value.
InvalidRegion.NotFound The region cannot be found.

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback