IVSEsempi di utilizzo di Amazon AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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à.

IVSEsempi di utilizzo di Amazon AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando il AWS Command Line Interface con AmazonIVS.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni di servizio, puoi vedere le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

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

AWS CLI

Per ottenere informazioni sulla configurazione dei canali su più canali

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

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

Output:

{
    "channels": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "authorized": false,
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": false,
            "latencyMode": "LOW",
            "name": "channel-1",
            "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-1.abcdEFGH.m3u8",
            "preset": "",
            "playbackRestrictionPolicyArn": "",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "tags": {},
            "type": "STANDARD"
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl",
            "authorized": false,
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "insecureIngest": true,
            "latencyMode": "LOW",
            "name": "channel-2",
            "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel-2.abcdEFGH.m3u8",
            "preset": "",
            "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ"",
            "recordingConfigurationArn": "",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "tags": {},
            "type": "STANDARD"
        }
    ]
}

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

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

AWS CLI

Per ottenere informazioni su più chiavi di streaming

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

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

Output:

{
    "streamKeys": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh",
            "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKIJKLmnop",
            "value": "sk_us-west-2_abcdABCDefgh_567890ghijkl",
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "tags": {}
        }
     ]
}

Per ulteriori informazioni, consultate Create a Channel nella IVSLow-Latency User Guide.

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

AWS CLI

Per revocare le sessioni di visualizzazione per più coppie di ID di canale ARN e visualizzatore

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

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

Output:

{
    "errors": [
        {
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh1",
            "viewerId": "abcdefg1",
            "code": "403",
            "message": "not authorized",
        },
        {
            "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh2",
            "viewerId": "abcdefg2",
            "code": "403",
            "message": "not authorized",
        }
    ]
}

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

Il seguente esempio di codice mostra come utilizzarecreate-channel.

AWS CLI

Esempio 1: creare un canale senza registrazione

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "authorized": false,
        "name": "test-channel",
        "latencyMode": "LOW",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}

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

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

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "BA1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}

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

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

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2edfGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {},
        "type": "STANDARD"
    },
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/abcdABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}

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

  • Per i API dettagli, vedere CreateChannelin Command Reference.AWS CLI

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

AWS CLI

Per creare una politica di restrizione della riproduzione

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

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

Output:

{
    "playbackRestrictionPolicy": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "allowedCountries": [
            "US",
            "MX"
        ],
        "allowedOrigins": [
            "https://www.website1.com",
            "https://www.website2.com"
        ],
        "enableStrictOriginEnforcement": true,
        "name": "test-playback-restriction-policy",
        "tags": {
            "key1": "value1",
            "key2": "value2"
        }
    }
}

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

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

AWS CLI

Per creare una RecordingConfiguration risorsa

L'create-recording-configurationesempio seguente crea una RecordingConfiguration risorsa per abilitare la registrazione su Amazon S3.

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

Output:

{
    "recordingConfiguration": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
        "name": "test-recording-config",
        "destinationConfiguration": {
            "s3": {
                "bucketName": "demo-recording-bucket"
            }
        },
        "state": "CREATING",
        "tags": {
            "key1": "value1",
            "key2": "value2"
        },
        "thumbnailConfiguration": {
            "recordingMode": "INTERVAL",
            "targetIntervalSeconds": 1,
            "resolution": "LOWEST_RESOLUTION",
            "storage": [
                "LATEST"
            ]
        },
        "recordingReconnectWindowSeconds": 60,
        "renditionConfiguration": {
            "renditionSelection": "CUSTOM",
            "renditions": [
                "HD"
            ]
        }
    }
}

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

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

AWS CLI

Per creare una chiave di streaming

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

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 Create a Channel nella IVSLow-Latency User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-channel.

AWS CLI

Per eliminare un canale e le chiavi di streaming associate

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

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

Questo comando non produce alcun output.

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

  • Per API i dettagli, vedere DeleteChannelin AWS CLI Command Reference.

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

