Esempi per Amazon IVS con AWS CLI - AWS Command Line Interface
Operazioni

Esempi per Amazon IVS con AWS CLI

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

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 link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare batch-get-channel.

AWS CLI

Come ottenere informazioni sulla configurazione di canale per più canali

L’esempio batch-get-channel 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta BatchGetChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare batch-get-stream-key.

AWS CLI

Come ottenere informazioni su più chiavi di flusso

L’esempio batch-get-stream-key seguente ottiene le informazioni sulle chiavi di flusso 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta BatchGetStreamKey in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare batch-start-viewer-session-revocation.

AWS CLI

Come revocare le sessioni di visualizzazione per più coppie ARN del canale e ID visualizzazione

L’esempio batch-start-viewer-session-revocation seguente esegue la revoca della sessione su più coppie ARN del canale e ID visualizzazione 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.

L’esempio di codice seguente mostra come utilizzare create-channel.

AWS CLI

Esempio 1: creare un canale senza registrazione

L’esempio create-channel seguente crea un nuovo canale e una chiave di flusso associata per avviare la trasmissione.

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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

Esempio 2: creare un canale con la registrazione abilitata, utilizzando la risorsa RecordingConfiguration specificata dal relativo nome della risorsa Amazon (ARN)

L’esempio create-channel seguente crea un nuovo canale e una chiave di flusso associata per avviare la trasmissione, nonché 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 Registrazione su Amazon S3 nella Guida per l’utente dello Streaming a bassa latenza di IVS.

Esempio 3: creare un canale con una policy di restrizione della riproduzione specificata dal relativo nome della risorsa Amazon (ARN)

L’esempio create-channel seguente crea un nuovo canale e una chiave di flusso associata per avviare la trasmissione, nonché imposta la policy 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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

Esempio 4: creare un canale con multitraccia abilitato

L’esempio create-channel seguente crea un nuovo canale e una chiave di flusso associata per avviare la trasmissione, nonché 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta CreateChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-playback-restriction-policy.

AWS CLI

Come creare una policy di restrizione della riproduzione

L’esempio create-playback-restriction-policy seguente crea una nuova policy 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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

L’esempio di codice seguente mostra come utilizzare create-recording-configuration.

AWS CLI

Come creare una risorsa RecordingConfiguration

L’esempio create-recording-configuration seguente crea una risorsa RecordingConfiguration 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 Registrazione su Amazon S3 nella Guida per l’utente del Servizio video interattivo Amazon.

L’esempio di codice seguente mostra come utilizzare create-stream-key.

AWS CLI

Come creare una chiave di flusso

L’esempio create-stream-key seguente crea una chiave di flusso per un nome della risorsa Amazon (ARN) 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta CreateStreamKey in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-channel.

AWS CLI

Come eliminare un canale e le relative chiavi di flusso associate

L’esempio delete-channel seguente elimina il canale con il nome della risorsa Amazon (ARN) 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta DeleteChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-playback-key-pair.

AWS CLI

Come eliminare una coppia di chiavi di riproduzione specificata

L’esempio delete-playback-key-pair 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.

L’esempio di codice seguente mostra come utilizzare delete-playback-restriction-policy.

AWS CLI

Come eliminare una policy di restrizione della riproduzione

L’esempio delete-playback-restriction-policy seguente elimina la policy di restrizione della riproduzione con il nome della risorsa Amazon (ARN) specificato.

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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

L’esempio di codice seguente mostra come utilizzare delete-recording-configuration.

AWS CLI

Come eliminare la risorsa RecordingConfiguration specificata dal relativo nome della risorsa Amazon (ARN)

