Content Listing

Applies To:

HTTP LargeThis platform has been optimized to cache and deliver static content (e.g., HTML, CSS, JavaScript, ISO, multimedia, and software downloads, etc.) over HTTP or HTTPS.

CDN Object StorageThis service was discontinued on 11/12/2018. This storage solution is designed to store content on behalf of the Media Ingest feature.

Media Ingest and CDN Object Storage underwent end-of-life on 11/12/2018. Content may no longer be streamed via Media Ingest and content uploaded by your encoder to CDN Object Storage is no longer available. This article is still available in order to provide assistance while you migrate to a new streaming workflow.

A bucket's contents may be retrieved:

From the Object Storage page.
By submitting a HTTP GET request.

Object Storage Page

The Object Storage page contains a listing of buckets and their contents.

View a bucket's content by clicking on it. This will expand the bucket's row to display a listing of its contents.
By default, only 10 assets will be listed at a time. However, you may display additional assets by clicking Options and then selecting the number of assets that should be listed on a single page (i.e., 10, 25, 50, 100, or 200).
Use the options at the bottom of the bucket's row to navigate the paginated listing of a bucket's contents.

HTTP GET Request

Retrieve a list of the assetA file is the most commonly known example of an asset. Refers to any collection of data that is typically stored as a single unit on a storage unit (e.g., disk drive). An example of an asset that is not physically stored on a disk drive occurs when dynamically generated content is not cached.s contained within a bucket by submitting a GET request for the desired bucket's root directory.

Key information:

This type of request may retrieve up to a 1000 assets.
Assets are retrieved in alphabetical order.
An encoder may continuously upload content to a bucket. Under these conditions, the response will only reflect the state of the bucket at the moment in time when the GET request was submitted.

Request

The syntax for this type of request is provided below.

HTTP Method	Request URI
GET	CDN URL: http://wpc.ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC..{Base Domain}/30ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC./CDNOSLocationReplace this term with the CDN Object Storage location assigned to your account./ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.-BucketRepresents the name of the bucket to which the event was uploaded. Edge CNAME URL: https://EdgeCNAMERepresents the edge CNAME configuration created for CDN Object Storage./CDNOSLocationThis term represents the CDN Object Storage location assigned to your account. Omit this URL segment when this location is defined as the edge CNAME's relative path/ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.-BucketRepresents the name of the bucket to which the event was uploaded.

HTTP Method

Request URI

GET

CDN URL:

http://wpc.ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC..{Base Domain}/30ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC./CDNOSLocationReplace this term with the CDN Object Storage location assigned to your account./ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.-BucketRepresents the name of the bucket to which the event was uploaded.

Edge CNAME URL:

https://EdgeCNAMERepresents the edge CNAME configuration created for CDN Object Storage./CDNOSLocationThis term represents the CDN Object Storage location assigned to your account. Omit this URL segment when this location is defined as the edge CNAME's relative path/ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.-BucketRepresents the name of the bucket to which the event was uploaded.

Do not include a trailing forward slash when requesting a bucket.
Invalid request:
https://stream.mydomain.com/0001-mybucket/

A CDN URL for each CDN Object Storage bucket is listed on the HTTP Media Ingest page.

Use the following query string parameters to filter or modify the response:

Query String Parameter	Description
prefix	Filters the response to only return assets whose Key tag starts with the specified value. Syntax: prefix=StartsWithValue Sample Value: ?prefix=elementalHLS/myevent1080p
delimiter	Groups delimited assets by prefix. Key information: Only assets whose Key tag contains the specified delimiter will be affected by this parameter. A delimiter may only consist of a single character. Detailed information on these assets will not be included in the response. In other words, a Contents tag will not be generated for these assets. Assets that contain the specified delimiter and share the same prefix will be grouped together under the CommonPrefixes tag. Syntax: delimiter=Delimiter Sample Value: ?delimiter=-
marker	The purpose of this query string parameter is to facilitate the retrieval of buckets that contain more than 1000 assets. It facilitates the retrieval of large buckets by determining the starting point of the response. Since assets are listed in alphabetical order, the contents of a large bucket may be retrieved by submitting multiple requests using this query string parameter. Details: This parameter identifies an asset by finding the first asset whose Key tag starts with the specified value. The response will only include assets that are alphabetically listed after the asset identified in the previous step. Learn more. Syntax: marker=StartsWithValue Sample Value: ?marker=elementalHLS/myevent1080p_00025.ts
max-keys	Limits the number of assets to the specified value. Omitting this query string parameter allows the response to include up to 1000 assets. Syntax: max-keys=#ofObjects Sample Value: ?max-keys=500