AWS CLI

Per eliminare una coppia di key pair di riproduzione specificata

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

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

Questo comando non produce alcun output.

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

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

AWS CLI

Per eliminare un criterio di restrizione della riproduzione

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

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 Undesired Content and Viewers nella Low-Latency User Guide. IVS

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

AWS CLI

Per eliminare la RecordingConfiguration risorsa specificata dalla sua ARN

L'delete-recording-configurationesempio seguente elimina la RecordingConfiguration risorsa con il valore specificatoARN.

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

Questo comando non produce alcun output.

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

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

AWS CLI

Per eliminare una chiave di streaming

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

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

Questo comando non produce alcun output.

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

Il seguente esempio di codice mostra come utilizzareget-channel.

AWS CLI

Per ottenere informazioni sulla configurazione di un canale

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "channel-1",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "preset": "",
        "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "tags": {}
    }
}

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

  • Per API i dettagli, vedere GetChannelin AWS CLI Command Reference.

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

AWS CLI

Per ottenere una coppia di key pair di riproduzione specificata

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

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

Output:

{
    "keyPair": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh",
        "name": "my-playback-key",
        "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72",
        "tags": {}
    }
}

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

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

AWS CLI

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

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

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 Undesired Content and Viewers nella Low-Latency User Guide. IVS

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

AWS CLI

Per ottenere informazioni su una RecordingConfiguration risorsa

L'get-recording-configurationesempio seguente ottiene informazioni sulla RecordingConfiguration risorsa per l'oggetto specificatoARN.

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

Output:

{
    "recordingConfiguration": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
        "destinationConfiguration": {
            "s3": {
                "bucketName": "demo-recording-bucket"
            }
        },
        "name": "test-recording-config",
        "recordingReconnectWindowSeconds": 60,
        "state": "ACTIVE",
        "tags": {
            "key1" : "value1",
            "key2" : "value2"
        },
        "thumbnailConfiguration": {
            "recordingMode": "INTERVAL",
            "targetIntervalSeconds": 1,
            "resolution": "LOWEST_RESOLUTION",
            "storage": [
                "LATEST"
            ]
        },
        "renditionConfiguration": {
            "renditionSelection": "CUSTOM",
            "renditions": [
                "HD"
            ]
        }
    }
}

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

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

AWS CLI

Per ottenere informazioni su uno stream

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

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

Output:

{
    "streamKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/skSKABCDefgh",
        "value": "sk_us-west-2_abcdABCDefgh_567890abcdef",
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "tags": {}
    }
}

Per ulteriori informazioni, consultate Create a Channel nella IVSLow-Latency User Guide.

  • Per API i dettagli, vedere GetStreamKeyin AWS CLI Command Reference.

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

AWS CLI

Per ottenere i metadati per uno stream specifico

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

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

Output:

{
    "streamSession": {
        "streamId": "mystream1",
        "startTime": "2023-06-26T19:09:28+00:00",
        "channel": {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "name": "mychannel",
            "latencyMode": "LOW",
            "type": "STANDARD",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
            "srt": {
                "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
                "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
            },
            "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
            "playbackUrl": "url-string",
            "authorized": false,
            "insecureIngest": false,
            "preset": ""
        },
        "ingestConfiguration": {
            "video": {
                "avcProfile": "Baseline",
                "avcLevel": "4.2",
                "codec": "avc1.42C02A",
                "encoder": "Lavf58.45.100",
                "targetBitrate": 8789062,
                "targetFramerate": 60,
                "videoHeight": 1080,
                "videoWidth": 1920
            },
            "audio": {
                "codec": "mp4a.40.2",
                "targetBitrate": 46875,
                "sampleRate": 8000,
                "channels": 2
            }
        },
        "recordingConfiguration": {
            "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
            "name": "test-recording-config",
            "destinationConfiguration": {
                "s3": {
                    "bucketName": "demo-recording-bucket"
                }
            },
            "state": "ACTIVE",
            "tags": {
                "key1": "value1",
                "key2": "value2"
            },
            "thumbnailConfiguration": {
                "recordingMode": "INTERVAL",
                "targetIntervalSeconds": 1,
                "resolution": "LOWEST_RESOLUTION",
                "storage": [
                    "LATEST"
                ]
            },
            "recordingReconnectWindowSeconds": 60,
            "renditionConfiguration": {
                "renditionSelection": "CUSTOM",
                "renditions": [
                    "HD"
                ]
            }
        },
        "truncatedEvents": [
            {
                "name": "Recording Start",
                "type": "IVS Recording State Change",
                "eventTime": "2023-06-26T19:09:35+00:00"
            },
            {
                "name": "Stream Start",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:34+00:00"
            },
            {
                "name": "Session Created",
                "type": "IVS Stream State Change",
                "eventTime": "2023-06-26T19:09:28+00:00"
            }
        ]
    }
}

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

