Mediapackagev2

This page documents function available when using the Mediapackagev2 module, created with @service Mediapackagev2.

Index

Documentation

Main.Mediapackagev2.create_channelMethod
create_channel(channel_group_name, channel_name)
create_channel(channel_group_name, channel_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "Description": Enter any descriptive text that helps you to identify the channel.
  • "InputType": 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).
  • "tags": A comma-separated list of tag key:value pairs that you define. For example: "Key1": "Value1", "Key2": "Value2"
  • "x-amzn-client-token": A unique, case-sensitive token that you provide to ensure the idempotency of the request.
source
Main.Mediapackagev2.create_channel_groupMethod
create_channel_group(channel_group_name)
create_channel_group(channel_group_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "Description": Enter any descriptive text that helps you to identify the channel group.
  • "tags": A comma-separated list of tag key:value pairs that you define. For example: "Key1": "Value1", "Key2": "Value2"
  • "x-amzn-client-token": A unique, case-sensitive token that you provide to ensure the idempotency of the request.
source
Main.Mediapackagev2.create_origin_endpointMethod
create_origin_endpoint(channel_group_name, channel_name, container_type, origin_endpoint_name)
create_origin_endpoint(channel_group_name, channel_name, container_type, origin_endpoint_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
  • container_type: 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.
  • origin_endpoint_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "DashManifests": A DASH manifest configuration.
  • "Description": Enter any descriptive text that helps you to identify the origin endpoint.
  • "ForceEndpointErrorConfiguration": The failover settings for the endpoint.
  • "HlsManifests": An HTTP live streaming (HLS) manifest configuration.
  • "LowLatencyHlsManifests": A low-latency HLS manifest configuration.
  • "Segment": The segment configuration, including the segment name, duration, and other configuration values.
  • "StartoverWindowSeconds": 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": A comma-separated list of tag key:value pairs that you define. For example: "Key1": "Value1", "Key2": "Value2"
  • "x-amzn-client-token": A unique, case-sensitive token that you provide to ensure the idempotency of the request.
source
Main.Mediapackagev2.delete_channelMethod
delete_channel(channel_group_name, channel_name)
delete_channel(channel_group_name, channel_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
source
Main.Mediapackagev2.delete_channel_groupMethod
delete_channel_group(channel_group_name)
delete_channel_group(channel_group_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
source
Main.Mediapackagev2.delete_channel_policyMethod
delete_channel_policy(channel_group_name, channel_name)
delete_channel_policy(channel_group_name, channel_name, params::Dict{String,<:Any})

Delete a channel policy.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
source
Main.Mediapackagev2.delete_origin_endpointMethod
delete_origin_endpoint(channel_group_name, channel_name, origin_endpoint_name)
delete_origin_endpoint(channel_group_name, channel_name, origin_endpoint_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
  • origin_endpoint_name: 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.
source
Main.Mediapackagev2.delete_origin_endpoint_policyMethod
delete_origin_endpoint_policy(channel_group_name, channel_name, origin_endpoint_name)
delete_origin_endpoint_policy(channel_group_name, channel_name, origin_endpoint_name, params::Dict{String,<:Any})

Delete an origin endpoint policy.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
  • origin_endpoint_name: 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.
source
Main.Mediapackagev2.get_channelMethod
get_channel(channel_group_name, channel_name)
get_channel(channel_group_name, channel_name, params::Dict{String,<:Any})

Retrieves the specified channel that's configured in AWS Elemental MediaPackage, including the origin endpoints that are associated with it.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
source
Main.Mediapackagev2.get_channel_groupMethod
get_channel_group(channel_group_name)
get_channel_group(channel_group_name, params::Dict{String,<:Any})

Retrieves the specified channel group that's configured in AWS Elemental MediaPackage, including the channels and origin endpoints that are associated with it.

Arguments

  • channel_group_name: 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.
source
Main.Mediapackagev2.get_channel_policyMethod
get_channel_policy(channel_group_name, channel_name)
get_channel_policy(channel_group_name, channel_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
source
Main.Mediapackagev2.get_origin_endpointMethod
get_origin_endpoint(channel_group_name, channel_name, origin_endpoint_name)
get_origin_endpoint(channel_group_name, channel_name, origin_endpoint_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
  • origin_endpoint_name: 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.
source
Main.Mediapackagev2.get_origin_endpoint_policyMethod
get_origin_endpoint_policy(channel_group_name, channel_name, origin_endpoint_name)
get_origin_endpoint_policy(channel_group_name, channel_name, origin_endpoint_name, params::Dict{String,<:Any})

Retrieves the specified origin endpoint policy that's configured in AWS Elemental MediaPackage.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
  • origin_endpoint_name: 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.
source
Main.Mediapackagev2.list_channel_groupsMethod
list_channel_groups()
list_channel_groups(params::Dict{String,<:Any})

Retrieves all channel groups that are configured in AWS Elemental MediaPackage, including the channels and origin endpoints that are associated with it.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": The maximum number of results to return in the response.
  • "nextToken": The pagination token from the GET list request. Use the token to fetch the next page of results.
source
Main.Mediapackagev2.list_channelsMethod
list_channels(channel_group_name)
list_channels(channel_group_name, params::Dict{String,<:Any})

Retrieves all channels in a specific channel group that are configured in AWS Elemental MediaPackage, including the origin endpoints that are associated with it.

Arguments

  • channel_group_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": The maximum number of results to return in the response.
  • "nextToken": The pagination token from the GET list request. Use the token to fetch the next page of results.
source
Main.Mediapackagev2.list_origin_endpointsMethod
list_origin_endpoints(channel_group_name, channel_name)
list_origin_endpoints(channel_group_name, channel_name, params::Dict{String,<:Any})

Retrieves all origin endpoints in a specific channel that are configured in AWS Elemental MediaPackage.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "maxResults": The maximum number of results to return in the response.
  • "nextToken": The pagination token from the GET list request. Use the token to fetch the next page of results.
source
Main.Mediapackagev2.list_tags_for_resourceMethod
list_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})

Lists the tags assigned to a resource.

Arguments

  • resource_arn: The ARN of the CloudWatch resource that you want to view tags for.
source
Main.Mediapackagev2.put_channel_policyMethod
put_channel_policy(channel_group_name, channel_name, policy)
put_channel_policy(channel_group_name, channel_name, policy, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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: The policy to attach to the specified channel.
source
Main.Mediapackagev2.put_origin_endpoint_policyMethod
put_origin_endpoint_policy(channel_group_name, channel_name, origin_endpoint_name, policy)
put_origin_endpoint_policy(channel_group_name, channel_name, origin_endpoint_name, policy, params::Dict{String,<:Any})

Attaches an IAM policy to the specified origin endpoint. You can attach only one policy with each request.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
  • origin_endpoint_name: 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: The policy to attach to the specified origin endpoint.
source
Main.Mediapackagev2.tag_resourceMethod
tag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})

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.

Arguments

  • resource_arn: The ARN of the MediaPackage resource that you're adding tags to.
  • tags: Contains a map of the key-value pairs for the resource tag or tags assigned to the resource.
source
Main.Mediapackagev2.untag_resourceMethod
untag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})

Removes one or more tags from the specified resource.

Arguments

  • resource_arn: The ARN of the MediaPackage resource that you're removing tags from.
  • tag_keys: The list of tag keys to remove from the resource.
source
Main.Mediapackagev2.update_channelMethod
update_channel(channel_group_name, channel_name)
update_channel(channel_group_name, channel_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "Description": Any descriptive information that you want to add to the channel for future identification purposes.
  • "x-amzn-update-if-match": 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.
source
Main.Mediapackagev2.update_channel_groupMethod
update_channel_group(channel_group_name)
update_channel_group(channel_group_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "Description": Any descriptive information that you want to add to the channel group for future identification purposes.
  • "x-amzn-update-if-match": 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.
source
Main.Mediapackagev2.update_origin_endpointMethod
update_origin_endpoint(channel_group_name, channel_name, container_type, origin_endpoint_name)
update_origin_endpoint(channel_group_name, channel_name, container_type, origin_endpoint_name, params::Dict{String,<:Any})

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.

Arguments

  • channel_group_name: 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.
  • channel_name: 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.
  • container_type: 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.
  • origin_endpoint_name: 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.

Optional Parameters

Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:

  • "DashManifests": A DASH manifest configuration.
  • "Description": Any descriptive information that you want to add to the origin endpoint for future identification purposes.
  • "ForceEndpointErrorConfiguration": The failover settings for the endpoint.
  • "HlsManifests": An HTTP live streaming (HLS) manifest configuration.
  • "LowLatencyHlsManifests": A low-latency HLS manifest configuration.
  • "Segment": The segment configuration, including the segment name, duration, and other configuration values.
  • "StartoverWindowSeconds": 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).
  • "x-amzn-update-if-match": 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.
source