tencent cloud

Cloud File Storage

Releases Notes and Announcements
Release Notes
Announcements
Product Introduction
Overview
Strengths
Storage Classes and Performance
Use Cases
Recommended Regions
Use Limits
Service Regions and Service Providers
Purchase Guide
Billing Overview
Pricing Overview
General Series Billing
Turbo Series Billing
High-Throughput CFS Billing
Billing Mode
IA ‍Storage Billing
Storage Resource Units
Resource Purchase
Viewing Bills
Arrears Reminder
Getting Started
Creating File Systems and Mount Targets
Using CFS File Systems on Linux Clients
Using CFS File Systems on Windows Clients
Using CFS Turbo on Linux Clients
Using the CFS Client Assistant to Mount File Systems
Operation Guide
Access Management
Managing File Systems
Permission Management
Using Tags
Snapshot Management
Guide for Cross-AZ and Cross-Network Access
Automatically Mounting File Systems
Data Migration Service
User Permission Management
User Quotas
Data Encryption
Data Lifecycle Management
Upgrading Standard File Systems
Practical Tutorial
Selecting Kernels for NFS Clients
Managing Turbo CFS Directories
Terminating Compute Instances
Using CFS on TKE
Using CFS on SCF
Using CFS Turbo on TKE
Using CFS Turbo on TKE Serverless Cluster
Selecting a Network for Turbo CFS
Copying Data
CFS Storage Performance Testing
API Documentation
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
Troubleshooting
Client Use Bottleneck due to Large Number of Small Files or Parallel Requests
FAQs
CFS Service Level Agreement
Contact Us
Glossary

CreateCfsSnapshot

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2026-03-24 17:02:26

1. API Description

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

This API is used to create a file system snapshot.

A maximum of 20 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: CreateCfsSnapshot.
Version Yes String Common Params. The value used for this API: 2019-07-19.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
FileSystemId Yes String File system ID, which can be obtained by querying the file system list; DescribeCfsFileSystems.
SnapshotName No String Snapshot name, supports no more than 64 characters in length, supports chinese, numbers, _, and -.
ResourceTags.N No Array of TagInfo Snapshot tag

3. Output Parameters

Parameter Name Type Description
SnapshotId String File system snapshot ID
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 Creating a File System Snapshot

Input Example

https://cfs.intl.tencentcloudapi.com/?Action=CreateCfsSnapshot
&FileSystemId=cfs-abcdefgh
&SnapshotName=defaulsnapshot
&<Common request parameters>

Output Example

{
    "Response": {
        "RequestId": "fjo8aejo-fjei-32eu-2je9-fhue83nd81",
        "SnapshotId": "snapcfs-abababb"
    }
}

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
AuthFailure.UnauthorizedOperation Request unauthorized.
InternalError Internal error.
InvalidParameter Invalid parameter.
InvalidParameter.InvalidSnapshotName The file system snapshot parameter name is invalid.
InvalidParameter.SnapshotNameLimitExceeded The file system snapshot name exceeds the upper limit.
InvalidParameterValue The parameter value is incorrect.
InvalidParameterValue.FsSizeLimitExceeded The file system quota exceeds the upper limit.
InvalidParameterValue.InvalidFileSystemId FileSystemId is invalid.
InvalidParameterValue.InvalidFsStatus Invalid file system status.
InvalidParameterValue.InvalidResourceTags Invalid parameter value: invalid resource tag value.
InvalidParameterValue.InvalidTagKey The tag key cannot be empty.
InvalidParameterValue.InvalidTagValue The tag value is empty or the character is invalid.
InvalidParameterValue.MissingFileSystemId FileSystemId is missing.
InvalidParameterValue.TagKeyFilterLimitExceeded Invalid parameter value: the number of tag keys exceeds the upper limit (6).
InvalidParameterValue.TagKeyLimitExceeded The length of the tag key exceeds the upper limit of 127 bytes.
InvalidParameterValue.TagValueFilterLimitExceeded The number of tag values exceeds the maximum (10).
InvalidParameterValue.TagValueLimitExceeded The length of the tag value exceeds the upper limit of 255 bytes.
ResourceInsufficient.SnapshotSizeLimitExceeded Snapshots are not supported because the file system is too large.
ResourceInsufficient.TagLimitExceeded The quantity of the resource tags reached the upper limit.
ResourceInsufficient.TagQuotasExceeded The tag quota is insufficient.
ResourceNotFound The resource does not exist.
ResourceNotFound.FileSystemNotFound The file system does not exist.
UnsupportedOperation Unsupported operation.
UnsupportedOperation.OutOfService Your account is in arrears. Please top up and try again.
UnsupportedOperation.UnverifiedUser Unverified user.

Ajuda e Suporte

Esta página foi útil?

comentários