

# Ejemplos de Amazon IVS que utilizan la AWS CLI
<a name="cli_ivs_code_examples"></a>

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Amazon IVS.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `batch-get-channel`
<a name="ivs_BatchGetChannel_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-channel`.

**AWS CLI**  
**Para obtener información de configuración de canal sobre varios canales**  
En el siguiente ejemplo de `batch-get-channel`, se enumera información sobre los canales especificados.  

```
aws ivs batch-get-channel \
    --arns arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
        arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl
```
Salida:  

```
{
    "channels": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "authorized": false,
            "containerFormat": "TS",
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": false,
            "latencyMode": "LOW",
            "multitrackInputConfiguration": {
                "enabled": false,
                "maximumResolution": "FULL_HD",
                "policy": "ALLOW"
            },
            "name": "channel-1",
            "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-1.abcdEFGH.m3u8",
            "preset": "",
            "playbackRestrictionPolicyArn": "",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "tags": {},
            "type": "STANDARD"
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl",
            "authorized": false,
            "containerFormat": "FRAGMENTED_MP4",
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": false,
            "latencyMode": "LOW",
            "multitrackInputConfiguration": {
                "enabled": true,
                "maximumResolution": "FULL_HD",
                "policy": "ALLOW"
            },
            "name": "channel-2",
            "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-2.abcdEFGH.m3u8",
            "preset": "",
            "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"",
            "recordingConfigurationArn": "",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "tags": {},
            "type": "STANDARD"
        }
    ]
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener detalles sobre la API, consulte [BatchGetChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/batch-get-channel.html) en la *Referencia de comandos de la AWS CLI*. 

### `batch-get-stream-key`
<a name="ivs_BatchGetStreamKey_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-stream-key`.

**AWS CLI**  
**Para obtener información sobre varias claves de transmisión**  
En el siguiente ejemplo de `batch-get-stream-key`, se obtiene información de las claves de transmisión especificadas.  

```
aws ivs batch-get-stream-key \
    --arns arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh \
       arn:aws:ivs:us-west-2:123456789012:stream-key/skSKIJKLmnop
```
Salida:  

```
{
    "streamKeys": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh",
            "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKIJKLmnop",
            "value": "sk_us-west-2_abcdABCDefgh_567890ghijkl",
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "tags": {}
        }
     ]
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener detalles sobre la API, consulte [BatchGetStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/batch-get-stream-key.html) en la *Referencia de comandos de la AWS CLI*. 

### `batch-start-viewer-session-revocation`
<a name="ivs_BatchStartViewerSessionRevocation_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `batch-start-viewer-session-revocation`.

**AWS CLI**  
**Para revocar las sesiones de los espectadores para varios pares de canal-ARN e ID de espectador**  
En el siguiente ejemplo de `batch-start-viewer-session-revocation`, se realiza la revocación de la sesión en varios pares de canal-ARN e ID-observador simultáneamente. La solicitud puede completarse con normalidad, pero devuelve valores en el campo de errores si quien llama no tiene permiso para revocar una sesión específica.  

```
aws ivs batch-start-viewer-session-revocation \
    --viewer-sessions '[{"channelArn":"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh1","viewerId":"abcdefg1","viewerSessionVersionsLessThanOrEqualTo":1234567890}, \
      {"channelArn":"arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh2","viewerId":"abcdefg2","viewerSessionVersionsLessThanOrEqualTo":1234567890}]'
```
Salida:  

```
{
    "errors": [
        {
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh1",
            "viewerId": "abcdefg1",
            "code": "403",
            "message": "not authorized",
        },
        {
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh2",
            "viewerId": "abcdefg2",
            "code": "403",
            "message": "not authorized",
        }
    ]
}
```
Para obtener más información, consulte [Configuración de canales privados](https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener detalles sobre la API, consulte [BatchStartViewerSessionRevocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/batch-start-viewer-session-revocation.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-channel`
<a name="ivs_CreateChannel_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-channel`.

**AWS CLI**  
**Ejemplo 1: crear un canal sin grabación**  
En el siguiente ejemplo de `create-channel`, se crea un nuevo canal y una clave de transmisión asociada para iniciar la transmisión.  