L’esempio delete-recording-configuration seguente elimina la risorsa RecordingConfiguration con il nome della risorsa Amazon (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 Registrazione su Amazon S3 nella Guida per l’utente del Servizio video interattivo Amazon.

L’esempio di codice seguente mostra come utilizzare delete-stream-key.

AWS CLI

Come eliminare una chiave di flusso

L’esempio delete-stream-key seguente elimina la chiave di flusso per un nome della risorsa Amazon (ARN) specificato, in modo che non possa più essere utilizzata per il flusso.

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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta DeleteStreamKey in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-channel.

AWS CLI

Come ottenere informazioni sulla configurazione di un canale

L’esempio get-channel seguente ottiene la configurazione del canale per un nome della risorsa Amazon (ARN) specificato.

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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta GetChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-playback-key-pair.

AWS CLI

Come ottenere una coppia di chiavi di riproduzione specificata

L’esempio get-playback-key-pair 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.

  • Per informazioni dettagliate sull’API, consulta GetPlaybackKeyPair in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-playback-restriction-policy.

AWS CLI

Come ottenere le informazioni sulla configurazione di una policy di restrizione della riproduzione

L’esempio get-playback-restriction-policy seguente ottiene la configurazione della policy di restrizione della riproduzione con il nome della risorsa Amazon (ARN) specificato.

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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

L’esempio di codice seguente mostra come utilizzare get-recording-configuration.

AWS CLI

Come ottenere informazioni su una risorsa RecordingConfiguration

L’esempio get-recording-configuration seguente ottiene informazioni sulla risorsa RecordingConfiguration per il nome della risorsa Amazon (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 Registrazione su Amazon S3 nella Guida per l’utente del Servizio video interattivo Amazon.

L’esempio di codice seguente mostra come utilizzare get-stream-key.

AWS CLI

Come ottenere informazioni su un flusso

L’esempio get-stream-key seguente ottiene informazioni sulla chiave di flusso 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta GetStreamKey in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-stream-session.

AWS CLI

Come ottenere i metadati per un flusso specificato

L’esempio get-stream-session seguente ottiene la configurazione dei metadati per il nome della risorsa Amazon (ARN) specificato per il canale e il flusso specificato; se streamId non viene fornito, viene selezionato il flusso più recente del 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta GetStreamSession in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-stream.

AWS CLI

Come ottenere informazioni su un flusso

L’esempio get-stream seguente ottiene informazioni sul flusso 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta GetStream in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare import-playback-key-pair.

AWS CLI

Come importare la parte pubblica di una nuova coppia di chiavi

L’esempio import-playback-key-pair seguente importa la chiave pubblica specificata (come stringa in formato PEM) e restituisce il nome della risorsa Amazon (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.

L’esempio di codice seguente mostra come utilizzare list-channels.

AWS CLI

Esempio 1: ottenere informazioni di riepilogo su tutti i canali

L’esempio list-channels seguente elenca tutti i canali dell’account AWS.

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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

Esempio 2: ottenere informazioni di riepilogo su tutti i canali, filtrate in base al nome della risorsa Amazon (ARN) di RecordingConfiguration specificato

L’esempio list-channels seguente elenca tutti i canali dell’account AWS associati al nome della risorsa Amazon (ARN) di RecordingConfiguration 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 Registrazione su Amazon S3 nella Guida per l’utente dello Streaming a bassa latenza di IVS.

Esempio 3: ottenere informazioni di riepilogo su tutti i canali, filtrate in base al nome della risorsa Amazon (ARN) di PlaybackRestrictionPolicy specificato

L’esempio list-channels seguente elenca tutti i canali dell’account AWS associati al nome della risorsa Amazon (ARN) di PlaybackRestrictionPolicy 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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta ListChannels in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-playback-key-pairs.

AWS CLI

Come ottenere informazioni di riepilogo su tutte le coppie di chiavi di riproduzione

L’esempio list-playback-key-pairs 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.

  • Per informazioni dettagliate sull’API, consulta ListPlaybackKeyPairs in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-playback-restriction-policies.

AWS CLI

Come ottenere informazioni di riepilogo su tutte le policy di restrizione della riproduzione

L’esempio list-playback-restriction-policies seguente elenca tutte le policy di restrizione della riproduzione per l’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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

L’esempio di codice seguente mostra come utilizzare list-recording-configurations.

AWS CLI

Come elencare tutte le risorse RecordingConfiguration create nell’account

L’esempio list-recording-configurations seguente ottiene informazioni su tutte le risorse RecordingConfiguration presenti nell’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 Registrazione su Amazon S3 nella Guida per l’utente del Servizio video interattivo Amazon.

L’esempio di codice seguente mostra come utilizzare list-stream-keys.

AWS CLI

Come ottenere un elenco di chiavi di flusso

L’esempio list-stream-keys seguente elenca tutte le chiavi di flusso per un nome della risorsa Amazon (ARN) 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": {}
        }
    ]
}

Per ulteriori informazioni, consulta Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta ListStreamKeys in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-stream-sessions.

AWS CLI

Come ottenere un riepilogo dei flussi attuali e precedenti per un canale specifico nella Regione AWS corrente

L’esempio list-stream-sessions seguente ottiene informazioni di riepilogo per i flussi di un nome della risorsa Amazon (ARN) specificato per il canale.

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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta ListStreamSessions in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-streams.

AWS CLI

Come ottenere un elenco dei flussi in tempo reale con il relativo stato

