tencent cloud

APIs

Cloud Virtual Machine
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
Tencent Cloud Lighthouse
History
Introduction
API Category
Making API Requests
Image APIs
Firewall APIs
Key APIs
Instance APIs
CCN APIs
Snapshot APIs
Other APIs
Cloud Disk APIs
Scene APIs
Package APIs
Quota APIs
Region APIs
Data Types
Error Codes
Auto Scaling
History
Introduction
API Category
Making API Requests
Scaling Group APIs
Scaling Group Instances APIs
Launch Configuration APIs
Scheduled Action APIs
Alarm Trigger Policy APIs
Notification APIs
Lifecycle Hook APIs
Instance Refresh APIs
Other APIs
Data Types
Error Codes
Batch Compute
History
Introduction
API Category
Making API Requests
Compute Environment APIs
Configuration Viewing-related APIs
Task Template-related APIs
Job-related APIs
Data Types
Error Codes
Tencent Cloud Automation Tools
History
Introduction
API Category
Making API Requests
Remote Command APIs
Scheduled Execution APIs
Managed Instance APIs
Scenario APIs
Statistics APIs
Data Types
Error Codes
Edge Computing Machine
History
API Category
Making API Requests
Region APIs
Module APIs
Instance APIs
Image APIs
VPC APIs
Subnet APIs
Route Table APIs
CLB APIs
ENI APIs
EIP APIs
HAVIP APIs
Other API
Key APIs
Security Group APIs
Data Types
Error Codes
Tencent Kubernetes Engine
History
Introduction
API Category
Making API Requests
Elastic Cluster APIs
Resource Reserved Coupon APIs
Cluster APIs
Third-party Node APIs
Relevant APIs for Addon
Network APIs
Node APIs
Node Pool APIs
TKE Edge Cluster APIs
Cloud Native Monitoring APIs
Scaling group APIs
Super Node APIs
Other APIs
Data Types
Error Codes
TKE API 2022-05-01
Tencent Container Registry
History
Introduction
API Category
Making API Requests
Instance Management APIs
Namespace APIs
Access Control APIs
Instance Synchronization APIs
Tag Retention APIs
Trigger APIs
Helm Chart APIs
Image Repository APIs
Custom Account APIs
Data Types
Error Codes
Tencent Cloud Elastic Microservice
History
Introduction
API Category
Making API Requests
Environment APIs
ModifyIngress
Resource APIs
Application APIs
Service APIs
Application Deployment APIs
Access Policy APIs
Configuration file APIs
Log collecting APIs
Scaling Rule APIs
Application Version APIs
Other APIs
Workload APIs
Data Types
Error Codes
Serverless Cloud Function
History
Introduction
API Category
Making API Requests
Other APIs
Namespace APIs
Layer Management APIs
Async Event Management APIs
Trigger APIs
Function APIs
Function and Layer Status Description
Data Types
Error Codes
Event Bridge
History
Introduction
API Category
Making API Requests
Delivery Target APIs
Event Bus APIs
Event Rule APIs
Event Connector APIs
Data Transformer APIs
Event Storage APIs
Data Types
Error Codes
Cloud Object Storage
Introduction
Common Request Headers
Common Response Headers
Error Codes
Request Signature
Action List
Service APIs
Bucket APIs
Object APIs
Batch Operation APIs
Data Processing APIs
Job and Workflow
Content Moderation APIs
Cloud Antivirus API
Cloud File Storage
History
Introduction
API Category
Snapshot APIs
File system APIs
Lifecycle APIs
Other APIs
Data Flow APIs
Making API Requests
Permission Group APIs
Service APIs
Scaling APIs
Data Migration APIs
Data Types
Error Codes
Cloud Block Storage
History
Introduction
API Category
Making API Requests
Snapshot APIs
Cloud Disk APIs
Data Types
Error Codes
Cloud HDFS
History
Introduction
API Category
Making API Requests
Other APIs
Permission group APIs
Permission rule APIs
Mount point APIs
Lifecycle rule APIs
File system APIs
Restoration task APIs
Data Types
Error Codes
Cloud Log Service
History
Introduction
API Category
Making API Requests
Topic Management APIs
Log Set Management APIs
Index APIs
Topic Partition APIs
Machine Group APIs
Collection Configuration APIs
Log APIs
Metric APIs
Alarm Policy APIs
Data Processing APIs
Kafka Protocol Consumption APIs
Kafka Task APIs
Kafka Data Subscription APIs
COS Task APIs
SCF Delivery Task APIs
Scheduled SQL Analysis APIs
COS Data Import Task APIs
Data Types
Error Codes
TDSQL-C for MySQL
History
Introduction
API Category
Making API Requests
Instance APIs
Multi-Availability Zone APIs
Other APIs
Audit APIs
Database Proxy APIs
Backup and Recovery APIs
Parameter Management APIs
Billing APIs
serverless APIs
Resource Package APIs
Account APIs
Performance Analysis APIs
Data Types
Error Codes
TencentDB for MySQL
History
Introduction
API Category
Instance APIs
Making API Requests
Data Import APIs
Database Proxy APIs
Database Audit APIs
Security APIs
Task APIs
Backup APIs
Account APIs
Rollback APIs
Parameter APIs
Database APIs
Monitoring APIs
Log-related API
Data Types
Error Codes
TencentDB for MariaDB
History
Introduction
API Category
Making API Requests
Security Group APIs
Other APIs
Account APIs
Parameter Management APIs
Monitoring Management APIs
Instance Management APIs
Backup and Restoration APIs
Data Types
Error Codes
TencentDB for PostgreSQL
History
Introduction
API Category
Making API Requests
Instance APIs
Read-only Replica APIs
Backup and Recovery APIs
Parameter Management APIs
Security Group APIs
Performance Optimization APIs
Account APIs
Specification APIs
Network APIs
Data Types
Error Codes
TencentDB for SQL Server
History
Introduction
API Category
Making API Requests
Sales and fee related APIs
Instance Management related APIs
Operation and maintenance management related APIs
Network management related APIs
Account management related APIs
Database management related APIs
Security group management related APIs
Data security encryption related APIs
Parameter configuration related APIs
Extended Event related APIs
Log management related APIs
Read only instance management related APIs
Publish and subscribe related APIs
Backup related APIs
Data migration (cold standby migration) related APIs
Rollback related APIs
Data migration (DTS old version) related APIs
SQL Server Integration Services (SSIS) related APIs
Data Types
Error Codes
TDSQL for MySQL
History
Introduction
API Category
Security Group APIs
Other APIs
Making API Requests
TDSQL APIs
Data Types
Error Codes
Tencent Cloud Distributed Cache (Redis OSS-Compatible)
History
Introduction
API Category
Making API Requests
Instance APIs
Parameter Management APIs
Other APIs
Backup and Restoration APIs
Region APIs
Monitoring and Management APIs
Log APIs
Data Types
Error Codes
TencentDB for MongoDB
History
Introduction
API Category
Making API Requests
Instance APIs
Backup APIs
Account APIs
Other APIs
Task APIs
Introduction
Data Types
Error Codes
TencentDB for TcaplusDB
History
Introduction
API Category
Making API Requests
Table Group APIs
Other APIs
Table APIs
Cluster APIs
Data Types
Error Codes
Data Transfer Service
History
Introduction
API Category
Making API Requests
(NewDTS) Data Migration APIs
Data Sync APIs
Data Consistency Check APIs
(NewDTS) Data Subscription APIs
Data Types
Error Codes
DTS API 2018-03-30
TencentDB for DBbrain
History
Introduction
Introduction
API Category
Making API Requests
Session Killing APIs
Exception Detection APIs
Other APIs
Redis related APIs
Health Report Email Sending APIs
Space Analysis APIs
Security Audit APIs
Slow Log Analysis APIs
Database Audit APIs
Data Types
Error Codes
DBbrain APIs 2019-10-16
Virtual Private Cloud
History
Introduction
API Category
Making API Requests
VPC APIs
Route Table APIs
Elastic Public IP APIs
Elastic IPv6 APIs
Highly Available Virtual IP APIs
ENI APIs
Bandwidth Package APIs
NAT Gateway APIs
Direct Connect Gateway APIs
Cloud Connect Network APIs
Network ACL APIs
Network Parameter Template APIs
Network Detection-Related APIs
Flow Log APIs
Gateway Traffic Monitor APIs
Private Link APIs
Traffic Mirroring APIs
Other APIs
Subnet APIs
VPN Gateway APIs
Security Group APIs
Snapshot Policy APIs
Error Codes
Data Types
Cloud Load Balancer
History
Introduction
API Category
Instance APIs
Listener APIs
Backend Service APIs
Target Group APIs
Redirection APIs
Other APIs
Classic CLB APIs
Load Balancing APIs
Making API Requests
Data Types
Error Codes
CLB API 2017
Direct Connect
History
Introduction
API Category
Making API Requests
Direct Connect APIs
Data Types
Error Codes
Content Delivery Network
History
Introduction
API Category
Content Management APIs
Real-time Log APIs
Service Query APIs
Data Query APIs
Making API Requests
Log Query APIs
Domain Name Management APIs
Configuration Management APIs
Obsoleted APIs
Other APIs
Data Types
Error Codes
Global Application Acceleration Platform
History
Introduction
API Category
Rule APIs
Connection Group APIs
Making API Requests
Origin Server APIs
Listener APIs
Connection APIs
Certificate APIs
Other APIs
Data Types
Error Codes
Tencent Cloud Firewall
History
Introduction
API Category
Making API Requests
Intrusion Defense APIs
Access Control APIs
Other APIs
Enterprise Security Group APIs
Firewall Status APIs
Data Types
Error Codes
Tencent Cloud EdgeOne
History
Introduction
API Category
Making API Requests
Site APIs
Acceleration Domain Management APIs
Site Acceleration Configuration APIs
Edge Function APIs
Alias Domain APIs
Security Configuration APIs
Layer 4 Application Proxy APIs
Content Management APIs
Data Analysis APIs
Log Service APIs
Billing APIs
Certificate APIs
Origin Protection APIs
Load Balancing APIs
Diagnostic Tool APIs
Custom Response Page APIs
API Security APIs
DNS Record APIs
Content Identifier APIs
Legacy APIs
Ownership APIs
Image and Video Processing APIs
Multi-Channel Security Gateway APIs
Version Management APIs
Data Types
Error Codes
Cloud Workload Protection Platform
History
Introduction
API Category
Asset Management APIs
Virus Scanning APIs
Abnormal Log-in APIs
Password Cracking APIs
Malicious Request APIs
High-Risk Command APIs
Local Privilege Escalation APIs
Reverse Shell APIs
Vulnerability Management APIs
New Baseline Management APIs
Baseline Management APIs
Advanced Defense APIs
Security Operation APIs
Expert Service APIs
Other APIs
Overview Statistics APIs
Settings Center APIs
Making API Requests
Intrusion Detection APIs
Data Types
Error Codes
Key Management Service
History
Introduction
API Category
Key APIs
Making API Requests
Asymmetric Key APIs
Data Types
Error Codes
Secrets Manager
History
Introduction
API Category
Making API Requests
Data Security APIs
Other APIs
Data Types
Error Codes
Captcha
History
Introduction
API Category
Making API Requests
Server APIs
Error Codes
Customer Identity and Access Management
History
Introduction
API Category
Making API Requests
User Management APIs
Data Sync APIs
Audit Management APIs
Data Types
Error Codes
Security Token Service
History
Introduction
API Category
Making API Requests
STS APIs
Data Types
Error Codes
SSL Certificates
History
Introduction
API Category
Making API Requests
Certificate APIs
Certificate Renewal (Certificate ID Unchanged) APIs
CSR APIs
Data Types
Error Codes
Private DNS
History
Introduction
API Category
Making API Requests
Private DNS APIs
Data Types
Error Codes
DNSPod
History
Introduction
API Category
Making API Requests
Line APIs
Package and Value-Added Service APIs
Batch Operation APIs
Group APIs
Record APIs
DNS Query Volume APIs
Alias APIs
Domain APIs
Data Types
Error Codes
Elastic MapReduce
History
Introduction
API Category
Cluster Resource Management APIs
Cluster Services APIs
User Management APIs
Data Inquiry APIs
Scaling APIs
Configuration APIs
Other APIs
Serverless HBase APIs
YARN Resource Scheduling APIs
Making API Requests
Data Types
Error Codes
Elasticsearch Service
History
Introduction
API Category
Instance APIs
Making API Requests
Data Types
Error Codes
Data Lake Compute
History
Introduction
API Category
Making API Requests
Data Table APIs
Task APIs
Metadata APIs
Service Configuration APIs
Permission Management APIs
Database APIs
Data Source Connection APIs
Data Optimization APIs
Data Engine APIs
Resource Group for the Standard Engine APIs
Data Types
Error Codes
Face Recognition
History
Introduction
API Category
Making API Requests
Face Detection and Analysis APIs
Facial Feature Localization APIs
Face Comparison APIs
Group Management APIs
Face Search APIs
Face Verification APIs
Image-based Liveness Detection (High Precision) APIs
Data Types
Error Codes
eKYC
History
Introduction
API Category
Making API Requests
Selfie Verification (Pure API) APIs
Selfie Verification (App SDK) APIs
Identity Verification (App SDK) APIs
Identity Verification(Mobile HTML5) APIs
AI Face Shield (Pure API) APIs
Other APIs
Data Types
Error Codes
Text To Speech
History
Introduction
API Category
Making API Requests
General Text-to-Speech APIs
Data Types
Error Codes
Tencent Machine Translation
History
Introduction
API Category
Making API Requests
APIs
Error Codes
Optical Character Recognition
History
Introduction
API Category
Making API Requests
Document Intelligent APIs
Card and Document OCR APIs
General Text OCR APIs
Vehicle Scene OCR APIs
Data Types
Error Codes
IoT Hub
History
Introduction
API Category
Making API Requests
Device Shadow APIs
Device APIs
CA Certificate APIs
Product APIs
Data Types
Error Codes
TDMQ for CKafka
History
Introduction
API Category
Making API Requests
Other APIs
ACL APIs
Instance APIs
Routing APIs
DataHub APIs
Topic APIs
Data Types
Error Codes
Cloud Message Queue
History
API Category
Making API Requests
Topic APIs
Queue APIs
Introduction
Data Types
Error Codes
Chat
JavaScript
Android
iOS & macOS
Swift
Flutter
Electron
Unity
React Native
C APIs
C++
Short Message Service
History
Introduction
API Category
Making API Requests
SMS Mobile Number APIs
SMS Conversion Rate APIs
Status Pull APIs
SMS Statistics APIs
SMS Signature APIs
SMS Delivery APIs
SMS Template APIs
Data Types
Error Codes
SMS Callback APIs
Tencent Push Notification Service
Overview
API Overview
Call Method
Push APIs
Tag APIs
Account APIs
Statistics APIs
User Attribute APIs
Server-Side Error Codes
Server SDKs
API (Java)
Simple Email Service
History
Introduction
API Category
Making API Requests
Domain Verification APIs
Mail APIs
Template APIs
Statistics APIs
Sender Address APIs
Blocklist APIs
Sending Status Query APIs
Batch Task APIs
Custom Blocklist APIs
Data Types
Error Codes
Tencent Real-Time Communication
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
StreamLive
History
Introduction
API Category
Making API Requests
Input Management APIs
Input Security Group Management APIs
Channel Management APIs
Plan APIs
Watermark Management APIs
Statistics APIs
Data Types
Error Codes
StreamPackage
History
Introduction
API Category
Making API Requests
Channel Management APIs
Advertising Insertion Configuration Management APIs
Channel linear assembly management APIs
VOD remux task APIs
Usage Query APIs
HarvestJob Management APIs
Data Types
Error Codes
StreamLink
History
API Category
Making API Requests
Flow APIs
Data Types
Error Codes
Cloud Streaming Services
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
Video on Demand
History
Introduction
API Category
Other APIs
Media Processing APIs
Task Management APIs
Media Upload APIs
Media Management APIs
Event Notification Relevant API
Media Categorization APIs
Domain Name Management APIs
Distribution APIs
AI-based Sample Management APIs
Region Management APIs
Data Statistics APIs
Carousel-Related APIs
Just In Time Transcode APIs
No longer recommended APIs
Making API Requests
AI-based image processing APIs
Parameter Template APIs
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
Media Processing Service
History
Introduction
API Category
Making API Requests
Processing Task Initiation APIs
Task Management APIs
Transcoding and Enhancement Template APIs
Watermark Template APIs
Screenshot Template APIs
Media AI Template APIs
Media AI—Hotword Lexicon APIs
Media AI—Sample Management APIs
Media Quality Inspection Template APIs
Live Streaming Recording Template APIs
Orchestration Management APIs
Data Statistics APIs
StreamLink—Security Group Management APIs
Other APIs
Image Processing Template APIs
AI Generation APIs
Other APIs
Data Types
Error Codes
Cloud Application Rendering
History
Introduction
API Category
Making API Requests
User APIs
Application Management APIs
Project Management APIs
Concurrency Management APIs
Stream Push Service APIs
Data Types
Error Codes
Game Multimedia Engine
History
Introduction
API Category
Usage APIs
Recording APIs
Making API Requests
Voice Chat APIs
Application APIs
Data Types
Error Codes
Tag
History
Introduction
API Category
Making API Requests
Write APIs
Read APIs
Project APIs
Data Types
Error Codes
Cloud Access Management
History
Introduction
API Category
Making API Requests
User APIs
Policy APIs
Role APIs
Identity Provider APIs
Data Types
Error Codes
CloudAudit
History
Introduction
API Category
Calling Method
CloudAudit APIs
Data Types
Error Codes
Tencent Cloud Organization
History
Introduction
API Category
Making API Requests
Organization Settings APIs
Department and Member Management APIs
Unified Member Login APIs
Member Access Management APIs
Organization Service Management APIs
Organization Management Policy APIs
Resource Sharing APIs
Identity Center Management APIs
Identity Center User Management APIs
Identity Center User Group Management APIs
Identity Center Management SCIM Synchronization APIs
Identity Center Single Sign-On Management APIs
Identity Center Permission Configuration Management APIs
Identity Center Multi-Account Authorization Management APIs
Identity Center Sub-User Synchronization Management APIs
Data Types
Error Codes
TCO API 2018-12-25
Tencent Cloud Observability Platform
History
Introduction
API Category
Making API Requests
Monitoring Data Query APIs
Alarm APIs
Legacy Alert APIs
Notification Template APIs
TMP APIs
Grafana Service APIs
Event Center APIs
TencentCloud Managed Service for Prometheus APIs
Monitoring APIs
Data Types
Error Codes
Real User Monitoring
History
Introduction
API Category
Making API Requests
Console APIs
Business System and Project Information APIs
Custom Speed Test APIs
Custom Event APIs
API Monitoring APIs
Exception Analysis APIs
Page View APIs
Static Resource Monitoring APIs
Log APIs
Page Performance APIs
Data Types
Error Codes
International Partners
History
Introduction
API Category
Making API Requests
Customer Management APIs
Credit Management APIs
Agent APIs
Bill Management APIs
Voucher Management APIs
Commission Management APIs
Data Types
Error Codes
Billing Center
API Category
Funds Management APIs
Order Management APIs
Resource Management APIs
Bill Management APIs
Cost Allocation Management APIs
Cost Management APIs
Making API Requests
Organization Account APIs
Data Types
Error Codes
TDSQL Boundless
History
Introduction
API Category
Making API Requests
Instance APIs
Security Group APIs
Task APIs
Backup APIs
Rollback APIs
Parameter APIs
Database APIs
Data Types
Error Codes
TDMQ for MQTT
History
Introduction
API Category
Making API Requests
Cluster APIs
Topic APIs
Authorization Policy APIs
User APIs
Client APIs
Message APIs
Message Enhancement Rule APIs
Data Types
Error Codes
Tencent HY
History
Introduction
API Category
Making API Requests
Hunyuan Text APIs
Hunyuan 3D APIs
Data Types
Error Codes
Smart Media Hosting
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
Quota Center
History
Introduction
API Category
Making API Requests
Alarm APIs
Data Types
Error Codes
Message Center
History
Introduction
API Category
Making API Requests
Message Subscription APIs
Data Types
Error Codes
Business Intelligence
History
Introduction
API Category
Making API Requests
Project Management APIs
Role APIs
Database Table APIs
Report Embedding APIs
Page Management APIs
Data Types
Error Codes
LLM Knowledge Engine Basic API
History
Introduction
API Category
Making API Requests
Atomic Capability APIs
Data Types
Error Codes
Tencent Cloud Agent Development Platform
History
API Category
Making API Requests
Atomic Capability APIs
Operation Optimization APIs
Document Library APIs
Q&A Database APIs
Knowledge Tag APIs
Application Management APIs
Enterprise Management APIs
Billing APIs
Release Management APIs
Dialogue Endpoint APIs
Data Statistics APIs
Data Types
Error Codes
Tencent Cloud Blockchain as a Service
History
Introduction
API Category
Making API Requests
Hyperledger Fabric 2.3 APIs
Data Types
Error Codes
Performance Testing Service
History
Introduction
API Category
Making API Requests
PTS-related APIs
Data Types
Error Codes
Real-time Teleoperation
History
Introduction
API Category
Making API Requests
Project APIs
Device APIs
Session APIs
Authorization APIs
Other APIs
Data Types
Error Codes
Gateway Load Balancer
History
Introduction
API Category
Making API Requests
Target Group APIs
GWLB APIs
Other APIs
Data Types
Error Codes
Identity Aware Platform
History
Introduction
API Category
Making API Requests
IAP APIs
Error Codes
Cloud Dedicated Cluster
History
Introduction
API Category
Making API Requests
Cloud Dedicated Cluster (CDC) APIs
Data Types
Error Codes
Image Creation Large Model
History
Introduction
API Category
Making API Requests
Image Style Transfer APIs
Data Types
Error Codes
Face Fusion
API Category
Making API Requests
Image Face Fusion (Basic) APIs
Video Face Fusion (Single Face) APIs
Data Types
Error Codes
Tencent Smart Advisor-Chaotic Fault Generator
History
Introduction
API Category
Making API Requests
Task APIs
Template Library APIs
Data Types
Error Codes
Tencent HealthCare Omics Platform
History
Introduction
API Category
Making API Requests
Environment Management APIs
Tencent Healthcare Omics Platform APIs
Data Types
Error Codes
Tencent Cloud TCHouse-D
History
Introduction
API Category
Making API Requests
Cluster Operation APIs
Database and Table APIs
Cluster Information Viewing APIs
Hot-Cold Data Layering APIs
Database and Operation Audit APIs
User and Permission APIs
Resource Group Management APIs
Data Types
Error Codes
Tencent Cloud WeData
History
Introduction
API Category
Making API Requests
Project Management APIs
Smart Ops Related Interfaces
Resource Group APIs
Data Development APIs
Data Asset - Data Dictionary APIs
Data Development APIs
Ops Center APIs
Data Exploration APIs
Data Operations Related Interfaces
Asset APIs
Metadata Related Interfaces
Task Operations APIs
Data Security APIs
Instance Operation and Maintenance Related Interfaces
Data Map and Data Dictionary APIs
Data Quality Related Interfaces
DataInLong APIs
Platform Management APIs
Data Source Management APIs
Data Quality APIs
Platform Management APIs
Asset Data APIs
Data Source Management APIs
Data Types
Error Codes
WeData API 2025-08-06
Anti-DDoS
History
Introduction
API Category
Making API Requests
Anti-DDoS Advanced Instance APIs
Resource List APIs
Protection Configuration APIs
Other APIs
Alarm Notification APIs
Connection Configuration APIs
Intelligent Scheduling APIs
Black hole unblocking APIs
Statistical Report APIs
Data Types
Error Codes
Cloud Contact Center
History
Introduction
API Category
Making API Requests
Agent APIs
Skill Group APIs
Number APIs
Dual Call APIs
Predictive Outbound Call APIs
SIP Phone APIs
Call Service Record APIs
Billing APIs
Other APIs
Outbound Call APIs
Speech Intelligent Agent APIs
Data Types
Error Codes
Tencent Cloud Super App as a Service
History
Introduction
API Category
Making API Requests
Operation Management APIs
Platform Management APIs
Sensitive API-Related APIs
Role Management APIs
Team Management APIs
Other Console APIs
Mini Program or Mini Game APIs
Management-Sensitive APIs
Global Domain Management APIs
Superapp APIs
User Management APIs
Data Types
Tencent Cloud Smart Advisor
History
Introduction
API Category
Making API Requests
Other APIs
Task APIs
Cloud Architecture Console APIs
Data Types
Error Codes
TDMQ for RabbitMQ
History
Introduction
API Category
Making API Requests
Relevant APIs for RabbitMQ Serverless PAAS Capacity
RabbitMQ Serverless Instance Management APIs
Data Types
Error Codes
Control Center
History
Introduction
API Category
Making API Requests
Account Factory APIs
Data Types
Error Codes
TDMQ for CMQ
API Documentation
API 2.0 to 3.0 Switch Guide
Tencent Cloud TCHouse-P
History
Introduction
API Category
Making API Requests
Information Query APIs
Instance APIs
Query APIs
Cluster Management APIs
Cluster Operation APIs
Data Types
Error Codes
TDMQ for RocketMQ
History
API Category
Making API Requests
Topic APIs
Consumer Group APIs
Message APIs
Role Authentication APIs
Hitless Migration APIs
Cloud Migration APIs
Cluster APIs
Data Types
Error Codes
Cloud Dedicated Zone
History
Introduction
API Category
Making API Requests
Availability Zone APIs
Data Types
Error Codes
Tencent Cloud Health Dashboard
History
Introduction
API Category
Making API Requests
Event APIs
Data Types
Error Codes
Application Performance Management
History
Introduction
API Category
Making API Requests
Application APIs
Business System APIs
General Query APIs
Unavailable APIs
Performance Analysis APIs
Data Types
Error Codes
Config
History
Introduction
API Category
Making API Requests
Rule APIs
Resource APIs
Data Types
Error Codes
Automatic Speech Recognition
History
Introduction
API Category
Making API Requests
Recording Recognition APIs
Real-Time Speech Recognition APIs
Data Types
Error Codes
Tencent Cloud TI Platform
History
Introduction
API Category
Making API Requests
Online Service APIs
Data Types
Error Codes
Web Application Firewall
History
Introduction
API Category
Making API Requests
Asset Management APIs
Billing APIs
Protection Settings APIs
Other APIs
IP Management APIs
Integration APIs
Log Service APIs
Security Overview APIs
Rule Engine APIs
Data Types
Error Codes
Cloud Security Center
History
Introduction
API Category
Making API Requests
Multi-account management related APIs
Scan Task APIs
Risk Center APIs
Asset Center APIs
Cloud Boundary Analysis APIs
Cloud API Anomaly Detection APIs
Report Download APIs
Solid Protection APIs
Cloud Security Center Overview APIs
Data Types
Error Codes
Risk Control Engine
History
Introduction
API Category
Making API Requests
TencentCloud API APIs
Data Types
Error Codes
TencentDB for CTSDB
History
Introduction
API Category
Making API Requests
Instance APIs
Database APIs
Data Types
Error Codes
Tencent Interactive Whiteboard
History
Introduction
API Category
Making API Requests
Whiteboard Push APIs
Other APIs
Document Transcoding APIs
Real-Time Recording APIs
Statistics Query APIs
Whiteboard Snapshot APIs
Recording Video Generation APIs
Data Types
Error Codes
Tencent Container Security Service
History
Introduction
API Category
Making API Requests
Network Security APIs
Cluster Security APIs
Security Compliance APIs
Runtime security - High-risk syscalls
Runtime Security - Reverse Shell APIs
Runtime Security APIs
Alert Settings APIs
Advanced prevention - K8s API abnormal requests
Asset Management APIs
Security Operations - Log Analysis APIs
Runtime Security - Trojan Call APIs
Runtime Security - Container Escape APIs
Image Security APIs
Billing APIs
Data Types
Error Codes
Domains
History
Introduction
API Category
Making API Requests
Domain Management APIs
Domain Query APIs
Bulk Operation APIs
Registrant Profile APIs
Other APIs
Data Types
Error Codes
Low-code Interactive Classroom
History
Introduction
API Category
Making API Requests
User Login APIs
Room Management APIs
Group Management APIs
Application Configuration APIs
Recording Management APIs
Courseware Management APIs
User Management APIs
Developer APIs
Data Types
Error Codes

