Beispiele für die Verwendung der AWS CLI mit Amazon IVS - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit Amazon IVS

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Amazon IVS verwenden.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie batch-get-channel verwendet wird.

AWS CLI

So rufen Sie die Kanalkonfigurationsinformationen zu mehreren Kanälen ab

Im folgenden Beispiel für batch-get-channel werden Informationen zu den angegebenen Kanälen abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter BatchGetChannel in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie batch-get-stream-key verwendet wird.

AWS CLI

So rufen Sie Informationen zu mehreren Stream-Schlüsseln ab

Im folgenden Beispiel für batch-get-stream-key werden Informationen zu angegebenen Stream-Schlüsseln abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

Das folgende Codebeispiel zeigt, wie batch-start-viewer-session-revocation verwendet wird.

AWS CLI

So widerrufen Sie Betrachtersitzungen für mehrere Kanal-ARN- und Betrachter-ID-Paare

Im folgenden Beispiel für batch-start-viewer-session-revocation wird der Sitzungswiderruf für mehrere Kanal-ARN- und Betrachter-ID-Paare gleichzeitig ausgeführt. Die Anforderung kann normal abgeschlossen werden, gibt jedoch Werte im Fehlerfeld zurück, wenn der Aufrufer nicht berechtigt ist, die angegebene Sitzung zu widerrufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Einrichten privater Kanäle im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie create-channel verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie einen Kanal ohne Aufzeichnung

Im folgenden Beispiel für create-channel werden ein neuer Kanal und ein zugeordneter Stream-Schlüssel erstellt, um das Streaming zu starten.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 2: So erstellen Sie einen Kanal mit aktivierter Aufzeichnung mit der durch seinen ARN angegebene RecordingConfiguration-Ressource

Im folgenden Beispiel für create-channel werden ein neuer Kanal und ein zugeordneter Stream-Schlüssel erstellt, um das Streaming zu starten, und die Aufzeichnung für den Kanal eingerichtet:

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

Ausgabe:

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

Weitere Informationen finden Sie unter In Amazon S3 aufzeichnen im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 3: So erstellen Sie einen Kanal mit einer durch seinen ARN angegebene Richtlinie für Wiedergabebeschränkungen

Im folgenden Beispiel für create-channel werden ein neuer Kanal und ein zugehöriger Stream-Schlüssel erstellt, um das Streaming zu starten, und richtet eine Wiedergabebeschränkungsrichtlinie für den Kanal ein:

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'

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 4: So erstellen Sie einen Kanal mit aktiviertem Multitrack

Im folgenden Beispiel für create-channel werden ein neuer Kanal und ein zugeordneter Stream-Schlüssel zum Starten des Streamings erstellt, und Multitrack aktiviert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter CreateChannel in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-playback-restriction-policy verwendet wird.

AWS CLI

So erstellen Sie eine Richtlinie für Wiedergabebeschränkungen

Im folgenden Beispiel für create-playback-restriction-policy wird eine neue Richtlinie zur Wiedergabebeschränkung erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Das folgende Codebeispiel zeigt, wie create-recording-configuration verwendet wird.

AWS CLI

So erstellen Sie eine RecordingConfiguration-Ressource

Im folgenden Beispiel für create-recording-configuration wird eine RecordingConfiguration-Ressource erstellt, um die Aufzeichnung in Amazon S3 zu ermöglichen.

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}

Ausgabe:

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

Weitere Informationen finden Sie unter Aufzeichnen in Amazon S3 im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie create-stream-key verwendet wird.

AWS CLI

So erstellen Sie einen Stream-Schlüssel

Im folgenden Beispiel für create-stream-key wird ein Stream-Schlüssel für einen angegebenen ARN (Amazon Resource Name) erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter CreateStreamKey in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-channel verwendet wird.

AWS CLI

So löschen Sie einen Kanal und die zugehörigen Stream-Schlüssel

Im folgenden Beispiel für delete-channel wird der Kanal mit dem angegebenen ARN (Amazon Resource Name) gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter DeleteChannel in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-playback-key-pair verwendet wird.

