# Channels id Configure\$1logs


Configures access logs for a channel. For information about access logs, see [Access logging](https://docs.aws.amazon.com/mediapackage/latest/ug/access-logging.html).

## URI


`/channels/id/configure_logs`

## HTTP methods


### PUT


**Operation ID:** `ConfigureLogs`

Configures access logs for a channel.


**Path parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| id | String | True | Identifier for the object that you are working on. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | Channel |  `200 OK` responseThe channel is updated 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 CORS by returning correct headers.


**Path parameters**  

| Name | Type | Required | Description | 
| --- |--- |--- |--- |
| id | String | True | Identifier for the object that you are working on. | 


**Responses**  

| Status code | Response model | Description | 
| --- |--- |--- |
| 200 | None | Default response for CORS method. | 

## Schemas


### Request bodies


#### PUT schema
PUT

```
{
  "ingressAccessLogs": {
    "logGroupName": "string"
  },
  "egressAccessLogs": {
    "logGroupName": "string"
  }
}
```

### Response bodies


#### Channel schema
Channel

```
{
  "createdAt": "string",
  "ingressAccessLogs": {
    "logGroupName": "string"
  },
  "egressAccessLogs": {
    "logGroupName": "string"
  },
  "description": "string",
  "hlsIngest": {
    "ingestEndpoints": [
      {
        "password": "string",
        "id": "string",
        "url": "string",
        "username": "string"
      }
    ]
  },
  "id": "string",
  "arn": "string",
  "tags": {
  }
}
```

## Properties


### Channel


Channel configuration.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| arn | string | False | The channel's unique system-generated resource name, based on the AWS record. | 
| createdAt | string | False | The date and time the Channel was created. | 
| description | string | False | Any descriptive information that you want to add to the channel for future identification purposes. | 
| egressAccessLogs | [EgressAccessLogs](#channels-id-configure_logs-model-egressaccesslogs) | False | Configures egress access logs. | 
| hlsIngest | [HlsIngest](#channels-id-configure_logs-model-hlsingest) | False | System-generated information about the channel. | 
| id | string | False | Unique identifier that you assign to the channel. | 
| ingressAccessLogs | [IngressAccessLogs](#channels-id-configure_logs-model-ingressaccesslogs) | False | Configures ingress access logs. | 
| tags | [Tags](#channels-id-configure_logs-model-tags) | False | The tags assigned to the channel. | 

### ConfigureLogsParameters


Access log configuration parameters.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| egressAccessLogs | [EgressAccessLogs](#channels-id-configure_logs-model-egressaccesslogs) | False | Configures egress access logs. | 
| ingressAccessLogs | [IngressAccessLogs](#channels-id-configure_logs-model-ingressaccesslogs) | False | Configures ingress access logs. | 

### EgressAccessLogs


Egress access log configuration parameters.


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

### HlsIngest


HLS ingest configuration.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| ingestEndpoints | Array of type [IngestEndpoint](#channels-id-configure_logs-model-ingestendpoint) | False | The input URL where the source stream should be sent. | 

### IngestEndpoint


An endpoint for ingesting source content for a channel.


| Property | Type | Required | Description | 
| --- |--- |--- |--- |
| id | string | False | The system-generated unique identifier for the IngestEndpoint. | 
| password | string | False | The system-generated password for WebDAV input authentication. | 
| url | string | False | The input URL where the source stream should be sent. | 
| username | string | False | The system-generated username for WebDAV input authentication. | 

### IngressAccessLogs


Ingress access log configuration parameters.


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

### Tags


A collection of tags associated with a resource.

Value description: 
+  **Property**: `"key1": "value1"` 
+  **Type**: string
+  **Required**: True
+  **Description**: A comma-separated list of tag key:value pairs that you define. For example:

  ```
   {
     "Key1": "Value1",
     "Key2": "Value2"
   }
  ```


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

## See also


For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

### ConfigureLogs

+ [AWS Command Line Interface V2](/goto/cli2/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for .NET V4](/goto/DotNetSDKV4/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for C\$1\$1](/goto/SdkForCpp/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for Go v2](/goto/SdkForGoV2/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for Java V2](/goto/SdkForJavaV2/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for JavaScript V3](/goto/SdkForJavaScriptV3/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for Kotlin](/goto/SdkForKotlin/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for PHP V3](/goto/SdkForPHPV3/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for Python](/goto/boto3/mediapackage-2017-10-12/ConfigureLogs)
+ [AWS SDK for Ruby V3](/goto/SdkForRubyV3/mediapackage-2017-10-12/ConfigureLogs)