Data Types

Focus Mode
Font Size
Last updated: 2025-10-30 21:53:45

AggregationLegend

Aggregation function

Used by actions: DescribeAvailableMetrics.

Name Type Description
Aggregation String Aggregation functions supported by the metric.
Legend String Description after the aggregation function is applied to the metric.
Unit String Metric unit after aggregation.

AlertChannel

Alert notification channel

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
NoticeId String No Notification template ID.

Note: This field may return null, indicating that no valid value is found.
AMPConsumerId String No AMP consumer ID.

Note: This field may return null, indicating that no valid value is found.

AlertChannelRecord

Alert notification recipient group.

Used by actions: DescribeAlertChannels.

Name Type Required Description
NoticeId String No Notice ID.

Note: This field may return null, indicating that no valid value is found.
AMPConsumerId String No Consumer ID.

Note: This field may return null, indicating that no valid value is found.
ProjectId String No Project ID.

Note: This field may return null, indicating that no valid value is found.
Status Integer No Status.

Note: This field may return null, indicating that no valid value is found.
CreatedAt String No Create time.

Note: This field may return null, indicating that no valid value is found.
UpdatedAt String No Update time.

Note: This field may return null, indicating that no valid value is found.
AppId Integer No App ID.

Note: This field may return null, indicating that no valid value is found.
Uin String No Account uin.

