View a markdown version of this page

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

Sono disponibili altri esempi di 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 azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

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, vedere Creazione di un canale nella Guida per l'utente IVS. Low-Latency

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, vedere Creare un canale nella Guida per l'utente IVS. Low-Latency

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 ulteriori 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: come 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, vedere Create a Channel nella Guida per l' Low-Latency utente IVS.

Esempio 2: creare un canale con la registrazione abilitata, utilizzando la RecordingConfiguration risorsa specificata dal relativo 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 Record to Amazon S3 nella Guida per l'utente IVS. Low-Latency

Esempio 3: come 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 Unwish Content and Viewers nella Guida per l'utente IVS. Low-Latency

Esempio 4: come 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, vedere Creare un canale nella Guida per l'utente Low-Latency IVS.

  • Per i dettagli sull'API, vedere 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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente IVS. Low-Latency

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

AWS CLI

Per creare una risorsa RecordingConfiguration

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 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, vedere Creare un canale nella Guida per l'utente IVS. Low-Latency

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, vedere Creazione di un canale nella Guida per l'utente Low-Latency IVS.

  • Per i dettagli sull'API, vedere 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 ulteriori 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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente IVS. Low-Latency

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

AWS CLI

Per eliminare la risorsa specificata dal relativo ARN RecordingConfiguration

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 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, vedere Creare un canale nella Guida per l'utente IVS. Low-Latency

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, vedere Creazione di un canale nella Guida per l'utente IVS. Low-Latency

  • Per i dettagli sull'API, vedere 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 ulteriori informazioni, consulta Impostazione dei canali privati nella Guida per l’utente di Amazon Interactive Video Service.

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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente IVS. Low-Latency

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

AWS CLI

Per ottenere informazioni su una risorsa RecordingConfiguration

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 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, vedere Creare un canale nella Guida per l'utente IVS. Low-Latency

  • Per i dettagli sull'API, vedere 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, vedere Creare un canale nella Guida per l'utente IVS. Low-Latency

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, vedere Create a Channel nella Guida per l'utente IVS. Low-Latency

  • Per i dettagli sull'API, vedere 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 ulteriori 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: come 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, vedere Creare un canale nella Guida per l' Low-Latency utente 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 del tuo AWS account, che sono associati all'ARN specificato RecordingConfiguration .

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 Guida per l'utente IVS. Low-Latency

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

L'list-channelsesempio seguente elenca tutti i canali del tuo AWS account, che sono associati all'ARN specificato PlaybackRestrictionPolicy .

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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente Low-Latency IVS.

  • Per i dettagli sull'API, consulta la sezione Command ListChannels Reference AWS CLI .

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 ulteriori 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-playback-restriction-policies.

AWS CLI

Come ottenere informazioni di riepilogo su tutte le policy 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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente Low-Latency IVS.

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

AWS CLI

Per elencare tutte le risorse create in questo account RecordingConfiguration

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 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, vedere Creazione di un canale nella Guida per l'utente IVS. Low-Latency

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

AWS CLI

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

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 Creare un canale nella Guida per l' Low-Latency utente IVS.

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'list-streamsesempio seguente elenca tutti i live streaming del tuo 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 Creare un canale nella Guida per l' Low-Latency utente IVS.

  • Per i dettagli sull'API, vedere ListStreams in AWS CLI Command Reference.

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

AWS CLI

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

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 (Amazon IVS).

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, vedere Creare un canale nella Guida per l'utente IVS. Low-Latency

  • Per i dettagli sull'API, vedere 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 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 ulteriori 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, vedere Creazione di un canale nella Guida per l'utente IVS. Low-Latency

  • Per i dettagli sull'API, vedere StopStream in AWS CLI Command Reference.

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

AWS CLI

Per aggiungere o aggiornare i tag per una AWS risorsa (ad esempio: channel, stream key)

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 (Amazon IVS).

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

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

AWS CLI

Per rimuovere i tag per una AWS risorsa (ad esempio: channel, stream key)

L’esempio untag-resource seguente rimuove i tag 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 (Amazon IVS).

  • Per i dettagli sull'API, vedi UntagResource in AWS CLI Command Reference.

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

AWS CLI

Esempio 1: come 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, vedere Creazione di un canale nella Guida per l'utente Low-Latency IVS.

Esempio 2: come 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 Record to Amazon S3 nella Guida per l'utente IVS. Low-Latency

Esempio 3: come 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 Record to Amazon S3 nella Guida per l'utente Low-Latency IVS.

Esempio 4: come 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 Unwish Content and Viewers nella Guida per l'utente IVS. Low-Latency

Esempio 5: come 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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente IVS. Low-Latency

Esempio 6: come 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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente IVS. Low-Latency

Esempio 7: come 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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente IVS. Low-Latency

  • Per i dettagli sull'API, consulta la sezione Command UpdateChannel Reference AWS CLI .

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, vedere Contenuti e visualizzatori indesiderati nella Guida per l'utente IVS. Low-Latency