{
  "opencollection": "1.0.0",
  "info": {
    "name": "CubeFS Master ACLs Buckets API",
    "version": "3.3"
  },
  "items": [
    {
      "info": {
        "name": "Buckets",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "CubeFS List buckets",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "http://{masterHost}:{masterPort}/"
          },
          "docs": "Returns a list of all buckets owned by the authenticated user. Each bucket corresponds to a CubeFS volume. The response includes the bucket name and creation date."
        },
        {
          "info": {
            "name": "CubeFS Create a bucket",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "http://{masterHost}:{masterPort}/:bucket",
            "params": [
              {
                "name": "bucket",
                "value": "",
                "type": "path",
                "description": "Name of the S3 bucket (corresponds to a CubeFS volume name)."
              }
            ]
          },
          "docs": "Creates a new S3 bucket, which corresponds to creating a new CubeFS volume. The bucket name becomes the volume name. The request may include a LocationConstraint to specify the storage region."
        },
        {
          "info": {
            "name": "CubeFS Delete a bucket",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "http://{masterHost}:{masterPort}/:bucket",
            "params": [
              {
                "name": "bucket",
                "value": "",
                "type": "path",
                "description": "Name of the S3 bucket (corresponds to a CubeFS volume name)."
              }
            ]
          },
          "docs": "Deletes an empty S3 bucket. The bucket must be empty before deletion. Attempting to delete a non-empty bucket returns a 409 BucketNotEmpty error."
        },
        {
          "info": {
            "name": "CubeFS Check if a bucket exists",
            "type": "http"
          },
          "http": {
            "method": "HEAD",
            "url": "http://{masterHost}:{masterPort}/:bucket",
            "params": [
              {
                "name": "bucket",
                "value": "",
                "type": "path",
                "description": "Name of the S3 bucket (corresponds to a CubeFS volume name)."
              }
            ]
          },
          "docs": "Checks whether a bucket exists and the caller has permission to access it. Returns 200 if the bucket exists and is accessible, 404 if it does not exist, or 403 if access is denied."
        }
      ]
    }
  ],
  "bundled": true
}