Note: This field may return null, indicating that no valid value is found.
SubAccountUin String No Sub account uin.

Note: This field may return null, indicating that no valid value is found.

AlertRecord

Alert history record.

Used by actions: DescribeAlertRecords.

Name Type Required Description
AlertRecordId String No Alert history record ID.

Note: This field may return null, indicating that no valid value is found.
ProjectId String No Project ID.

Note: This field may return null, indicating that no valid value is found.
ScenarioId String No Scenario ID.

Note: This field may return null, indicating that no valid value is found.
Status AlertRecordStatus No Status.

Note: This field may return null, indicating that no valid value is found.
CreatedAt String No Create time.

Note: This field may return null, indicating that no valid value is found.
UpdatedAt String No Update time.

Note: This field may return null, indicating that no valid value is found.
JobId String No Job ID.

Note: This field may return null, indicating that no valid value is found.
AppId Integer No App ID.

Note: This field may return null, indicating that no valid value is found.
Uin String No Account uin.

Note: This field may return null, indicating that no valid value is found.
SubAccountUin String No Sub account uin.

Note: This field may return null, indicating that no valid value is found.
ScenarioName String No Scenario name.

Note: This field may return null, indicating that no valid value is found.
Target String No Alert target.

Note: This field may return null, indicating that no valid value is found.
JobSLAId String No SLA ID.