Il seguente esempio di codice mostra come utilizzareget-stream.

AWS CLI

Per ottenere informazioni su uno stream

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

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

Output:

{
    "stream": {
        "channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "startTime": "2020-05-05T21:55:38Z",
        "state": "LIVE",
        "health": "HEALTHY",
        "streamId": "st-ABCDEfghij01234KLMN5678",
        "viewerCount": 1
    }
}

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

  • Per API i dettagli, vedere GetStreamin AWS CLI Command Reference.

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

AWS CLI

Per importare la parte pubblica di una nuova coppia di chiavi

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

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

Output:

{
    "keyPair": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh",
        "name": "my-playback-key",
        "fingerprint": "0a:1b:2c:ab:cd:ef:34:56:70:b1:b2:71:01:2a:a3:72",
        "tags": {}
    }
}

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

Il seguente esempio di codice mostra come utilizzarelist-channels.

AWS CLI

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

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

aws ivs list-channels

Output:

{
    "channels": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
            "name": "channel-1",
            "latencyMode": "LOW",
            "authorized": false,
            "insecureIngest": false,
            "preset": "",
            "playbackRestrictionPolicyArn": "",
            "recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABCD12cdEFgh",
            "tags": {},
            "type": "STANDARD"
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:channel/efghEFGHijkl",
            "name": "channel-2",
            "latencyMode": "LOW",
            "authorized": false,
            "preset": "",
            "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
            "recordingConfigurationArn": "",
            "tags": {},
            "type": "STANDARD"
        }
    ]
}

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

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

L'list-channelsesempio seguente elenca tutti i canali AWS del tuo account associati a quanto specificato RecordingConfiguration ARN.

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 IVSLow-Latency User Guide.

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

L'list-channelsesempio seguente elenca tutti i canali AWS del tuo account associati a quanto specificato PlaybackRestrictionPolicy ARN.

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 Contenuto e visualizzatori indesiderati nella Guida per l'utente IVSa bassa latenza.

  • Per i API dettagli, vedere ListChannelsin Command Reference.AWS CLI

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

AWS CLI

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

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

aws ivs list-playback-key-pairs

Output:

{
    "keyPairs": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/abcd1234efgh",
            "name": "test-key-0",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:playback-key/ijkl5678mnop",
            "name": "test-key-1",
            "tags": {}
        }
    ]
}

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

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

AWS CLI

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

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

aws ivs list-playback-restriction-policies

Output:

{
    "playbackRestrictionPolicies": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
            "allowedCountries": [
                "US",
                "MX"
            ],
            "allowedOrigins": [
                "https://www.website1.com",
                "https://www.website2.com"
            ],
            "enableStrictOriginEnforcement": true,
            "name": "test-playback-restriction-policy",
            "tags": {
                "key1": "value1",
                "key2": "value2"
            }
        }
    ]
}

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

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

AWS CLI

Per elencare tutte le RecordingConfiguration risorse create in questo account

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

aws ivs list-recording-configurations

Output:

