Client Panel
CDN77 API reference
S3 API reference

Create CDN77 Object Storage

Posthttps://api.cdn77.com/v3/origin/object-storage

Request body≥1 required

  • aclstring

    Available values: authenticated-read, private, public-read, public-read-write

  • cluster_idstring, format UUIDv4required

    Cluster ID

  • labelstringrequired

    Your label for the bucket. Must be unique for your account.

  • bucket_namestringrequired

    Bucket name must be a unique label within the selected cluster.

  • notestring
Example of the request body
{
  "acl": "public-read",
  "cluster_id": "9880280c-0507-46d1-88f3-71cfee83fa57",
  "label": "My bucket",
  "bucket_name": "my-bucket",
  "note": "Storage for video content"
}

Responses

Object storage was created.

Response parameters

  • cdnsarray of objects

    List of all CDN Resources assigned to the Origin.

  • idstring

    Origin ID.

  • labelstring

    Origin label.

  • notestring

    Optional note for the Origin.

  • schemestring

    Available values: http, https

  • base_dirstring

    Base directory for the object storage. This is optional and can be used to specify a subdirectory in the bucket. If not specified, the root of the bucket will be used.

  • bucket_namestring

    Name of your bucket.

  • created_atstring, format date-time
  • hoststring

    Origin host without scheme and port.

  • portinteger

    Origin port. If not specified, the default scheme port is used. Allowed range is between 1 and 65535.

  • primary_origin_idstring

    Origin ID.

  • fallback_originsarray of objects
  • fallback_policyobject
  • typestring

    Available values: aws, object-storage, storage, url

  • usageobject
Example of the response
{
  "cdns": [
    {
      "id": 1234567890,
      "label": "My cdn"
    }
  ],
  "id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "label": "My origin",
  "note": "Note for my Origin",
  "scheme": "https",
  "base_dir": "/pictures/images",
  "bucket_name": "my-bucket",
  "created_at": "2027-07-07T00:00:00.000Z",
  "host": "region.cdn77-storage.com",
  "port": 8080,
  "primary_origin_id": "e56564d1-8d3e-4457-93a6-082b054bc736",
  "fallback_origins": [
    {
      "id": {
        "id": "9880280c-0507-46d1-88f3-71cfee83fa57"
      },
      "label": "MISSING EXAMPLE",
      "usage": {
        "file_count": 1500,
        "size_bytes": 1073741824
      }
    }
  ],
  "fallback_policy": {
    "balancer": "closest",
    "max_fails": 0,
    "fail_timeout": 0,
    "max_fail_timeout": 0,
    "next_upstream": [
      "error"
    ]
  },
  "type": "object-storage",
  "usage": {
    "file_count": 1500,
    "size_bytes": 1073741824
  }
}