# Tencent Cloud GooseFS Data Accelerator API

> Tencent Cloud GooseFS Data Accelerator API on Apizie: 45 endpoints (Add Cross Vpc Subnet Support For Client Node, Attach File System Bucket, Batch Add Client Nodes, Batch Delete Client Nodes, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:tencent-goosefs/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-goosefs`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://www.apizie.tech/api/cloud/tencent-goosefs
- OpenAPI: https://www.apizie.tech/api/cloud/tencent-goosefs/openapi.json

Tencent Cloud API 3.0 for GooseFS Data Accelerator (goosefs). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Add Cross Vpc Subnet Support For Client Node
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/add-cross-vpc-subnet-support-for-client-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| SubnetInfo | object | yes |  |

### Attach File System Bucket
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/attach-file-system-bucket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| Bucket | object | yes |  |

### Batch Add Client Nodes
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/batch-add-client-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| ClientNodes | array | yes |  |
| SingleClusterFlag | boolean | no |  |
| ClusterId | string | no |  |

### Batch Delete Client Nodes
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/batch-delete-client-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| ClientNodes | array | yes |  |
| SingleClusterFlag | boolean | no |  |
| ClusterId | string | no |  |

### Build Client Node Mount Command
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/build-client-node-mount-command` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| CustomMountDir | string | no |  |
| ClusterId | string | no |  |

### Build Customer Cluster
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/build-customer-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | no |  |
| VpcId | string | no |  |
| SubnetId | string | no |  |
| ClusterName | string | no |  |
| Zone | string | no |  |

### Cancel Load Task
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/cancel-load-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| TaskId | string | yes |  |

### Cancel Policy Rule Execute Record
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/cancel-policy-rule-execute-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | string | yes |  |
| FileSystemId | string | yes |  |
| RecordId | string | yes |  |

### Create Data Repository Task
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/create-data-repository-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskType | string | yes |  |
| Bucket | string | yes |  |
| FileSystemId | string | yes |  |
| TaskPath | string | yes |  |
| TaskName | string | yes |  |
| IsTaskPathAbsolute | boolean | no |  |
| RepositoryType | string | no |  |
| TextLocation | string | no |  |
| EnableCustomDestPath | boolean | no |  |
| CustomDestPath | string | no |  |
| OutputBucket | string | no |  |
| OutputPrefix | string | no |  |
| EnableCustomSrcPath | boolean | no |  |
| CustomSrcPath | string | no |  |

### Create File System
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/create-file-system` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Name | string | yes |  |
| Description | string | yes |  |
| VpcId | string | yes |  |
| SubnetId | string | yes |  |
| Zone | string | yes |  |
| Tag | array | no |  |
| GooseFSxBuildElements | object | no |  |
| SecurityGroupId | string | no |  |
| ClusterPort | integer | no |  |

### Create Fileset
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/create-fileset` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| FsetName | string | yes |  |
| FsetDir | string | yes |  |
| QuotaSizeLimit | string | no |  |
| QuotaFilesLimit | string | no |  |
| AuditState | string | no |  |

### Create Load Task
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/create-load-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| LoadTaskCreationAttrs | object | yes |  |

### Create Policy Rule
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/create-policy-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| ScanDir | string | yes |  |
| Name | string | yes |  |
| Execution | object | yes |  |
| PolicyRuleSet | array | no |  |
| EnableManifest | boolean | no |  |
| Manifest | object | no |  |

### Delete Cross Vpc Subnet Support For Client Node
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/delete-cross-vpc-subnet-support-for-client-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| SubnetInfo | object | yes |  |

### Delete Customer Cluster
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/delete-customer-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | no |  |
| ClusterId | string | no |  |

### Delete File System
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/delete-file-system` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |

### Delete Fileset
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/delete-fileset` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| FsetId | string | yes |  |

### Delete Policy Rule
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/delete-policy-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | string | yes |  |
| FileSystemId | string | yes |  |

### Describe Client Nodes
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-client-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |

### Describe Cluster Client Token
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-cluster-client-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |

### Describe Cluster Role Token
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-cluster-role-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| RoleName | string | yes |  |

### Describe Customer Cluster
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-customer-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | no |  |

### Describe Data Repository Task Status
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-data-repository-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskId | string | yes |  |
| FileSystemId | string | yes |  |

### Describe Data Repository Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-data-repository-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |

### Describe File System Buckets
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-file-system-buckets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |

### Describe File Systems
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-file-systems` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | yes |  |
| Limit | integer | yes |  |

### Describe Fileset General Config
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-fileset-general-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |

### Describe Filesets
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-filesets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| FilesetIds | array | no |  |
| FilesetDirs | array | no |  |

### Describe Load Task
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-load-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| TaskId | string | yes |  |

### Describe Policy Rule
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-policy-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |

### Describe Policy Rule Execute Record
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/describe-policy-rule-execute-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| RuleId | string | no |  |

### Detach File System Bucket
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/detach-file-system-bucket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| BucketName | string | yes |  |

### Disable Policy Rule
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/disable-policy-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | string | yes |  |
| FileSystemId | string | yes |  |

### Enable Policy Rule
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/enable-policy-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | string | yes |  |
| FileSystemId | string | yes |  |

### Expand Capacity
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/expand-capacity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| ExpandedCapacity | integer | yes |  |
| ModifyType | string | no |  |
| RapidExpansion | boolean | no |  |

### List Load Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/list-load-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| StartTimestamp | integer | no |  |
| EndTimestamp | integer | no |  |
| State | string | no |  |
| Priority | integer | no |  |

### Modify Data Repository Bandwidth
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/modify-data-repository-bandwidth` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| Bandwidth | integer | yes |  |

### Modify Data Repository Task Status
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/modify-data-repository-task-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| TaskId | string | yes |  |
| ModifyType | string | yes |  |

### Mount Multiple Storage File System
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/mount-multiple-storage-file-system` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | no |  |
| CustomerClusterId | string | no |  |
| StorageFileSystemId | string | no |  |

### Query Client Node Mount Command
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/query-client-node-mount-command` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | no |  |
| ClusterMountInfo | array | no |  |
| FileSystemId | string | no |  |

### Query Cross Vpc Subnet Support For Client Node
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/query-cross-vpc-subnet-support-for-client-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |

### Query Data Repository Bandwidth
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/query-data-repository-bandwidth` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |

### Update Fileset
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/update-fileset` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| FsetId | string | yes |  |
| QuotaSizeLimit | string | no |  |
| QuotaFilesLimit | string | no |  |
| AuditState | string | no |  |

### Update Fileset General Config
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/update-fileset-general-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FileSystemId | string | yes |  |
| EnforceQuotaOnRoot | string | no |  |

### Update Load Task Priority
`POST https://www.apizie.tech/v1/cloud:tencent-goosefs/update-load-task-priority` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ClusterId | string | yes |  |
| TaskId | string | yes |  |
| Priority | integer | yes |  |

## Example
```
curl "https://www.apizie.tech/v1/cloud:tencent-goosefs/add-cross-vpc-subnet-support-for-client-node" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud GooseFS Data Accelerator API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:tencent-goosefs/add-cross-vpc-subnet-support-for-client-node with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud GooseFS Data Accelerator API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud GooseFS Data Accelerator itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud GooseFS Data Accelerator API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-goosefs.

### What is the status of the Tencent Cloud GooseFS Data Accelerator API?
Needs your own provider key (bring your own key)