Note: This field may return null, indicating that no valid value is found.
JobSLADescription String No SLA description.

Note: This field may return null, indicating that no valid value is found.

AlertRecordStatus

Status of alert history record

Used by actions: DescribeAlertRecords.

Name Type Required Description
AbortJob Integer No Success or failure of stopping performance test job.

Note: This field may return null, indicating that no valid value is found.
SendNotice Integer No Success or failure of sending alert notification.

Note: This field may return null, indicating that no valid value is found.

Attributes

Sampling log attributes

Used by actions: DescribeSampleLogs.

Name Type Description
Status String Response status code.

Note: This field may return null, indicating that no valid value is found.
Result String Response result code.

Note: This field may return null, indicating that no valid value is found.
Service String Request service.

Note: This field may return null, indicating that no valid value is found.
Method String Request method.

Note: This field may return null, indicating that no valid value is found.
Duration String Request duration.

Note: This field may return null, indicating that no valid value is found.

CheckSummary

Checkpoint summary results

Used by actions: DescribeCheckSummary.

Name Type Description
Name String Checkpoint name.
Step String Step name of the checkpoint.
SuccessCount Integer Number of successful checks.
FailCount Integer Number of failed checks.
ErrorRate Float Error ratio.

Concurrency

Load configuration for concurrency mode

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
Stages Array of Stage No Array of multi-stage configuration.

