Esempi di utilizzo di Amazon IVS AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi AWS SDK nel repository AWS Doc SDK Examples. GitHub

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di utilizzo di Amazon IVS AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando Amazon IVS. AWS Command Line Interface

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, dove puoi trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarebatch-get-channel.

AWS CLI

Per ottenere informazioni sulla configurazione dei canali su più canali

L'batch-get-channelesempio seguente elenca le informazioni sui canali specificati.

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

Output:

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

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command BatchGetChannelReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarebatch-get-stream-key.

AWS CLI

Per ottenere informazioni su più chiavi di streaming

L'batch-get-stream-keyesempio seguente ottiene informazioni sulle chiavi di stream specificate.

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

Output:

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

Per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

Il seguente esempio di codice mostra come utilizzarebatch-start-viewer-session-revocation.

AWS CLI

Per revocare le sessioni di visualizzazione per più coppie Channel-ARN e Viewer-ID

L'batch-start-viewer-session-revocationesempio seguente esegue la revoca della sessione su più coppie channel-ARN e Viewer-ID contemporaneamente. La richiesta può essere completata normalmente, ma restituisce valori nel campo degli errori se il chiamante non è autorizzato a revocare la sessione specificata.

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}]'

Output:

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

Per maggiori informazioni, consulta Impostazione dei canali privati nella Guida per l'utente di Amazon Interactive Video Service.

Il seguente esempio di codice mostra come utilizzarecreate-channel.

AWS CLI

Esempio 1: creare un canale senza registrazione

L'create-channelesempio seguente crea un nuovo canale e una chiave di streaming associata per avviare lo streaming.

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

Output:

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

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

Esempio 2: creare un canale con la registrazione abilitata, utilizzando la RecordingConfiguration risorsa specificata dal relativo ARN

L'create-channelesempio seguente crea un nuovo canale e una chiave di streaming associata per avviare lo streaming e imposta la registrazione per il canale:

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

Output:

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

Per ulteriori informazioni, consulta Record to Amazon S3 nella IVS Low-Latency User Guide.

Esempio 3: creare un canale con una politica di restrizione della riproduzione specificata dal relativo ARN

L'create-channelesempio seguente crea un nuovo canale e una chiave di streaming associata per avviare lo streaming e imposta una politica di restrizione della riproduzione per il canale:

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'

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Esempio 4: creare un canale con multitraccia abilitato

L'create-channelesempio seguente crea un nuovo canale e una chiave di streaming associata per avviare lo streaming e abilita il multitraccia.

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

Output:

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

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command CreateChannelReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarecreate-playback-restriction-policy.

AWS CLI

Per creare una politica di restrizione della riproduzione

L'create-playback-restriction-policyesempio seguente crea una nuova politica di restrizione della riproduzione.

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

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Il seguente esempio di codice mostra come utilizzarecreate-recording-configuration.

AWS CLI

Per creare una RecordingConfiguration risorsa

L'create-recording-configurationesempio seguente crea una RecordingConfiguration risorsa per abilitare la registrazione su 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}

Output:

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

Per ulteriori informazioni, consulta Record to Amazon S3 nella Amazon Interactive Video Service User Guide.

Il seguente esempio di codice mostra come utilizzarecreate-stream-key.

AWS CLI

Per creare una chiave di streaming

L'create-stream-keyesempio seguente crea una chiave di flusso per un ARN (Amazon Resource Name) specificato.

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

Output:

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

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command CreateStreamKeyReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-channel.

AWS CLI

Per eliminare un canale e le chiavi di streaming associate

L'delete-channelesempio seguente elimina il canale con l'ARN (Amazon Resource Name) specificato.

aws ivs delete-channel \
    --arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

  • Per i dettagli sull'API, consulta Command DeleteChannelReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-playback-key-pair.

AWS CLI

Per eliminare una coppia di key pair di riproduzione specificata

L'delete-playback-key-pairesempio seguente restituisce l'impronta digitale della coppia di chiavi specificata.

aws ivs delete-playback-key-pair \
    --arn arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh

Questo comando non produce alcun output.

Per maggiori informazioni, consulta Impostazione dei canali privati nella Guida per l'utente di Amazon Interactive Video Service.

Il seguente esempio di codice mostra come utilizzaredelete-playback-restriction-policy.

AWS CLI

Per eliminare un criterio di restrizione della riproduzione