```
aws ivs create-channel \
    --name 'test-channel' \
    --no-insecure-ingest
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "authorized": false,
        "containerFormat": "TS",
        "name": "test-channel",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 2: crear un canal con la grabación habilitada, mediante el recurso RecordingConfiguration especificado por su ARN**  
En el siguiente ejemplo de `create-channel`, se crea un nuevo canal y una clave de transmisión asociada para iniciar la transmisión y se configura la grabación para el canal:  

```
aws ivs create-channel \
    --name test-channel-with-recording \
    --insecure-ingest \
    --recording-configuration-arn 'arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh'
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "TS",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 3: crear un canal con una política de restricción de reproducción especificada por su ARN**  
En el siguiente ejemplo de `create-channel`, se crea un nuevo canal y una clave de transmisión asociada para iniciar la transmisión y se configura la política de restricción de reproducción para el canal:  

```
aws ivs create-channel \
    --name test-channel-with-playback-restriction-policy\
    --insecure-ingest \
    --playback-restriction-policy-arn 'arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ'
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "TS",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 4: creación de un canal con la función multipista habilitada**  
En el siguiente ejemplo de `create-channel`, se crea un nuevo canal y una clave de transmisión asociada para iniciar la transmisión, y se habilita la multipista.  

```
aws ivs create-channel \
    --name 'test-channel' \
    --no-insecure-ingest \
    --container-format 'FRAGMENTED_MP4' \
    --multitrack-input-configuration '{"enabled": true,"maximumResolution": "FULL_HD","policy": "ALLOW"}'
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "authorized": false,
        "containerFormat": "FRAGMENTED_MP4",
        "name": "test-channel",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": true,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multitrack-video.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [CreateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-channel.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-playback-restriction-policy`
<a name="ivs_CreatePlaybackRestrictionPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-playback-restriction-policy`.

**AWS CLI**  
**Para crear una política de restricción de la reproducción**  
En el siguiente ejemplo de `create-playback-restriction-policy`, se crea una nueva política de restricción de reproducción.  

```
aws ivs create-playback-restriction-policy \
    --name "test-playback-restriction-policy" \
    --enable-strict-origin-enforcement \
    --tags "key1=value1, key2=value2" \
    --allowed-countries US MX \
    --allowed-origins https://www.website1.com https://www.website2.com
```
Salida:  

```
{
    "playbackRestrictionPolicy": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "allowedCountries": [
            "US",
            "MX"
        ],
        "allowedOrigins": [
            "https://www.website1.com",
            "https://www.website2.com"
        ],
        "enableStrictOriginEnforcement": true,
        "name": "test-playback-restriction-policy",
        "tags": {
            "key1": "value1",
            "key2": "value2"
        }
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [CreatePlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-playback-restriction-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-recording-configuration`
<a name="ivs_CreateRecordingConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-recording-configuration`.

**AWS CLI**  
**Para crear un recurso RecordingConfiguration**  
En el siguiente ejemplo de `create-recording-configuration`, se crea un recurso RecordingConfiguration para activar grabación en Amazon S3.  

```
aws ivs create-recording-configuration \
    --name "test-recording-config" \
    --recording-reconnect-window-seconds 60 \
    --tags "key1=value1, key2=value2" \
    --rendition-configuration renditionSelection="CUSTOM",renditions="HD" \
    --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=1,storage="LATEST",resolution="LOWEST_RESOLUTION" \
    --destination-configuration s3={bucketName=demo-recording-bucket}
```
Salida:  

