Beispiele für Amazon IVS unter Verwendung von AWS CLI - AWS-SDK-Codebeispiele
Aktionen

Weitere AWS-SDK-Beispiele sind im GitHub-Repository Beispiele für AWS Doc SDKs verfügbar.

Beispiele für Amazon IVS unter Verwendung von AWS CLI

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

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

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

Themen

Aktionen

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

  • Weitere API-Informationen finden Sie unter BatchGetStreamKey in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für 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 für 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 für 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, wie delete-playback-key-pair verwendet wird.

AWS CLI

So löschen Sie ein angegebenes Wiedergabeschlüsselpaar

Im folgenden Beispiel für delete-playback-key-pair wird der Fingerabdruck des angegebenen Schlüsselpaars zurückgegeben.

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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, wie get-playback-key-pair verwendet wird.

AWS CLI

So rufen Sie ein angegebenes Wiedergabeschlüsselpaar ab

Im folgenden Beispiel für get-playback-key-pair wird der Fingerabdruck des angegebenen Schlüsselpaars zurückgegeben.

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 für Amazon Interactive Video Service.

  • Weitere API-Informationen finden Sie unter GetPlaybackKeyPair in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

  • Weitere API-Informationen finden Sie unter GetStreamSession in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, wie list-channels verwendet wird.

AWS CLI

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

Im folgenden Beispiel für list-channels werden alle Kanäle für Ihr AWS-Konto aufgelistet.

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 für 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 In Amazon S3 aufzeichnen im Benutzerhandbuch für 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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

Im folgenden Beispiel für list-stream-sessions werden zusammenfassende Informationen für Streams für einen angegebenen Kanal-ARN (Amazon Resource Name) gemeldet.

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 für IVS mit niedriger Latenz.

  • Weitere API-Informationen finden Sie unter ListStreamSessions in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, wie list-streams verwendet wird.

AWS CLI

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

Im folgenden Beispiel für list-streams werden alle Live-Streams für Ihr AWS-Konto aufgelistet.

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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie alle Tags für eine AWS-Ressource auf (zum Beispiel: Kanal, Stream-Schlü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 zu Amazon Interactive Video Service.

  • Weitere API-Informationen finden Sie unter ListTagsForResource in der AWS CLI-Befehlsreferenz.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für Amazon Interactive Video Service.

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, wie tag-resource verwendet wird.

AWS CLI

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

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 zu Amazon Interactive Video Service.

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

Die folgenden Codebeispiele zeigen, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags für eine AWS-Ressource (zum Beispiel: Kanal, Stream-Schlü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 zu Amazon Interactive Video Service.

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

Die folgenden Codebeispiele zeigen, 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 für 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 In Amazon S3 aufzeichnen im Benutzerhandbuch für 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 für 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 für 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 für 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 für 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 für IVS mit niedriger Latenz.

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

Die folgenden Codebeispiele zeigen, 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 für IVS mit niedriger Latenz.