CubeFS

CubeFS is a CNCF graduated cloud-native distributed file system supporting POSIX, HDFS, and S3-compatible object storage protocols. It provides multi-tenancy, multi-AZ deployment, cross-region replication, and erasure coding for both hot and cold data tiers, and is widely used to back cloud-native AI training, big-data analytics, and container storage workloads.

CubeFS publishes 11 APIs on the APIs.io network, including ACLs API, Buckets API, Cluster API, and 8 more. Tagged areas include Cloud Native, CNCF Graduated, Distributed File System, Kubernetes, and Object Storage.

The CubeFS catalog on APIs.io includes 1 JSON-LD context and 3 Spectral governance rulesets.

CubeFS’s developer surface includes authentication, documentation, getting-started guide, changelog, and 11 more developer resources.

🌐 Visit website 📡 Source on GitHub

50.8/100 developing ▼ -5.1 Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

11 APIs

Cloud NativeCNCF GraduatedDistributed File SystemKubernetesObject StoragePOSIXS3 CompatibleStorage

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 50.8/100 · developing

Contract Quality 15.3 / 25

Developer Ergonomics 6.1 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 6.8 / 13

Governance 8.3 / 12

Discoverability 6.5 / 10

Agent readiness — 31/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/cubefs: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Cubefs Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

Get Started 1

Portal, sign-up, and the first successful call

GettingStarted

GettingStarted

Documentation 2

Reference material describing how the API behaves

JSONSchema

JSONSchema

Documentation

Documentation

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

LlmsText

LlmsText

Design & Contract 4

Pagination, idempotency, versioning, errors, and events

JSONLD

Vocabulary

SpectralRules

SpectralRules

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

GitHubRepository

GitHubRepository

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

ChangeLog

ChangeLog

Company 1

The organization behind the API

Website

Website

Source (apis.yml)

aid: cubefs
url: https://raw.githubusercontent.com/api-evangelist/cubefs/refs/heads/main/apis.yml
kind: opensource
name: CubeFS
description: CubeFS is a CNCF graduated cloud-native distributed file system supporting POSIX, HDFS, and S3-compatible object
  storage protocols. It provides multi-tenancy, multi-AZ deployment, cross-region replication, and erasure coding for both
  hot and cold data tiers, and is widely used to back cloud-native AI training, big-data analytics, and container storage
  workloads.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/cubefs.png
tags:
- Cloud Native
- CNCF Graduated
- Distributed File System
- Kubernetes
- Object Storage
- POSIX
- S3 Compatible
- Storage
type: Index
specificationVersion: '0.19'
created: '2026-03-16'
modified: '2026-05-19'
apis:
- aid: cubefs:cubefs-acls-api
  name: CubeFS ACLs API
  description: Access control list operations for buckets and objects. Supports getting and setting ACLs to control access
    at the bucket and object level.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - ACLs
  properties:
  - type: OpenAPI
    url: openapi/cubefs-acls-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-buckets-api
  name: CubeFS Buckets API
  description: Bucket-level operations including creating, listing, and deleting buckets. In CubeFS, each S3 bucket corresponds
    to a CubeFS volume. Bucket names must be unique within the cluster.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - Buckets
  properties:
  - type: OpenAPI
    url: openapi/cubefs-buckets-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-cluster-api
  name: CubeFS Cluster API
  description: Cluster-level operations including retrieving cluster status, topology, and freezing/unfreezing the cluster
    to control automatic partition creation.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - Cluster
  properties:
  - type: OpenAPI
    url: openapi/cubefs-cluster-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-datanodes-api
  name: CubeFS DataNodes API
  description: Data node management operations including listing nodes, querying node status, decommissioning nodes, and managing
    data partitions on nodes.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - DataNodes
  properties:
  - type: OpenAPI
    url: openapi/cubefs-datanodes-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-datapartitions-api
  name: CubeFS DataPartitions API
  description: Data partition management including creating, loading, decommissioning, and diagnosing data partitions within
    volumes.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - DataPartitions
  properties:
  - type: OpenAPI
    url: openapi/cubefs-datapartitions-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-metanodes-api
  name: CubeFS MetaNodes API
  description: Metadata node management operations including listing nodes, querying node status, decommissioning nodes, and
    managing metadata partitions.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - MetaNodes
  properties:
  - type: OpenAPI
    url: openapi/cubefs-metanodes-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-metapartitions-api
  name: CubeFS MetaPartitions API
  description: Metadata partition management including creating, loading, and decommissioning metadata partitions within volumes.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - MetaPartitions
  properties:
  - type: OpenAPI
    url: openapi/cubefs-metapartitions-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-multipart-api
  name: CubeFS Multipart API
  description: Multipart upload operations for uploading large objects in parts. Supports initiating, uploading parts, listing
    parts, completing, and aborting multipart uploads.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - Multipart
  properties:
  - type: OpenAPI
    url: openapi/cubefs-multipart-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-objects-api
  name: CubeFS Objects API
  description: Object CRUD operations including uploading, downloading, copying, listing, and deleting objects. Supports both
    standard single-part uploads and multipart uploads for large objects.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - Objects
  properties:
  - type: OpenAPI
    url: openapi/cubefs-objects-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-users-api
  name: CubeFS Users API
  description: User and access control management for CubeFS multi-tenancy. Users own volumes and are assigned access keys
    and secret keys for S3-compatible object storage operations.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/cubefs-users-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