{
    "recordingConfigurations": [
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/ABcdef34ghIJ",
            "name": "test-recording-config-1",
            "destinationConfiguration": {
                "s3": {
                    "bucketName": "demo-recording-bucket-1"
                }
            },
            "state": "ACTIVE",
            "tags": {}
        },
        {
            "arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/CD12abcdGHIJ",
            "name": "test-recording-config-2",
            "destinationConfiguration": {
                "s3": {
                    "bucketName": "demo-recording-bucket-2"
                }
            },
            "state": "ACTIVE",
            "tags": {}
        }
    ]
}

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

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

AWS CLI

Per ottenere un elenco di chiavi di streaming

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

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

FForper ulteriori informazioni, consulta Create a Channel nella IVSLow-Latency User Guide.

  • Per API i dettagli, vedere ListStreamKeysin AWS CLI Command Reference.

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

AWS CLI

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

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

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

Output:

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

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

Il seguente esempio di codice mostra come utilizzarelist-streams.

AWS CLI

Per ottenere un elenco dei live streaming e del loro stato

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

aws ivs list-streams

Output:

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

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

  • Per API i dettagli, vedere ListStreamsin AWS CLI Command Reference.

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

AWS CLI

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

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

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

Output:

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

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

Il seguente esempio di codice mostra come utilizzareput-metadata.

AWS CLI

Per inserire metadati nello stream attivo per un canale specifico

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

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

Questo comando non produce alcun output.

Per ulteriori informazioni, vedete Creare un canale nella Guida per l'utente IVSa bassa latenza.

  • Per API i dettagli, vedere PutMetadatain AWS CLI Command Reference.

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

AWS CLI

Per revocare una sessione di visualizzazione per una determinata coppia di ID ARN e canali multipli

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

aws ivs batch-start-viewer-session-revocation \
    --channel-arn arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh \
    --viewer-id abcdefg \
    --viewer-session-versions-less-than-or-equal-to 1234567890

Questo comando non produce alcun output.

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

Il seguente esempio di codice mostra come utilizzarestop-stream.

AWS CLI

Per interrompere uno stream specificato

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

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

Questo comando non produce alcun output.

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

  • Per API i dettagli, vedere StopStreamin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

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

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

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

Questo comando non produce alcun output.

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

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

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

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

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

Questo comando non produce alcun output.

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

Il seguente esempio di codice mostra come utilizzareupdate-channel.

AWS CLI

Esempio 1: aggiornare le informazioni di configurazione di un canale

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "channel-1",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": true,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
}

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

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

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "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 IVSLow-Latency User Guide.

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

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-recording",
        "latencyMode": "LOW",
        "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 IVSLow-Latency User Guide.

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

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaCBDEfghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}

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

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

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

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

Output:

{
    "channel": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
        "name": "test-channel-with-playback-restriction-policy",
        "latencyMode": "LOW",
        "type": "STANDARD",
        "playbackRestrictionPolicyArn": "",
        "recordingConfigurationArn": "",
        "srt": {
            "endpoint": "a1b2c3d4e5f6.srt.live-video.net",
            "passphrase": "AB1C2defGHijkLMNo3PqQRstUvwxyzaBCDeFghh4ijklMN5opqrStuVWxyzAbCDEfghIJ"
        },
        "ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
        "insecureIngest": false,
        "playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
        "preset": "",
        "authorized": false,
        "tags": {}
    }
}

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

  • Per i API dettagli, vedere UpdateChannelin Command Reference.AWS CLI

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

AWS CLI

Per aggiornare una politica di restrizione della riproduzione

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

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

Output:

{
    "playbackRestrictionPolicy": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/ABcdef34ghIJ",
        "allowedCountries": [
            "US",
            "MX"
        ],
        "allowedOrigins": [
            "https://www.website1.com",
            "https://www.website2.com"
        ],
        "enableStrictOriginEnforcement": false,
        "name": "test-playback-restriction-policy",
        "tags": {
            "key1": "value1",
            "key2": "value2"
        }
    }
}

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