# Working with channel groups in AWS Elemental MediaPackage Working with channel groups A channel group is the top-level resource that consists of channels and origin endpoints associated with it. After you create a channel group, MediaPackage provides a fixed egress domain for its lifetime, regardless of any failures or upgrades that might occur. All channels and origin endpoints belonging to this channel group use the same egress domain. Direct your CDNs to this domain for stream delivery from MediaPackage. For each channel group, you add channels that define the entry point for a content stream into MediaPackage. You then add origin endpoints to the channels that define the packaging options for the output stream. **Topics** + [Creating a channel group](channel-group-create.md) + [Viewing channel group details](channel-group-view.md) + [Editing a channel group](channel-group-edit.md) + [Deleting a channel group](channel-group-delete.md) # Creating a channel group in AWS Elemental MediaPackage Creating a channel group This guide shows how to create a channel group as a holder for your channels and origin endpoints. You can provide high-level information about your channel group and can add a certain number of channel groups for each account. After you create a channel group, you can add channels to the channel group. You can use the MediaPackage console, MediaPackage API, or AWS Command Line Interface (AWS CLI) to create a channel group. When you're creating a channel group, don't put sensitive identifying information like customer account numbers into free-form fields such as the name or description field. MediaPackage doesn’t require that you supply any customer data. This includes when you work with MediaPackage using the MediaPackage console, MediaPackage API, AWS CLI, or AWS SDKs. Any data that you enter into MediaPackage might get picked up for inclusion in diagnostic logs or Amazon CloudWatch Events. **To create a channel group** 1. Open the MediaPackage console at [https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/). 1. Choose **Create channel group** from the **Channel groups** list. 1. For **Name**, enter a name that describes the channel group. This is the name that you use for API and console interactions. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region. Supported characters are **A-Z**, **a-z**, **0-9**, **\$1** (underscore), and **-** (hyphen) with a length of 1–256 characters. You can't use spaces in the name, and you can't change the name after you create the channel group. 1. (Optional) For **Description**, enter any descriptive text that helps you to identify the channel group. 1. Choose **Create**. MediaPackage displays the new channel group's details page. After you create a channel group, MediaPackage provides an egress domain URL that is fixed for the lifetime of the channel group. This domain remains regardless of any failures or upgrades that might happen over time. All channels and origin endpoints that belong to this channel group will use the same domain URL. For stream delivery from MediaPackage, direct your CDNs to this domain. When you create a channel group, if you exceed the quotas on the account, you'll receive an error. The error will be similar to Too many requests, please try again. Resource limit exceeded. This error means that either you exceeded the API request quotas, or that you reached the maximum number of channel groups that your account permits. You can add channels to a channel group to do the following: + Permit a live content stream from a source such as AWS Elemental MediaLive or another encoder. + Permit downstream video players and content delivery networks (CDNs) to start requesting content playback. For instructions on adding channels to a channel group from the MediaPackage console, see [Working with channels in AWS Elemental MediaPackage](channels.md). # Viewing channel group details in AWS Elemental MediaPackage Viewing channel group details This guide shows how to view all channel groups that are configured in AWS Elemental MediaPackage. You can also view the details of a specific channel group. This includes the channels and origin endpoints that are associated with it. You can use the MediaPackage console, MediaPackage API, or AWS CLI to view channel group details. **To view a channel group** 1. Open the MediaPackage console at [https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/). The console shows all existing channel groups that are configured in MediaPackage. 1. (Optional) To adjust your viewing preferences, choose **Preferences**. For example, you can adjust the page size and properties that you want to view. 1. To view more information about a specific channel group, select that channel group from the **Channel groups** list. MediaPackage displays important information such as the values for egress domain, when the channel group was created, the ARN, and any channels that are associated with the channel group. # Editing a channel group in AWS Elemental MediaPackage Editing a channel group This guides shows how to 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. You can use the MediaPackage console, MediaPackage API, or AWS CLI to edit a channel group. When you're editing a channel group, don't put sensitive identifying information like customer account numbers into free-form fields such as the name or description field. MediaPackage doesn’t require that you supply any customer data. This includes when you work with MediaPackage using the MediaPackage console, MediaPackage API, AWS CLI, or AWS SDKs. Any data that you enter into MediaPackage might get picked up for inclusion in diagnostic logs or Amazon CloudWatch Events. **To edit a channel group** 1. Open the MediaPackage console at [https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/). The console shows all existing channel groups that are configured in MediaPackage. 1. Select the name of the channel group that you want to edit. 1. On the channel group's details page, choose **Edit**. 1. Edit the description for easier identification later. 1. Choose **Edit**. # Deleting a channel group from AWS Elemental MediaPackage Deleting a channel group This guides shows how to delete a channel group to stop AWS Elemental MediaPackage from receiving content. Before you can delete the channel group, you must delete the channel group's channels and endpoints. For instructions, see [Deleting a channel in AWS Elemental MediaPackageDeleting a channel](channels-delete.md) and [Deleting an endpoint in AWS Elemental MediaPackage](endpoints-delete.md). You can use the MediaPackage console, MediaPackage API, or AWS CLI to delete a channel group. **Warning** If you delete a channel group, you'll lose access to the egress domain URL. If that happens, you must create a new channel group to replace it. **To delete a channel group** 1. Open the MediaPackage console at [https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/). The console shows all existing channel groups that are configured in MediaPackage. 1. Select the name of the channel group that you want to delete. 1. Choose **Delete**. 1. Choose **Delete** in the confirmation dialog box.