- aid: cubefs:cubefs-volumes-api
  name: CubeFS Volumes API
  description: Volume lifecycle management operations including creating, updating, expanding, shrinking, and deleting volumes.
    Volumes are the top-level storage namespaces in CubeFS.
  humanURL: https://cubefs.io/docs/master/user-guide/objectnode.html
  tags:
  - Volumes
  properties:
  - type: OpenAPI
    url: openapi/cubefs-volumes-api-openapi.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/user-guide/objectnode.html
  - type: GitHubRepository
    url: https://github.com/cubefs/cubefs
  - type: SpectralRules
    url: rules/cubefs-s3-rules.yml
  - type: Documentation
    url: https://cubefs.io/docs/master/dev-guide/master-api.html
  - type: JSONSchema
    url: json-schema/cubefs-volume-schema.json
  - type: SpectralRules
    url: rules/cubefs-master-rules.yml
features:
- name: Multi-Protocol Access
  description: Single backend serves POSIX (FUSE), HDFS, and S3-compatible clients.
- name: Multi-Tenancy
  description: Tenant isolation by user, access key, and per-volume policies.
- name: Multi-AZ Deployment
  description: Replication across availability zones with optional cross-zone partitions.
- name: Erasure Coding
  description: Parity-coded storage to reduce overhead for cold data tiers.
- name: Container Storage
  description: First-class CSI driver for Kubernetes persistent volumes.
- name: Master Control Plane
  description: HTTP master API for volume, node, partition, and user management.
- name: S3-Compatible ObjectNode
  description: ObjectNode gateway exposes standard S3 verbs to AWS SDK clients.
- name: CNCF Graduated
  description: Project status, governance, and community managed under the CNCF.
useCases:
- name: AI/ML Training Storage
  description: Large training datasets stored on CubeFS via POSIX or S3 access.
- name: Big Data Analytics
  description: HDFS clients run analytics on CubeFS-backed datasets.
- name: Cloud-Native Object Storage
  description: Apps use S3-compatible buckets backed by CubeFS without AWS dependency.
- name: Kubernetes Persistent Volumes
  description: CubeFS CSI driver provides RWX persistent volumes to stateful workloads.
- name: Multi-Region Storage
  description: Cross-region replication backs disaster recovery and locality strategies.
- name: Hot/Cold Tiering
  description: Replicated tier for hot data and erasure-coded tier for cold data.
common:
- type: AgenticAccess
  url: agentic-access/cubefs-agentic-access.yml
- type: DomainSecurity
  url: security/cubefs-domain-security.yml
- type: Authentication
  url: authentication/cubefs-authentication.yml
- type: JSONLD
  url: json-ld/cubefs-context.jsonld
  name: CubeFS JSON-LD Context
  description: Linked-data context mapping CubeFS resources to standard vocabularies.
- type: JSONSchema
  url: json-schema/cubefs-volume-schema.json
  name: CubeFS Volume JSON Schema
  description: JSON Schema for CubeFS volume, partition, node, and user data models.
- type: Vocabulary
  url: vocabulary/cubefs-vocabulary.yml
  name: CubeFS Vocabulary
- type: SpectralRules
  url: rules/cubefs-master-rules.yml
  name: CubeFS Master API Spectral Rules
- type: SpectralRules
  url: rules/cubefs-s3-rules.yml
  name: CubeFS S3 API Spectral Rules
- type: Website
  name: CubeFS Website
  description: Official CubeFS project website.
  url: https://cubefs.io/
- type: Documentation
  name: CubeFS Documentation
  description: Official documentation for CubeFS.
  url: https://cubefs.io/docs/master/overview/introduction.html
- type: GettingStarted
  name: CubeFS Quick Start
  description: Quick start guide for deploying CubeFS.
  url: https://cubefs.io/docs/master/quickstart/single-deploy.html
- type: ChangeLog
  name: CubeFS Changelog
  description: Version history and changelog for CubeFS releases.
  url: https://github.com/cubefs/cubefs/blob/master/CHANGELOG.md
- type: GitHubOrganization
  name: CubeFS GitHub Organization
  description: GitHub organization hosting all CubeFS source code.
  url: https://github.com/cubefs
- type: GitHubRepository
  name: CubeFS GitHub Repository
  description: Main CubeFS source code repository.
  url: https://github.com/cubefs/cubefs
- type: LlmsText
  url: https://cubefs.io/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com