IVSEjemplos de Amazon que utilizan AWS CLI - AWS SDKEjemplos de código
Acciones

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

IVSEjemplos de Amazon que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface mediante AmazonIVS.

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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

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

AWS CLI

Para obtener información sobre la configuración de varios canales

En el siguiente batch-get-channel ejemplo, se muestra 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,
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": false,
            "latencyMode": "LOW",
            "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,
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": true,
            "latencyMode": "LOW",
            "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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte BatchGetChannella Referencia de AWS CLI comandos.

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

AWS CLI

Para obtener información sobre varias claves de transmisión

En el siguiente batch-get-stream-key ejemplo, se obtiene información sobre las claves de flujo 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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte BatchGetStreamKeyla Referencia de AWS CLI comandos.

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

AWS CLI

Para revocar las sesiones de espectadores para varios pares de ID de canal ARN e ID de espectador

En el siguiente batch-start-viewer-session-revocation ejemplo, se realiza la revocación de la sesión en varios pares de ID de canal ARN e ID de espectador de forma simultánea. La solicitud puede completarse con normalidad, pero devuelve valores en el campo de errores si la persona que 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 en la Guía del usuario de Amazon Interactive Video Service.

En el siguiente ejemplo de código se muestra cómo usar create-channel.

AWS CLI

Ejemplo 1: Para crear un canal sin grabación

El siguiente create-channel ejemplo crea un canal nuevo 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,
        "name": "test-channel",
        "latencyMode": "LOW",
        "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 Crear un canal en la Guía del usuario IVS de baja latencia.

Ejemplo 2: Para crear un canal con la grabación habilitada, utilice el RecordingConfiguration recurso especificado por su ARN

El siguiente create-channel ejemplo crea un canal nuevo y una clave de transmisión asociada para iniciar la transmisión y 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",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "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 Grabar en Amazon S3 en la Guía del usuario IVS de baja latencia.

Ejemplo 3: Para crear un canal con una política de restricción de reproducción especificada por su ARN

El siguiente create-channel ejemplo crea un canal nuevo y una clave de transmisión asociada para iniciar la transmisión, y configura una 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",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "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 no deseado y espectadores en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte la Referencia CreateChannelde AWS CLI comandos.

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

AWS CLI

Para crear una política de restricción de reproducción

El siguiente create-playback-restriction-policy ejemplo 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 no deseado y espectadores en la Guía del usuario de IVSbaja latencia.

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

AWS CLI

Para crear un RecordingConfiguration recurso

El siguiente create-recording-configuration ejemplo crea un RecordingConfiguration recurso para permitir la 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 Grabar en Amazon S3 en la Guía del usuario de Amazon Interactive Video Service.

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

AWS CLI

Para crear una clave de flujo

En el siguiente create-stream-key ejemplo, se crea una clave de flujo para un determinado ARN (Amazon Resource Name).

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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte CreateStreamKeyla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-channel.

AWS CLI

Para eliminar un canal y sus claves de transmisión asociadas

En el siguiente delete-channel ejemplo, 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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte DeleteChannella Referencia de AWS CLI comandos.

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

AWS CLI

Para eliminar un par de claves de reproducción especificado

En el siguiente delete-playback-key-pair ejemplo, 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 en la Guía del usuario de Amazon Interactive Video Service.

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

AWS CLI

Para eliminar una política de restricción de reproducción

El siguiente delete-playback-restriction-policy ejemplo elimina la política de restricción de reproducción con la política especificada (ARNAmazon Resource Name).

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 no deseado y espectadores en la Guía del IVS usuario de baja latencia.

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

AWS CLI

Para eliminar el RecordingConfiguration recurso especificado por su ARN

En el siguiente delete-recording-configuration ejemplo, se elimina el RecordingConfiguration recurso con lo especificadoARN.

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 Grabar en Amazon S3 en la Guía del usuario de Amazon Interactive Video Service.

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

AWS CLI

Para eliminar una clave de flujo

En el siguiente delete-stream-key ejemplo, se elimina la clave de transmisión de un elemento especificado ARN (Amazon Resource Name), por lo que ya no se puede usar para transmitir.

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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte DeleteStreamKeyla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar get-channel.

AWS CLI

Para obtener la información de configuración de un canal

El siguiente get-channel ejemplo obtiene la configuración del canal para un canal específico ARN (Amazon Resource Name).

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",
        "name": "channel-1",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "preset": "",
        "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
        "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",
        "tags": {}
    }
}

Para obtener más información, consulte Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte GetChannella Referencia de AWS CLI comandos.

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

AWS CLI