L'delete-playback-restriction-policyesempio seguente elimina la politica di restrizione della riproduzione con la politica ARN (Amazon Resource Name) specificata.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Il seguente esempio di codice mostra come utilizzaredelete-recording-configuration.

AWS CLI

Per eliminare la RecordingConfiguration risorsa specificata dal relativo ARN

L'delete-recording-configurationesempio seguente elimina la RecordingConfiguration risorsa con l'ARN specificato.

aws ivs delete-recording-configuration \
    --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Record to Amazon S3 nella Amazon Interactive Video Service User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-stream-key.

AWS CLI

Per eliminare una chiave di streaming

L'delete-stream-keyesempio seguente elimina la chiave stream per un ARN (Amazon Resource Name) specificato, in modo che non possa più essere utilizzata per lo streaming.

aws ivs delete-stream-key \
    --arn arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

  • Per i dettagli sull'API, consulta Command DeleteStreamKeyReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareget-channel.

AWS CLI

Per ottenere informazioni sulla configurazione di un canale

L'get-channelesempio seguente ottiene la configurazione del canale per un determinato canale ARN (Amazon Resource Name).

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

Output:

{
    "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",
    }
}

Per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

  • Per i dettagli sull'API, consulta Command GetChannelReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareget-playback-key-pair.

AWS CLI

Per ottenere una coppia di key pair di riproduzione specificata

L'get-playback-key-pairesempio seguente restituisce l'impronta digitale della coppia di chiavi specificata.

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

Output:

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

Per maggiori informazioni, consulta Impostazione dei canali privati nella Guida per l'utente di Amazon Interactive Video Service.

Il seguente esempio di codice mostra come utilizzareget-playback-restriction-policy.

AWS CLI

Per ottenere le informazioni di configurazione di una politica di restrizione della riproduzione

L'get-playback-restriction-policyesempio seguente ottiene la configurazione della politica di restrizione della riproduzione con la politica ARN (Amazon Resource Name) specificata.

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

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Il seguente esempio di codice mostra come utilizzareget-recording-configuration.

AWS CLI

Per ottenere informazioni su una RecordingConfiguration risorsa

L'get-recording-configurationesempio seguente ottiene informazioni sulla RecordingConfiguration risorsa per l'ARN specificato.

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

Output:

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

Per ulteriori informazioni, consulta Record to Amazon S3 nella Amazon Interactive Video Service User Guide.

Il seguente esempio di codice mostra come utilizzareget-stream-key.

AWS CLI

Per ottenere informazioni su uno stream

L'get-stream-keyesempio seguente ottiene informazioni sulla chiave di stream specificata.

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

Output:

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

Per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

  • Per i dettagli sull'API, consulta Command GetStreamKeyReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareget-stream-session.

AWS CLI

Per ottenere i metadati per uno stream specifico

L'get-stream-sessionesempio seguente ottiene la configurazione dei metadati per il canale ARN (Amazon Resource Name) specificato e lo stream specificato; streamId se non viene fornito, viene selezionato lo stream più recente per il canale.

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

Output:

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

Per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

Il seguente esempio di codice mostra come utilizzareget-stream.

AWS CLI

Per ottenere informazioni su uno stream

L'get-streamesempio seguente ottiene informazioni sullo stream per il canale specificato.

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

Output:

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

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command GetStreamReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareimport-playback-key-pair.

AWS CLI

Per importare la parte pubblica di una nuova coppia di chiavi

L'import-playback-key-pairesempio seguente importa la chiave pubblica specificata (specificata come stringa in formato PEM) e restituisce l'arn e l'impronta digitale della nuova coppia di chiavi.

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

Output:

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

Per maggiori informazioni, consulta Impostazione dei canali privati nella Guida per l'utente di Amazon Interactive Video Service.

Il seguente esempio di codice mostra come utilizzarelist-channels.

AWS CLI

Esempio 1: Per ottenere informazioni di riepilogo su tutti i canali

L'list-channelsesempio seguente elenca tutti i canali del tuo AWS account.

aws ivs list-channels

Output:

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

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

Esempio 2: per ottenere informazioni di riepilogo su tutti i canali, filtrate in base all'ARN specificato RecordingConfiguration

L'list-channelsesempio seguente elenca tutti i canali AWS dell'account associati all' RecordingConfiguration ARN specificato.

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

Output:

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

