Cloud Virtual Machine
- Release Notes and Announcements
- Announcements
- Product Introduction
- Image
- Public Image
- TencentOS Server
- Network and Security
- OPS and Monitoring
- Purchase Guide
- Purchasing Instances
- Purchasing Cloud Disks
- Purchasing Reserved Instances
- Purchasing Public Network Bandwidth
- Getting Started
- Operation Guide
- Convenience Features
- Instances
- Creating Instances
- Logging In to Linux Instances
- Logging in to Windows instance
- Adjusting Configuration
- View Instance Details
- Managing Instance IPs
- Terminating/Returning Instances
- Reserved Instances
- Images
- Importing Images
- CentOS Linux Operations
- Migrating Servers
- Online Migration
- Migration Operation Guide
- Maintenance Tasks
- Networking
- Security
- Security Groups
- Managing Security Groups
- Managing Security Group Rules
- Monitoring and Alarms
- Practical Tutorial
- Building an Environment
- Setting up LNMP
- Setting up LAMP manually
- Setting up Java Web
- Setting up Node.js
- Manual Setup of WIPM Environment
- Building a Website
- Discuz! Forum
- Building an Application
- Setting Up FTP Site
- NTP Service
- Building a Visual GUI
- Uploading Local Files to CVM
- High-throughput Network Performance Test
- Operations Guide
- Initializing Data Disks
- Environment Configurations
- Installing Software
- Work with Operating Systems
- Troubleshooting
- Instance-Related Failures
- Windows Instance Login Failures
- Linux Instance Login Failures
- Linux CVM Memory Issues
- API Documentation
- Region APIs
- Instance APIs
- Cloud Hosting Cluster APIs
- Image APIs
- Instance Launch Template APIs
- Making API Requests
- Placement Group APIs
- Key APIs
- Security Group APIs
- Network APIs
- FAQs
- Billing
- Instance
- Storage
- Images
- OPS & Monitoring
- Related Agreement
DocumentationCloud Virtual MachineAPI DocumentationPlacement Group APIsDescribeDisasterRecoverGroups
DescribeDisasterRecoverGroups
Last updated: 2025-03-04 20:59:40
1. API Description
Domain name for API request: cvm.intl.tencentcloudapi.com.
This API is used to query the information on spread placement groups.
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: DescribeDisasterRecoverGroups. |
| 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. |
| DisasterRecoverGroupIds.N | No | Array of String | ID list of spread placement groups. You can operate up to 10 spread placement groups in each request. |
| Name | No | String | Name of a spread placement group. Fuzzy match is supported. |
| Offset | No | Integer | Offset; default value: 0. For more information on Offset, see the corresponding section in API Introduction. |
| Limit | No | Integer | Number of results returned; default value: 20; maximum: 100. For more information on Limit, see the corresponding section in API Introduction. |
| Filters.N | No | Array of Filter | tag-key - String - Optional - Filter by the tag key.tag-value - String - Optional - Filter by the tag value.tag:tag-key - String - Optional - Filter by the tag key-value pair. Replace tag-key with the actual tag keys.Each request can have up to 10 Filters and 5 Filters.Values. |
3. Output Parameters
| Parameter Name | Type | Description |
|---|---|---|
| DisasterRecoverGroupSet | Array of DisasterRecoverGroup | Information on spread placement groups. |
| TotalCount | Integer | Total number of placement groups of the user. |
| 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 the information of a spread placement group
This example shows you how to query the information of a spread placement group.
Input Example
GET https://cvm.intl.tencentcloudapi.com/?Action=DescribeDisasterRecoverGroups
&<Common request parameters>
Output Example
{
"Response": {
"DisasterRecoverGroupSet": [
{
"DisasterRecoverGroupId": "ps-21q9ibvr",
"Name": "Database service",
"Type": "RACK",
"CvmQuotaTotal": 30,
"CurrentNum": 0,
"InstanceIds": [],
"CreateTime": "2018-04-19T02:47:12Z"
}
],
"TotalCount": 1,
"RequestId": "c68ce193-be41-4d13-9a9b-2dc031db6477"
}
}
5. Developer Resources
SDK
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
- Tencent Cloud SDK 3.0 for Python
- Tencent Cloud SDK 3.0 for Java
- Tencent Cloud SDK 3.0 for PHP
- Tencent Cloud SDK 3.0 for Go
- Tencent Cloud SDK 3.0 for Node.js
- Tencent Cloud SDK 3.0 for .NET
- Tencent Cloud SDK 3.0 for C++
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 |
|---|---|
| InvalidParameterValue.DisasterRecoverGroupIdMalformed | Incorrect placement group ID format. |
| InvalidParameterValue.LimitExceeded | The number of parameter values exceeds the limit. |
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No