Assets
URI
/assets
HTTP methods
GET
Operation ID: ListAssets
Lists assets that match a set of filters that you define.
Query parameters | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name | Type | Required | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
packagingGroupId | String | False | Limits the results to records that are associated with the given packaging group. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
nextToken | String | False | Pagination token. Use this token to request the next page of record results. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
maxResults | String | False | Upper bound on number of records to return. |
Responses | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status code | Response model | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | AssetList |
The list of tags is returned successfully. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
403 | None |
AWS Elemental MediaPackage cannot authorize the request, possibly due to insufficient authentication credentials. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | None |
AWS Elemental MediaPackage did not find a representation of the target resource. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
422 | None |
AWS Elemental MediaPackage could not process the instructions in the body of the request. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
429 | None |
Too many requests have been sent in a given amount of time. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
500 | None |
An unexpected condition prevented AWS Elemental MediaPackage from fulfilling the request. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
503 | None |
AWS Elemental MediaPackage can't currently complete the request, usually because of a temporary overload or maintenance. |
POST
Operation ID: CreateAsset
Creates an asset to ingest VOD content.
Once created, the asset starts ingesting content and generates playback URLs for the packaging configurations associated with it. When ingest is complete, downstream devices request VOD content from AWS Elemental MediaPackage using the appropriate URL.
Responses | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status code | Response model | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | Asset |
The list of tags is returned successfully. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
403 | None |
AWS Elemental MediaPackage cannot authorize the request, possibly due to insufficient authentication credentials. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | None |
AWS Elemental MediaPackage did not find a representation of the target resource. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
422 | None |
AWS Elemental MediaPackage could not process the instructions in the body of the request. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
429 | None |
Too many requests have been sent in a given amount of time. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
500 | None |
An unexpected condition prevented AWS Elemental MediaPackage from fulfilling the request. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
503 | None |
AWS Elemental MediaPackage can't currently complete the request, usually because of a temporary overload or maintenance. |
OPTIONS
Enable cross-origin resource sharing (CORS) by returning correct headers.
Responses | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status code | Response model | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | None |
The list of tags is returned successfully. |
Schemas
Request bodies
{ "packagingGroupId": "string", "sourceArn": "string", "resourceId": "string", "sourceRoleArn": "string", "id": "string", "tags": { } }
Response bodies
{ "assets": [ { "createdAt": "string", "packagingGroupId": "string", "sourceArn": "string", "resourceId": "string", "sourceRoleArn": "string", "id": "string", "arn": "string", "tags": { } } ], "nextToken": "string" }
{ "createdAt": "string", "packagingGroupId": "string", "sourceArn": "string", "resourceId": "string", "sourceRoleArn": "string", "id": "string", "arn": "string", "egressEndpoints": [ { "packagingConfigurationId": "string", "url": "string", "status": "string" } ], "tags": { } }
Properties
Asset
Parameters for an asset.
Property | Type | Required | Description |
---|---|---|---|
arn | string | False | The Amazon Resource Name (ARN) for the asset. You can get this from the response to any request to the asset. |
createdAt | string | False | The date and time the Asset was initially submitted for Ingest. |
egressEndpoints | Array of type EgressEndpoint | False | List of playback endpoints that are available for this asset. |
id | string | False | Unique identifier that you assign to the asset. |
packagingGroupId | string | False | The ID of the packaging group associated with this asset. |
resourceId | string | False | Unique identifier for this asset, as it's configured in the key provider service. |
sourceArn | string | False | The ARN for the source content in Amazon S3. |
sourceRoleArn | string | False | The ARN for the IAM role that provides AWS Elemental MediaPackage access to the Amazon S3 bucket where the source content is stored. Valid format: |
tags | False | The tags to assign to the asset. |
AssetCreateParameters
Parameters for creating an asset.
Property | Type | Required | Description |
---|---|---|---|
id | string | True | Unique identifier that you assign to the asset. |
packagingGroupId | string | True | The ID of the packaging group associated with this asset. |
resourceId | string | False | Unique identifier for this asset, as it's configured in the key provider service. |
sourceArn | string | True | The ARN for the source content in Amazon S3. |
sourceRoleArn | string | True | The ARN for the IAM role that provides AWS Elemental MediaPackage access to the Amazon S3 bucket where the source content is stored. Valid format: |
tags | False | The tags to assign to the asset. |
AssetList
A collection of Asset records.
Property | Type | Required | Description |
---|---|---|---|
assets | Array of type AssetShallow | False | A list of Asset records that are configured on this account in this AWS Region. |
nextToken | string | False | Pagination token. Use this token to request the next page of assets results. |
AssetShallow
Parameters on an asset.
Property | Type | Required | Description |
---|---|---|---|
arn | string | False | The Amazon Resource Name (ARN) for the asset. You can get this from the response to any request to the asset. |
createdAt | string | False | The date and time the Asset was initially submitted for Ingest. |
id | string | False | Unique identifier that you assigned to the asset. |
packagingGroupId | string | False | The ID of the packaging group associated with this asset. |
resourceId | string | False | Unique identifier for this endpoint, as it's configured in the key provider service. |
sourceArn | string | False | The ARN for the source content in Amazon S3. |
sourceRoleArn | string | False | The ARN for the IAM role that provides AWS Elemental MediaPackage access to the Amazon S3 bucket where the source content is stored. Valid format: |
tags | False | The tags to assign to the asset. |
EgressEndpoint
The playback endpoint for a packaging configuration on an asset.
Property | Type | Required | Description |
---|---|---|---|
packagingConfigurationId | string | False | The ID of a packaging configuration that's applied to this asset. |
status | string | False | The current processing status of the asset used for the packaging configuration. The status can be |
url | string | False | The URL that's used to request content from this endpoint. |
Tags
A collection of tags associated with a resource.
Property | Type | Required | Description |
---|---|---|---|
| string | False |