Per ulteriori informazioni, consulta Record to Amazon S3 nella IVS Low-Latency User Guide.

Esempio 3: per ottenere informazioni di riepilogo su tutti i canali, filtrate in base all'ARN specificato PlaybackRestrictionPolicy

L'list-channelsesempio seguente elenca tutti i canali AWS dell'account associati all' PlaybackRestrictionPolicy ARN specificato.

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

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command Reference. ListChannelsAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-playback-key-pairs.

AWS CLI

Per ottenere informazioni di riepilogo su tutte le coppie di tasti di riproduzione

L'list-playback-key-pairsesempio seguente restituisce informazioni su tutte le coppie di chiavi.

aws ivs list-playback-key-pairs

Output:

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

Per maggiori informazioni, consulta Impostazione dei canali privati nella Guida per l'utente di Amazon Interactive Video Service.

Il seguente esempio di codice mostra come utilizzarelist-playback-restriction-policies.

AWS CLI

Per ottenere informazioni di riepilogo su tutte le politiche di restrizione della riproduzione

L'list-playback-restriction-policiesesempio seguente elenca tutte le politiche di restrizione della riproduzione per il tuo account. AWS 

aws ivs list-playback-restriction-policies

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Il seguente esempio di codice mostra come utilizzarelist-recording-configurations.

AWS CLI

Per elencare tutte le RecordingConfiguration risorse create in questo account

L'list-recording-configurationsesempio seguente ottiene informazioni su tutte le RecordingConfiguration risorse del tuo account.

aws ivs list-recording-configurations

Output:

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

Per ulteriori informazioni, consulta Record to Amazon S3 nella Amazon Interactive Video Service User Guide.

Il seguente esempio di codice mostra come utilizzarelist-stream-keys.

AWS CLI

Per ottenere un elenco di chiavi di streaming

L'list-stream-keysesempio seguente elenca tutte le chiavi di stream per un ARN (Amazon Resource Name) specificato.

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

Output:

{
    "streamKeys": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "tags": {}
        }
    ]
}

FFor per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

  • Per i dettagli sull'API, consulta Command ListStreamKeysReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarelist-stream-sessions.

AWS CLI

Per ottenere un riepilogo degli stream correnti e precedenti per un canale specificato nella regione corrente AWS

L'list-stream-sessionsesempio seguente riporta informazioni di riepilogo per gli stream per un canale ARN (Amazon Resource Name) specificato.

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

Output:

{
    "nextToken": "set-2",
    "streamSessions": [
        {
            "startTime": 1641578182,
            "endTime": 1641579982,
            "hasErrorEvent": false,
            "streamId": "mystream"
        }
        ...
    ]
}

Per ulteriori informazioni, consulta Create a Channel nella IVS Low-Latency User Guide.

Il seguente esempio di codice mostra come utilizzarelist-streams.

AWS CLI

Per ottenere un elenco dei live streaming e del loro stato

L'list-streamsesempio seguente elenca tutti i live streaming del tuo AWS account.

aws ivs list-streams

Output:

{
   "streams": [
        {
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "state": "LIVE",
            "health": "HEALTHY",
            "streamId": "st-ABCDEfghij01234KLMN5678",
            "viewerCount": 1
        }
    ]
}

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command ListStreamsReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare tutti i tag di una AWS risorsa (ad esempio: canale, chiave stream)

L'list-tags-for-resourceesempio seguente elenca tutti i tag per una risorsa ARN (Amazon Resource Name) specificata.

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

Output:

{
    "tags":
    {
        "key1": "value1",
        "key2": "value2"
    }
}

Per ulteriori informazioni, consulta Tagging in Amazon Interactive Video Service API Reference.

Il seguente esempio di codice mostra come utilizzareput-metadata.

AWS CLI

Per inserire metadati nello stream attivo per un canale specifico

L'put-metadataesempio seguente inserisce i metadati specificati nello stream per il canale specificato.

aws ivs put-metadata \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --metadata '{"my": "metadata"}'

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command PutMetadataReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarestart-viewer-session-revocation.

AWS CLI

Per revocare una sessione di visualizzazione per una determinata coppia multiplo canale-ARN e Viewer-ID

L'start-viewer-session-revocationesempio seguente avvia il processo di revoca della sessione del visualizzatore associata a un ARN del canale e all'ID del visualizzatore specificati, fino all'inclusione del numero di versione della sessione specificato. Se la versione non viene fornita, il valore predefinito è 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

