# Tencent Cloud Cloud HDFS API

> Tencent Cloud Cloud HDFS API on Apizie: 37 endpoints (Associate Access Groups, Create Access Group, Create Access Rules, Create File System, …) 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-chdfs/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Tencent Cloud API 3.0 for Cloud HDFS (chdfs). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Associate Access Groups
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/associate-access-groups` (byok)

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

### Create Access Group
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/create-access-group` (byok)

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

### Create Access Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/create-access-rules` (byok)

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

### Create File System
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/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 |
| FileSystemName | string | yes |  |
| PosixAcl | boolean | yes |  |
| Description | string | no |  |
| CapacityQuota | integer | no |  |
| SuperUsers | array | no |  |
| RootInodeUser | string | no |  |
| RootInodeGroup | string | no |  |
| EnableRanger | boolean | no |  |
| RangerServiceAddresses | array | no |  |
| Tags | array | no |  |

### Create Life Cycle Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/create-life-cycle-rules` (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 |  |
| LifeCycleRules | array | yes |  |

### Create Mount Point
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/create-mount-point` (byok)

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

### Create Path Protection Rule
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/create-path-protection-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 |  |
| Name | string | yes |  |
| Path | string | yes |  |
| Status | integer | yes |  |

### Create Restore Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/create-restore-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 |  |
| RestoreTasks | array | yes |  |

### Create Trash Config
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/create-trash-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 |  |
| ReservedDays | integer | yes |  |
| Status | integer | yes |  |
| Path | string | no |  |

### Delete Access Group
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/delete-access-group` (byok)

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

### Delete Access Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/delete-access-rules` (byok)

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

### Delete File System
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/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 Life Cycle Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/delete-life-cycle-rules` (byok)

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

### Delete Mount Point
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/delete-mount-point` (byok)

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

### Delete Path Protection Rule
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/delete-path-protection-rule` (byok)

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

### Delete Trash Config
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/delete-trash-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 Access Group
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-access-group` (byok)

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

### Describe Access Groups
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-access-groups` (byok)

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

### Describe Access Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-access-rules` (byok)

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

### Describe File System
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-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 |  |

### Describe File Systems
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/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 |
| FileSystemIdMarker | string | no |  |

### Describe Life Cycle Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-life-cycle-rules` (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 Mount Point
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-mount-point` (byok)

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

### Describe Mount Points
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-mount-points` (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 |  |
| AccessGroupId | string | no |  |
| OwnerUin | integer | no |  |

### Describe Path Protection Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-path-protection-rules` (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 Resource Tags
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-resource-tags` (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 Restore Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-restore-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 |  |
| RestoreTaskIdMarker | integer | no |  |

### Describe Trash Config
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/describe-trash-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 |  |

### Disassociate Access Groups
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/disassociate-access-groups` (byok)

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

### Modify Access Group
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-access-group` (byok)

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

### Modify Access Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-access-rules` (byok)

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

### Modify File System
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-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 |  |
| FileSystemName | string | no |  |
| Description | string | no |  |
| CapacityQuota | integer | no |  |
| SuperUsers | array | no |  |
| PosixAcl | boolean | no |  |
| EnableRanger | boolean | no |  |
| RangerServiceAddresses | array | no |  |

### Modify Life Cycle Rules
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-life-cycle-rules` (byok)

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

### Modify Mount Point
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-mount-point` (byok)

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

### Modify Path Protection Rule
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-path-protection-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PathProtectionRuleId | integer | yes |  |
| Name | string | no |  |
| Path | string | no |  |
| Status | integer | no |  |

### Modify Resource Tags
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-resource-tags` (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 |  |
| Tags | array | no |  |

### Modify Trash Config
`POST https://www.apizie.tech/v1/cloud:tencent-chdfs/modify-trash-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 |  |
| ReservedDays | integer | no |  |
| Status | integer | no |  |

## Example
```
curl "https://www.apizie.tech/v1/cloud:tencent-chdfs/associate-access-groups" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Cloud HDFS API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:tencent-chdfs/associate-access-groups with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Tencent Cloud Cloud HDFS 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-chdfs.

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