AWS CLI

So löschen Sie ein angegebenes Wiedergabeschlüsselpaar

Das folgende Beispiel für delete-playback-key-pair gibt den Fingerabdruck des angegebenen Schlüsselpaars zurück.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Einrichten privater Kanäle im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie delete-playback-restriction-policy verwendet wird.

AWS CLI

So erstellen Sie eine Richtlinie für Wiedergabebeschränkungen

Im folgenden Beispiel für delete-playback-restriction-policy wird die Richtlinie für Wiedergabebeschränkungen mit dem angegebenen Richtlinien-ARN (Amazon Resource Name) gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Das folgende Codebeispiel zeigt, wie delete-recording-configuration verwendet wird.

AWS CLI

So löschen Sie die durch ihren ARN angegebene RecordingConfiguration-Ressource

Im folgenden Beispiel für delete-recording-configuration wird die RecordingConfiguration-Ressource mit dem angegebenen ARN gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Aufzeichnen in Amazon S3 im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie delete-stream-key verwendet wird.

AWS CLI

So löschen Sie einen Stream-Schlüssel

Im folgenden Beispiel für delete-stream-key wird der Stream-Schlüssel für einen angegebenen ARN (Amazon Resource Name) gelöscht, sodass er nicht mehr zum Streamen verwendet werden kann.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter DeleteStreamKey in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-channel verwendet wird.

AWS CLI

So rufen Sie die Konfigurationsinformationen eines Kanals ab

Im folgenden Beispiel für get-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN (Amazon Resource Name) abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter GetChannel in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-playback-key-pair verwendet wird.

AWS CLI

So rufen Sie ein angegebenes Wiedergabeschlüsselpaar ab

Das folgende Beispiel für get-playback-key-pair gibt den Fingerabdruck des angegebenen Schlüsselpaars zurück.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Einrichten privater Kanäle im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie get-playback-restriction-policy verwendet wird.

AWS CLI

So rufen Sie die Konfigurationsinformationen einer Richtlinie zur Wiedergabeeinschränkung ab

Im folgenden Beispiel für get-playback-restriction-policy wird die Konfiguration der Wiedergabebeschränkungsrichtlinie mit dem angegebenen Richtlinien-ARN (Amazon Resource Name) abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Das folgende Codebeispiel zeigt, wie get-recording-configuration verwendet wird.

AWS CLI

So rufen Sie Informationen zu einer RecordingConfiguration-Ressource ab

Im folgenden Beispiel für get-recording-configuration werden Informationen zur RecordingConfiguration-Ressource für den angegebenen ARN abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Aufzeichnen in Amazon S3 im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie get-stream-key verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Stream ab

Im folgenden Beispiel für get-stream-key werden Informationen zum angegebenen Stream-Schlüsseln abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter GetStreamKey in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-stream-session verwendet wird.

AWS CLI

So rufen Sie Metadaten für einen bestimmten Stream ab

Im folgenden Beispiel für get-stream-session wird die Metadatenkonfiguration für den angegebenen Kanal-ARN (Amazon Resource Name) und den angegebenen Stream abgerufen. Wenn streamId nicht angegeben, wird der neueste Stream für den Kanal ausgewählt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

Das folgende Codebeispiel zeigt, wie get-stream verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Stream ab

Im folgenden Beispiel für get-stream werden Informationen zum Stream für den angegebenen Kanal abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter GetStream in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie import-playback-key-pair verwendet wird.

AWS CLI

So importieren Sie den öffentlichen Teil eines neuen Schlüsselpaars

Im folgenden Beispiel für import-playback-key-pair wird der angegebene öffentliche Schlüssel (als Zeichenfolge im PEM-Format angegeben) importiert und der ARN und der Fingerabdruck des neuen Schlüsselpaars werden zurückgegeben.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Einrichten privater Kanäle im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie list-channels verwendet wird.

AWS CLI