Para obtener un par de claves de reproducción específico

En el siguiente get-playback-key-pair ejemplo, 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 en la Guía del usuario de Amazon Interactive Video Service.

  • Para API obtener más información, consulte GetPlaybackKeyPairla Referencia de AWS CLI comandos.

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

AWS CLI

Para obtener la información de configuración de una política de restricción de reproducción

El siguiente get-playback-restriction-policy ejemplo obtiene la configuración de la política de restricción de reproducción con la política especificada (ARNAmazon Resource Name).

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 no deseado y espectadores en la Guía del IVS usuario de baja latencia.

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

AWS CLI

Para obtener información sobre un RecordingConfiguration recurso

En el siguiente get-recording-configuration ejemplo, se obtiene información sobre el RecordingConfiguration recurso especificadoARN.

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 Grabar en Amazon S3 en la Guía del usuario de Amazon Interactive Video Service.

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

AWS CLI

Para obtener información sobre una transmisión

En el siguiente get-stream-key ejemplo, se obtiene información sobre la clave de flujo 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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte GetStreamKeyla Referencia de AWS CLI comandos.

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

AWS CLI

Para obtener los metadatos de una transmisión específica

El siguiente get-stream-session ejemplo obtiene la configuración de metadatos para el canal especificado ARN (Amazon Resource Name) y la transmisión especificada; si no streamId se proporciona, 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",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "playbackUrl": "url-string",
            "authorized": false,
            "insecureIngest": false,
            "preset": ""
        },
        "ingestConfiguration": {
            "video": {
                "avcProfile": "Baseline",
                "avcLevel": "4.2",
                "codec": "avc1.42C02A",
                "encoder": "Lavf58.45.100",
                "targetBitrate": 8789062,
                "targetFramerate": 60,
                "videoHeight": 1080,
                "videoWidth": 1920
            },
            "audio": {
                "codec": "mp4a.40.2",
                "targetBitrate": 46875,
                "sampleRate": 8000,
                "channels": 2
            }
        },
        "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": [
            {
                "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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte GetStreamSessionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar get-stream.

AWS CLI

Para obtener información sobre una transmisión

El siguiente get-stream ejemplo obtiene información sobre la transmisión del 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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte GetStreamla Referencia de AWS CLI comandos.

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

AWS CLI

Para importar la parte pública de un nuevo key pair

El siguiente import-playback-key-pair ejemplo importa la clave pública especificada (especificada como una cadena en PEM formato) y 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 en la Guía del usuario de Amazon Interactive Video Service.

En el siguiente ejemplo de código se muestra cómo usar list-channels.

AWS CLI

Ejemplo 1: Para obtener información resumida sobre todos los canales

En el siguiente list-channels ejemplo, se enumeran todos los canales de tu AWS cuenta.

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 Crear un canal en la Guía del usuario IVS de baja latencia.

Ejemplo 2: Para obtener información resumida sobre todos los canales, filtrada por los especificados RecordingConfiguration ARN

En el siguiente list-channels ejemplo, se enumeran todos los canales de su AWS cuenta que están asociados al canal especificado RecordingConfiguration ARN.

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 Grabar en Amazon S3 en la Guía del usuario IVS de baja latencia.

Ejemplo 3: Para obtener información resumida sobre todos los canales, filtrada según lo especificado PlaybackRestrictionPolicy ARN

En el siguiente list-channels ejemplo, se enumeran todos los canales de su AWS cuenta que están asociados al canal especificado PlaybackRestrictionPolicy ARN.

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 no deseado y espectadores en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte la Referencia ListChannelsde AWS CLI comandos.

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

AWS CLI

Para obtener información resumida sobre todos los pares de claves de reproducción

El siguiente list-playback-key-pairs ejemplo devuelve 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 en la Guía del usuario de Amazon Interactive Video Service.

  • Para API obtener más información, consulte ListPlaybackKeyPairsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar 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 list-playback-restriction-policies ejemplo, se enumeran todas las políticas de restricción de reproducción de su AWS cuenta.

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 no deseado y espectadores en la Guía del usuario IVS de baja latencia.

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

AWS CLI

Para ver una lista de todos los RecordingConfiguration recursos creados en esta cuenta

En el siguiente list-recording-configurations ejemplo, se obtiene información sobre todos RecordingConfiguration los recursos de la 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 Grabar en Amazon S3 en la Guía del usuario de Amazon Interactive Video Service.

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

AWS CLI

Para obtener una lista de claves de transmisión

En el siguiente list-stream-keys ejemplo, se enumeran todas las claves de flujo de un determinado ARN (Amazon Resource Name).

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": {}
        }
    ]
}