```
{
    "recordingConfiguration": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
        "name": "test-recording-config",
        "destinationConfiguration": {
            "s3": {
                "bucketName": "demo-recording-bucket"
            }
        },
        "state": "CREATING",
        "tags": {
            "key1": "value1",
            "key2": "value2"
        },
        "thumbnailConfiguration": {
            "recordingMode": "INTERVAL",
            "targetIntervalSeconds": 1,
            "resolution": "LOWEST_RESOLUTION",
            "storage": [
                "LATEST"
            ]
        },
        "recordingReconnectWindowSeconds": 60,
        "renditionConfiguration": {
            "renditionSelection": "CUSTOM",
            "renditions": [
                "HD"
            ]
        }
    }
}
```
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener información sobre la API, consulte [CreateRecordingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-recording-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-stream-key`
<a name="ivs_CreateStreamKey_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-stream-key`.

**AWS CLI**  
**Para crear una clave de transmisión**  
En el siguiente ejemplo de `create-stream-key`, se crea una clave de transmisión para un ARN (Nombre de recurso de Amazon) específico.  

```
aws ivs create-stream-key \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
```
Salida:  

```
{
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [CreateStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/create-stream-key.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-channel`
<a name="ivs_DeleteChannel_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-channel`.

**AWS CLI**  
**Para eliminar un canal y las claves de transmisión asociadas**  
En el siguiente ejemplo de `delete-channel`, se elimina el canal con el ARN (Amazon Resource Name) especificado.  

```
aws ivs delete-channel \
    --arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [DeleteChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-channel.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-playback-key-pair`
<a name="ivs_DeletePlaybackKeyPair_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-playback-key-pair`.

**AWS CLI**  
**Para eliminar un par de claves de reproducción especificado**  
En el siguiente ejemplo de `delete-playback-key-pair`, se devuelve la huella digital del par de claves especificado.  

```
aws ivs delete-playback-key-pair \
    --arn arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Configuración de canales privados](https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener información sobre la API, consulte [DeletePlaybackKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-playback-key-pair.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-playback-restriction-policy`
<a name="ivs_DeletePlaybackRestrictionPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-playback-restriction-policy`.

**AWS CLI**  
**Para eliminar una política de restricción de la reproducción**  
En el siguiente ejemplo de `delete-playback-restriction-policy`, se elimina la política de restricción de reproducción con el ARN (Amazon Resource Name) de política especificado.  

```
aws ivs delete-playback-restriction-policy \
    --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [DeletePlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-playback-restriction-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-recording-configuration`
<a name="ivs_DeleteRecordingConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-recording-configuration`.

**AWS CLI**  
**Para eliminar el recurso RecordingConfiguration especificado por su ARN**  
En el siguiente ejemplo de `delete-recording-configuration`, se elimina el recurso RecordingConfiguration con el ARN especificado.  

```
aws ivs delete-recording-configuration \
    --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ"
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener información sobre la API, consulte [DeleteRecordingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-recording-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-stream-key`
<a name="ivs_DeleteStreamKey_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-stream-key`.

**AWS CLI**  
**Para eliminar una clave de transmisión**  
En el siguiente ejemplo de `delete-stream-key`, se elimina la clave de transmisión de un ARN (Amazon Resource Name) específico, por lo que ya no se puede utilizar para la transmisión.  

```
aws ivs delete-stream-key \
    --arn arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [DeleteStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/delete-stream-key.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-channel`
<a name="ivs_GetChannel_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-channel`.

**AWS CLI**  
**Para obtener la información de configuración de un canal**  
En el siguiente ejemplo de `get-channel`, se obtiene la configuración del canal para un ARN (Nombre de recurso de Amazon) de canal específico.  

```
aws ivs get-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh'
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "authorized": false,
        "containerFormat": "TS",
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "name": "channel-1",
        "playbackRestrictionPolicyArn": "",
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "tags": {}
        "type": "STANDARD",
    }
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para ver los detalles de la API, consulte [GetChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-channel.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-playback-key-pair`
<a name="ivs_GetPlaybackKeyPair_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-playback-key-pair`.

**AWS CLI**  
**Para obtener un par de claves de reproducción especificado**  
En el siguiente ejemplo de `get-playback-key-pair`, se devuelve la huella digital del par de claves especificado.  

```
aws ivs get-playback-key-pair \
    --arn arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh
```
Salida:  

```
{
    "keyPair": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh",
        "name": "my-playback-key",
        "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Configuración de canales privados](https://docs.aws.amazon.com/ivs/latest/userguide//private-channels.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener información sobre la API, consulte [GetPlaybackKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-playback-key-pair.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-playback-restriction-policy`
<a name="ivs_GetPlaybackRestrictionPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-playback-restriction-policy`.

**AWS CLI**  
**Para obtener la información de configuración de una política de restricción de reproducción**  
En el siguiente ejemplo de `get-playback-restriction-policy`, se obtiene la configuración de la política de restricción de reproducción con el ARN (Nombre de recurso de Amazon) de política especificado.  

```
aws ivs get-playback-restriction-policy \
    --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
```
Salida:  

```
{
    "playbackRestrictionPolicy": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "allowedCountries": [
            "US",
            "MX"
        ],
        "allowedOrigins": [
            "https://www.website1.com",
            "https://www.website2.com"
        ],
        "enableStrictOriginEnforcement": true,
        "name": "test-playback-restriction-policy",
        "tags": {
            "key1": "value1",
            "key2": "value2"
        }
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [GetPlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-playback-restriction-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-recording-configuration`
<a name="ivs_GetRecordingConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-recording-configuration`.

**AWS CLI**  
**Para obtener información sobre un recurso RecordingConfiguration**  
En el siguiente ejemplo de `get-recording-configuration`, se obtiene información del recurso RecordingConfiguration con el ARN especificado.  

```
aws ivs get-recording-configuration \
    --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ"
```
Salida:  

```
{
    "recordingConfiguration": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
        "destinationConfiguration": {
            "s3": {
                "bucketName": "demo-recording-bucket"
            }
        },
        "name": "test-recording-config",
        "recordingReconnectWindowSeconds": 60,
        "state": "ACTIVE",
        "tags": {
            "key1" : "value1",
            "key2" : "value2"
        },
        "thumbnailConfiguration": {
            "recordingMode": "INTERVAL",
            "targetIntervalSeconds": 1,
            "resolution": "LOWEST_RESOLUTION",
            "storage": [
                "LATEST"
            ]
        },
        "renditionConfiguration": {
            "renditionSelection": "CUSTOM",
            "renditions": [
                "HD"
            ]
        }
    }
}
```
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener información sobre la API, consulte [GetRecordingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-recording-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-stream-key`
<a name="ivs_GetStreamKey_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-stream-key`.

**AWS CLI**  
**Para obtener información acerca de un flujo**  
En el siguiente ejemplo de `get-stream-key`, se obtiene información sobre la clave de transmisión especificada.  

```
aws ivs get-stream-key \
    --arn arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh --region=us-west-2
```
Salida:  

```
{
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [GetStreamKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-stream-key.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-stream-session`
<a name="ivs_GetStreamSession_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-stream-session`.

**AWS CLI**  
**Para obtener los metadatos de una transmisión específica**  
En el siguiente ejemplo de `get-stream-session`, se obtiene la configuración de metadatos para el nombre de recurso de Amazon (ARN) de canal y de transmisión especificados; si no se proporciona `streamId`, se selecciona la transmisión más reciente del canal.  

```
aws ivs get-stream-session \
    --channel-arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --stream-id 'mystream'
```
Salida:  

```
{
    "streamSession": {
        "streamId": "mystream1",
        "startTime": "2023-06-26T19:09:28+00:00",
        "channel": {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "name": "mychannel",
            "latencyMode": "LOW",
            "type": "STANDARD",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "playbackUrl": "url-string",
            "authorized": false,
            "insecureIngest": false,
            "preset": ""
        },
        "ingestConfiguration": {
            "audio": {
                "channels": 2,
                "codec": "mp4a.40.2",
                "sampleRate": 8000,
                "targetBitrate": 46875,
                "track": "Track0"
            },
            "video": {
                "avcProfile": "Baseline",
                "avcLevel": "4.2",
                "codec": "avc1.42C02A",
                "encoder": "Lavf58.45.100",
                "level": "4.2",
                "profile": "Baseline",
                "targetBitrate": 8789062,
                "targetFramerate": 60,
                "track": "Track0",
                "videoHeight": 1080,
                "videoWidth": 1920
            }
        },
        "ingestConfigurations": {
            "audioConfigurations": [
                {
                    "channels": 2,
                    "codec": "mp4a.40.2",
                    "sampleRate": 8000,
                    "targetBitrate": 46875,
                    "track": "Track0"
                }
            ],
            "videoConfigurations": [
                {
                    "codec": "avc1.42C02A",
                    "encoder": "Lavf58.45.100",
                    "level": "4.2",
                    "profile": "Baseline",
                    "targetBitrate": 8789062,
                    "targetFramerate": 60,
                    "track": "Track0",
                    "videoHeight": 1080,
                    "videoWidth": 1920
                }
            ]
        },
        "recordingConfiguration": {
            "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
            "name": "test-recording-config",
            "destinationConfiguration": {
                "s3": {
                    "bucketName": "demo-recording-bucket"
                }
            },
            "state": "ACTIVE",
            "tags": {
                "key1": "value1",
                "key2": "value2"
            },
            "thumbnailConfiguration": {
                "recordingMode": "INTERVAL",
                "targetIntervalSeconds": 1,
                "resolution": "LOWEST_RESOLUTION",
                "storage": [
                    "LATEST"
                ]
            },
            "recordingReconnectWindowSeconds": 60,
            "renditionConfiguration": {
                "renditionSelection": "CUSTOM",
                "renditions": [
                    "HD"
                ]
            }
        },
        "truncatedEvents": [
            {
                "code": "StreamTakeoverInvalidPriority",
                "name": "Stream Takeover Failure",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:48+00:00"
            },
            {
                "name": "Stream Takeover",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:47+00:00"
            },
            {
                "name": "Recording Start",
                "type": "IVS Recording State Change",
                "eventTime": "2023-06-26T19:09:35+00:00"
            },
            {
                "name": "Stream Start",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:34+00:00"
            },
            {
                "name": "Session Created",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:28+00:00"
            }
        ]
    }
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [GetStreamSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-stream-session.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-stream`
<a name="ivs_GetStream_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-stream`.

**AWS CLI**  
**Para obtener información acerca de un flujo**  
En el siguiente ejemplo de `get-stream`, se obtiene información sobre la transmisión para el canal especificado.  

```
aws ivs get-stream \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
```
Salida:  

```
{
    "stream": {
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "startTime": "2020-05-05T21:55:38Z",
        "state": "LIVE",
        "health": "HEALTHY",
        "streamId": "st-ABCDEfghij01234KLMN5678",
        "viewerCount": 1
    }
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [GetStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/get-stream.html) en la *Referencia de comandos de AWS CLI*. 

### `import-playback-key-pair`
<a name="ivs_ImportPlaybackKeyPair_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `import-playback-key-pair`.

**AWS CLI**  
**Para importar la parte pública de un nuevo par de claves**  
En el siguiente ejemplo de `import-playback-key-pair`, se importa la clave pública especificada (como una cadena en formato PEM) y se devuelve el ARN y la huella digital del nuevo par de claves.  

```
aws ivs import-playback-key-pair \
    --name "my-playback-key" \
    --public-key-material "G1lbnQxOTA3BgNVBAMMMFdoeSBhcmUgeW91IGRl..."
```
Salida:  

```
{
    "keyPair": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh",
        "name": "my-playback-key",
        "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72",
        "tags": {}
    }
}
```
Para obtener más información, consulte [Configuración de canales privados](https://docs.aws.amazon.com/ivs/latest/userguide//private-channels.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener detalles sobre la API, consulte [ImportPlaybackKeyPair](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/import-playback-key-pair.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-channels`
<a name="ivs_ListChannels_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-channels`.

**AWS CLI**  
**Ejemplo 1: obtener información resumida de todos los canales**  
En el siguiente ejemplo de `list-channels`, se enumeran todos los canales de su cuenta de AWS.  

```
aws ivs list-channels
```
Salida:  

```
{
    "channels": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "name": "channel-1",
            "latencyMode": "LOW",
            "authorized": false,
            "insecureIngest": false,
            "preset": "",
            "playbackRestrictionPolicyArn": "",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
            "tags": {},
            "type": "STANDARD"
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl",
            "name": "channel-2",
            "latencyMode": "LOW",
            "authorized": false,
            "preset": "",
            "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
            "recordingConfigurationArn": "",
            "tags": {},
            "type": "STANDARD"
        }
    ]
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 2: obtener información resumida de todos los canales, filtrada por el ARN de RecordingConfiguration especificado**  
En el siguiente ejemplo de `list-channels`, se enumeran todos los canales de su cuenta de AWS que están asociados al ARN de RecordingConfiguration especificado.  

```
aws ivs list-channels \
    --filter-by-recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh"
```
Salida:  

```
{
    "channels": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "name": "channel-1",
            "latencyMode": "LOW",
            "authorized": false,
            "insecureIngest": false,
            "preset": "",
            "playbackRestrictionPolicyArn": "",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
            "tags": {},
            "type": "STANDARD"
        }
    ]
}
```
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 3: obtener información resumida de todos los canales, filtrada por el ARN de PlaybackRestrictionPolicy especificado**  
En el siguiente ejemplo de `list-channels`, se enumeran todos los canales de su cuenta de AWS que están asociados al ARN de PlaybackRestrictionPolicy especificado.  

```
aws ivs list-channels \
    --filter-by-playback-restriction-policy-arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"