Beispiel 1: So rufen Sie zusammenfassende Informationen zu allen Kanälen ab

Das folgende list-channels Beispiel listet alle Kanäle für Ihr AWS-Konto auf.

aws ivs list-channels

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 2: So rufen Sie zusammenfassende Informationen über alle Kanäle ab, gefiltert nach dem angegebenen RecordingConfiguration-ARN

Im folgenden Beispiel für list-channels werden alle Kanäle für Ihr AWS-Konto aufgelistet, die dem angegebenen RecordingConfiguration-ARN zugeordnet sind.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Aufzeichnen in Amazon S3 im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 3: So rufen Sie zusammenfassende Informationen zu allen Kanälen ab, gefiltert nach dem angegebenen PlaybackRestrictionPolicy-ARN

Im folgenden Beispiel für list-channels werden alle Kanäle für Ihr AWS Konto aufgelistet, die dem angegebenen PlaybackRestrictionPolicy-ARN zugeordnet sind.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter ListChannels in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-playback-key-pairs verwendet wird.

AWS CLI

So rufen Sie zusammenfassende Informationen zu allen Wiedergabe-Schlüsselpaaren auf

Im folgenden Beispiel für list-playback-key-pairs werden Informationen zu allen Schlüsselpaaren zurückgegeben.

aws ivs list-playback-key-pairs

Ausgabe:

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

Weitere Informationen finden Sie unter Einrichten privater Kanäle im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie list-playback-restriction-policies verwendet wird.

AWS CLI

So rufen Sie zusammenfassende Informationen zu allen Richtlinien für Wiedergabebeschränkungen

Im folgenden Beispiel für list-playback-restriction-policies werden alle Richtlinien für Wiedergabebeschränkungen für Ihr AWS-Konto aufgeführt.

aws ivs list-playback-restriction-policies

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Das folgende Codebeispiel zeigt, wie list-recording-configurations verwendet wird.

AWS CLI

So listen Sie alle in diesem Konto erstellten RecordingConfiguration-Ressourcen auf

Im folgenden Beispiel für list-recording-configurations werden Informationen zu allen RecordingConfiguration-Ressource in Ihrem Konto abgerufen.

aws ivs list-recording-configurations

Ausgabe:

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

Weitere Informationen finden Sie unter Aufzeichnen in Amazon S3 im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie list-stream-keys verwendet wird.

AWS CLI

So rufen Sie eine Liste der Stream-Schlüssel ab

Im folgenden Beispiel für list-stream-keys wird ein Stream-Schlüssel für einen angegebenen ARN (Amazon Resource Name) erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter ListStreamKeys in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-stream-sessions verwendet wird.

AWS CLI

So rufen Sie eine Zusammenfassung der aktuellen und vorherigen Streams für einen angegebenen Kanal in der aktuellen AWS-Region ab

Das folgende list-stream-sessions Beispiel meldet zusammenfassende Informationen für Streams für einen angegebenen Kanal-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 ""

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

Das folgende Codebeispiel zeigt, wie list-streams verwendet wird.

AWS CLI

So rufen Sie eine Liste der Live-Streams und ihrer Status ab

Das folgende list-streams Beispiel listet alle Live-Streams für Ihr AWS-Konto auf.

aws ivs list-streams

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter ListStreams in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie alle Tags für eine AWS-Ressource auf (zum Beispiel: Kanal, Streamschlüssel)

Im folgenden Beispiel für list-tags-for-resource werden alle Tags für einen angegebenen Ressourcen-ARN (Amazon Resource Name) aufgelistet.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Tags in der API-Referenz zum Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie put-metadata verwendet wird.

AWS CLI

So fügen Sie Metadaten für einen angegebenen Kanal in den aktiven Stream ein

Im folgenden Beispiel für put-metadata werden die angegebenen Metadaten in den Stream für den angegebenen Kanal eingefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter PutMetadata in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie start-viewer-session-revocation verwendet wird.

AWS CLI

