# Packaging\$1groups


## URI


`/packaging_groups`

## HTTP methods


### GET


**Operation ID:** `ListPackagingGroups`

Lists packaging groups that match a set of filters that you define.


**Query parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| nextToken | String | False | Pagination token. Use this token to request the next page of record results. | 
| maxResults | String | False | Upper bound on number of records to return. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | PackagingGroupList |  `200 OK` responseThe list of tags is returned successfully. | 
| 403 | None |  `403 Forbidden` responseAWS Elemental MediaPackage cannot authorize the request, possibly due to insufficient authentication credentials. | 
| 404 | None |  `404 Not Found` responseAWS Elemental MediaPackage did not find a representation of the target resource. | 
| 422 | None |  `422 Unprocessable Entity` responseAWS Elemental MediaPackage could not process the instructions in the body of the request. | 
| 429 | None |  `429 Too Many Requests` responseOne of these two error conditions:Too many requests have been sent in a given amount of time.Your account has exceeded the quota allotted for the resource that you're creating. | 
| 500 | None |  `500 Internal Server Error` responseAn unexpected condition prevented AWS Elemental MediaPackage from fulfilling the request. | 
| 503 | None |  `Service unavailable` responseAWS Elemental MediaPackage can't currently complete the request, usually because of a temporary overload or maintenance. | 

### POST


**Operation ID:** `CreatePackagingGroup`

Creates a packaging group.

The packaging group holds one or more packaging configurations. When you create an asset, you specify the packaging group associated with the asset. The asset has playback endpoints for each packaging configuration within the group.


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | PackagingGroup |  `200 OK` responseThe list of tags is returned successfully. | 
| 403 | None |  `403 Forbidden` responseAWS Elemental MediaPackage cannot authorize the request, possibly due to insufficient authentication credentials. | 
| 404 | None |  `404 Not Found` responseAWS Elemental MediaPackage did not find a representation of the target resource. | 
| 422 | None |  `422 Unprocessable Entity` responseAWS Elemental MediaPackage could not process the instructions in the body of the request. | 
| 429 | None |  `429 Too Many Requests` responseOne of these two error conditions:Too many requests have been sent in a given amount of time.Your account has exceeded the quota allotted for the resource that you're creating. | 
| 500 | None |  `500 Internal Server Error` responseAn unexpected condition prevented AWS Elemental MediaPackage from fulfilling the request. | 
| 503 | None |  `Service unavailable` responseAWS Elemental MediaPackage can't currently complete the request, usually because of a temporary overload or maintenance. | 

### OPTIONS


Enable cross-origin resource sharing (CORS) by returning correct headers.


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | None |  `200 OK` responseThe list of tags is returned successfully. | 

## Schemas


### Request bodies


#### POST schema
POST

```
{
  "authorization": {
    "cdnIdentifierSecret": "string",
    "secretsRoleArn": "string"
  },
  "egressAccessLogs": {
    "logGroupName": "string"
  },
  "id": "string",
  "tags": {
  }
}
```

### Response bodies


#### PackagingGroupList schema
PackagingGroupList

```
{
  "nextToken": "string",
  "packagingGroups": [
    {
      "authorization": {
        "cdnIdentifierSecret": "string",
        "secretsRoleArn": "string"
      },
      "createdAt": "string",
      "domainName": "string",
      "egressAccessLogs": {
        "logGroupName": "string"
      },
      "id": "string",
      "arn": "string",
      "approximateAssetCount": integer,
      "tags": {
      }
    }
  ]
}
```

#### PackagingGroup schema
PackagingGroup

```
{
  "authorization": {
    "cdnIdentifierSecret": "string",
    "secretsRoleArn": "string"
  },
  "createdAt": "string",
  "domainName": "string",
  "egressAccessLogs": {
    "logGroupName": "string"
  },
  "id": "string",
  "arn": "string",
  "approximateAssetCount": integer,
  "tags": {
  }
}
```

## Properties


### Authorization


Parameters for enabling CDN authorization.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| cdnIdentifierSecret | string | True | The Amazon Resource Name (ARN) for the secret in AWS Secrets Manager that's used for CDN authorization. | 
| secretsRoleArn | string | True | The ARN for the IAM role that allows MediaPackage to communicate with AWS Secrets Manager. | 

### EgressAccessLogs


Configures egress access logs.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| logGroupName | string | False | Sets a custom Amazon CloudWatch log group name for egress logs. If a log group name isn't specified, the default name is used: `/aws/MediaPackage/EgressAccessLogs`. | 

### PackagingGroup


Parameters for a packaging group.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| approximateAssetCount | integer | False | The approximate number of assets in a packaging group. The number is approximate because the count is not updated immediately after adding or removing assets. | 
| arn | string | False | The ARN for the packaging group. You can get this from the response to any request to the packaging group. | 
| authorization | [Authorization](#packaging_groups-model-authorization) | False | Parameters for CDN authorization. | 
| createdAt | string | False | The date and time the PackagingGroup was created. | 
| domainName | string | False | The fully qualified domain name for assets in the PackagingGroup. | 
| egressAccessLogs | [EgressAccessLogs](#packaging_groups-model-egressaccesslogs) | False | The configuration parameters for egress access logging. | 
| id | string | False | Unique identifier that you assign to the packaging group. | 
| tags | [Tags](#packaging_groups-model-tags) | False | The tags to assign to the packaging group. | 

### PackagingGroupCreateParameters


Parameters for creating a packaging group.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| authorization | [Authorization](#packaging_groups-model-authorization) | False | Parameters for CDN authorization. | 
| egressAccessLogs | [EgressAccessLogs](#packaging_groups-model-egressaccesslogs) | False | The configuration parameters for egress access logging. | 
| id | string | True | Unique identifier that you assign to the packaging group. | 
| tags | [Tags](#packaging_groups-model-tags) | False | The tags to assign to the packaging group. | 

### PackagingGroupList


A collection of PackagingGroup records.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| nextToken | string | False | Pagination token. Use this token to request the next page of packaging groups results. | 
| packagingGroups | Array of type [PackagingGroup](#packaging_groups-model-packaginggroup) | False | A list of PackagingGroup records that are configured on this account in this AWS Region. | 

### Tags


A collection of tags associated with a resource.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| `*` | string | False |  |