Note: This field may return null, indicating that no valid value is found.
IterationCount Integer No Number of iteration.

Note: This field may return null, indicating that no valid value is found.
MaxRequestsPerSecond Integer No Maximum rps.

Note: This field may return null, indicating that no valid value is found.
GracefulStopSeconds Integer No Graceful termination job waiting time.

Note: This field may return null, indicating that no valid value is found.
Resources Integer No Number of resource.

Note: This field may return null, indicating that no valid value is found.

Credentials

COS temporary credentials.

Used by actions: GenerateTmpKey.

Name Type Description
TmpSecretId String Temporary secret ID.
TmpSecretKey String Temporary secret key.
Token String Temporary token.

CronJob

Cron job.

Used by actions: DescribeCronJobs.

Name Type Description
CronJobId String Cron job ID.

Note: This field may return null, indicating that no valid value is found.
Name String Cron job name.

Note: This field may return null, indicating that no valid value is found.
ProjectId String Project ID.

Note: This field may return null, indicating that no valid value is found.
ScenarioId String Scenario ID.

Note: This field may return null, indicating that no valid value is found.
ScenarioName String Scenario name.

Note: This field may return null, indicating that no valid value is found.
CronExpression String Cron expression.

Note: This field may return null, indicating that no valid value is found.
EndTime Timestamp ISO8601 End time.

Note: This field may return null, indicating that no valid value is found.
AbortReason Integer Abort reason.

Note: This field may return null, indicating that no valid value is found.
Status Integer Cron job status.

Note: This field may return null, indicating that no valid value is found.
NoticeId String Notice ID.

Note: This field may return null, indicating that no valid value is found.
CreatedAt Timestamp ISO8601 Create time.

Note: This field may return null, indicating that no valid value is found.
UpdatedAt Timestamp ISO8601 Update time.

Note: This field may return null, indicating that no valid value is found.
FrequencyType Integer Execution frequency type: 1, execute once only; 2, Daily; 3, Weekly; 4, Advanced mode using cron expression.

Note: This field may return null, indicating that no valid value is found.
Note String Note.

Note: This field may return null, indicating that no valid value is found.
JobOwner String Cron job initiator.

Note: This field may return null, indicating that no valid value is found.
AppId Integer App ID.

Note: This field may return null, indicating that no valid value is found.
Uin String Account uin.

Note: This field may return null, indicating that no valid value is found.
SubAccountUin String Sub account uin.

Note: This field may return null, indicating that no valid value is found.

CustomSample

Sample includes metric, aggregation from original metric query statement.

Used by actions: DescribeSampleBatchQuery, DescribeSampleQuery.

Name Type Description
Metric String Metric name.
Aggregation String Aggregation condition.
Labels Array of Label Label filter.

Note: This field may return null, indicating that no valid value is found.
Value Float Value obtained from the query.
Timestamp Integer Time is the number of milliseconds since the epoch (1970-01-01 00:00 UTC) excluding leap seconds.
Unit String Unit corresponding to the metric, including s(second), bytes, bytes/s, reqs, reqs/s, checks, checks/s, iters, iters/s, VUs, %.
Name String Metric name in PTS.

Note: This field may return null, indicating that no valid value is found.

CustomSampleMatrix

Metric matrix, which contains multiple metric sequence arrays.

Used by actions: DescribeSampleMatrixBatchQuery, DescribeSampleMatrixQuery.

Name Type Description
Metric String Metric name.
Aggregation String Aggregation function.
Unit String Metric unit.

Note: This field may return null, indicating that no valid value is found.
Streams Array of SampleStream Metric sequence array.

Note: This field may return null, indicating that no valid value is found.

DNSConfig

DNS configuration of the pressure machine.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
Nameservers Array of String No DNS IP list.

Note: This field may return null, indicating that no valid value is found.

DomainNameConfig

Domain resolution configuration of the pressure machine.

Used by actions: CreateScenario, DescribeFiles, DescribeJobs, DescribeScenarios, UpdateScenario.

Name Type Required Description
HostAliases Array of HostAlias No Domain configuration.

Note: This field may return null, indicating that no valid value is found.
DNSConfig DNSConfig No DNS configuration.

Note: This field may return null, indicating that no valid value is found.

ErrorSummary

Error Summary.

Used by actions: DescribeErrorSummary.

Name Type Description
Status String Status code.

Note: This field may return null, indicating that no valid value is found.
Result String Result code.

Note: This field may return null, indicating that no valid value is found.
Count Integer Number of error occurrences.

Note: This field may return null, indicating that no valid value is found.
Rate Float Error rate.

Note: This field may return null, indicating that no valid value is found.
Message String Error message.

Note: This field may return null, indicating that no valid value is found.
Proto String Request protocol type.

Note: This field may return null, indicating that no valid value is found.

File

File.

Used by actions: DescribeFiles.

Name Type Description
FileId String File ID.
Kind Integer File type. 1 represents parameter file, 2 represents protocol file, 3 represents request file.
Name String Filename.
Size Integer File size.
Type String File type. The 'folder' represents a folder; if not specified, it represents a normal file.
UpdatedAt Timestamp ISO8601 Update time.
LineCount Integer Number of file lines.

Note: This field may return null, indicating that no valid value is found.
HeadLines Array of String First few rows of file.

Note: This field may return null, indicating that no valid value is found.
TailLines Array of String Last few rows of file.

Note: This field may return null, indicating that no valid value is found.
HeaderInFile Boolean Whether the header is in the file.

Note: This field may return null, indicating that no valid value is found.
HeaderColumns Array of String Parameter name.

Note: This field may return null, indicating that no valid value is found.
FileInfos Array of FileInfo Files in the folder.

Note: This field may return null, indicating that no valid value is found.
ScenarioSet Array of Scenario Associated scenario.

