CDN account services operations#

You can perform the operations described in this section at the account level of your Cloud Files CDN account.

The examples in this section use sample values for the following:

  • account — for example, MossoCloudFS_0672d7fa-9f85-4a81-a3ab-adb66a880123

  • X-Auth-Token — for example, f064c46a782c444cb4ba4b6434288f7c

For your own requests, you must use your own account information and authentication token. For more information, see Authenticate to the Rackspace Cloud. Your authentication token and your account information are in the service catalog that is produced.

List CDN-enabled containers#

GET /v1/{account}

This operation lists any containers that are currently or have ever been CDN-enabled, sorted by name.

GET operations against the cloudFilesCDN endpoints for an account retrieve a list of containers that are currently or have ever been CDN-enabled. No private containers appear in the list. (For the CDN endpoints, see Service access endpoints.)

The list is returned in the response body, one container name per line.

An HTTP response status code of 200 through 299 indicates success. A 200 (OK) code is returned if there are containers to list, and a 204 (No Content) code is returned if there are no containers to list.

For instructions about how to delete containers that were CDN-enabled in the past and are now disabled, but are showing in the listing, see Delete CDN-enabled object.

To view the CDN container details, see List metadata for CDN-enabled container.

This table shows the possible response codes for this operation:

Response Code

Name

Description

200

OK

The request succeeded. The information returned with the response is dependent on the method used in the request.

204

No Content

The request succeeded. The server fulfilled the request but does not need to return a body.

404

Not Found

The requested resource was not found.

Request#

This table shows the URI parameters for the request:

Name

Type

Description

{account}

String

Your unique account identifier.

This table shows the query parameters for the request:

Name

Type

Description

limit

Int

For an integer value n, limits the number of results to n values.

marker

String

Given a string value x, returns container names greater in value than the specified marker. Only strings using UTF-8 encoding are valid. Using marker provides a mechanism for iterating through the entire list of containers.

end_marker

String

Given a string value x, returns container names lesser in value than the specified end marker. Only strings using UTF-8 encoding are valid.

format

String

Value of the serialized response format, either JSON or XML.

This operation does not accept a request body.

Example: List CDN-enabled containers HTTP request

GET /v1/MossoCloudFS_0672d7fa-9f85-4a81-a3ab-adb66a880123 HTTP/1.1
Host: cdn.clouddrive.com
X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c

Example: List CDN-enabled containers HTTP request with a query parameter ?format=json​

GET /v1/MossoCloudFS_0672d7fa-9f85-4a81-a3ab-adb66a880123?format=json HTTP/1.1
Host: cdn.clouddrive.com
X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c

Response#

Example: List CDN-enabled containers HTTP response

HTTP/1.1 200 OK
Date: Thu, 08 Sep 2011 14:35:45 GMT
Transfer-Encoding: chunked
Content-Type: text/plain

images
movies

Example: List CDN-enabled containers HTTP response, using a query parameter ?format=json​

Note: X-Cdn-Streaming-Uri and X-Cdn-Ios-Uri links will be discontinued on July 31, 2022.

HTTP/1.1 200 OK
Content-Length: 1985
Content-Type: application/json
X-Trans-Id: tx82a6752e00424edb9c46fa2573132e2c​iad3
Date: Tue, 05 May 2015 14:09:02 GMT

[
    {
        "cdn_enabled": true,
        "X-Cdn-Ios-Uri": "http://acc3b9ba6a79805f5577-e7e60117100ffd73b45850c0b1fd96c1.iosr.cf5.rackcdn.com",
        "X-Cdn-Ssl-Uri": "https://83c49b9a2f7ad18250b3-346eb45fd42c58ca13011d659bfc1ac1. ssl.cf0.rackcdn.com",
        "X-Cdn-Streaming-Uri": "http://084cc2790632ccee0a12-346eb45fd42c58ca13011d659bfc1ac1. r49.stream.cf0.rackcdn.com",
        "X-Cdn-Uri": "http://081e40d3ee1cec5f77bf-346eb45fd42c58ca13011d659bfc1ac1.r49.cf0.rackcdn.com",
        "log_retention": false,
        "name": "cdn_test",
        "ttl": 259200
    },
    ...
]