So widerrufen Sie Betrachtersitzungen für mehrere Kanal-ARN- und Betrachter-ID-Paare

Im folgenden Beispiel für start-viewer-session-revocation wird der Prozess zum Widerrufen der Betrachtersitzung, die mit einer bestimmten Kanal-ARN und Betrachter-ID verknüpft ist, bis einschließlich der angegebenen Sitzungsversionsnummer gestartet. Wenn die Version nicht angegeben wird, ist sie standardmäßig 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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Einrichten privater Kanäle im Benutzerhandbuch zu Amazon Interactive Video Service.

Das folgende Codebeispiel zeigt, wie stop-stream verwendet wird.

AWS CLI

So beenden Sie einen angegebenen Stream

Im folgenden Beispiel für stop-stream wird der Stream auf dem angegebenen Kanal gestoppt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter StopStream in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie Tags für eine AWS-Ressource auf (zum Beispiel: Kanal, Streamschlüssel) hinzu oder aktualisieren sie

Im folgenden Beispiel für tag-resource werden Tags für einen angegebenen Ressourcen-ARN (Amazon Resource Name) hinzugefügt oder aktualisiert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tags in der API-Referenz zum Amazon Interactive Video Service.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags für eine AWS-Ressource (zum Beispiel: Channel, Streamschlüssel)

Im folgenden Beispiel für untag-resource werden die angegebenen Tags für eine angegebene Ressourcen-ARN (Amazon Resource Name) entfernt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tags in der API-Referenz zum Amazon Interactive Video Service.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-channel verwendet wird.

AWS CLI

Beispiel 1: So rufen Sie die Konfigurationsinformationen eines Kanals ab

Im folgenden Beispiel für update-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um den Kanalnamen zu ändern. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines Kanals im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 2: So aktualisieren Sie die Konfiguration eines Kanals, um die Aufzeichnung zu aktivieren

Im folgenden Beispiel für update-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um die Aufzeichnung zu aktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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'

Ausgabe:

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

Weitere Informationen finden Sie unter Aufzeichnen in Amazon S3 im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 3: So aktualisieren Sie die Konfiguration eines Kanals, um die Aufzeichnung zu deaktivieren

Im folgenden Beispiel für update-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um die Aufzeichnung zu deaktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter In Amazon S3 aufzeichnen im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 4: So aktualisieren Sie die Konfiguration eines Kanals, um die Wiedergabebeschränkung zu aktivieren

Im folgenden Beispiel für update-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um eine Richtlinie für Wiedergabebeschränkungen anzuwenden. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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'

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 5: So aktualisieren Sie die Konfiguration eines Kanals, um die Wiedergabebeschränkung zu deaktivieren

Im folgenden Beispiel für update-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um die Aufzeichnung zu deaktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 6: So aktualisieren Sie die Konfiguration eines Kanals, um Multitrack zu aktivieren

Im folgenden Beispiel für update-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um Multitrack zu aktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

Beispiel 7: So aktualisieren Sie die Konfiguration eines Kanals, um die Wiedergabebeschränkung zu deaktivieren

Im folgenden Beispiel für update-channel wird die Kanalkonfiguration für einen angegebenen Kanal-ARN aktualisiert, um Multitrack zu aktivieren. Dies wirkt sich nicht auf einen laufenden Stream dieses Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.

  • API-Details finden Sie unter UpdateChannel in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-playback-restriction-policy verwendet wird.

AWS CLI

So erstellen Sie eine Richtlinie für Wiedergabebeschränkungen

Im folgenden Beispiel für update-playback-restriction-policy wird die Wiedergabebeschränkungsrichtlinie mit dem angegebenen Richtlinien-ARN aktualisiert, um die strenge Durchsetzung der Herkunft zu deaktivieren. Dies wirkt sich nicht auf einen laufenden Stream des zugeordneten Kanals aus. Sie müssen den Stream beenden und neu starten, damit die Änderungen wirksam werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Unerwünschte Inhalte und Betrachter im Benutzerhandbuch zu IVS mit niedriger Latenz.