Note: This field may return null, indicating that no valid value is found.
Status Integer File status.

Note: This field may return null, indicating that no valid value is found.
CreatedAt Timestamp ISO8601 Create time.

Note: This field may return null, indicating that no valid value is found.
ProjectId String Project ID.

Note: This field may return null, indicating that no valid value is found.
AppID Integer Deprecated.

Note: This field may return null, indicating that no valid value is found.
Uin String Uin.

Note: This field may return null, indicating that no valid value is found.
SubAccountUin String Sub account uin.

Note: This field may return null, indicating that no valid value is found.
AppId Integer App ID of user account.

Note: This field may return null, indicating that no valid value is found.

FileInfo

Basic file information

Used by actions: CreateFile, CreateScenario, DescribeFiles, DescribeJobs, DescribeScenarios, UpdateScenario.

Name Type Required Description
Name String No Filename

Note: This field may return null, indicating that no valid value is found.
Size Integer No File size

Note: This field may return null, indicating that no valid value is found.
Type String No File type

Note: This field may return null, indicating that no valid value is found.
UpdatedAt Timestamp ISO8601 No Update time

Note: This field may return null, indicating that no valid value is found.
FileId String No File ID

Note: This field may return null, indicating that no valid value is found.

Filter

Metric query filter.

Used by actions: DescribeErrorSummary, DescribeSampleBatchQuery, DescribeSampleMatrixBatchQuery, DescribeSampleMatrixQuery.

Name Type Required Description
Operator Integer Yes Equals: 0, not equals: 1.
LabelName String Yes Tag name, optional values include:
1. method, request method name;
2. proto: protocol name;
3. service: service name;
4. status: response status code;
5.result: response details
6.check: check name.
LabelValue String Yes Tag value, optional values include:
1.method: request method name, for example, GET, POST, PUT, etc.
2.proto: protocol name, for example, HTTP/1.1, HTTP/2, etc.
3.service: service name, for example, the request URL such as http://httpbin.org/get
4.status: response status code, for example, 200, 404, 500, etc.
5.result: response details, used to determine whether the request was successful or failed; if successful, the result Tag value is ok; if failed, the result Tag carries an error code and description.
6.check: check name, the Tag value is the checkpoint name set by the user.

GeoRegionsLoadItem

Load distribution configuration.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
RegionId Integer Yes Region ID.
Region String No Region.
Percentage Integer No Percentage.

HostAlias

Domain configuration of the pressure machine.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
HostNames Array of String No Domain list to be bound.

Note: This field may return null, indicating that no valid value is found.
IP String No IP address to be bound.

Note: This field may return null, indicating that no valid value is found.

InternalMetricQuery

General metric query structure.

Used by actions: DescribeSampleBatchQuery, DescribeSampleMatrixBatchQuery.

Name Type Required Description
Metric String Yes Metric name.
Aggregation String Yes Aggregation Function, optional value including Rate, Count, Avg, P90, P95, P99, Gauge.
Labels Array of Label No Deprecated, please use 'Filters'.
Filters Array of Filter No Use label filter rules to filter metrics. Rules include LabelName, LabelValue, and Operator (0 means equal, 1 means not equal).
GroupBy Array of String No Metric group.

Job

Performance test job.

Used by actions: DescribeJobs, DescribeScenarioWithJobs.

Name Type Required Description
JobId String No Job ID.

Note: This field may return null, indicating that no valid value is found.
ScenarioId String No Scenario ID.

Note: This field may return null, indicating that no valid value is found.
Load Load No Load configuration.

Note: This field may return null, indicating that no valid value is found.
Configs Array of String No Deprecated.

Note: This field may return null, indicating that no valid value is found.
Datasets Array of TestData No Test datasets.

Note: This field may return null, indicating that no valid value is found.
Extensions Array of String No Deprecated.

Note: This field may return null, indicating that no valid value is found.
Status Integer No Job status, values including:
JobUnknown: 0, JobCreated: 1, JobPending: 2, JobPreparing: 3, JobSelectClustering: 4, JobCreateTasking: 5, JobSyncTasking: 6,
JobRunning:11,JobFinished:12,JobPrepareException:13,JobFinishException:14,JobAborting:15,JobAborted:16,JobAbortException:17,JobDeleted:18,
JobSelectClusterException:19,JobCreateTaskException:20,JobSyncTaskException:21

Note: This field may return null, indicating that no valid value is found.
StartTime Timestamp ISO8601 No Start time.

Note: This field may return null, indicating that no valid value is found.
EndTime Timestamp ISO8601 No End time.

Note: This field may return null, indicating that no valid value is found.
MaxVirtualUserCount Integer No Maximum VU.

Note: This field may return null, indicating that no valid value is found.
Note String No Note.

Note: This field may return null, indicating that no valid value is found.
ErrorRate Float No Error rate percentage.

Note: This field may return null, indicating that no valid value is found.
JobOwner String No Job owner.

Note: This field may return null, indicating that no valid value is found.
LoadSources LoadSource No Deprecated.

Note: This field may return null, indicating that no valid value is found.
Duration Integer No Job duration.

Note: This field may return null, indicating that no valid value is found.
MaxRequestsPerSecond Integer No Maximum requests per second.

Note: This field may return null, indicating that no valid value is found.
RequestTotal Float No Total number of requests.

Note: This field may return null, indicating that no valid value is found.
RequestsPerSecond Float No Average requests per second.

Note: This field may return null, indicating that no valid value is found.
ResponseTimeAverage Float No Average response time.

Note: This field may return null, indicating that no valid value is found.
ResponseTimeP99 Float No 99th percentile response time.

Note: This field may return null, indicating that no valid value is found.
ResponseTimeP95 Float No 95th percentile response time.

Note: This field may return null, indicating that no valid value is found.
ResponseTimeP90 Float No 90th percentile response time.

Note: This field may return null, indicating that no valid value is found.
Scripts Array of String No Deprecated.

Note: This field may return null, indicating that no valid value is found.
ResponseTimeMax Float No Maximum response time.

Note: This field may return null, indicating that no valid value is found.
ResponseTimeMin Float No Minimum response time.

Note: This field may return null, indicating that no valid value is found.
LoadSourceInfos Array of LoadSource No Stress machine information.

Note: This field may return null, indicating that no valid value is found.
TestScripts Array of ScriptInfo No Test script information.

Note: This field may return null, indicating that no valid value is found.
Protocols Array of ProtocolInfo No Protocol file information.

Note: This field may return null, indicating that no valid value is found.
RequestFiles Array of FileInfo No Request file information.

Note: This field may return null, indicating that no valid value is found.
Plugins Array of FileInfo No Extension file information.

Note: This field may return null, indicating that no valid value is found.
CronId String No Cron job ID.

Note: This field may return null, indicating that no valid value is found.
Type String No Scenario type.

Note: This field may return null, indicating that no valid value is found.
DomainNameConfig DomainNameConfig No Domain binding configuration.

Note: This field may return null, indicating that no valid value is found.
Debug Boolean No Whether the job is a debug job.

Note: This field may return null, indicating that no valid value is found.
AbortReason Integer No Abort reason.

Note: This field may return null, indicating that no valid value is found.
CreatedAt Timestamp ISO8601 No Create Time.

Note: This field may return null, indicating that no valid value is found.
ProjectId String No Project ID.

Note: This field may return null, indicating that no valid value is found.
NotificationHooks Array of NotificationHook No Notification event callback.

Note: This field may return null, indicating that no valid value is found.
NetworkReceiveRate Float No Bytes received per second.

Note: This field may return null, indicating that no valid value is found.
NetworkSendRate Float No Bytes sent per second.

Note: This field may return null, indicating that no valid value is found.
Message String No Job status description.

Note: This field may return null, indicating that no valid value is found.
ProjectName String No Project name.