```
Salida:  

```
{
    "channels": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl",
            "name": "channel-2",
            "latencyMode": "LOW",
            "authorized": false,
            "preset": "",
            "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
            "recordingConfigurationArn": "",
            "tags": {},
            "type": "STANDARD"
        }
    ]
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [ListChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-channels.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-playback-key-pairs`
<a name="ivs_ListPlaybackKeyPairs_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-playback-key-pairs`.

**AWS CLI**  
**Para obtener información resumida sobre todos los pares de claves de reproducción**  
En el siguiente ejemplo de `list-playback-key-pairs`, se obtiene información sobre todos los pares de claves.  

```
aws ivs list-playback-key-pairs
```
Salida:  

```
{
    "keyPairs": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh",
            "name": "test-key-0",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/ijkl5678mnop",
            "name": "test-key-1",
            "tags": {}
        }
    ]
}
```
Para obtener más información, consulte [Configuración de canales privados](https://docs.aws.amazon.com/ivs/latest/userguide//private-channels.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener información sobre la API, consulte [ListPlaybackKeyPairs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-playback-key-pairs.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-playback-restriction-policies`
<a name="ivs_ListPlaybackRestrictionPolicies_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-playback-restriction-policies`.

**AWS CLI**  
**Para obtener información resumida sobre todas las políticas de restricción de reproducción**  
En el siguiente ejemplo de `list-playback-restriction-policies`, se enumeran todas las políticas de restricción de reproducción de su cuenta de AWS.  

```
aws ivs list-playback-restriction-policies
```
Salida:  

```
{
    "playbackRestrictionPolicies": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
            "allowedCountries": [
                "US",
                "MX"
            ],
            "allowedOrigins": [
                "https://www.website1.com",
                "https://www.website2.com"
            ],
            "enableStrictOriginEnforcement": true,
            "name": "test-playback-restriction-policy",
            "tags": {
                "key1": "value1",
                "key2": "value2"
            }
        }
    ]
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [ListPlaybackRestrictionPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-playback-restriction-policies.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-recording-configurations`
<a name="ivs_ListRecordingConfigurations_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-recording-configurations`.

**AWS CLI**  
**Para enumerar todos los recursos RecordingConfiguration creados en esta cuenta**  
En el siguiente ejemplo de `list-recording-configurations`, se obtiene información de todos los recursos RecordingConfiguration de su cuenta.  

```
aws ivs list-recording-configurations
```
Salida:  

```
{
    "recordingConfigurations": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
            "name": "test-recording-config-1",
            "destinationConfiguration": {
                "s3": {
                    "bucketName": "demo-recording-bucket-1"
                }
            },
            "state": "ACTIVE",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/CD12abcdGHIJ",
            "name": "test-recording-config-2",
            "destinationConfiguration": {
                "s3": {
                    "bucketName": "demo-recording-bucket-2"
                }
            },
            "state": "ACTIVE",
            "tags": {}
        }
    ]
}
```
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener más información sobre la API, consulte [ListRecordingConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-recording-configurations.html) en *Referencia de comandos de la AWS CLI*. 

### `list-stream-keys`
<a name="ivs_ListStreamKeys_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-stream-keys`.

**AWS CLI**  
**Para obtener una lista de claves de transmisión**  
En el siguiente ejemplo de `list-stream-keys`, se enumeran todas las claves de transmisión de un ARN (Nombre de recurso de Amazon) especificado.  

```
aws ivs list-stream-keys \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
```
Salida:  

```
{
    "streamKeys": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "tags": {}
        }
    ]
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener detalles de la API, consulte [ListStreamKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-stream-keys.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-stream-sessions`
<a name="ivs_ListStreamSessions_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-stream-sessions`.

**AWS CLI**  
**Para obtener un resumen de las transmisiones actuales y anteriores de un canal específico en la región de AWS actual**  
En el siguiente ejemplo de `list-stream-sessions`, se proporciona información resumida de las transmisiones de un ARN (Nombre de recurso de Amazon) de canal específico.  

```
aws ivs list-stream-sessions \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --max-results 25 \
    --next-token ""
```
Salida:  

```
{
    "nextToken": "set-2",
    "streamSessions": [
        {
            "startTime": 1641578182,
            "endTime": 1641579982,
            "hasErrorEvent": false,
            "streamId": "mystream"
        }
        ...
    ]
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [ListStreamSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-stream-sessions.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-streams`
<a name="ivs_ListStreams_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-streams`.

**AWS CLI**  
**Para obtener una lista de las transmisiones en directo y su estado**  
En el siguiente ejemplo de `list-streams`, se enumeran todas las transmisiones en directo de la cuenta de AWS.  

```
aws ivs list-streams
```
Salida:  

```
{
   "streams": [
        {
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "state": "LIVE",
            "health": "HEALTHY",
            "streamId": "st-ABCDEfghij01234KLMN5678",
            "viewerCount": 1
        }
    ]
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-streams.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-tags-for-resource`
<a name="ivs_ListTagsForResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.

**AWS CLI**  
**Para enumerar todas las etiquetas de un recurso de AWS (por ejemplo, channel, stream key)**  
En el siguiente ejemplo de `list-tags-for-resource`, se enumeran todas las etiquetas de un ARN (Nombre de recurso de Amazon) de recurso específico.  

```
aws ivs list-tags-for-resource \
    --resource-arn arn:aws:ivs:us-west-2:12345689012:channel/abcdABCDefgh
```
Salida:  

```
{
    "tags":
    {
        "key1": "value1",
        "key2": "value2"
    }
}
```
Para obtener más información, consulte [Tagging](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) en la *Referencia de la API de Amazon Interactive Video Service*.  
+  Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `put-metadata`
<a name="ivs_PutMetadata_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `put-metadata`.

**AWS CLI**  
**Para insertar metadatos en la transmisión activa para un canal específico**  
En el siguiente ejemplo de `put-metadata`, se insertan los metadatos indicados en la transmisión del canal especificado.  

```
aws ivs put-metadata \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --metadata '{"my": "metadata"}'
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener más información sobre la API, consulte [PutMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/put-metadata.html) en la *Referencia de comandos de la AWS CLI*. 

### `start-viewer-session-revocation`
<a name="ivs_StartViewerSessionRevocation_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `start-viewer-session-revocation`.

**AWS CLI**  
**Para revocar las sesiones de los espectadores para varios pares de canal-ARN y ID-de espectador**  
En el siguiente ejemplo de `start-viewer-session-revocation`, se inicia el proceso de revocación de la sesión del observador asociada a un ARN de canal e ID de observador específicos hasta el número de versión de sesión especificado. Si no se proporciona la versión, el valor predeterminado es 0.  

```
aws ivs batch-start-viewer-session-revocation \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --viewer-id abcdefg \
    --viewer-session-versions-less-than-or-equal-to 1234567890
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Configuración de canales privados](https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html) en la *Guía del usuario de Amazon Interactive Video Service*.  
+  Para obtener información sobre la API, consulte [StartViewerSessionRevocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/start-viewer-session-revocation.html) en la *Referencia de comandos de la AWS CLI*. 

### `stop-stream`
<a name="ivs_StopStream_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `stop-stream`.

**AWS CLI**  
**Para detener una transmisión específica**  
En el siguiente ejemplo de `stop-stream`, se detiene la transmisión en el canal especificado.  

```
aws ivs stop-stream \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [StopStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/stop-stream.html) en la *Referencia de comandos de AWS CLI*. 

### `tag-resource`
<a name="ivs_TagResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.

**AWS CLI**  
**Para agregar o actualizar todas las etiquetas de un recurso de AWS (por ejemplo, channel, stream key)**  
En el siguiente ejemplo de `tag-resource`, se agregan o actualizan las etiquetas de un ARN (Nombre de recurso de Amazon) de recurso específico.  

```
aws ivs tag-resource \
    --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --tags "tagkey1=tagvalue1, tagkey2=tagvalue2"
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Tagging](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) en la *Referencia de la API de Amazon Interactive Video Service*.  
+  Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/tag-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `untag-resource`
<a name="ivs_UntagResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.