L’esempio list-streams seguente elenca tutti i flussi in tempo reale dell’account AWS.

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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta ListStreams in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come elencare tutti i tag di una risorsa AWS (ad esempio canale, chiave di flusso)

L’esempio list-tags-for-resource seguente elenca tutti i tag per un nome della risorsa Amazon (ARN) specificato per la risorsa.

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 nella Guida di riferimento all’API del Servizio video interattivo Amazon.

  • Per informazioni dettagliate sull'API, consulta ListTagsForResource nella Documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare put-metadata.

AWS CLI

Come inserire i metadati nel flusso attivo per un canale specificato

L’esempio put-metadata seguente inserisce i metadati indicati nel flusso 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta PutMetadata in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare start-viewer-session-revocation.

AWS CLI

Come revocare una sessione di visualizzazione per una coppia ARN del canale e ID visualizzazione

L’esempio start-viewer-session-revocation seguente avvia il processo di revoca della sessione di visualizzazione associata a un nome della risorsa Amazon (ARN) del canale specificato e a un ID visualizzazione, fino al numero di versione della sessione specificato incluso. 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.

L’esempio di codice seguente mostra come utilizzare stop-stream.

AWS CLI

Come arrestare un flusso specificato

L’esempio stop-stream seguente arresta il flusso 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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta StopStream in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come aggiungere o aggiornare i tag di una risorsa AWS (ad esempio canale, chiave di flusso)

L’esempio tag-resource seguente aggiunge o aggiorna i tag per un nome della risorsa Amazon (ARN) specificato per la risorsa.

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 nella Guida di riferimento all’API del Servizio video interattivo Amazon.

  • Per informazioni dettagliate sull’API, consulta TagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere i tag di una risorsa AWS (ad esempio canale, chiave di flusso)

L’esempio untag-resource seguente rimuove i tag specificati per un nome della risorsa Amazon (ARN) specificato per la risorsa.

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 nella Guida di riferimento all’API del Servizio video interattivo Amazon.

  • Per informazioni dettagliate sull’API, consulta UntagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-channel.

AWS CLI

Esempio 1: aggiornare le informazioni di configurazione di un canale

L’esempio update-channel seguente aggiorna la configurazione del canale con il nome della risorsa Amazon (ARN) specificato per modificare il nome del canale. Ciò non influisce sul flusso in corso di questo canale; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 Creazione di un canale nella Guida per l’utente dello Streaming a bassa latenza di IVS.

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

L’esempio update-channel seguente aggiorna la configurazione del canale con il nome della risorsa Amazon (ARN) specificato per abilitare la registrazione. Ciò non influisce sul flusso in corso di questo canale; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 Registrazione su Amazon S3 nella Guida per l’utente dello Streaming a bassa latenza di IVS.

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

L’esempio update-channel seguente aggiorna la configurazione del canale con il nome della risorsa Amazon (ARN) specificato per disabilitare la registrazione. Ciò non influisce sul flusso in corso di questo canale; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 Registrazione su Amazon S3 nella Guida per l’utente dello Streaming a bassa latenza di IVS.

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

L’esempio update-channel seguente aggiorna la configurazione del canale con il nome della risorsa Amazon (ARN) specificato per applicare una policy di restrizione della riproduzione. Ciò non influisce sul flusso in corso di questo canale; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

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

L’esempio update-channel seguente aggiorna la configurazione del canale con il nome della risorsa Amazon (ARN) specificato per disabilitare la restrizione della riproduzione. Ciò non influisce sul flusso in corso di questo canale; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

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

L’esempio update-channel seguente aggiorna la configurazione del canale con il nome della risorsa Amazon (ARN) specificato per abilitare il multitraccia. Ciò non influisce sul flusso in corso di questo canale; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

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

L’esempio update-channel seguente aggiorna la configurazione del canale con il nome della risorsa Amazon (ARN) specificato per disabilitare il multitraccia. Ciò non influisce sul flusso in corso di questo canale; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.

  • Per informazioni dettagliate sull’API, consulta UpdateChannel in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-playback-restriction-policy.

AWS CLI

Come aggiornare una policy di restrizione della riproduzione

L’esempio update-playback-restriction-policy seguente aggiorna la policy di restrizione della riproduzione con il nome della risorsa Amazon (ARN) specificato per disabilitare l’applicazione rigorosa dell’origine. Ciò non influisce sul flusso in corso del canale associato; è necessario interrompere e riavviare il flusso per rendere effettive le modifiche.

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 spettatori indesiderati in IVS nella Guida per l’utente dello Streaming a bassa latenza di IVS.