Note: This field may return null, indicating that no valid value is found.
ScenarioName String No Scenario name.

Note: This field may return null, indicating that no valid value is found.
PayMode Integer No Billing type.

Note: This field may return null, indicating that no valid value is found.
Usage Integer No Job VUM usage.

Note: This field may return null, indicating that no valid value is found.

Label

Contains label name and label value.

Used by actions: DescribeSampleBatchQuery, DescribeSampleMatrixBatchQuery, DescribeSampleMatrixQuery, DescribeSampleQuery.

Name Type Required Description
LabelName String Yes Label name.
LabelValue String Yes Label value.

LabelWithValues

Label name and value.

Used by actions: DescribeMetricLabelWithValues.

Name Type Description
LabelName String Label Name.
LabelValues Array of String Label values.

Load

Load configuration.

Used by actions: CreateScenario, DescribeFiles, DescribeJobs, DescribeScenarios, UpdateScenario.

Name Type Required Description
LoadSpec LoadSpec No Load configuration.

Note: This field may return null, indicating that no valid value is found.
VpcLoadDistribution VpcLoadDistribution No Stress source from vpc.

Note: This field may return null, indicating that no valid value is found.
GeoRegionsLoadDistribution Array of GeoRegionsLoadItem No Multi-region stress distribution.

Note: This field may return null, indicating that no valid value is found.

LoadSource

Performance test host source.

Used by actions: DescribeJobs.

Name Type Required Description
IP String No Pressure machine IP.

Note: This field may return null, indicating that no valid value is found.
PodName String No Pressure machine pod.

Note: This field may return null, indicating that no valid value is found.
Region String No Region.

Note: This field may return null, indicating that no valid value is found.

LoadSpec

Load configuration.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
Concurrency Concurrency No Configuration for concurrency mode.

Note: This field may return null, indicating that no valid value is found.
RequestsPerSecond RequestsPerSecond No Configuration for RPS mode.

Note: This field may return null, indicating that no valid value is found.
ScriptOrigin ScriptOrigin No Built-in script mode.

Note: This field may return null, indicating that no valid value is found.

MetricInfo

Metric structure.

Used by actions: DescribeAvailableMetrics.

Name Type Description
Metric String Metric name in backend.
Alias String Metric name displayed in frontend.
Description String Metric description.

Note: This field may return null, indicating that no valid value is found.
MetricType String Metric type.
Unit String Default metric unit.
Aggregations Array of AggregationLegend Aggregation functions supported by the metric.
InnerMetric Boolean Whether it is an internal metric, internal metrics cannot be freely selected by users on the frontend.

MetricLabelWithValues

Metric provided by PTS with labels and values.

Used by actions: DescribeMetricLabelWithValues.

Name Type Description
MetricName String Metric name.
LabelValuesSet Array of LabelWithValues Labels and values.

NormalLog

General log struct.

Used by actions: DescribeNormalLogs.

Name Type Description
Timestamp String Timestamp in milliseconds.

Note: This field may return null, indicating that no valid value is found.
SeverityText String Log level.

Note: This field may return null, indicating that no valid value is found.
Body String Log output content.

Note: This field may return null, indicating that no valid value is found.

Notification

Message notification before and after job.

Used by actions: UpdateScenario.

Name Type Required Description
Events Array of String No Event.
URL String No Webhook URL.

NotificationHook

Event notification callback.

Used by actions: DescribeFiles, DescribeJobs, DescribeScenarios.

Name Type Required Description
Events Array of String No Event.

Note: This field may return null, indicating that no valid value is found.
URL String No Callback URL.

Note: This field may return null, indicating that no valid value is found.

Project

Project.

Used by actions: DescribeProjects.

Name Type Description
ProjectId String Project ID.
Name String Project name.
Description String Project description.

Note: This field may return null, indicating that no valid value is found.
Tags Array of TagSpec Tags.

Note: This field may return null, indicating that no valid value is found.
Status Integer Project status.
CreatedAt Timestamp ISO8601 Create time.
UpdatedAt Timestamp ISO8601 Update time.
AppId Integer App ID.
Uin String Uin.
SubAccountUin String Sub account uin.

ProtocolInfo

Protocol file information.

Used by actions: CreateScenario, DescribeFiles, DescribeJobs, DescribeScenarios, UpdateScenario.

Name Type Required Description
Name String No Name.

Note: This field may return null, indicating that no valid value is found.
Size Integer No File size.

Note: This field may return null, indicating that no valid value is found.
Type String No File type, such as 'proto'.

Note: This field may return null, indicating that no valid value is found.
UpdatedAt Timestamp ISO8601 No Update time.

Note: This field may return null, indicating that no valid value is found.
FileId String No File ID.

Note: This field may return null, indicating that no valid value is found.

ReactionTimeRange

Log response time RT range.

Used by actions: DescribeSampleLogs.

Name Type Required Description
Min String No Minimum response time (ms).
Max String No Maximum response time (ms).

RegionDetail

Region.

Used by actions: DescribeRegions.

Name Type Required Description
Region String Yes Region code.
RegionId Integer Yes Region ID.
Area String No Area where the region is located.
RegionName String No Region name.
RegionState Integer No Region state.
RegionShortName String No Region abbreviation.
CreatedAt Timestamp ISO8601 No Create time.
UpdatedAt Timestamp ISO8601 No Update time.

RequestSummary

Request details in performance test.

Used by actions: DescribeRequestSummary.

Name Type Description
Service String Request URL.
Method String Request method.
Count Integer Number of requests.
Average Float Average request response time (seconds).
P90 Float Request p90 latency (seconds).
P95 Float Request p95 latency (seconds).
Min Float Minimum request latency (seconds).
Max Float Maximum request latency (seconds).
ErrorPercentage Float Request error rate.
P99 Float Request p99 latency (seconds).
Status String Response status code.
Result String Response details.
RPS Float Request per seconds, unit req/s.

RequestsPerSecond

Load configuration for RPS mode.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
MaxRequestsPerSecond Integer No Maximum rps.

Note: This field may return null, indicating that no valid value is found.
DurationSeconds Integer No Duration time.

Note: This field may return null, indicating that no valid value is found.
TargetVirtualUsers Integer No Deprecated.

Note: This field may return null, indicating that no valid value is found.
Resources Integer No Number of resources.

Note: This field may return null, indicating that no valid value is found.
StartRequestsPerSecond Integer No Initial rps.

Note: This field may return null, indicating that no valid value is found.
TargetRequestsPerSecond Integer No Target rps, invalid as an input parameter.

Note: This field may return null, indicating that no valid value is found.
GracefulStopSeconds Integer No Graceful shutdown waiting time.

Note: This field may return null, indicating that no valid value is found.

SLALabel

SLA label.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
LabelName String No Label name.

Note: This field may return null, indicating that no valid value is found.
LabelValue String No Label value.

Note: This field may return null, indicating that no valid value is found.

SLAPolicy

SLA policy.

Used by actions: CreateScenario, DescribeFiles, DescribeScenarios, UpdateScenario.

Name Type Required Description
SLARules Array of SLARule No SLA rules.

Note: This field may return null, indicating that no valid value is found.
AlertChannel AlertChannel No Alert notification channel.

Note: This field may return null, indicating that no valid value is found.

SLARule

SLA rule.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
Metric String No Metric.

Note: This field may return null, indicating that no valid value is found.
Aggregation String No Metric aggregation method.

Note: This field may return null, indicating that no valid value is found.
Condition String No Condition, such as '==' '!=' '<' '<=' '>' '>='.

Note: This field may return null, indicating that no valid value is found.
Value Float No Threshold value.

Note: This field may return null, indicating that no valid value is found.
LabelFilter Array of SLALabel No Label.