FForPara obtener más información, consulte Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte ListStreamKeysla Referencia de AWS CLI comandos.

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

AWS CLI

Para obtener un resumen de las transmisiones actuales y anteriores de un canal específico en la AWS región actual

El siguiente list-stream-sessions ejemplo proporciona información resumida de las transmisiones de un canal específico ARN (Amazon Resource Name).

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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte ListStreamSessionsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar list-streams.

AWS CLI

Para obtener una lista de las transmisiones en directo y su estado

En el siguiente list-streams ejemplo, se enumeran todas las transmisiones en directo de tu AWS cuenta.

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, consulta Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte ListStreamsla Referencia de AWS CLI comandos.

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

AWS CLI

Para enumerar todas las etiquetas de un AWS recurso (por ejemplo: canal, clave de flujo)

En el siguiente list-tags-for-resource ejemplo, se enumeran todas las etiquetas de un recurso específico ARN (Amazon Resource Name).

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 Etiquetado en la APIreferencia de Amazon Interactive Video Service.

  • Para API obtener más información, consulte ListTagsForResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar put-metadata.

AWS CLI

Para insertar metadatos en la transmisión activa de un canal específico

En el siguiente put-metadata ejemplo, 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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte PutMetadatala Referencia de AWS CLI comandos.

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

AWS CLI

Para revocar la sesión de un espectador para un par determinado de múltiples canales ARN e ID de espectador

En el siguiente start-viewer-session-revocation ejemplo, se inicia el proceso de revocación de la sesión de espectador asociada a un canal ARN y un ID de espectador específicos, hasta el número de versión de la sesión especificado, inclusive. 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 en la Guía del usuario de Amazon Interactive Video Service.

En el siguiente ejemplo de código se muestra cómo usar stop-stream.

AWS CLI

Para detener una transmisión específica

El siguiente stop-stream ejemplo 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 Crear un canal en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte StopStreamla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar tag-resource.

AWS CLI

Para añadir o actualizar las etiquetas de un AWS recurso (por ejemplo: canal, clave de transmisión)

En el siguiente tag-resource ejemplo, se añaden o actualizan las etiquetas de un recurso específico ARN (Amazon Resource Name).

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 Etiquetado en la APIreferencia de Amazon Interactive Video Service.

  • Para API obtener más información, consulte TagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar untag-resource.

AWS CLI

Para eliminar las etiquetas de un AWS recurso (por ejemplo: canal, clave de transmisión)

El siguiente untag-resource ejemplo elimina las etiquetas especificadas para un recurso específico ARN (Amazon Resource Name).

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 Etiquetado en la APIreferencia de Amazon Interactive Video Service.

  • Para API obtener más información, consulte UntagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar update-channel.

AWS CLI

Ejemplo 1: Para actualizar la información de configuración de un canal

El siguiente update-channel ejemplo actualiza la configuración del canal de un canal específico ARN para cambiar el nombre del 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",
        "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 Crear un canal en la Guía del usuario IVS de baja latencia.

Ejemplo 2: Para actualizar la configuración de un canal para permitir la grabación

El siguiente update-channel ejemplo actualiza la configuración del canal de un canal específico ARN para permitir 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",
        "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 Grabar en Amazon S3 en la Guía del usuario IVS de baja latencia.

Ejemplo 3: Para actualizar la configuración de un canal para deshabilitar la grabación

El siguiente update-channel ejemplo actualiza la configuración del canal de un canal específico para inhabilitar ARN 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",
        "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 Grabar en Amazon S3 en la Guía del usuario IVS de baja latencia.

Ejemplo 4: Para actualizar la configuración de un canal para habilitar la restricción de reproducción

El siguiente update-channel ejemplo actualiza la configuración del canal de un canal específico ARN para aplicar una 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",
        "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 no deseado y espectadores en la Guía del usuario IVS de baja latencia.

Ejemplo 5: Para actualizar la configuración de un canal para deshabilitar la restricción de reproducción

El siguiente update-channel ejemplo actualiza la configuración del canal de un canal específico para inhabilitar ARN 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",
        "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 no deseado y espectadores en la Guía del usuario IVS de baja latencia.

  • Para API obtener más información, consulte la Referencia UpdateChannelde AWS CLI comandos.

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

AWS CLI

Para actualizar una política de restricción de reproducción

El siguiente update-playback-restriction-policy ejemplo actualiza la política de restricción de reproducción con la política especificada ARN para deshabilitar la aplicación estricta de Origin. 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 no deseado y espectadores en la Guía del usuario IVS de baja latencia.