**AWS CLI**  
**Para eliminar todas las etiquetas de un recurso de AWS (por ejemplo, channel, stream key)**  
En el siguiente ejemplo de `untag-resource`, se eliminan etiquetas específicas de un ARN (Nombre de recurso de Amazon) de recurso específico.  

```
aws ivs untag-resource \
    --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --tag-keys "tagkey1, tagkey2"
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Tagging](https://docs.aws.amazon.com/ivs/latest/APIReference/Welcome.html) en la *Referencia de la API de Amazon Interactive Video Service*.  
+  Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/untag-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-channel`
<a name="ivs_UpdateChannel_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-channel`.

**AWS CLI**  
**Ejemplo 1: actualizar la información de configuración de un canal**  
En el siguiente ejemplo de `update-channel`, se actualiza la configuración del canal para un ARN de canal específico para cambiar el nombre de canal. Esto no afecta a la transmisión en curso de este canal; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --name 'channel-1' \
    --insecure-ingest
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "channel-1",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
}
```
Para obtener más información, consulte [Create a Channel](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started-create-channel.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 2: actualizar la configuración de un canal para permitir la grabación**  
En el siguiente ejemplo de `update-channel`, se actualiza la configuración del canal para un ARN de canal específico para activar la grabación. Esto no afecta a la transmisión en curso de este canal; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --no-insecure-ingest \
    --recording-configuration-arn 'arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh'
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}
```
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 3: actualizar la configuración de un canal para deshabilitar la grabación**  
En el siguiente ejemplo de `update-channel`, se actualiza la configuración del canal para un ARN de canal específico para desactivar la grabación. Esto no afecta a la transmisión en curso de este canal; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --recording-configuration-arn ''
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}
```
Para obtener más información, consulte [Record to Amazon S3](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/record-to-s3.html) en la *Guía del usuario de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 4: actualizar la configuración de un canal para habilitar la restricción de reproducción**  
En el siguiente ejemplo de `update-channel`, se actualiza la configuración del canal para un ARN de canal específico para activar la política de restricción de reproducción. Esto no afecta a la transmisión en curso de este canal; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --no-insecure-ingest \
    --playback-restriction-policy-arn 'arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ'
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 5: actualizar la configuración de un canal para deshabilitar la restricción de reproducción**  
En el siguiente ejemplo de `update-channel`, se actualiza la configuración del canal para un ARN de canal específico para desactivar la restricción de reproducción. Esto no afecta a la transmisión en curso de este canal; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --playback-restriction-policy-arn ''
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "containerFormat": "TS",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDeFghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 6: actualización de la configuración de un canal para permitir la multipista**  
En el siguiente ejemplo de `update-channel`, se actualiza la configuración del canal para un ARN de canal específico para habilitar la multipista. Esto no afecta a la transmisión en curso de este canal; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --container-format 'FRAGMENTED_MP4' \
    --multitrack-input-configuration '{"enabled": true,"maximumResolution": "FULL_HD","policy": "ALLOW"}'
```
Salida:  