Note: This field may return null, indicating that no valid value is found.
AbortFlag Boolean No Whether to stop performance test job.

Note: This field may return null, indicating that no valid value is found.
For String No Duration.

Note: This field may return null, indicating that no valid value is found.

SampleLog

Sampled request logs.

Used by actions: DescribeSampleLogs.

Name Type Description
Timestamp String Millisecond timestamp.

Note: This field may return null, indicating that no valid value is found.
Attributes Attributes Log attributes.

Note: This field may return null, indicating that no valid value is found.
Body String Request in har format in log.

Note: This field may return null, indicating that no valid value is found.

SamplePair

Metric sample value with timestamp.

Used by actions: DescribeSampleMatrixBatchQuery, DescribeSampleMatrixQuery.

Name Type Description
Timestamp Integer Timestamp. It is the number of milliseconds since the epoch (1970-01-01 00:00 UTC) excluding leap seconds.
Value Float Value of a given sample at a given time.

SampleStream

Stream of values belonging to a metric.

Used by actions: DescribeSampleMatrixBatchQuery, DescribeSampleMatrixQuery.

Name Type Description
Labels Array of Label Metric labels.

Note: This field may return null, indicating that no valid value is found.
Values Array of SamplePair Array of metric values.
Name String Metric name.

Note: This field may return null, indicating that no valid value is found.

Scenario

Performance test scenario.

Used by actions: DescribeFiles, DescribeScenarioWithJobs, DescribeScenarios.

Name Type Description
ScenarioId String Scenario ID.
Name String Scenario name.
Description String Scenario description.

Note: This field may return null, indicating that no valid value is found.
Type String Type of scenario. Valid values: 'pts-http' represents the simple mode, 'pts-js' represents the script mode, 'pts-jmeter' represents the JMeter mode.

Note: This field may return null, indicating that no valid value is found.
Status Integer Scenario status.

Note: This field may return null, indicating that no valid value is found.
Load Load Load configuration.

Note: This field may return null, indicating that no valid value is found.
EncodedScripts String Deprecated.

Note: This field may return null, indicating that no valid value is found.
Configs Array of String Deprecated.

Note: This field may return null, indicating that no valid value is found.
Extensions Array of String Deprecated.

Note: This field may return null, indicating that no valid value is found.
Datasets Array of TestData Test datasets.

Note: This field may return null, indicating that no valid value is found.
SLAId String Deprecated.

Note: This field may return null, indicating that no valid value is found.
CronId String CronJob ID.

Note: This field may return null, indicating that no valid value is found.
CreatedAt String Create time.
UpdatedAt String Update time.
ProjectId String Project ID.

Note: This field may return null, indicating that no valid value is found.
AppId Integer App ID.

Note: This field may return null, indicating that no valid value is found.
Uin String Uin.

Note: This field may return null, indicating that no valid value is found.
SubAccountUin String Sub account uin.

Note: This field may return null, indicating that no valid value is found.
TestScripts Array of ScriptInfo Test scripts.

Note: This field may return null, indicating that no valid value is found.
Protocols Array of ProtocolInfo Protocol files.

Note: This field may return null, indicating that no valid value is found.
RequestFiles Array of FileInfo Request files.

Note: This field may return null, indicating that no valid value is found.
SLAPolicy SLAPolicy SLA policy.

Note: This field may return null, indicating that no valid value is found.
Plugins Array of FileInfo Extension plugin files.

Note: This field may return null, indicating that no valid value is found.
DomainNameConfig DomainNameConfig Domain name resolution configuration.

Note: This field may return null, indicating that no valid value is found.
NotificationHooks Array of NotificationHook Notification event hooks.

Note: This field may return null, indicating that no valid value is found.
Owner String Creator name.

Note: This field may return null, indicating that no valid value is found.
ProjectName String Project name.

Note: This field may return null, indicating that no valid value is found.

ScenarioRelatedJobsParams

Parameters for querying jobs associated with a specific scenario.

Used by actions: DescribeScenarioWithJobs.

Name Type Required Description
Offset Integer No Offset, default value is 0.
Limit Integer No Number of returns. Default value is 20, maximum is 100.
OrderBy String No Field for sorting.
Ascend Boolean No Whether in ascending order.

ScenarioWithJobs

Scenario with jobs.

Used by actions: DescribeScenarioWithJobs.

Name Type Description
Scenario Scenario Scenario.

Note: This field may return null, indicating that no valid value is found.
Jobs Array of Job Job list.

Note: This field may return null, indicating that no valid value is found.

ScriptInfo

Performance test script information.

Used by actions: CreateScenario, DescribeFiles, DescribeJobs, DescribeScenarios, UpdateScenario.

Name Type Required Description
Name String No Filename.

Note: This field may return null, indicating that no valid value is found.
Size Integer No File size.

Note: This field may return null, indicating that no valid value is found.
Type String No File type.

Note: This field may return null, indicating that no valid value is found.
UpdatedAt Timestamp ISO8601 No Update time.

Note: This field may return null, indicating that no valid value is found.
EncodedContent String No Base64-encoded file content.

Note: This field may return null, indicating that no valid value is found.
EncodedHttpArchive String No Base64-encoded har structure.

Note: This field may return null, indicating that no valid value is found.
LoadWeight Integer No Script weight, range 1-100.

Note: This field may return null, indicating that no valid value is found.
FileId String No File ID.

Note: This field may return null, indicating that no valid value is found.

ScriptOrigin

Built-in script load model, not supported currently.

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
MachineNumber Integer Yes Machine number.
MachineSpecification String Yes Machine specification.
DurationSeconds Integer Yes Duration.

Stage

Load configuration for a single stage in concurrency mode

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
DurationSeconds Integer No Duration time of this stage.

Note: This field may return null, indicating that no valid value is found.
TargetVirtualUsers Integer No Target number of virtual users.

Note: This field may return null, indicating that no valid value is found.

TagSpec

Tag.

Used by actions: CreateProject, DescribeProjects, UpdateProject.

Name Type Required Description
TagKey String No Tag key.

Note: This field may return null, indicating that no valid value is found.
TagValue String No Tag value.

Note: This field may return null, indicating that no valid value is found.

TestData

Test dataset.

Used by actions: CreateScenario, DescribeFiles, DescribeJobs, DescribeScenarios, UpdateScenario.

Name Type Required Description
Name String Yes File name of the test dataset.

Note: This field may return null, indicating that no valid value is found.
Split Boolean Yes Whether the dataset is sharded.

Note: This field may return null, indicating that no valid value is found.
HeaderInFile Boolean Yes Whether the first row is parameter name.

Note: This field may return null, indicating that no valid value is found.
HeaderColumns Array of String No Array of parameter name.

Note: This field may return null, indicating that no valid value is found.
LineCount Integer No Number of file lines.

Note: This field may return null, indicating that no valid value is found.
UpdatedAt Timestamp ISO8601 No Update time.

Note: This field may return null, indicating that no valid value is found.
Size Integer No File size.

Note: This field may return null, indicating that no valid value is found.
HeadLines Array of String No First few rows of dataset.

Note: This field may return null, indicating that no valid value is found.
TailLines Array of String No Last few rows of dataset.

Note: This field may return null, indicating that no valid value is found.
Type String No File type.

Note: This field may return null, indicating that no valid value is found.
FileId String No File ID.

Note: This field may return null, indicating that no valid value is found.

VpcLoadDistribution

Load specification in vpc mode

Used by actions: CreateScenario, UpdateScenario.

Name Type Required Description
RegionId Integer Yes Region ID.
Region String No Region.
VpcId String No VPC ID.

Note: This field may return null, indicating that no valid value is found.
SubnetIds Array of String No List of subnet IDs.

Note: This field may return null, indicating that no valid value is found.

Help and Support

Was this page helpful?

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

Feedback