AWS Elemental MediaPackage v2 2022-12-25
- Client: Aws\MediaPackageV2\MediaPackageV2Client
- Service ID: mediapackagev2
- Version: 2022-12-25
This page describes the parameters and results for the operations of the AWS Elemental MediaPackage v2 (2022-12-25), and shows how to use the Aws\MediaPackageV2\MediaPackageV2Client object to call the described operations. This documentation is specific to the 2022-12-25 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- CancelHarvestJob ( array $params = [] )
- Cancels an in-progress harvest job.
- CreateChannel ( array $params = [] )
- Create a channel to start receiving content streams.
- CreateChannelGroup ( array $params = [] )
- Create a channel group to group your channels and origin endpoints.
- CreateHarvestJob ( array $params = [] )
- Creates a new harvest job to export content from a MediaPackage v2 channel to an S3 bucket.
- CreateOriginEndpoint ( array $params = [] )
- The endpoint is attached to a channel, and represents the output of the live content.
- DeleteChannel ( array $params = [] )
- Delete a channel to stop AWS Elemental MediaPackage from receiving further content.
- DeleteChannelGroup ( array $params = [] )
- Delete a channel group.
- DeleteChannelPolicy ( array $params = [] )
- Delete a channel policy.
- DeleteOriginEndpoint ( array $params = [] )
- Origin endpoints can serve content until they're deleted.
- DeleteOriginEndpointPolicy ( array $params = [] )
- Delete an origin endpoint policy.
- GetChannel ( array $params = [] )
- Retrieves the specified channel that's configured in AWS Elemental MediaPackage, including the origin endpoints that are associated with it.
- GetChannelGroup ( array $params = [] )
- Retrieves the specified channel group that's configured in AWS Elemental MediaPackage, including the channels and origin endpoints that are associated with it.
- GetChannelPolicy ( array $params = [] )
- Retrieves the specified channel policy that's configured in AWS Elemental MediaPackage.
- GetHarvestJob ( array $params = [] )
- Retrieves the details of a specific harvest job.
- GetOriginEndpoint ( array $params = [] )
- Retrieves the specified origin endpoint that's configured in AWS Elemental MediaPackage to obtain its playback URL and to view the packaging settings that it's currently using.
- GetOriginEndpointPolicy ( array $params = [] )
- Retrieves the specified origin endpoint policy that's configured in AWS Elemental MediaPackage.
- ListChannelGroups ( array $params = [] )
- Retrieves all channel groups that are configured in AWS Elemental MediaPackage, including the channels and origin endpoints that are associated with it.
- ListChannels ( array $params = [] )
- Retrieves all channels in a specific channel group that are configured in AWS Elemental MediaPackage, including the origin endpoints that are associated with it.
- ListHarvestJobs ( array $params = [] )
- Retrieves a list of harvest jobs that match the specified criteria.
- ListOriginEndpoints ( array $params = [] )
- Retrieves all origin endpoints in a specific channel that are configured in AWS Elemental MediaPackage.
- ListTagsForResource ( array $params = [] )
- Lists the tags assigned to a resource.
- PutChannelPolicy ( array $params = [] )
- Attaches an IAM policy to the specified channel.
- PutOriginEndpointPolicy ( array $params = [] )
- Attaches an IAM policy to the specified origin endpoint.
- TagResource ( array $params = [] )
- Assigns one of more tags (key-value pairs) to the specified MediaPackage resource.
- UntagResource ( array $params = [] )
- Removes one or more tags from the specified resource.
- UpdateChannel ( array $params = [] )
- Update the specified channel.
- UpdateChannelGroup ( array $params = [] )
- Update the specified channel group.
- UpdateOriginEndpoint ( array $params = [] )
- Update the specified origin endpoint.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
Waiters
Waiters allow you to poll a resource until it enters into a desired state. A waiter has a name used to describe what it does, and is associated with an API operation. When creating a waiter, you can provide the API operation parameters associated with the corresponding operation. Waiters can be accessed using the getWaiter($waiterName, $operationParameters) method of a client object. This client supports the following waiters:
Waiter name | API Operation | Delay | Max Attempts |
---|---|---|---|
HarvestJobFinished | GetHarvestJob | 2 | 60 |
Operations
CancelHarvestJob
$result = $client->cancelHarvestJob
([/* ... */]); $promise = $client->cancelHarvestJobAsync
([/* ... */]);
Cancels an in-progress harvest job.
Parameter Syntax
$result = $client->cancelHarvestJob([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'ETag' => '<string>', 'HarvestJobName' => '<string>', // REQUIRED 'OriginEndpointName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name of the channel group containing the channel from which the harvest job is running.
- ChannelName
-
- Required: Yes
- Type: string
The name of the channel from which the harvest job is running.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with the harvest job. Used for concurrency control.
- HarvestJobName
-
- Required: Yes
- Type: string
The name of the harvest job to cancel. This name must be unique within the channel and cannot be changed after the harvest job is submitted.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name of the origin endpoint that the harvest job is harvesting from. This cannot be changed after the harvest job is submitted.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Cancel a Harvest Job
$result = $client->cancelHarvestJob([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'HarvestJobName' => 'HarvestJobName', 'OriginEndpointName' => 'exampleOriginEndpointName', ]);
Result syntax:
[ ]
CreateChannel
$result = $client->createChannel
([/* ... */]); $promise = $client->createChannelAsync
([/* ... */]);
Create a channel to start receiving content streams. The channel represents the input to MediaPackage for incoming live content from an encoder such as AWS Elemental MediaLive. The channel receives content, and after packaging it, outputs it through an origin endpoint to downstream devices (such as video players or CDNs) that request the content. You can create only one channel with each request. We recommend that you spread out channels between channel groups, such as putting redundant channels in the same AWS Region in different channel groups.
Parameter Syntax
$result = $client->createChannel([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'ClientToken' => '<string>', 'Description' => '<string>', 'InputSwitchConfiguration' => [ 'MQCSInputSwitching' => true || false, ], 'InputType' => 'HLS|CMAF', 'OutputHeaderConfiguration' => [ 'PublishMQCS' => true || false, ], 'Tags' => ['<string>', ...], ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group. You can't change the name after you create the channel.
- ClientToken
-
- Type: string
A unique, case-sensitive token that you provide to ensure the idempotency of the request.
- Description
-
- Type: string
Enter any descriptive text that helps you to identify the channel.
- InputSwitchConfiguration
-
- Type: InputSwitchConfiguration structure
The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when
InputType
isCMAF
. - InputType
-
- Type: string
The input type will be an immutable field which will be used to define whether the channel will allow CMAF ingest or HLS ingest. If unprovided, it will default to HLS to preserve current behavior.
The allowed values are:
-
HLS
- The HLS streaming specification (which defines M3U8 manifests and TS segments). -
CMAF
- The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
- OutputHeaderConfiguration
-
- Type: OutputHeaderConfiguration structure
The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when
InputType
isCMAF
. - Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A comma-separated list of tag key:value pairs that you define. For example:
"Key1": "Value1",
"Key2": "Value2"
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'ETag' => '<string>', 'IngestEndpoints' => [ [ 'Id' => '<string>', 'Url' => '<string>', ], // ... ], 'InputSwitchConfiguration' => [ 'MQCSInputSwitching' => true || false, ], 'InputType' => 'HLS|CMAF', 'ModifiedAt' => <DateTime>, 'OutputHeaderConfiguration' => [ 'PublishMQCS' => true || false, ], 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was created.
- Description
-
- Type: string
The description for your channel.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- IngestEndpoints
-
- Type: Array of IngestEndpoint structures
The list of ingest endpoints.
- InputSwitchConfiguration
-
- Type: InputSwitchConfiguration structure
The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when
InputType
isCMAF
. - InputType
-
- Type: string
The input type will be an immutable field which will be used to define whether the channel will allow CMAF ingest or HLS ingest. If unprovided, it will default to HLS to preserve current behavior.
The allowed values are:
-
HLS
- The HLS streaming specification (which defines M3U8 manifests and TS segments). -
CMAF
- The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was modified.
- OutputHeaderConfiguration
-
- Type: OutputHeaderConfiguration structure
The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when
InputType
isCMAF
. - Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the channel.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
- ServiceQuotaExceededException:
The request would cause a service quota to be exceeded.
Examples
Example 1: Creating a Channel
$result = $client->createChannel([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'Description' => 'Description for exampleChannel', 'InputType' => 'HLS', 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'CreatedAt' =>, 'Description' => 'Description for exampleChannel', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'IngestEndpoints' => [ [ 'Id' => '1', 'Url' => 'https://abcde-1.ingest.vwxyz.mediapackagev2.us-west-2.amazonaws.com/v1/exampleChannelGroup/exampleChannel/index', ], [ 'Id' => '2', 'Url' => 'https://abcde-2.ingest.vwxyz.mediapackagev2.us-west-2.amazonaws.com/v1/exampleChannelGroup/exampleChannel/index', ], ], 'InputType' => 'HLS', 'ModifiedAt' => , 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
CreateChannelGroup
$result = $client->createChannelGroup
([/* ... */]); $promise = $client->createChannelGroupAsync
([/* ... */]);
Create a channel group to group your channels and origin endpoints. A channel group is the top-level resource that consists of channels and origin endpoints that are associated with it and that provides predictable URLs for stream delivery. All channels and origin endpoints within the channel group are guaranteed to share the DNS. You can create only one channel group with each request.
Parameter Syntax
$result = $client->createChannelGroup([ 'ChannelGroupName' => '<string>', // REQUIRED 'ClientToken' => '<string>', 'Description' => '<string>', 'Tags' => ['<string>', ...], ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region. You can't use spaces in the name. You can't change the name after you create the channel group.
- ClientToken
-
- Type: string
A unique, case-sensitive token that you provide to ensure the idempotency of the request.
- Description
-
- Type: string
Enter any descriptive text that helps you to identify the channel group.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A comma-separated list of tag key:value pairs that you define. For example:
"Key1": "Value1",
"Key2": "Value2"
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'ETag' => '<string>', 'EgressDomain' => '<string>', 'ModifiedAt' => <DateTime>, 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was created.
- Description
-
- Type: string
The description for your channel group.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- EgressDomain
-
- Required: Yes
- Type: string
The output domain where the source stream should be sent. Integrate the egress domain with a downstream CDN (such as Amazon CloudFront) or playback device.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was modified.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the channel group.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
- ServiceQuotaExceededException:
The request would cause a service quota to be exceeded.
Examples
Example 1: Creating a Channel Group
$result = $client->createChannelGroup([ 'ChannelGroupName' => 'exampleChannelGroup', 'Description' => 'Description for exampleChannelGroup', 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup', 'ChannelGroupName' => 'exampleChannelGroup', 'CreatedAt' =>, 'Description' => 'Description for exampleChannelGroup', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'EgressDomain' => 'abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com', 'ModifiedAt' => , 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
CreateHarvestJob
$result = $client->createHarvestJob
([/* ... */]); $promise = $client->createHarvestJobAsync
([/* ... */]);
Creates a new harvest job to export content from a MediaPackage v2 channel to an S3 bucket.
Parameter Syntax
$result = $client->createHarvestJob([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'ClientToken' => '<string>', 'Description' => '<string>', 'Destination' => [ // REQUIRED 'S3Destination' => [ // REQUIRED 'BucketName' => '<string>', // REQUIRED 'DestinationPath' => '<string>', // REQUIRED ], ], 'HarvestJobName' => '<string>', 'HarvestedManifests' => [ // REQUIRED 'DashManifests' => [ [ 'ManifestName' => '<string>', // REQUIRED ], // ... ], 'HlsManifests' => [ [ 'ManifestName' => '<string>', // REQUIRED ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => '<string>', // REQUIRED ], // ... ], ], 'OriginEndpointName' => '<string>', // REQUIRED 'ScheduleConfiguration' => [ // REQUIRED 'EndTime' => <integer || string || DateTime>, // REQUIRED 'StartTime' => <integer || string || DateTime>, // REQUIRED ], 'Tags' => ['<string>', ...], ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name of the channel group containing the channel from which to harvest content.
- ChannelName
-
- Required: Yes
- Type: string
The name of the channel from which to harvest content.
- ClientToken
-
- Type: string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
- Description
-
- Type: string
An optional description for the harvest job.
- Destination
-
- Required: Yes
- Type: Destination structure
The S3 destination where the harvested content will be placed.
- HarvestJobName
-
- Type: string
A name for the harvest job. This name must be unique within the channel.
- HarvestedManifests
-
- Required: Yes
- Type: HarvestedManifests structure
A list of manifests to be harvested.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name of the origin endpoint from which to harvest content.
- ScheduleConfiguration
-
- Required: Yes
- Type: HarvesterScheduleConfiguration structure
The configuration for when the harvest job should run, including start and end times.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A collection of tags associated with the harvest job.
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'Destination' => [ 'S3Destination' => [ 'BucketName' => '<string>', 'DestinationPath' => '<string>', ], ], 'ETag' => '<string>', 'ErrorMessage' => '<string>', 'HarvestJobName' => '<string>', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], 'HlsManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], ], 'ModifiedAt' => <DateTime>, 'OriginEndpointName' => '<string>', 'ScheduleConfiguration' => [ 'EndTime' => <DateTime>, 'StartTime' => <DateTime>, ], 'Status' => 'QUEUED|IN_PROGRESS|CANCELLED|COMPLETED|FAILED', 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the created harvest job.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name of the channel group containing the channel from which content is being harvested.
- ChannelName
-
- Required: Yes
- Type: string
The name of the channel from which content is being harvested.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the harvest job was created.
- Description
-
- Type: string
The description of the harvest job, if provided.
- Destination
-
- Required: Yes
- Type: Destination structure
The S3 destination where the harvested content will be placed.
- ETag
-
- Type: string
The current version of the harvest job. Used for concurrency control.
- ErrorMessage
-
- Type: string
An error message if the harvest job creation failed.
- HarvestJobName
-
- Required: Yes
- Type: string
The name of the created harvest job.
- HarvestedManifests
-
- Required: Yes
- Type: HarvestedManifests structure
A list of manifests that will be harvested.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the harvest job was last modified.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name of the origin endpoint from which content is being harvested.
- ScheduleConfiguration
-
- Required: Yes
- Type: HarvesterScheduleConfiguration structure
The configuration for when the harvest job will run, including start and end times.
- Status
-
- Required: Yes
- Type: string
The current status of the harvest job (e.g., CREATED, IN_PROGRESS, ABORTED, COMPLETED, FAILED).
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A collection of tags associated with the harvest job.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
- ServiceQuotaExceededException:
The request would cause a service quota to be exceeded.
Examples
Example 1: Creating a Harvest Job
$result = $client->createHarvestJob([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'Description' => 'Example HarvestJob description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'OriginEndpointName' => 'exampleOriginEndpointName', 'ScheduleConfiguration' => [ 'EndTime' =>, 'StartTime' => , ], ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName/originEndpoint/exampleOriginEndpointName/harvestJob/HarvestJobName', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'CreatedAt' =>, 'Description' => 'Example HarvestJob description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'HarvestJobName' => 'HarvestJobName', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'QUEUED', 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
CreateOriginEndpoint
$result = $client->createOriginEndpoint
([/* ... */]); $promise = $client->createOriginEndpointAsync
([/* ... */]);
The endpoint is attached to a channel, and represents the output of the live content. You can associate multiple endpoints to a single channel. Each endpoint gives players and downstream CDNs (such as Amazon CloudFront) access to the content for playback. Content can't be served from a channel until it has an endpoint. You can create only one endpoint with each request.
Parameter Syntax
$result = $client->createOriginEndpoint([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'ClientToken' => '<string>', 'ContainerType' => 'TS|CMAF', // REQUIRED 'DashManifests' => [ [ 'DrmSignaling' => 'INDIVIDUAL|REFERENCED', 'FilterConfiguration' => [ 'ClipStartTime' => <integer || string || DateTime>, 'End' => <integer || string || DateTime>, 'ManifestFilter' => '<string>', 'Start' => <integer || string || DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', // REQUIRED 'ManifestWindowSeconds' => <integer>, 'MinBufferTimeSeconds' => <integer>, 'MinUpdatePeriodSeconds' => <integer>, 'PeriodTriggers' => ['<string>', ...], 'ScteDash' => [ 'AdMarkerDash' => 'BINARY|XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => <integer>, 'UtcTiming' => [ 'TimingMode' => 'HTTP_HEAD|HTTP_ISO|HTTP_XSDATE|UTC_DIRECT', 'TimingSource' => '<string>', ], ], // ... ], 'Description' => '<string>', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => ['<string>', ...], ], 'HlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <integer || string || DateTime>, 'End' => <integer || string || DateTime>, 'ManifestFilter' => '<string>', 'Start' => <integer || string || DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', // REQUIRED 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, // REQUIRED ], ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <integer || string || DateTime>, 'End' => <integer || string || DateTime>, 'ManifestFilter' => '<string>', 'Start' => <integer || string || DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', // REQUIRED 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, // REQUIRED ], ], // ... ], 'OriginEndpointName' => '<string>', // REQUIRED 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => '<string>', 'EncryptionMethod' => [ // REQUIRED 'CmafEncryptionMethod' => 'CENC|CBCS', 'TsEncryptionMethod' => 'AES_128|SAMPLE_AES', ], 'KeyRotationIntervalSeconds' => <integer>, 'SpekeKeyProvider' => [ // REQUIRED 'DrmSystems' => ['<string>', ...], // REQUIRED 'EncryptionContractConfiguration' => [ // REQUIRED 'PresetSpeke20Audio' => 'PRESET_AUDIO_1|PRESET_AUDIO_2|PRESET_AUDIO_3|SHARED|UNENCRYPTED', // REQUIRED 'PresetSpeke20Video' => 'PRESET_VIDEO_1|PRESET_VIDEO_2|PRESET_VIDEO_3|PRESET_VIDEO_4|PRESET_VIDEO_5|PRESET_VIDEO_6|PRESET_VIDEO_7|PRESET_VIDEO_8|SHARED|UNENCRYPTED', // REQUIRED ], 'ResourceId' => '<string>', // REQUIRED 'RoleArn' => '<string>', // REQUIRED 'Url' => '<string>', // REQUIRED ], ], 'IncludeIframeOnlyStreams' => true || false, 'Scte' => [ 'ScteFilter' => ['<string>', ...], ], 'SegmentDurationSeconds' => <integer>, 'SegmentName' => '<string>', 'TsIncludeDvbSubtitles' => true || false, 'TsUseAudioRenditionGroup' => true || false, ], 'StartoverWindowSeconds' => <integer>, 'Tags' => ['<string>', ...], ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ClientToken
-
- Type: string
A unique, case-sensitive token that you provide to ensure the idempotency of the request.
- ContainerType
-
- Required: Yes
- Type: string
The type of container to attach to this origin endpoint. A container type is a file format that encapsulates one or more media streams, such as audio and video, into a single file. You can't change the container type after you create the endpoint.
- DashManifests
-
- Type: Array of CreateDashManifestConfiguration structures
A DASH manifest configuration.
- Description
-
- Type: string
Enter any descriptive text that helps you to identify the origin endpoint.
- ForceEndpointErrorConfiguration
-
- Type: ForceEndpointErrorConfiguration structure
The failover settings for the endpoint.
- HlsManifests
-
- Type: Array of CreateHlsManifestConfiguration structures
An HTTP live streaming (HLS) manifest configuration.
- LowLatencyHlsManifests
-
- Type: Array of CreateLowLatencyHlsManifestConfiguration structures
A low-latency HLS manifest configuration.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and must be unique for your account in the AWS Region and channel. You can't use spaces in the name. You can't change the name after you create the endpoint.
- Segment
-
- Type: Segment structure
The segment configuration, including the segment name, duration, and other configuration values.
- StartoverWindowSeconds
-
- Type: int
The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window. The maximum startover window is 1,209,600 seconds (14 days).
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A comma-separated list of tag key:value pairs that you define. For example:
"Key1": "Value1",
"Key2": "Value2"
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'ContainerType' => 'TS|CMAF', 'CreatedAt' => <DateTime>, 'DashManifests' => [ [ 'DrmSignaling' => 'INDIVIDUAL|REFERENCED', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'MinBufferTimeSeconds' => <integer>, 'MinUpdatePeriodSeconds' => <integer>, 'PeriodTriggers' => ['<string>', ...], 'ScteDash' => [ 'AdMarkerDash' => 'BINARY|XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => <integer>, 'Url' => '<string>', 'UtcTiming' => [ 'TimingMode' => 'HTTP_HEAD|HTTP_ISO|HTTP_XSDATE|UTC_DIRECT', 'TimingSource' => '<string>', ], ], // ... ], 'Description' => '<string>', 'ETag' => '<string>', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => ['<string>', ...], ], 'HlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, ], 'Url' => '<string>', ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, ], 'Url' => '<string>', ], // ... ], 'ModifiedAt' => <DateTime>, 'OriginEndpointName' => '<string>', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => '<string>', 'EncryptionMethod' => [ 'CmafEncryptionMethod' => 'CENC|CBCS', 'TsEncryptionMethod' => 'AES_128|SAMPLE_AES', ], 'KeyRotationIntervalSeconds' => <integer>, 'SpekeKeyProvider' => [ 'DrmSystems' => ['<string>', ...], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'PRESET_AUDIO_1|PRESET_AUDIO_2|PRESET_AUDIO_3|SHARED|UNENCRYPTED', 'PresetSpeke20Video' => 'PRESET_VIDEO_1|PRESET_VIDEO_2|PRESET_VIDEO_3|PRESET_VIDEO_4|PRESET_VIDEO_5|PRESET_VIDEO_6|PRESET_VIDEO_7|PRESET_VIDEO_8|SHARED|UNENCRYPTED', ], 'ResourceId' => '<string>', 'RoleArn' => '<string>', 'Url' => '<string>', ], ], 'IncludeIframeOnlyStreams' => true || false, 'Scte' => [ 'ScteFilter' => ['<string>', ...], ], 'SegmentDurationSeconds' => <integer>, 'SegmentName' => '<string>', 'TsIncludeDvbSubtitles' => true || false, 'TsUseAudioRenditionGroup' => true || false, ], 'StartoverWindowSeconds' => <integer>, 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ContainerType
-
- Required: Yes
- Type: string
The type of container attached to this origin endpoint.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was created.
- DashManifests
-
- Type: Array of GetDashManifestConfiguration structures
A DASH manifest configuration.
- Description
-
- Type: string
The description for your origin endpoint.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- ForceEndpointErrorConfiguration
-
- Type: ForceEndpointErrorConfiguration structure
The failover settings for the endpoint.
- HlsManifests
-
- Type: Array of GetHlsManifestConfiguration structures
An HTTP live streaming (HLS) manifest configuration.
- LowLatencyHlsManifests
-
- Type: Array of GetLowLatencyHlsManifestConfiguration structures
A low-latency HLS manifest configuration.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was modified.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
- Segment
-
- Required: Yes
- Type: Segment structure
The segment configuration, including the segment name, duration, and other configuration values.
- StartoverWindowSeconds
-
- Type: int
The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the origin endpoint.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
- ServiceQuotaExceededException:
The request would cause a service quota to be exceeded.
Examples
Example 1: Creating an OriginEndpoint with container type TS, and encryption enabled
$result = $client->createOriginEndpoint([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'TS', 'Description' => 'Description for exampleOriginEndpointTS', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], ], 'OriginEndpointName' => 'exampleOriginEndpointTS', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => 'A382A901F3C1F7718512266CFFBB0B7E', 'EncryptionMethod' => [ 'TsEncryptionMethod' => 'AES_128', ], 'KeyRotationIntervalSeconds' => 300, 'SpekeKeyProvider' => [ 'DrmSystems' => [ 'CLEAR_KEY_AES_128', ], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'SHARED', 'PresetSpeke20Video' => 'SHARED', ], 'ResourceId' => 'ResourceId', 'RoleArn' => 'arn:aws:iam::123456789012:role/empRole', 'Url' => 'https://foo.com', ], ], 'IncludeIframeOnlyStreams' => 1, 'Scte' => [ 'ScteFilter' => [ 'SPLICE_INSERT', 'BREAK', ], ], 'SegmentDurationSeconds' => 6, 'SegmentName' => 'segmentName', 'TsIncludeDvbSubtitles' => 1, 'TsUseAudioRenditionGroup' => 1, ], 'StartoverWindowSeconds' => 300, 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel/originEndpoint/exampleOriginEndpointTS', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'TS', 'CreatedAt' =>, 'Description' => 'Description for exampleOriginEndpointTS', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest2.m3u8', ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest2.m3u8', ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointTS', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => 'A382A901F3C1F7718512266CFFBB0B7E', 'EncryptionMethod' => [ 'TsEncryptionMethod' => 'AES_128', ], 'KeyRotationIntervalSeconds' => 300, 'SpekeKeyProvider' => [ 'DrmSystems' => [ 'CLEAR_KEY_AES_128', ], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'SHARED', 'PresetSpeke20Video' => 'SHARED', ], 'ResourceId' => 'ResourceId', 'RoleArn' => 'arn:aws:iam::123456789012:role/empRole', 'Url' => 'https://foo.com', ], ], 'IncludeIframeOnlyStreams' => 1, 'Scte' => [ 'ScteFilter' => [ 'SPLICE_INSERT', 'BREAK', ], ], 'SegmentDurationSeconds' => 6, 'SegmentName' => 'segmentName', 'TsIncludeDvbSubtitles' => 1, 'TsUseAudioRenditionGroup' => 1, ], 'StartoverWindowSeconds' => 300, 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
Example 2: Creating an OriginEndpoint with container type CMAF, and encryption enabled
$result = $client->createOriginEndpoint([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'CMAF', 'DashManifests' => [ [ 'DrmSignaling' => 'INDIVIDUAL', 'ManifestName' => 'exampleDashManifest1', 'ManifestWindowSeconds' => 300, 'MinBufferTimeSeconds' => 30, 'MinUpdatePeriodSeconds' => 5, 'PeriodTriggers' => [ 'AVAILS', ], 'ScteDash' => [ 'AdMarkerDash' => 'XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => 2, ], [ 'DrmSignaling' => 'INDIVIDUAL', 'ManifestName' => 'exampleDashManifest2', 'ManifestWindowSeconds' => 60, 'MinBufferTimeSeconds' => 9, 'MinUpdatePeriodSeconds' => 3, 'PeriodTriggers' => [ 'AVAILS', 'DRM_KEY_ROTATION', 'SOURCE_CHANGES', 'SOURCE_DISRUPTIONS', ], 'ScteDash' => [ 'AdMarkerDash' => 'XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => 12, ], ], 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], ], 'OriginEndpointName' => 'exampleOriginEndpointCMAF', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => 'A382A901F3C1F7718512266CFFBB0B9F', 'EncryptionMethod' => [ 'CmafEncryptionMethod' => 'CBCS', ], 'KeyRotationIntervalSeconds' => 300, 'SpekeKeyProvider' => [ 'DrmSystems' => [ 'PLAYREADY', 'WIDEVINE', ], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'PRESET_AUDIO_1', 'PresetSpeke20Video' => 'PRESET_VIDEO_1', ], 'ResourceId' => 'ResourceId', 'RoleArn' => 'arn:aws:iam::123456789012:role/empRole', 'Url' => 'https://foo.com', ], ], 'IncludeIframeOnlyStreams' => 1, 'Scte' => [ 'ScteFilter' => [ 'SPLICE_INSERT', 'BREAK', ], ], 'SegmentDurationSeconds' => 6, 'SegmentName' => 'segmentName', ], 'StartoverWindowSeconds' => 300, 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel/originEndpoint/exampleOriginEndpointCMAF', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'CMAF', 'CreatedAt' =>, 'DashManifests' => [ [ 'DrmSignaling' => 'INDIVIDUAL', 'ManifestName' => 'exampleDashManifest1', 'ManifestWindowSeconds' => 300, 'MinBufferTimeSeconds' => 30, 'MinUpdatePeriodSeconds' => 5, 'PeriodTriggers' => [ 'AVAILS', ], 'ScteDash' => [ 'AdMarkerDash' => 'XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => 2, 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleDashManifest1.mpd', ], [ 'DrmSignaling' => 'INDIVIDUAL', 'ManifestName' => 'exampleDashManifest2', 'ManifestWindowSeconds' => 60, 'MinBufferTimeSeconds' => 9, 'MinUpdatePeriodSeconds' => 3, 'PeriodTriggers' => [ 'AVAILS', 'DRM_KEY_ROTATION', 'SOURCE_CHANGES', 'SOURCE_DISRUPTIONS', ], 'ScteDash' => [ 'AdMarkerDash' => 'XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => 12, 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleDashManifest2.mpd', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleManifest2.m3u8', ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleLLManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleLLManifest2.m3u8', ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointCMAF', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => 'A382A901F3C1F7718512266CFFBB0B9F', 'EncryptionMethod' => [ 'CmafEncryptionMethod' => 'CBCS', ], 'KeyRotationIntervalSeconds' => 300, 'SpekeKeyProvider' => [ 'DrmSystems' => [ 'PLAYREADY', 'WIDEVINE', ], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'PRESET_AUDIO_1', 'PresetSpeke20Video' => 'PRESET_VIDEO_1', ], 'ResourceId' => 'ResourceId', 'RoleArn' => 'arn:aws:iam::123456789012:role/empRole', 'Url' => 'https://foo.com', ], ], 'IncludeIframeOnlyStreams' => 1, 'Scte' => [ 'ScteFilter' => [ 'SPLICE_INSERT', 'BREAK', ], ], 'SegmentDurationSeconds' => 6, 'SegmentName' => 'segmentName', ], 'StartoverWindowSeconds' => 300, 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
DeleteChannel
$result = $client->deleteChannel
([/* ... */]); $promise = $client->deleteChannelAsync
([/* ... */]);
Delete a channel to stop AWS Elemental MediaPackage from receiving further content. You must delete the channel's origin endpoints before you can delete the channel.
Parameter Syntax
$result = $client->deleteChannel([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Deleting a Channel
$result = $client->deleteChannel([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', ]);
Result syntax:
[ ]
DeleteChannelGroup
$result = $client->deleteChannelGroup
([/* ... */]); $promise = $client->deleteChannelGroupAsync
([/* ... */]);
Delete a channel group. You must delete the channel group's channels and origin endpoints before you can delete the channel group. If you delete a channel group, you'll lose access to the egress domain and will have to create a new channel group to replace it.
Parameter Syntax
$result = $client->deleteChannelGroup([ 'ChannelGroupName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Deleting a Channel Group
$result = $client->deleteChannelGroup([ 'ChannelGroupName' => 'exampleChannelGroup', ]);
Result syntax:
[ ]
DeleteChannelPolicy
$result = $client->deleteChannelPolicy
([/* ... */]); $promise = $client->deleteChannelPolicyAsync
([/* ... */]);
Delete a channel policy.
Parameter Syntax
$result = $client->deleteChannelPolicy([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Deleting a Channel Policy
$result = $client->deleteChannelPolicy([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', ]);
Result syntax:
[ ]
DeleteOriginEndpoint
$result = $client->deleteOriginEndpoint
([/* ... */]); $promise = $client->deleteOriginEndpointAsync
([/* ... */]);
Origin endpoints can serve content until they're deleted. Delete the endpoint if it should no longer respond to playback requests. You must delete all endpoints from a channel before you can delete the channel.
Parameter Syntax
$result = $client->deleteOriginEndpoint([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'OriginEndpointName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Deleting an OriginEndpoint
$result = $client->deleteOriginEndpoint([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'OriginEndpointName' => 'exampleOriginEndpointTS', ]);
Result syntax:
[ ]
DeleteOriginEndpointPolicy
$result = $client->deleteOriginEndpointPolicy
([/* ... */]); $promise = $client->deleteOriginEndpointPolicyAsync
([/* ... */]);
Delete an origin endpoint policy.
Parameter Syntax
$result = $client->deleteOriginEndpointPolicy([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'OriginEndpointName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Deleting an Origin Endpoint Policy
$result = $client->deleteOriginEndpointPolicy([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'OriginEndpointName' => 'exampleOriginEndpoint', ]);
Result syntax:
[ ]
GetChannel
$result = $client->getChannel
([/* ... */]); $promise = $client->getChannelAsync
([/* ... */]);
Retrieves the specified channel that's configured in AWS Elemental MediaPackage, including the origin endpoints that are associated with it.
Parameter Syntax
$result = $client->getChannel([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'ETag' => '<string>', 'IngestEndpoints' => [ [ 'Id' => '<string>', 'Url' => '<string>', ], // ... ], 'InputSwitchConfiguration' => [ 'MQCSInputSwitching' => true || false, ], 'InputType' => 'HLS|CMAF', 'ModifiedAt' => <DateTime>, 'OutputHeaderConfiguration' => [ 'PublishMQCS' => true || false, ], 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was created.
- Description
-
- Type: string
The description for your channel.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- IngestEndpoints
-
- Type: Array of IngestEndpoint structures
The list of ingest endpoints.
- InputSwitchConfiguration
-
- Type: InputSwitchConfiguration structure
The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when
InputType
isCMAF
. - InputType
-
- Type: string
The input type will be an immutable field which will be used to define whether the channel will allow CMAF ingest or HLS ingest. If unprovided, it will default to HLS to preserve current behavior.
The allowed values are:
-
HLS
- The HLS streaming specification (which defines M3U8 manifests and TS segments). -
CMAF
- The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was modified.
- OutputHeaderConfiguration
-
- Type: OutputHeaderConfiguration structure
The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when
InputType
isCMAF
. - Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the channel.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Getting a Channel
$result = $client->getChannel([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'CreatedAt' =>, 'Description' => 'Description for exampleChannel', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'IngestEndpoints' => [ [ 'Id' => '1', 'Url' => 'https://abcde-1.ingest.vwxyz.mediapackagev2.us-west-2.amazonaws.com/v1/exampleChannelGroup/exampleChannel/index', ], [ 'Id' => '2', 'Url' => 'https://abcde-2.ingest.vwxyz.mediapackagev2.us-west-2.amazonaws.com/v1/exampleChannelGroup/exampleChannel/index', ], ], 'InputType' => 'HLS', 'ModifiedAt' => , 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
GetChannelGroup
$result = $client->getChannelGroup
([/* ... */]); $promise = $client->getChannelGroupAsync
([/* ... */]);
Retrieves the specified channel group that's configured in AWS Elemental MediaPackage, including the channels and origin endpoints that are associated with it.
Parameter Syntax
$result = $client->getChannelGroup([ 'ChannelGroupName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'ETag' => '<string>', 'EgressDomain' => '<string>', 'ModifiedAt' => <DateTime>, 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was created.
- Description
-
- Type: string
The description for your channel group.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- EgressDomain
-
- Required: Yes
- Type: string
The output domain where the source stream should be sent. Integrate the domain with a downstream CDN (such as Amazon CloudFront) or playback device.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was modified.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the channel group.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Getting a Channel Group
$result = $client->getChannelGroup([ 'ChannelGroupName' => 'exampleChannelGroup', ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup', 'ChannelGroupName' => 'exampleChannelGroup', 'CreatedAt' =>, 'Description' => 'Description for exampleChannelGroup', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'EgressDomain' => 'abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com', 'ModifiedAt' => , 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
GetChannelPolicy
$result = $client->getChannelPolicy
([/* ... */]); $promise = $client->getChannelPolicyAsync
([/* ... */]);
Retrieves the specified channel policy that's configured in AWS Elemental MediaPackage. With policies, you can specify who has access to AWS resources and what actions they can perform on those resources.
Parameter Syntax
$result = $client->getChannelPolicy([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
Result Syntax
[ 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'Policy' => '<string>', ]
Result Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- Policy
-
- Required: Yes
- Type: string
The policy assigned to the channel.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Getting a Channel Policy
$result = $client->getChannelPolicy([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', ]);
Result syntax:
[ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'Policy' => '{...}', ]
GetHarvestJob
$result = $client->getHarvestJob
([/* ... */]); $promise = $client->getHarvestJobAsync
([/* ... */]);
Retrieves the details of a specific harvest job.
Parameter Syntax
$result = $client->getHarvestJob([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'HarvestJobName' => '<string>', // REQUIRED 'OriginEndpointName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name of the channel group containing the channel associated with the harvest job.
- ChannelName
-
- Required: Yes
- Type: string
The name of the channel associated with the harvest job.
- HarvestJobName
-
- Required: Yes
- Type: string
The name of the harvest job to retrieve.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name of the origin endpoint associated with the harvest job.
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'Destination' => [ 'S3Destination' => [ 'BucketName' => '<string>', 'DestinationPath' => '<string>', ], ], 'ETag' => '<string>', 'ErrorMessage' => '<string>', 'HarvestJobName' => '<string>', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], 'HlsManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], ], 'ModifiedAt' => <DateTime>, 'OriginEndpointName' => '<string>', 'ScheduleConfiguration' => [ 'EndTime' => <DateTime>, 'StartTime' => <DateTime>, ], 'Status' => 'QUEUED|IN_PROGRESS|CANCELLED|COMPLETED|FAILED', 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the harvest job.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name of the channel group containing the channel associated with the harvest job.
- ChannelName
-
- Required: Yes
- Type: string
The name of the channel associated with the harvest job.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the harvest job was created.
- Description
-
- Type: string
The description of the harvest job, if provided.
- Destination
-
- Required: Yes
- Type: Destination structure
The S3 destination where the harvested content is being placed.
- ETag
-
- Type: string
The current version of the harvest job. Used for concurrency control.
- ErrorMessage
-
- Type: string
An error message if the harvest job encountered any issues.
- HarvestJobName
-
- Required: Yes
- Type: string
The name of the harvest job.
- HarvestedManifests
-
- Required: Yes
- Type: HarvestedManifests structure
A list of manifests that are being or have been harvested.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the harvest job was last modified.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name of the origin endpoint associated with the harvest job.
- ScheduleConfiguration
-
- Required: Yes
- Type: HarvesterScheduleConfiguration structure
The configuration for when the harvest job is scheduled to run, including start and end times.
- Status
-
- Required: Yes
- Type: string
The current status of the harvest job (e.g., QUEUED, IN_PROGRESS, CANCELLED, COMPLETED, FAILED).
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
A collection of tags associated with the harvest job.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Getting a Harvest Job
$result = $client->getHarvestJob([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'HarvestJobName' => 'HarvestJobName', 'OriginEndpointName' => 'exampleOriginEndpointName', ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName/originEndpoint/exampleOriginEndpointName/harvestJob/HarvestJobName', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'CreatedAt' =>, 'Description' => 'Example HarvestJob description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'HarvestJobName' => 'HarvestJobName', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'QUEUED', 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
GetOriginEndpoint
$result = $client->getOriginEndpoint
([/* ... */]); $promise = $client->getOriginEndpointAsync
([/* ... */]);
Retrieves the specified origin endpoint that's configured in AWS Elemental MediaPackage to obtain its playback URL and to view the packaging settings that it's currently using.
Parameter Syntax
$result = $client->getOriginEndpoint([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'OriginEndpointName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'ContainerType' => 'TS|CMAF', 'CreatedAt' => <DateTime>, 'DashManifests' => [ [ 'DrmSignaling' => 'INDIVIDUAL|REFERENCED', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'MinBufferTimeSeconds' => <integer>, 'MinUpdatePeriodSeconds' => <integer>, 'PeriodTriggers' => ['<string>', ...], 'ScteDash' => [ 'AdMarkerDash' => 'BINARY|XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => <integer>, 'Url' => '<string>', 'UtcTiming' => [ 'TimingMode' => 'HTTP_HEAD|HTTP_ISO|HTTP_XSDATE|UTC_DIRECT', 'TimingSource' => '<string>', ], ], // ... ], 'Description' => '<string>', 'ETag' => '<string>', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => ['<string>', ...], ], 'HlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, ], 'Url' => '<string>', ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, ], 'Url' => '<string>', ], // ... ], 'ModifiedAt' => <DateTime>, 'OriginEndpointName' => '<string>', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => '<string>', 'EncryptionMethod' => [ 'CmafEncryptionMethod' => 'CENC|CBCS', 'TsEncryptionMethod' => 'AES_128|SAMPLE_AES', ], 'KeyRotationIntervalSeconds' => <integer>, 'SpekeKeyProvider' => [ 'DrmSystems' => ['<string>', ...], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'PRESET_AUDIO_1|PRESET_AUDIO_2|PRESET_AUDIO_3|SHARED|UNENCRYPTED', 'PresetSpeke20Video' => 'PRESET_VIDEO_1|PRESET_VIDEO_2|PRESET_VIDEO_3|PRESET_VIDEO_4|PRESET_VIDEO_5|PRESET_VIDEO_6|PRESET_VIDEO_7|PRESET_VIDEO_8|SHARED|UNENCRYPTED', ], 'ResourceId' => '<string>', 'RoleArn' => '<string>', 'Url' => '<string>', ], ], 'IncludeIframeOnlyStreams' => true || false, 'Scte' => [ 'ScteFilter' => ['<string>', ...], ], 'SegmentDurationSeconds' => <integer>, 'SegmentName' => '<string>', 'TsIncludeDvbSubtitles' => true || false, 'TsUseAudioRenditionGroup' => true || false, ], 'StartoverWindowSeconds' => <integer>, 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ContainerType
-
- Required: Yes
- Type: string
The type of container attached to this origin endpoint.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was created.
- DashManifests
-
- Type: Array of GetDashManifestConfiguration structures
A DASH manifest configuration.
- Description
-
- Type: string
The description for your origin endpoint.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- ForceEndpointErrorConfiguration
-
- Type: ForceEndpointErrorConfiguration structure
The failover settings for the endpoint.
- HlsManifests
-
- Type: Array of GetHlsManifestConfiguration structures
An HTTP live streaming (HLS) manifest configuration.
- LowLatencyHlsManifests
-
- Type: Array of GetLowLatencyHlsManifestConfiguration structures
A low-latency HLS manifest configuration.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was modified.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
- Segment
-
- Required: Yes
- Type: Segment structure
The segment configuration, including the segment name, duration, and other configuration values.
- StartoverWindowSeconds
-
- Type: int
The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the origin endpoint.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Getting an OriginEndpoint
$result = $client->getOriginEndpoint([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'OriginEndpointName' => 'exampleOriginEndpointTS', ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel/originEndpoint/exampleOriginEndpointTS', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'TS', 'CreatedAt' =>, 'Description' => 'Description for exampleOriginEndpointTS', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest2.m3u8', ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest2.m3u8', ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointTS', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => 'A382A901F3C1F7718512266CFFBB0B7E', 'EncryptionMethod' => [ 'TsEncryptionMethod' => 'AES_128', ], 'KeyRotationIntervalSeconds' => 300, 'SpekeKeyProvider' => [ 'DrmSystems' => [ 'CLEAR_KEY_AES_128', ], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'SHARED', 'PresetSpeke20Video' => 'SHARED', ], 'ResourceId' => 'ResourceId', 'RoleArn' => 'arn:aws:iam::123456789012:role/empRole', 'Url' => 'https://foo.com', ], ], 'IncludeIframeOnlyStreams' => 1, 'Scte' => [ 'ScteFilter' => [ 'SPLICE_INSERT', 'BREAK', ], ], 'SegmentDurationSeconds' => 6, 'SegmentName' => 'segmentName', 'TsIncludeDvbSubtitles' => 1, 'TsUseAudioRenditionGroup' => 1, ], 'StartoverWindowSeconds' => 300, 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
GetOriginEndpointPolicy
$result = $client->getOriginEndpointPolicy
([/* ... */]); $promise = $client->getOriginEndpointPolicyAsync
([/* ... */]);
Retrieves the specified origin endpoint policy that's configured in AWS Elemental MediaPackage.
Parameter Syntax
$result = $client->getOriginEndpointPolicy([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'OriginEndpointName' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
Result Syntax
[ 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'OriginEndpointName' => '<string>', 'Policy' => '<string>', ]
Result Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
- Policy
-
- Required: Yes
- Type: string
The policy assigned to the origin endpoint.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Getting an Origin Endpoint Policy
$result = $client->getOriginEndpointPolicy([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'OriginEndpointName' => 'exampleOriginEndpoint', ]);
Result syntax:
[ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'OriginEndpointName' => 'exampleOriginEndpoint', 'Policy' => '{...}', ]
ListChannelGroups
$result = $client->listChannelGroups
([/* ... */]); $promise = $client->listChannelGroupsAsync
([/* ... */]);
Retrieves all channel groups that are configured in AWS Elemental MediaPackage, including the channels and origin endpoints that are associated with it.
Parameter Syntax
$result = $client->listChannelGroups([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of results to return in the response.
- NextToken
-
- Type: string
The pagination token from the GET list request. Use the token to fetch the next page of results.
Result Syntax
[ 'Items' => [ [ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'ModifiedAt' => <DateTime>, ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Items
-
- Type: Array of ChannelGroupListConfiguration structures
The objects being returned.
- NextToken
-
- Type: string
The pagination token from the GET list request. Use the token to fetch the next page of results.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Listing all Channel Groups
$result = $client->listChannelGroups([ ]);
Result syntax:
[ 'Items' => [ [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup', 'ChannelGroupName' => 'exampleChannelGroup', 'CreatedAt' =>, 'Description' => 'Description for exampleChannelGroup', 'ModifiedAt' => , ], [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/anotherExampleChannelGroup', 'ChannelGroupName' => 'anotherExampleChannelGroup', 'CreatedAt' => , 'ModifiedAt' => , ], ], ]
ListChannels
$result = $client->listChannels
([/* ... */]); $promise = $client->listChannelsAsync
([/* ... */]);
Retrieves all channels in a specific channel group that are configured in AWS Elemental MediaPackage, including the origin endpoints that are associated with it.
Parameter Syntax
$result = $client->listChannels([ 'ChannelGroupName' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- MaxResults
-
- Type: int
The maximum number of results to return in the response.
- NextToken
-
- Type: string
The pagination token from the GET list request. Use the token to fetch the next page of results.
Result Syntax
[ 'Items' => [ [ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'InputType' => 'HLS|CMAF', 'ModifiedAt' => <DateTime>, ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Items
-
- Type: Array of ChannelListConfiguration structures
The objects being returned.
- NextToken
-
- Type: string
The pagination token from the GET list request.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Listing all Channels
$result = $client->listChannels([ 'ChannelGroupName' => 'exampleChannelGroup', ]);
Result syntax:
[ 'Items' => [ [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'CreatedAt' =>, 'Description' => 'Description for exampleChannel', 'ModifiedAt' => , ], [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/anotherExampleChannel', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'anotherExampleChannel', 'CreatedAt' => , 'ModifiedAt' => , ], ], ]
ListHarvestJobs
$result = $client->listHarvestJobs
([/* ... */]); $promise = $client->listHarvestJobsAsync
([/* ... */]);
Retrieves a list of harvest jobs that match the specified criteria.
Parameter Syntax
$result = $client->listHarvestJobs([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', 'MaxResults' => <integer>, 'NextToken' => '<string>', 'OriginEndpointName' => '<string>', 'Status' => 'QUEUED|IN_PROGRESS|CANCELLED|COMPLETED|FAILED', ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name of the channel group to filter the harvest jobs by. If specified, only harvest jobs associated with channels in this group will be returned.
- ChannelName
-
- Type: string
The name of the channel to filter the harvest jobs by. If specified, only harvest jobs associated with this channel will be returned.
- MaxResults
-
- Type: int
The maximum number of harvest jobs to return in a single request. If not specified, a default value will be used.
- NextToken
-
- Type: string
A token used for pagination. Provide this value in subsequent requests to retrieve the next set of results.
- OriginEndpointName
-
- Type: string
The name of the origin endpoint to filter the harvest jobs by. If specified, only harvest jobs associated with this origin endpoint will be returned.
- Status
-
- Type: string
The status to filter the harvest jobs by. If specified, only harvest jobs with this status will be returned.
Result Syntax
[ 'Items' => [ [ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'Destination' => [ 'S3Destination' => [ 'BucketName' => '<string>', 'DestinationPath' => '<string>', ], ], 'ETag' => '<string>', 'ErrorMessage' => '<string>', 'HarvestJobName' => '<string>', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], 'HlsManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => '<string>', ], // ... ], ], 'ModifiedAt' => <DateTime>, 'OriginEndpointName' => '<string>', 'ScheduleConfiguration' => [ 'EndTime' => <DateTime>, 'StartTime' => <DateTime>, ], 'Status' => 'QUEUED|IN_PROGRESS|CANCELLED|COMPLETED|FAILED', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Items
-
- Type: Array of HarvestJob structures
An array of harvest job objects that match the specified criteria.
- NextToken
-
- Type: string
A token used for pagination. Include this value in subsequent requests to retrieve the next set of results. If null, there are no more results to retrieve.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: ListHarvestJobs: Specify ChannelGroup only
$result = $client->listHarvestJobs([ 'ChannelGroupName' => 'exampleChannelGroup', ]);
Result syntax:
[ 'Items' => [ [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName/originEndpoint/exampleOriginEndpointName/harvestJob/HarvestJobName', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'CreatedAt' =>, 'Description' => 'Example HarvestJob description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'HarvestJobName' => 'HarvestJobName', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'QUEUED', ], [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName2/originEndpoint/exampleOriginEndpointName2/harvestJob/HarvestJobName2', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName2', 'CreatedAt' => , 'Description' => 'Example HarvestJob2 description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'HarvestJobName' => 'HarvestJobName2', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName2', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'IN_PROGRESS', ], ], 'NextToken' => 'someTokenValue', ]
Example 2: ListHarvestJobs: Specify ChannelGroup, Channel only
$result = $client->listHarvestJobs([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', ]);
Result syntax:
[ 'Items' => [ [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName/originEndpoint/exampleOriginEndpointName/harvestJob/HarvestJobName', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'CreatedAt' =>, 'Description' => 'Example HarvestJob description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'HarvestJobName' => 'HarvestJobName', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'QUEUED', ], [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName/originEndpoint/exampleOriginEndpointName2/harvestJob/HarvestJobName2', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'CreatedAt' => , 'Description' => 'Example HarvestJob2 description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'HarvestJobName' => 'HarvestJobName2', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName2', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'IN_PROGRESS', ], ], 'NextToken' => 'someTokenValue', ]
Example 3: ListHarvestJobs: Specify ChannelGroup, Channel, OriginEndpoint
$result = $client->listHarvestJobs([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'OriginEndpointName' => 'exampleOriginEndpointName', ]);
Result syntax:
[ 'Items' => [ [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName/originEndpoint/exampleOriginEndpointName/harvestJob/HarvestJobName', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'CreatedAt' =>, 'Description' => 'Example HarvestJob description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'HarvestJobName' => 'HarvestJobName', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'QUEUED', ], ], 'NextToken' => 'someTokenValue', ]
Example 4: ListHarvestJobs: Specify ChannelGroup, Channel, OriginEndpoint + Status filter
$result = $client->listHarvestJobs([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'OriginEndpointName' => 'exampleOriginEndpointName', 'Status' => 'QUEUED', ]);
Result syntax:
[ 'Items' => [ [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannelName/originEndpoint/exampleOriginEndpointName/harvestJob/HarvestJobName', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'CreatedAt' =>, 'Description' => 'Example HarvestJob description', 'Destination' => [ 'S3Destination' => [ 'BucketName' => 'harvestJobS3DestinationBucket', 'DestinationPath' => 'manifests', ], ], 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'HarvestJobName' => 'HarvestJobName', 'HarvestedManifests' => [ 'DashManifests' => [ [ 'ManifestName' => 'DashManifest', ], ], 'HlsManifests' => [ [ 'ManifestName' => 'HlsManifest', ], ], 'LowLatencyHlsManifests' => [ [ 'ManifestName' => 'LowLatencyHlsManifest', ], ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointName', 'ScheduleConfiguration' => [ 'EndTime' => , 'StartTime' => , ], 'Status' => 'QUEUED', ], ], 'NextToken' => 'someTokenValue', ]
Example 5: ListHarvestJobs: Empty response
$result = $client->listHarvestJobs([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannelName', 'OriginEndpointName' => 'exampleOriginEndpointName', ]);
Result syntax:
[ ]
ListOriginEndpoints
$result = $client->listOriginEndpoints
([/* ... */]); $promise = $client->listOriginEndpointsAsync
([/* ... */]);
Retrieves all origin endpoints in a specific channel that are configured in AWS Elemental MediaPackage.
Parameter Syntax
$result = $client->listOriginEndpoints([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- MaxResults
-
- Type: int
The maximum number of results to return in the response.
- NextToken
-
- Type: string
The pagination token from the GET list request. Use the token to fetch the next page of results.
Result Syntax
[ 'Items' => [ [ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'ContainerType' => 'TS|CMAF', 'CreatedAt' => <DateTime>, 'DashManifests' => [ [ 'ManifestName' => '<string>', 'Url' => '<string>', ], // ... ], 'Description' => '<string>', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => ['<string>', ...], ], 'HlsManifests' => [ [ 'ChildManifestName' => '<string>', 'ManifestName' => '<string>', 'Url' => '<string>', ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => '<string>', 'ManifestName' => '<string>', 'Url' => '<string>', ], // ... ], 'ModifiedAt' => <DateTime>, 'OriginEndpointName' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Items
-
- Type: Array of OriginEndpointListConfiguration structures
The objects being returned.
- NextToken
-
- Type: string
The pagination token from the GET list request. Use the token to fetch the next page of results.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Listing all OriginEndpoints
$result = $client->listOriginEndpoints([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', ]);
Result syntax:
[ 'Items' => [ [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel/originEndpoint/exampleOriginEndpointTS', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'TS', 'CreatedAt' =>, 'Description' => 'Description for exampleOriginEndpointTS', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest2.m3u8', ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest2.m3u8', ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointTS', ], [ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel/originEndpoint/exampleOriginEndpointCMAF', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'CMAF', 'CreatedAt' => , 'DashManifests' => [ [ 'ManifestName' => 'exampleDashManifest1', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleDashManifest1.mpd', ], [ 'ManifestName' => 'exampleDashManifest2', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleDashManifest2.mpd', ], ], 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleManifest2.m3u8', ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleLLManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointCMAF/exampleLLManifest2.m3u8', ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointCMAF', ], ], ]
ListTagsForResource
$result = $client->listTagsForResource
([/* ... */]); $promise = $client->listTagsForResourceAsync
([/* ... */]);
Lists the tags assigned to a resource.
Parameter Syntax
$result = $client->listTagsForResource([ 'ResourceArn' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ResourceArn
-
- Required: Yes
- Type: string
The ARN of the CloudWatch resource that you want to view tags for.
Result Syntax
[ 'Tags' => ['<string>', ...], ]
Result Details
Members
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
Contains a map of the key-value pairs for the resource tag or tags assigned to the resource.
Errors
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: List all tags for a resource
$result = $client->listTagsForResource([ 'ResourceArn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel', ]);
Result syntax:
[ 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
PutChannelPolicy
$result = $client->putChannelPolicy
([/* ... */]); $promise = $client->putChannelPolicyAsync
([/* ... */]);
Attaches an IAM policy to the specified channel. With policies, you can specify who has access to AWS resources and what actions they can perform on those resources. You can attach only one policy with each request.
Parameter Syntax
$result = $client->putChannelPolicy([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'Policy' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- Policy
-
- Required: Yes
- Type: string
The policy to attach to the specified channel.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Creating a Channel Policy
$result = $client->putChannelPolicy([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'Policy' => '{...}', ]);
Result syntax:
[ ]
PutOriginEndpointPolicy
$result = $client->putOriginEndpointPolicy
([/* ... */]); $promise = $client->putOriginEndpointPolicyAsync
([/* ... */]);
Attaches an IAM policy to the specified origin endpoint. You can attach only one policy with each request.
Parameter Syntax
$result = $client->putOriginEndpointPolicy([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'OriginEndpointName' => '<string>', // REQUIRED 'Policy' => '<string>', // REQUIRED ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
- Policy
-
- Required: Yes
- Type: string
The policy to attach to the specified origin endpoint.
Result Syntax
[]
Result Details
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Creating an Origin Endpoint Policy
$result = $client->putOriginEndpointPolicy([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'OriginEndpointName' => 'exampleOriginEndpoint', 'Policy' => '{...}', ]);
Result syntax:
[ ]
TagResource
$result = $client->tagResource
([/* ... */]); $promise = $client->tagResourceAsync
([/* ... */]);
Assigns one of more tags (key-value pairs) to the specified MediaPackage resource.
Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with certain tag values. You can use the TagResource operation with a resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value that you specify replaces the previous value for that tag.
Parameter Syntax
$result = $client->tagResource([ 'ResourceArn' => '<string>', // REQUIRED 'Tags' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- ResourceArn
-
- Required: Yes
- Type: string
The ARN of the MediaPackage resource that you're adding tags to.
- Tags
-
- Required: Yes
- Type: Associative array of custom strings keys (TagKey) to strings
Contains a map of the key-value pairs for the resource tag or tags assigned to the resource.
Result Syntax
[]
Result Details
Errors
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Add tags to a resource
$result = $client->tagResource([ 'ResourceArn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel', 'Tags' => [ 'key3' => 'value3', 'key4' => 'value4', ], ]);
Result syntax:
[ ]
UntagResource
$result = $client->untagResource
([/* ... */]); $promise = $client->untagResourceAsync
([/* ... */]);
Removes one or more tags from the specified resource.
Parameter Syntax
$result = $client->untagResource([ 'ResourceArn' => '<string>', // REQUIRED 'TagKeys' => ['<string>', ...], // REQUIRED ]);
Parameter Details
Members
- ResourceArn
-
- Required: Yes
- Type: string
The ARN of the MediaPackage resource that you're removing tags from.
- TagKeys
-
- Required: Yes
- Type: Array of strings
The list of tag keys to remove from the resource.
Result Syntax
[]
Result Details
Errors
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
Examples
Example 1: Remove tags from a resource
$result = $client->untagResource([ 'ResourceArn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel', 'TagKeys' => [ 'key3', 'key4', ], ]);
Result syntax:
[ ]
UpdateChannel
$result = $client->updateChannel
([/* ... */]); $promise = $client->updateChannelAsync
([/* ... */]);
Update the specified channel. You can edit if MediaPackage sends ingest or egress access logs to the CloudWatch log group, if content will be encrypted, the description on a channel, and your channel's policy settings. You can't edit the name of the channel or CloudFront distribution details.
Any edits you make that impact the video output may not be reflected for a few minutes.
Parameter Syntax
$result = $client->updateChannel([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'Description' => '<string>', 'ETag' => '<string>', 'InputSwitchConfiguration' => [ 'MQCSInputSwitching' => true || false, ], 'OutputHeaderConfiguration' => [ 'PublishMQCS' => true || false, ], ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- Description
-
- Type: string
Any descriptive information that you want to add to the channel for future identification purposes.
- ETag
-
- Type: string
The expected current Entity Tag (ETag) for the resource. If the specified ETag does not match the resource's current entity tag, the update request will be rejected.
- InputSwitchConfiguration
-
- Type: InputSwitchConfiguration structure
The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when
InputType
isCMAF
. - OutputHeaderConfiguration
-
- Type: OutputHeaderConfiguration structure
The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when
InputType
isCMAF
.
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'ETag' => '<string>', 'IngestEndpoints' => [ [ 'Id' => '<string>', 'Url' => '<string>', ], // ... ], 'InputSwitchConfiguration' => [ 'MQCSInputSwitching' => true || false, ], 'InputType' => 'HLS|CMAF', 'ModifiedAt' => <DateTime>, 'OutputHeaderConfiguration' => [ 'PublishMQCS' => true || false, ], 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was created.
- Description
-
- Type: string
The description for your channel.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- IngestEndpoints
-
- Type: Array of IngestEndpoint structures
The list of ingest endpoints.
- InputSwitchConfiguration
-
- Type: InputSwitchConfiguration structure
The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when
InputType
isCMAF
. - InputType
-
- Type: string
The input type will be an immutable field which will be used to define whether the channel will allow CMAF ingest or HLS ingest. If unprovided, it will default to HLS to preserve current behavior.
The allowed values are:
-
HLS
- The HLS streaming specification (which defines M3U8 manifests and TS segments). -
CMAF
- The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was modified.
- OutputHeaderConfiguration
-
- Type: OutputHeaderConfiguration structure
The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when
InputType
isCMAF
. - Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the channel.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Updating a Channel
$result = $client->updateChannel([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'Description' => 'Updated description for exampleChannel', ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'CreatedAt' =>, 'Description' => 'Updated description for exampleChannel', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'IngestEndpoints' => [ [ 'Id' => '1', 'Url' => 'https://abcde-1.ingest.vwxyz.mediapackagev2.us-west-2.amazonaws.com/v1/exampleChannelGroup/exampleChannel/index', ], [ 'Id' => '2', 'Url' => 'https://abcde-2.ingest.vwxyz.mediapackagev2.us-west-2.amazonaws.com/v1/exampleChannelGroup/exampleChannel/index', ], ], 'InputType' => 'HLS', 'ModifiedAt' => , 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
UpdateChannelGroup
$result = $client->updateChannelGroup
([/* ... */]); $promise = $client->updateChannelGroupAsync
([/* ... */]);
Update the specified channel group. You can edit the description on a channel group for easier identification later from the AWS Elemental MediaPackage console. You can't edit the name of the channel group.
Any edits you make that impact the video output may not be reflected for a few minutes.
Parameter Syntax
$result = $client->updateChannelGroup([ 'ChannelGroupName' => '<string>', // REQUIRED 'Description' => '<string>', 'ETag' => '<string>', ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- Description
-
- Type: string
Any descriptive information that you want to add to the channel group for future identification purposes.
- ETag
-
- Type: string
The expected current Entity Tag (ETag) for the resource. If the specified ETag does not match the resource's current entity tag, the update request will be rejected.
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'CreatedAt' => <DateTime>, 'Description' => '<string>', 'ETag' => '<string>', 'EgressDomain' => '<string>', 'ModifiedAt' => <DateTime>, 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was created.
- Description
-
- Type: string
The description for your channel group.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- EgressDomain
-
- Required: Yes
- Type: string
The output domain where the source stream is sent. Integrate the domain with a downstream CDN (such as Amazon CloudFront) or playback device.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was modified.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the channel group.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
Examples
Example 1: Updating a Channel Group
$result = $client->updateChannelGroup([ 'ChannelGroupName' => 'exampleChannelGroup', 'Description' => 'Updated description for exampleChannelGroup', ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup', 'ChannelGroupName' => 'exampleChannelGroup', 'CreatedAt' =>, 'Description' => 'Updated description for exampleChannelGroup', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'EgressDomain' => 'abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com', 'ModifiedAt' => , 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
UpdateOriginEndpoint
$result = $client->updateOriginEndpoint
([/* ... */]); $promise = $client->updateOriginEndpointAsync
([/* ... */]);
Update the specified origin endpoint. Edit the packaging preferences on an endpoint to optimize the viewing experience. You can't edit the name of the endpoint.
Any edits you make that impact the video output may not be reflected for a few minutes.
Parameter Syntax
$result = $client->updateOriginEndpoint([ 'ChannelGroupName' => '<string>', // REQUIRED 'ChannelName' => '<string>', // REQUIRED 'ContainerType' => 'TS|CMAF', // REQUIRED 'DashManifests' => [ [ 'DrmSignaling' => 'INDIVIDUAL|REFERENCED', 'FilterConfiguration' => [ 'ClipStartTime' => <integer || string || DateTime>, 'End' => <integer || string || DateTime>, 'ManifestFilter' => '<string>', 'Start' => <integer || string || DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', // REQUIRED 'ManifestWindowSeconds' => <integer>, 'MinBufferTimeSeconds' => <integer>, 'MinUpdatePeriodSeconds' => <integer>, 'PeriodTriggers' => ['<string>', ...], 'ScteDash' => [ 'AdMarkerDash' => 'BINARY|XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => <integer>, 'UtcTiming' => [ 'TimingMode' => 'HTTP_HEAD|HTTP_ISO|HTTP_XSDATE|UTC_DIRECT', 'TimingSource' => '<string>', ], ], // ... ], 'Description' => '<string>', 'ETag' => '<string>', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => ['<string>', ...], ], 'HlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <integer || string || DateTime>, 'End' => <integer || string || DateTime>, 'ManifestFilter' => '<string>', 'Start' => <integer || string || DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', // REQUIRED 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, // REQUIRED ], ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <integer || string || DateTime>, 'End' => <integer || string || DateTime>, 'ManifestFilter' => '<string>', 'Start' => <integer || string || DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', // REQUIRED 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, // REQUIRED ], ], // ... ], 'OriginEndpointName' => '<string>', // REQUIRED 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => '<string>', 'EncryptionMethod' => [ // REQUIRED 'CmafEncryptionMethod' => 'CENC|CBCS', 'TsEncryptionMethod' => 'AES_128|SAMPLE_AES', ], 'KeyRotationIntervalSeconds' => <integer>, 'SpekeKeyProvider' => [ // REQUIRED 'DrmSystems' => ['<string>', ...], // REQUIRED 'EncryptionContractConfiguration' => [ // REQUIRED 'PresetSpeke20Audio' => 'PRESET_AUDIO_1|PRESET_AUDIO_2|PRESET_AUDIO_3|SHARED|UNENCRYPTED', // REQUIRED 'PresetSpeke20Video' => 'PRESET_VIDEO_1|PRESET_VIDEO_2|PRESET_VIDEO_3|PRESET_VIDEO_4|PRESET_VIDEO_5|PRESET_VIDEO_6|PRESET_VIDEO_7|PRESET_VIDEO_8|SHARED|UNENCRYPTED', // REQUIRED ], 'ResourceId' => '<string>', // REQUIRED 'RoleArn' => '<string>', // REQUIRED 'Url' => '<string>', // REQUIRED ], ], 'IncludeIframeOnlyStreams' => true || false, 'Scte' => [ 'ScteFilter' => ['<string>', ...], ], 'SegmentDurationSeconds' => <integer>, 'SegmentName' => '<string>', 'TsIncludeDvbSubtitles' => true || false, 'TsUseAudioRenditionGroup' => true || false, ], 'StartoverWindowSeconds' => <integer>, ]);
Parameter Details
Members
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ContainerType
-
- Required: Yes
- Type: string
The type of container attached to this origin endpoint. A container type is a file format that encapsulates one or more media streams, such as audio and video, into a single file.
- DashManifests
-
- Type: Array of CreateDashManifestConfiguration structures
A DASH manifest configuration.
- Description
-
- Type: string
Any descriptive information that you want to add to the origin endpoint for future identification purposes.
- ETag
-
- Type: string
The expected current Entity Tag (ETag) for the resource. If the specified ETag does not match the resource's current entity tag, the update request will be rejected.
- ForceEndpointErrorConfiguration
-
- Type: ForceEndpointErrorConfiguration structure
The failover settings for the endpoint.
- HlsManifests
-
- Type: Array of CreateHlsManifestConfiguration structures
An HTTP live streaming (HLS) manifest configuration.
- LowLatencyHlsManifests
-
- Type: Array of CreateLowLatencyHlsManifestConfiguration structures
A low-latency HLS manifest configuration.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
- Segment
-
- Type: Segment structure
The segment configuration, including the segment name, duration, and other configuration values.
- StartoverWindowSeconds
-
- Type: int
The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window. The maximum startover window is 1,209,600 seconds (14 days).
Result Syntax
[ 'Arn' => '<string>', 'ChannelGroupName' => '<string>', 'ChannelName' => '<string>', 'ContainerType' => 'TS|CMAF', 'CreatedAt' => <DateTime>, 'DashManifests' => [ [ 'DrmSignaling' => 'INDIVIDUAL|REFERENCED', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'MinBufferTimeSeconds' => <integer>, 'MinUpdatePeriodSeconds' => <integer>, 'PeriodTriggers' => ['<string>', ...], 'ScteDash' => [ 'AdMarkerDash' => 'BINARY|XML', ], 'SegmentTemplateFormat' => 'NUMBER_WITH_TIMELINE', 'SuggestedPresentationDelaySeconds' => <integer>, 'Url' => '<string>', 'UtcTiming' => [ 'TimingMode' => 'HTTP_HEAD|HTTP_ISO|HTTP_XSDATE|UTC_DIRECT', 'TimingSource' => '<string>', ], ], // ... ], 'Description' => '<string>', 'ETag' => '<string>', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => ['<string>', ...], ], 'HlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, ], 'Url' => '<string>', ], // ... ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => '<string>', 'FilterConfiguration' => [ 'ClipStartTime' => <DateTime>, 'End' => <DateTime>, 'ManifestFilter' => '<string>', 'Start' => <DateTime>, 'TimeDelaySeconds' => <integer>, ], 'ManifestName' => '<string>', 'ManifestWindowSeconds' => <integer>, 'ProgramDateTimeIntervalSeconds' => <integer>, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'StartTag' => [ 'Precise' => true || false, 'TimeOffset' => <float>, ], 'Url' => '<string>', ], // ... ], 'ModifiedAt' => <DateTime>, 'OriginEndpointName' => '<string>', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => '<string>', 'EncryptionMethod' => [ 'CmafEncryptionMethod' => 'CENC|CBCS', 'TsEncryptionMethod' => 'AES_128|SAMPLE_AES', ], 'KeyRotationIntervalSeconds' => <integer>, 'SpekeKeyProvider' => [ 'DrmSystems' => ['<string>', ...], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'PRESET_AUDIO_1|PRESET_AUDIO_2|PRESET_AUDIO_3|SHARED|UNENCRYPTED', 'PresetSpeke20Video' => 'PRESET_VIDEO_1|PRESET_VIDEO_2|PRESET_VIDEO_3|PRESET_VIDEO_4|PRESET_VIDEO_5|PRESET_VIDEO_6|PRESET_VIDEO_7|PRESET_VIDEO_8|SHARED|UNENCRYPTED', ], 'ResourceId' => '<string>', 'RoleArn' => '<string>', 'Url' => '<string>', ], ], 'IncludeIframeOnlyStreams' => true || false, 'Scte' => [ 'ScteFilter' => ['<string>', ...], ], 'SegmentDurationSeconds' => <integer>, 'SegmentName' => '<string>', 'TsIncludeDvbSubtitles' => true || false, 'TsUseAudioRenditionGroup' => true || false, ], 'StartoverWindowSeconds' => <integer>, 'Tags' => ['<string>', ...], ]
Result Details
Members
- Arn
-
- Required: Yes
- Type: string
The ARN associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ContainerType
-
- Required: Yes
- Type: string
The type of container attached to this origin endpoint.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was created.
- DashManifests
-
- Type: Array of GetDashManifestConfiguration structures
A DASH manifest configuration.
- Description
-
- Type: string
The description of the origin endpoint.
- ETag
-
- Type: string
The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- ForceEndpointErrorConfiguration
-
- Type: ForceEndpointErrorConfiguration structure
The failover settings for the endpoint.
- HlsManifests
-
- Type: Array of GetHlsManifestConfiguration structures
An HTTP live streaming (HLS) manifest configuration.
- LowLatencyHlsManifests
-
- Type: Array of GetLowLatencyHlsManifestConfiguration structures
A low-latency HLS manifest configuration.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was modified.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
- Segment
-
- Required: Yes
- Type: Segment structure
The segment configuration, including the segment name, duration, and other configuration values.
- StartoverWindowSeconds
-
- Type: int
The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window.
- Tags
-
- Type: Associative array of custom strings keys (TagKey) to strings
The comma-separated list of tag key:value pairs assigned to the origin endpoint.
Errors
- ThrottlingException:
The request throughput limit was exceeded.
- ConflictException:
Updating or deleting this resource can cause an inconsistent state.
- InternalServerException:
Indicates that an error from the service occurred while trying to process a request.
- AccessDeniedException:
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
- ValidationException:
The input failed to meet the constraints specified by the AWS service.
- ResourceNotFoundException:
The specified resource doesn't exist.
- ServiceQuotaExceededException:
The request would cause a service quota to be exceeded.
Examples
Example 1: Updating an OriginEndpoint
$result = $client->updateOriginEndpoint([ 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'TS', 'Description' => 'Updated description for exampleOriginEndpointTS', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], ], ], 'OriginEndpointName' => 'exampleOriginEndpointTS', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => 'A382A901F3C1F7718512266CFFBB0B7E', 'EncryptionMethod' => [ 'TsEncryptionMethod' => 'AES_128', ], 'KeyRotationIntervalSeconds' => 300, 'SpekeKeyProvider' => [ 'DrmSystems' => [ 'CLEAR_KEY_AES_128', ], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'SHARED', 'PresetSpeke20Video' => 'SHARED', ], 'ResourceId' => 'ResourceId', 'RoleArn' => 'arn:aws:iam::123456789012:role/empRole', 'Url' => 'https://foo.com', ], ], 'IncludeIframeOnlyStreams' => , 'Scte' => [ 'ScteFilter' => [ 'SPLICE_INSERT', ], ], 'SegmentDurationSeconds' => 7, 'SegmentName' => 'segmentName2', 'TsIncludeDvbSubtitles' => , 'TsUseAudioRenditionGroup' => 1, ], 'StartoverWindowSeconds' => 600, ]);
Result syntax:
[ 'Arn' => 'arn:aws:mediapackagev2:us-west-2:123456789012:channelGroup/exampleChannelGroup/channel/exampleChannel/originEndpoint/exampleOriginEndpointTS', 'ChannelGroupName' => 'exampleChannelGroup', 'ChannelName' => 'exampleChannel', 'ContainerType' => 'TS', 'CreatedAt' =>, 'Description' => 'Updated description for exampleOriginEndpointTS', 'ETag' => 'GlfT+dwAyGIR4wuy8nKWl1RDPwSrjQej9qUutLZxoxk=', 'ForceEndpointErrorConfiguration' => [ 'EndpointErrorConditions' => [ 'STALE_MANIFEST', 'INCOMPLETE_MANIFEST', 'MISSING_DRM_KEY', 'SLATE_INPUT', ], ], 'HlsManifests' => [ [ 'ChildManifestName' => 'exampleChildManifest1', 'ManifestName' => 'exampleManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleManifest2', 'ManifestName' => 'exampleManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleManifest2.m3u8', ], ], 'LowLatencyHlsManifests' => [ [ 'ChildManifestName' => 'exampleLLChildManifest1', 'ManifestName' => 'exampleLLManifest1', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest1.m3u8', ], [ 'ChildManifestName' => 'exampleLLManifest2', 'ManifestName' => 'exampleLLManifest2', 'ManifestWindowSeconds' => 30, 'ProgramDateTimeIntervalSeconds' => 60, 'ScteHls' => [ 'AdMarkerHls' => 'DATERANGE', ], 'Url' => 'https://abcde.egress.vwxyz.mediapackagev2.us-west-2.amazonaws.com/out/v1/exampleChannelGroup/exampleChannel/exampleOriginEndpointTS/exampleLLManifest2.m3u8', ], ], 'ModifiedAt' => , 'OriginEndpointName' => 'exampleOriginEndpointTS', 'Segment' => [ 'Encryption' => [ 'ConstantInitializationVector' => 'A382A901F3C1F7718512266CFFBB0B7E', 'EncryptionMethod' => [ 'TsEncryptionMethod' => 'AES_128', ], 'KeyRotationIntervalSeconds' => 300, 'SpekeKeyProvider' => [ 'DrmSystems' => [ 'CLEAR_KEY_AES_128', ], 'EncryptionContractConfiguration' => [ 'PresetSpeke20Audio' => 'SHARED', 'PresetSpeke20Video' => 'SHARED', ], 'ResourceId' => 'ResourceId', 'RoleArn' => 'arn:aws:iam::123456789012:role/empRole', 'Url' => 'https://foo.com', ], ], 'IncludeIframeOnlyStreams' => , 'Scte' => [ 'ScteFilter' => [ 'SPLICE_INSERT', ], ], 'SegmentDurationSeconds' => 7, 'SegmentName' => 'segmentName2', 'TsIncludeDvbSubtitles' => , 'TsUseAudioRenditionGroup' => 1, ], 'StartoverWindowSeconds' => 600, 'Tags' => [ 'key1' => 'value1', 'key2' => 'value2', ], ]
Shapes
AccessDeniedException
Description
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.
Members
- Message
-
- Type: string
ChannelGroupListConfiguration
Description
The configuration of the channel group.
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was created.
- Description
-
- Type: string
Any descriptive information that you want to add to the channel group for future identification purposes.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel group was modified.
ChannelListConfiguration
Description
The configuration of the channel.
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was created.
- Description
-
- Type: string
Any descriptive information that you want to add to the channel for future identification purposes.
- InputType
-
- Type: string
The input type will be an immutable field which will be used to define whether the channel will allow CMAF ingest or HLS ingest. If unprovided, it will default to HLS to preserve current behavior.
The allowed values are:
-
HLS
- The HLS streaming specification (which defines M3U8 manifests and TS segments). -
CMAF
- The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the channel was modified.
ConflictException
Description
Updating or deleting this resource can cause an inconsistent state.
Members
- ConflictExceptionType
-
- Type: string
The type of ConflictException.
- Message
-
- Type: string
CreateDashManifestConfiguration
Description
Create a DASH manifest configuration.
Members
- DrmSignaling
-
- Type: string
Determines how the DASH manifest signals the DRM content.
- FilterConfiguration
-
- Type: FilterConfiguration structure
Filter configuration includes settings for manifest filtering, start and end times, and time delay that apply to all of your egress requests for this manifest.
- ManifestName
-
- Required: Yes
- Type: string
A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint.
- ManifestWindowSeconds
-
- Type: int
The total duration (in seconds) of the manifest's content.
- MinBufferTimeSeconds
-
- Type: int
Minimum amount of content (in seconds) that a player must keep available in the buffer.
- MinUpdatePeriodSeconds
-
- Type: int
Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest.
- PeriodTriggers
-
- Type: Array of strings
A list of triggers that controls when AWS Elemental MediaPackage separates the MPEG-DASH manifest into multiple periods. Type
ADS
to indicate that AWS Elemental MediaPackage must create periods in the output manifest that correspond to SCTE-35 ad markers in the input source. Leave this value empty to indicate that the manifest is contained all in one period. For more information about periods in the DASH manifest, see Multi-period DASH in AWS Elemental MediaPackage. - ScteDash
-
- Type: ScteDash structure
The SCTE configuration.
- SegmentTemplateFormat
-
- Type: string
Determines the type of variable used in the
media
URL of theSegmentTemplate
tag in the manifest. Also specifies if segment timeline information is included inSegmentTimeline
orSegmentTemplate
.Value description:
-
NUMBER_WITH_TIMELINE
- The$Number$
variable is used in themedia
URL. The value of this variable is the sequential number of the segment. A fullSegmentTimeline
object is presented in eachSegmentTemplate
.
- SuggestedPresentationDelaySeconds
-
- Type: int
The amount of time (in seconds) that the player should be from the end of the manifest.
- UtcTiming
-
- Type: DashUtcTiming structure
Determines the type of UTC timing included in the DASH Media Presentation Description (MPD).
CreateHlsManifestConfiguration
Description
Create an HTTP live streaming (HLS) manifest configuration.
Members
- ChildManifestName
-
- Type: string
A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index, with an added suffix to distinguish it from the manifest name. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- FilterConfiguration
-
- Type: FilterConfiguration structure
Filter configuration includes settings for manifest filtering, start and end times, and time delay that apply to all of your egress requests for this manifest.
- ManifestName
-
- Required: Yes
- Type: string
A short short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. MediaPackage automatically inserts the format extension, such as .m3u8. You can't use the same manifest name if you use HLS manifest and low-latency HLS manifest. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- ManifestWindowSeconds
-
- Type: int
The total duration (in seconds) of the manifest's content.
- ProgramDateTimeIntervalSeconds
-
- Type: int
Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.
Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.
- ScteHls
-
- Type: ScteHls structure
The SCTE configuration.
- StartTag
-
- Type: StartTag structure
To insert an EXT-X-START tag in your HLS playlist, specify a StartTag configuration object with a valid TimeOffset. When you do, you can also optionally specify whether to include a PRECISE value in the EXT-X-START tag.
CreateLowLatencyHlsManifestConfiguration
Description
Create a low-latency HTTP live streaming (HLS) manifest configuration.
Members
- ChildManifestName
-
- Type: string
A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index, with an added suffix to distinguish it from the manifest name. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- FilterConfiguration
-
- Type: FilterConfiguration structure
Filter configuration includes settings for manifest filtering, start and end times, and time delay that apply to all of your egress requests for this manifest.
- ManifestName
-
- Required: Yes
- Type: string
A short short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. MediaPackage automatically inserts the format extension, such as .m3u8. You can't use the same manifest name if you use HLS manifest and low-latency HLS manifest. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- ManifestWindowSeconds
-
- Type: int
The total duration (in seconds) of the manifest's content.
- ProgramDateTimeIntervalSeconds
-
- Type: int
Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.
Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.
- ScteHls
-
- Type: ScteHls structure
The SCTE configuration.
- StartTag
-
- Type: StartTag structure
To insert an EXT-X-START tag in your HLS playlist, specify a StartTag configuration object with a valid TimeOffset. When you do, you can also optionally specify whether to include a PRECISE value in the EXT-X-START tag.
DashUtcTiming
Description
Determines the type of UTC timing included in the DASH Media Presentation Description (MPD).
Members
- TimingMode
-
- Type: string
The UTC timing mode.
- TimingSource
-
- Type: string
The the method that the player uses to synchronize to coordinated universal time (UTC) wall clock time.
Destination
Description
The configuration for the destination where the harvested content will be exported.
Members
- S3Destination
-
- Required: Yes
- Type: S3DestinationConfig structure
The configuration for exporting harvested content to an S3 bucket. This includes details such as the bucket name and destination path within the bucket.
Encryption
Description
The parameters for encrypting content.
Members
- ConstantInitializationVector
-
- Type: string
A 128-bit, 16-byte hex value represented by a 32-character string, used in conjunction with the key for encrypting content. If you don't specify a value, then MediaPackage creates the constant initialization vector (IV).
- EncryptionMethod
-
- Required: Yes
- Type: EncryptionMethod structure
The encryption method to use.
- KeyRotationIntervalSeconds
-
- Type: int
The frequency (in seconds) of key changes for live workflows, in which content is streamed real time. The service retrieves content keys before the live content begins streaming, and then retrieves them as needed over the lifetime of the workflow. By default, key rotation is set to 300 seconds (5 minutes), the minimum rotation interval, which is equivalent to setting it to 300. If you don't enter an interval, content keys aren't rotated.
The following example setting causes the service to rotate keys every thirty minutes:
1800
- SpekeKeyProvider
-
- Required: Yes
- Type: SpekeKeyProvider structure
The parameters for the SPEKE key provider.
EncryptionContractConfiguration
Description
Configure one or more content encryption keys for your endpoints that use SPEKE Version 2.0. The encryption contract defines which content keys are used to encrypt the audio and video tracks in your stream. To configure the encryption contract, specify which audio and video encryption presets to use.
Members
- PresetSpeke20Audio
-
- Required: Yes
- Type: string
A collection of audio encryption presets.
Value description:
-
PRESET-AUDIO-1 - Use one content key to encrypt all of the audio tracks in your stream.
-
PRESET-AUDIO-2 - Use one content key to encrypt all of the stereo audio tracks and one content key to encrypt all of the multichannel audio tracks.
-
PRESET-AUDIO-3 - Use one content key to encrypt all of the stereo audio tracks, one content key to encrypt all of the multichannel audio tracks with 3 to 6 channels, and one content key to encrypt all of the multichannel audio tracks with more than 6 channels.
-
SHARED - Use the same content key for all of the audio and video tracks in your stream.
-
UNENCRYPTED - Don't encrypt any of the audio tracks in your stream.
- PresetSpeke20Video
-
- Required: Yes
- Type: string
A collection of video encryption presets.
Value description:
-
PRESET-VIDEO-1 - Use one content key to encrypt all of the video tracks in your stream.
-
PRESET-VIDEO-2 - Use one content key to encrypt all of the SD video tracks and one content key for all HD and higher resolutions video tracks.
-
PRESET-VIDEO-3 - Use one content key to encrypt all of the SD video tracks, one content key for HD video tracks and one content key for all UHD video tracks.
-
PRESET-VIDEO-4 - Use one content key to encrypt all of the SD video tracks, one content key for HD video tracks, one content key for all UHD1 video tracks and one content key for all UHD2 video tracks.
-
PRESET-VIDEO-5 - Use one content key to encrypt all of the SD video tracks, one content key for HD1 video tracks, one content key for HD2 video tracks, one content key for all UHD1 video tracks and one content key for all UHD2 video tracks.
-
PRESET-VIDEO-6 - Use one content key to encrypt all of the SD video tracks, one content key for HD1 video tracks, one content key for HD2 video tracks and one content key for all UHD video tracks.
-
PRESET-VIDEO-7 - Use one content key to encrypt all of the SD+HD1 video tracks, one content key for HD2 video tracks and one content key for all UHD video tracks.
-
PRESET-VIDEO-8 - Use one content key to encrypt all of the SD+HD1 video tracks, one content key for HD2 video tracks, one content key for all UHD1 video tracks and one content key for all UHD2 video tracks.
-
SHARED - Use the same content key for all of the video and audio tracks in your stream.
-
UNENCRYPTED - Don't encrypt any of the video tracks in your stream.
EncryptionMethod
Description
The encryption type.
Members
- CmafEncryptionMethod
-
- Type: string
The encryption method to use.
- TsEncryptionMethod
-
- Type: string
The encryption method to use.
FilterConfiguration
Description
Filter configuration includes settings for manifest filtering, start and end times, and time delay that apply to all of your egress requests for this manifest.
Members
- ClipStartTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Optionally specify the clip start time for all of your manifest egress requests. When you include clip start time, note that you cannot use clip start time query parameters for this manifest's endpoint URL.
- End
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Optionally specify the end time for all of your manifest egress requests. When you include end time, note that you cannot use end time query parameters for this manifest's endpoint URL.
- ManifestFilter
-
- Type: string
Optionally specify one or more manifest filters for all of your manifest egress requests. When you include a manifest filter, note that you cannot use an identical manifest filter query parameter for this manifest's endpoint URL.
- Start
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
Optionally specify the start time for all of your manifest egress requests. When you include start time, note that you cannot use start time query parameters for this manifest's endpoint URL.
- TimeDelaySeconds
-
- Type: int
Optionally specify the time delay for all of your manifest egress requests. Enter a value that is smaller than your endpoint's startover window. When you include time delay, note that you cannot use time delay query parameters for this manifest's endpoint URL.
ForceEndpointErrorConfiguration
Description
The failover settings for the endpoint.
Members
- EndpointErrorConditions
-
- Type: Array of strings
The failover conditions for the endpoint. The options are:
-
STALE_MANIFEST
- The manifest stalled and there are no new segments or parts. -
INCOMPLETE_MANIFEST
- There is a gap in the manifest. -
MISSING_DRM_KEY
- Key rotation is enabled but we're unable to fetch the key for the current key period. -
SLATE_INPUT
- The segments which contain slate content are considered to be missing content.
GetDashManifestConfiguration
Description
Retrieve the DASH manifest configuration.
Members
- DrmSignaling
-
- Type: string
Determines how the DASH manifest signals the DRM content.
- FilterConfiguration
-
- Type: FilterConfiguration structure
Filter configuration includes settings for manifest filtering, start and end times, and time delay that apply to all of your egress requests for this manifest.
- ManifestName
-
- Required: Yes
- Type: string
A short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index.
- ManifestWindowSeconds
-
- Type: int
The total duration (in seconds) of the manifest's content.
- MinBufferTimeSeconds
-
- Type: int
Minimum amount of content (in seconds) that a player must keep available in the buffer.
- MinUpdatePeriodSeconds
-
- Type: int
Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest.
- PeriodTriggers
-
- Type: Array of strings
A list of triggers that controls when AWS Elemental MediaPackage separates the MPEG-DASH manifest into multiple periods. Leave this value empty to indicate that the manifest is contained all in one period. For more information about periods in the DASH manifest, see Multi-period DASH in AWS Elemental MediaPackage.
- ScteDash
-
- Type: ScteDash structure
The SCTE configuration.
- SegmentTemplateFormat
-
- Type: string
Determines the type of variable used in the
media
URL of theSegmentTemplate
tag in the manifest. Also specifies if segment timeline information is included inSegmentTimeline
orSegmentTemplate
.Value description:
-
NUMBER_WITH_TIMELINE
- The$Number$
variable is used in themedia
URL. The value of this variable is the sequential number of the segment. A fullSegmentTimeline
object is presented in eachSegmentTemplate
.
- SuggestedPresentationDelaySeconds
-
- Type: int
The amount of time (in seconds) that the player should be from the end of the manifest.
- Url
-
- Required: Yes
- Type: string
The egress domain URL for stream delivery from MediaPackage.
- UtcTiming
-
- Type: DashUtcTiming structure
Determines the type of UTC timing included in the DASH Media Presentation Description (MPD).
GetHlsManifestConfiguration
Description
Retrieve the HTTP live streaming (HLS) manifest configuration.
Members
- ChildManifestName
-
- Type: string
A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default child manifest name, index_1. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- FilterConfiguration
-
- Type: FilterConfiguration structure
Filter configuration includes settings for manifest filtering, start and end times, and time delay that apply to all of your egress requests for this manifest.
- ManifestName
-
- Required: Yes
- Type: string
A short short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. MediaPackage automatically inserts the format extension, such as .m3u8. You can't use the same manifest name if you use HLS manifest and low-latency HLS manifest. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- ManifestWindowSeconds
-
- Type: int
The total duration (in seconds) of the manifest's content.
- ProgramDateTimeIntervalSeconds
-
- Type: int
Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.
Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.
- ScteHls
-
- Type: ScteHls structure
The SCTE configuration.
- StartTag
-
- Type: StartTag structure
To insert an EXT-X-START tag in your HLS playlist, specify a StartTag configuration object with a valid TimeOffset. When you do, you can also optionally specify whether to include a PRECISE value in the EXT-X-START tag.
- Url
-
- Required: Yes
- Type: string
The egress domain URL for stream delivery from MediaPackage.
GetLowLatencyHlsManifestConfiguration
Description
Retrieve the low-latency HTTP live streaming (HLS) manifest configuration.
Members
- ChildManifestName
-
- Type: string
A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default child manifest name, index_1. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- FilterConfiguration
-
- Type: FilterConfiguration structure
Filter configuration includes settings for manifest filtering, start and end times, and time delay that apply to all of your egress requests for this manifest.
- ManifestName
-
- Required: Yes
- Type: string
A short short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. MediaPackage automatically inserts the format extension, such as .m3u8. You can't use the same manifest name if you use HLS manifest and low-latency HLS manifest. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- ManifestWindowSeconds
-
- Type: int
The total duration (in seconds) of the manifest's content.
- ProgramDateTimeIntervalSeconds
-
- Type: int
Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.
Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.
- ScteHls
-
- Type: ScteHls structure
The SCTE configuration.
- StartTag
-
- Type: StartTag structure
To insert an EXT-X-START tag in your HLS playlist, specify a StartTag configuration object with a valid TimeOffset. When you do, you can also optionally specify whether to include a PRECISE value in the EXT-X-START tag.
- Url
-
- Required: Yes
- Type: string
The egress domain URL for stream delivery from MediaPackage.
HarvestJob
Description
Represents a harvest job resource in MediaPackage v2, which is used to export content from an origin endpoint to an S3 bucket.
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) of the harvest job.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name of the channel group containing the channel associated with this harvest job.
- ChannelName
-
- Required: Yes
- Type: string
The name of the channel associated with this harvest job.
- CreatedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the harvest job was created.
- Description
-
- Type: string
An optional description of the harvest job.
- Destination
-
- Required: Yes
- Type: Destination structure
The S3 destination where the harvested content will be placed.
- ETag
-
- Type: string
The current version of the harvest job. Used for concurrency control.
- ErrorMessage
-
- Type: string
An error message if the harvest job encountered any issues.
- HarvestJobName
-
- Required: Yes
- Type: string
The name of the harvest job.
- HarvestedManifests
-
- Required: Yes
- Type: HarvestedManifests structure
A list of manifests that are being or have been harvested.
- ModifiedAt
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time when the harvest job was last modified.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name of the origin endpoint associated with this harvest job.
- ScheduleConfiguration
-
- Required: Yes
- Type: HarvesterScheduleConfiguration structure
The configuration for when the harvest job is scheduled to run.
- Status
-
- Required: Yes
- Type: string
The current status of the harvest job (e.g., QUEUED, IN_PROGRESS, CANCELLED, COMPLETED, FAILED).
HarvestedDashManifest
Description
Information about a harvested DASH manifest.
Members
- ManifestName
-
- Required: Yes
- Type: string
The name of the harvested DASH manifest.
HarvestedHlsManifest
Description
Information about a harvested HLS manifest.
Members
- ManifestName
-
- Required: Yes
- Type: string
The name of the harvested HLS manifest.
HarvestedLowLatencyHlsManifest
Description
Information about a harvested Low-Latency HLS manifest.
Members
- ManifestName
-
- Required: Yes
- Type: string
The name of the harvested Low-Latency HLS manifest.
HarvestedManifests
Description
A collection of harvested manifests of different types.
Members
- DashManifests
-
- Type: Array of HarvestedDashManifest structures
A list of harvested DASH manifests.
- HlsManifests
-
- Type: Array of HarvestedHlsManifest structures
A list of harvested HLS manifests.
- LowLatencyHlsManifests
-
- Type: Array of HarvestedLowLatencyHlsManifest structures
A list of harvested Low-Latency HLS manifests.
HarvesterScheduleConfiguration
Description
Defines the schedule configuration for a harvest job.
Members
- EndTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The end time for the harvest job.
- StartTime
-
- Required: Yes
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The start time for the harvest job.
IngestEndpoint
Description
The ingest domain URL where the source stream should be sent.
Members
- Id
-
- Type: string
The system-generated unique identifier for the IngestEndpoint.
- Url
-
- Type: string
The ingest domain URL where the source stream should be sent.
InputSwitchConfiguration
Description
The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive.
Members
- MQCSInputSwitching
-
- Type: boolean
When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is true. This setting is valid only when
InputType
isCMAF
.
InternalServerException
Description
Indicates that an error from the service occurred while trying to process a request.
Members
- Message
-
- Type: string
ListDashManifestConfiguration
Description
List the DASH manifest configuration.
Members
- ManifestName
-
- Required: Yes
- Type: string
A short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index.
- Url
-
- Type: string
The egress domain URL for stream delivery from MediaPackage.
ListHlsManifestConfiguration
Description
List the HTTP live streaming (HLS) manifest configuration.
Members
- ChildManifestName
-
- Type: string
A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default child manifest name, index_1. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- ManifestName
-
- Required: Yes
- Type: string
A short short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. MediaPackage automatically inserts the format extension, such as .m3u8. You can't use the same manifest name if you use HLS manifest and low-latency HLS manifest. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- Url
-
- Type: string
The egress domain URL for stream delivery from MediaPackage.
ListLowLatencyHlsManifestConfiguration
Description
List the low-latency HTTP live streaming (HLS) manifest configuration.
Members
- ChildManifestName
-
- Type: string
A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default child manifest name, index_1. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- ManifestName
-
- Required: Yes
- Type: string
A short short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. MediaPackage automatically inserts the format extension, such as .m3u8. You can't use the same manifest name if you use HLS manifest and low-latency HLS manifest. The manifestName on the HLSManifest object overrides the manifestName you provided on the originEndpoint object.
- Url
-
- Type: string
The egress domain URL for stream delivery from MediaPackage.
OriginEndpointListConfiguration
Description
The configuration of the origin endpoint.
Members
- Arn
-
- Required: Yes
- Type: string
The Amazon Resource Name (ARN) associated with the resource.
- ChannelGroupName
-
- Required: Yes
- Type: string
The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- ChannelName
-
- Required: Yes
- Type: string
The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ContainerType
-
- Required: Yes
- Type: string
The type of container attached to this origin endpoint. A container type is a file format that encapsulates one or more media streams, such as audio and video, into a single file.
- CreatedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was created.
- DashManifests
-
- Type: Array of ListDashManifestConfiguration structures
A DASH manifest configuration.
- Description
-
- Type: string
Any descriptive information that you want to add to the origin endpoint for future identification purposes.
- ForceEndpointErrorConfiguration
-
- Type: ForceEndpointErrorConfiguration structure
The failover settings for the endpoint.
- HlsManifests
-
- Type: Array of ListHlsManifestConfiguration structures
An HTTP live streaming (HLS) manifest configuration.
- LowLatencyHlsManifests
-
- Type: Array of ListLowLatencyHlsManifestConfiguration structures
A low-latency HLS manifest configuration.
- ModifiedAt
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The date and time the origin endpoint was modified.
- OriginEndpointName
-
- Required: Yes
- Type: string
The name that describes the origin endpoint. The name is the primary identifier for the origin endpoint, and and must be unique for your account in the AWS Region and channel.
OutputHeaderConfiguration
Description
The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN.
Members
- PublishMQCS
-
- Type: boolean
When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when
InputType
isCMAF
.
ResourceNotFoundException
Description
The specified resource doesn't exist.
Members
- Message
-
- Type: string
- ResourceTypeNotFound
-
- Type: string
The specified resource type wasn't found.
S3DestinationConfig
Description
Configuration parameters for where in an S3 bucket to place the harvested content.
Members
- BucketName
-
- Required: Yes
- Type: string
The name of an S3 bucket within which harvested content will be exported.
- DestinationPath
-
- Required: Yes
- Type: string
The path within the specified S3 bucket where the harvested content will be placed.
Scte
Description
The SCTE configuration.
Members
- ScteFilter
-
- Type: Array of strings
The SCTE-35 message types that you want to be treated as ad markers in the output.
ScteDash
Description
The SCTE configuration.
Members
- AdMarkerDash
-
- Type: string
Choose how ad markers are included in the packaged content. If you include ad markers in the content stream in your upstream encoders, then you need to inform MediaPackage what to do with the ad markers in the output.
Value description:
-
Binary
- The SCTE-35 marker is expressed as a hex-string (Base64 string) rather than full XML. -
XML
- The SCTE marker is expressed fully in XML.
ScteHls
Description
The SCTE configuration.
Members
- AdMarkerHls
-
- Type: string
Ad markers indicate when ads should be inserted during playback. If you include ad markers in the content stream in your upstream encoders, then you need to inform MediaPackage what to do with the ad markers in the output. Choose what you want MediaPackage to do with the ad markers.
Value description:
-
DATERANGE - Insert EXT-X-DATERANGE tags to signal ad and program transition events in TS and CMAF manifests. If you use DATERANGE, you must set a programDateTimeIntervalSeconds value of 1 or higher. To learn more about DATERANGE, see SCTE-35 Ad Marker EXT-X-DATERANGE.
Segment
Description
The segment configuration, including the segment name, duration, and other configuration values.
Members
- Encryption
-
- Type: Encryption structure
The parameters for encrypting content.
- IncludeIframeOnlyStreams
-
- Type: boolean
When selected, the stream set includes an additional I-frame only stream, along with the other tracks. If false, this extra stream is not included. MediaPackage generates an I-frame only stream from the first rendition in the manifest. The service inserts EXT-I-FRAMES-ONLY tags in the output manifest, and then generates and includes an I-frames only playlist in the stream. This playlist permits player functionality like fast forward and rewind.
- Scte
-
- Type: Scte structure
The SCTE configuration options in the segment settings.
- SegmentDurationSeconds
-
- Type: int
The duration (in seconds) of each segment. Enter a value equal to, or a multiple of, the input segment duration. If the value that you enter is different from the input segment duration, MediaPackage rounds segments to the nearest multiple of the input segment duration.
- SegmentName
-
- Type: string
The name that describes the segment. The name is the base name of the segment used in all content manifests inside of the endpoint. You can't use spaces in the name.
- TsIncludeDvbSubtitles
-
- Type: boolean
By default, MediaPackage excludes all digital video broadcasting (DVB) subtitles from the output. When selected, MediaPackage passes through DVB subtitles into the output.
- TsUseAudioRenditionGroup
-
- Type: boolean
When selected, MediaPackage bundles all audio tracks in a rendition group. All other tracks in the stream can be used with any audio rendition from the group.
ServiceQuotaExceededException
Description
The request would cause a service quota to be exceeded.
Members
- Message
-
- Type: string
SpekeKeyProvider
Description
The parameters for the SPEKE key provider.
Members
- DrmSystems
-
- Required: Yes
- Type: Array of strings
The DRM solution provider you're using to protect your content during distribution.
- EncryptionContractConfiguration
-
- Required: Yes
- Type: EncryptionContractConfiguration structure
Configure one or more content encryption keys for your endpoints that use SPEKE Version 2.0. The encryption contract defines which content keys are used to encrypt the audio and video tracks in your stream. To configure the encryption contract, specify which audio and video encryption presets to use.
- ResourceId
-
- Required: Yes
- Type: string
The unique identifier for the content. The service sends this to the key server to identify the current endpoint. How unique you make this depends on how fine-grained you want access controls to be. The service does not permit you to use the same ID for two simultaneous encryption processes. The resource ID is also known as the content ID.
The following example shows a resource ID:
MovieNight20171126093045
- RoleArn
-
- Required: Yes
- Type: string
The ARN for the IAM role granted by the key provider that provides access to the key provider API. This role must have a trust policy that allows MediaPackage to assume the role, and it must have a sufficient permissions policy to allow access to the specific key retrieval URL. Get this from your DRM solution provider.
Valid format:
arn:aws:iam::{accountID}:role/{name}
. The following example shows a role ARN:arn:aws:iam::444455556666:role/SpekeAccess
- Url
-
- Required: Yes
- Type: string
The URL of the API Gateway proxy that you set up to talk to your key server. The API Gateway proxy must reside in the same AWS Region as MediaPackage and must start with https://.
The following example shows a URL:
https://1wm2dx1f33.execute-api.us-west-2.amazonaws.com/SpekeSample/copyProtection
StartTag
Description
To insert an EXT-X-START tag in your HLS playlist, specify a StartTag configuration object with a valid TimeOffset. When you do, you can also optionally specify whether to include a PRECISE value in the EXT-X-START tag.
Members
- Precise
-
- Type: boolean
Specify the value for PRECISE within your EXT-X-START tag. Leave blank, or choose false, to use the default value NO. Choose yes to use the value YES.
- TimeOffset
-
- Required: Yes
- Type: float
Specify the value for TIME-OFFSET within your EXT-X-START tag. Enter a signed floating point value which, if positive, must be less than the configured manifest duration minus three times the configured segment target duration. If negative, the absolute value must be larger than three times the configured segment target duration, and the absolute value must be smaller than the configured manifest duration.
ThrottlingException
Description
The request throughput limit was exceeded.
Members
- Message
-
- Type: string
ValidationException
Description
The input failed to meet the constraints specified by the AWS service.
Members
- Message
-
- Type: string
- ValidationExceptionType
-
- Type: string
The type of ValidationException.