Retrieving Large Buckets

The contents of a bucket containing more than 1000 assets may be retrieved through the following procedure:

Find out the current number of assets contained within the desired bucket.
1. Submit a HEAD request to the bucket's root directory.
  
  HEAD http://wpc.ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC..{Base Domain}/30ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC./CDNOSLocationReplace this term with the CDN Object Storage location assigned to your account./ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.-BucketRepresents the name of the bucket to which the event was uploaded.
2. Look at the value assigned to the X-RGW-Object-Count header.
  
  Example:
  
  X-RGW-Object-Count: 3001
Divide the value assigned to the X-RGW-Object-Count header by 1000 and round up to the next whole integer.

For example, a value of 3001 requires 4 separate requests.
Submit the initial GET request to the root directory of the desired bucket.
Parse through the response to find the last asset (i.e., the last Contents tag in the response).
Submit a GET request to the root directory of the desired bucket using the marker query string parameter. Set this parameter to the value assigned to the Key tag for the asset identified in the previous step.

GET http://wpc.ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC..{Base Domain}/30ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC./CDNOSLocationReplace this term with the CDN Object Storage location assigned to your account./ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.-BucketRepresents the name of the bucket to which the event was uploaded.?marker=elementalHLS/myevent1080p_00025.ts
Repeat steps 4 and 5 until the total number of GET requests equals the integer calculated in step 2.

Response

The response to a request for a listing of a bucket's content may contain the following elements:

Name	Description
ListBucketResult	This tag contains the entire response.
Name	Identifies the name of the bucket whose content was requested. Syntax: ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.-BucketName
Prefix	Identifies the value defined in the prefix query string parameter. This tag is empty when the prefix query string parameter is not included in the request URI.
Marker	Identifies the value defined in the marker query string parameter. This tag is empty when the marker query string parameter is not included in the request URI.
MaxKeys	Indicates the maximum number of assets that may be included in the response. This tag is empty when the max-keys query string parameter is not included in the request URI.
IsTruncated	Indicates whether the response includes a listing of all assets stored within the requested bucket. Valid values are: true: The response included a partial listing of a bucket's contents. false: The response included all assets stored within the bucket.
Contents	Contains a set of response elements that describe an asset. A Contents tag is generated for each asset included in the response.
Key	Identifies an asset by its file name.
LastModified	Indicates the date and time when the asset was last modified. Format: YYYY-MM-DDThh:mm:ss.000Z Example: 2015-06-30T20:42:09.000Z The above value represents June 30th, 2015 at 8:42 p.m. UTC.
ETag	Indicates the asset's entity tag (ETag). This value is a MD5 hash of the asset.
Size	Indicates the asset's file size in bytes.
StorageClass	This response element always reports "STANDARD."
Owner	Contains response elements that identify your customer account.
ID	Identifies your customer account number. Format: ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.
DisplayName	Identifies your customer account number. Format: Customer AN#ANThis term represents your customer account number (e.g., 0001) which can be found in the upper right-hand corner of the MCC.
CommonPrefixes	Contains the Prefix tag. This tag is only present when the delimiter query string parameter is defined in the request URL. A CommonPrefixes tag is generated for each set of assets that share a common prefix and whose name includes a delimiter.
Prefix	Identifies a set of delimited assets that share a common prefix.

Sample Request and Response

A sample request is provided below.

GET http://stream.mydomain.com/0001-mybucket

The response to the above request is provided below.

<?xml version="1.0" encoding="UTF-8"?>

<Name>0001-mybucket</Name>

<IsTruncated>false</IsTruncated>

<Key>elementalHLS/myevent.m3u8</Key>