```
{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "FRAGMENTED_MP4",
        "name": "test-channel-with-multitrack",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": true,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multitrack-video.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
**Ejemplo 7: actualización de la configuración de un canal para desactivar la restricción de reproducción**  
En el siguiente ejemplo de `update-channel`, se actualiza la configuración del canal para un ARN de canal específico para desactivar la multipista. Esto no afecta a la transmisión en curso de este canal; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-channel \
    --arn 'arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh' \
    --container-format 'TS' \
    --multitrack-input-configuration '{"enabled": false}'
```
Salida:  

```
{
    "channel": {
        ""arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "containerFormat": "TS",
        "name": "test-channel-with-multitrack",
        "latencyMode": "LOW",
        "multitrackInputConfiguration": {
            "enabled": false,
            "maximumResolution": "FULL_HD",
            "policy": "ALLOW"
        },
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multitrack-video.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener información sobre la API, consulte [UpdateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/update-channel.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-playback-restriction-policy`
<a name="ivs_UpdatePlaybackRestrictionPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-playback-restriction-policy`.

**AWS CLI**  
**Para actualizar una política de restricción de reproducción**  
En el siguiente ejemplo de `update-playback-restriction-policy`, se actualiza la política de restricción de reproducción con el ARN de política especificado para deshabilitar la aplicación estricta del origen. Esto no afecta a la transmisión en curso del canal asociado; debe detener y reiniciar la transmisión para que los cambios surtan efecto.  

```
aws ivs update-playback-restriction-policy \
    --arn "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ" \
    --no-enable-strict-origin-enforcement
```
Salida:  

```
{
    "playbackRestrictionPolicy": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "allowedCountries": [
            "US",
            "MX"
        ],
        "allowedOrigins": [
            "https://www.website1.com",
            "https://www.website2.com"
        ],
        "enableStrictOriginEnforcement": false,
        "name": "test-playback-restriction-policy",
        "tags": {
            "key1": "value1",
            "key2": "value2"
        }
    }
}
```
Para obtener más información, consulte [Contenido y espectadores no deseados en IVS](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/undesired-content.html) en la *Guía del usuario de Guía de Transmisión de baja latencia de Amazon IVS*.  
+  Para obtener detalles sobre la API, consulte [UpdatePlaybackRestrictionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs/update-playback-restriction-policy.html) en la *Referencia de comandos de la AWS CLI*. 