Questo comando non produce alcun output.

Per maggiori informazioni, consulta Impostazione dei canali privati nella Guida per l'utente di Amazon Interactive Video Service.

Il seguente esempio di codice mostra come utilizzarestop-stream.

AWS CLI

Per interrompere uno stream specificato

L'stop-streamesempio seguente interrompe lo streaming sul canale specificato.

aws ivs stop-stream \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command StopStreamReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per aggiungere o aggiornare tag per una AWS risorsa (ad esempio: canale, chiave stream)

L'tag-resourceesempio seguente aggiunge o aggiorna i tag per una risorsa ARN (Amazon Resource Name) specificata.

aws ivs tag-resource \
    --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --tags "tagkey1=tagvalue1, tagkey2=tagvalue2"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging in Amazon Interactive Video Service API Reference.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere i tag da una AWS risorsa (ad esempio: canale, chiave stream)

L'untag-resourceesempio seguente rimuove i tag specificati per una risorsa ARN (Amazon Resource Name) specificata.

aws ivs untag-resource \
    --resource-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --tag-keys "tagkey1, tagkey2"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging in Amazon Interactive Video Service API Reference.

Il seguente esempio di codice mostra come utilizzareupdate-channel.

AWS CLI

Esempio 1: aggiornare le informazioni di configurazione di un canale

L'update-channelesempio seguente aggiorna la configurazione del canale per un determinato canale ARN per modificare il nome del canale. Ciò non influisce sullo streaming continuo di questo canale; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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

Output:

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

Per ulteriori informazioni, consulta Creare un canale nella Guida per l'utente a bassa latenza di IVS.

Esempio 2: Aggiornare la configurazione di un canale per abilitare la registrazione

L'update-channelesempio seguente aggiorna la configurazione dei canali per un canale ARN specificato per consentire la registrazione. Ciò non influisce sullo streaming continuo di questo canale; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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'

Output:

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

Per ulteriori informazioni, consulta Record to Amazon S3 nella IVS Low-Latency User Guide.

Esempio 3: aggiornare la configurazione di un canale per disabilitare la registrazione

L'update-channelesempio seguente aggiorna la configurazione dei canali per un canale ARN specificato per disabilitare la registrazione. Ciò non influisce sullo streaming continuo di questo canale; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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

Output:

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

Per ulteriori informazioni, consulta Record to Amazon S3 nella IVS Low-Latency User Guide.

Esempio 4: aggiornare la configurazione di un canale per abilitare la restrizione della riproduzione

L'update-channelesempio seguente aggiorna la configurazione dei canali per un determinato canale ARN per applicare un criterio di restrizione della riproduzione. Ciò non influisce sullo streaming continuo di questo canale; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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'

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Esempio 5: aggiornare la configurazione di un canale per disabilitare la restrizione alla riproduzione

L'update-channelesempio seguente aggiorna la configurazione dei canali per un determinato canale ARN per disabilitare la restrizione della riproduzione. Ciò non influisce sullo streaming continuo di questo canale; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Esempio 6: aggiornare la configurazione di un canale per abilitare il multitraccia

L'update-channelesempio seguente aggiorna la configurazione dei canali per un determinato canale ARN per abilitare il multitraccia. Ciò non influisce sullo streaming continuo di questo canale; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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"}'

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

Esempio 7: aggiornare la configurazione di un canale per disabilitare la restrizione alla riproduzione

L'update-channelesempio seguente aggiorna la configurazione dei canali per un determinato canale ARN per disabilitare il multitraccia. Ciò non influisce sullo streaming continuo di questo canale; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.

  • Per i dettagli sull'API, consulta Command Reference. UpdateChannelAWS CLI

Il seguente esempio di codice mostra come utilizzareupdate-playback-restriction-policy.

AWS CLI

Per aggiornare una politica di restrizione della riproduzione

L'update-playback-restriction-policyesempio seguente aggiorna il criterio di restrizione della riproduzione con il criterio ARN specificato per disabilitare l'applicazione rigorosa dell'origine. Ciò non influisce sullo streaming continuo del canale associato; è necessario interrompere e riavviare lo streaming affinché le modifiche abbiano effetto.

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

Output:

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

Per ulteriori informazioni, consulta Contenuti e visualizzatori indesiderati nella Guida per l'utente a bassa latenza di IVS.