Amazon IVS-Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon IVS-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon IVS Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface

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 Siebatch-get-channel.

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.

  • Einzelheiten zur API finden Sie BatchGetChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungbatch-get-stream-key.

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 die Verwendungbatch-start-viewer-session-revocation.

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 die Verwendungcreate-channel.

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: Um einen Kanal mit aktivierter Aufzeichnung zu erstellen, verwenden Sie die in seinem 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 Aufzeichnen in Amazon S3 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.

  • Einzelheiten zur API finden Sie CreateChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-playback-restriction-policy.

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 die Verwendungcreate-recording-configuration.

AWS CLI

Um eine RecordingConfiguration Ressource zu erstellen

Das folgende create-recording-configuration Beispiel erstellt eine RecordingConfiguration Ressource, um die Aufzeichnung auf 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 die Verwendungcreate-stream-key.

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.

  • Einzelheiten zur API finden Sie CreateStreamKeyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-channel.

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.

  • Einzelheiten zur API finden Sie DeleteChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-playback-key-pair.

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 die Verwendungdelete-playback-restriction-policy.

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 die Verwendungdelete-recording-configuration.

AWS CLI

Um die durch ihren ARN angegebene RecordingConfiguration Ressource zu löschen

Im folgenden delete-recording-configuration Beispiel 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 die Verwendungdelete-stream-key.

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.

  • Einzelheiten zur API finden Sie DeleteStreamKeyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-channel.

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.

  • Einzelheiten zur API finden Sie GetChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-playback-key-pair.

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 die Verwendungget-playback-restriction-policy.

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 die Verwendungget-recording-configuration.

AWS CLI

Um Informationen über eine RecordingConfiguration Ressource zu erhalten

Im folgenden get-recording-configuration Beispiel werden Informationen über die 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 die Verwendungget-stream-key.

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.

  • Einzelheiten zur API finden Sie GetStreamKeyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-stream-session.

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.

  • Einzelheiten zur API finden Sie GetStreamSessionin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-stream.

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.

  • Einzelheiten zur API finden Sie GetStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungimport-playback-key-pair.

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 die Verwendunglist-channels.

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: Um zusammenfassende Informationen über alle Kanäle zu erhalten, gefiltert nach dem angegebenen RecordingConfiguration ARN

Das folgende list-channels Beispiel listet alle Kanäle für Ihr AWS Konto auf, die mit dem angegebenen RecordingConfiguration ARN verknüpft 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 zu IVS mit niedriger Latenz.

Beispiel 3: Um zusammenfassende Informationen über alle Kanäle zu erhalten, gefiltert nach dem angegebenen PlaybackRestrictionPolicy ARN

Das folgende list-channels Beispiel listet alle Kanäle für Ihr AWS Konto auf, die mit dem angegebenen PlaybackRestrictionPolicy ARN verknüpft 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.

  • Einzelheiten zur API finden Sie ListChannelsunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-playback-key-pairs.

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

AWS CLI

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

Das folgende list-playback-restriction-policies Beispiel listet alle Richtlinien für Wiedergabebeschränkungen für Ihr AWS Konto auf.

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 die Verwendunglist-recording-configurations.

AWS CLI

Um alle in diesem Konto erstellten RecordingConfiguration Ressourcen aufzulisten

Im folgenden list-recording-configurations Beispiel werden Informationen zu allen RecordingConfiguration Ressourcen 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 die Verwendunglist-stream-keys.

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

FFor Weitere Informationen finden Sie unter Einen Kanal erstellen im IVS-Benutzerhandbuch mit niedriger Latenz.

  • Einzelheiten zur API finden Sie ListStreamKeysin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-stream-sessions.

AWS CLI

Um eine Zusammenfassung der aktuellen und vorherigen Streams für einen bestimmten Kanal in der aktuellen AWS Region zu erhalten

Das folgende Beispiel für list-stream-sessions 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 die Verwendunglist-streams.

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.

  • Einzelheiten zur API finden Sie ListStreamsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

Um alle Tags für eine AWS Ressource aufzulisten (zum Beispiel: Channel, Stream Key)

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 die Verwendungput-metadata.

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.

  • Einzelheiten zur API finden Sie PutMetadatain der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-viewer-session-revocation.

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 die Verwendungstop-stream.

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.

  • Einzelheiten zur API finden Sie StopStreamin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

Um Tags für eine AWS Ressource hinzuzufügen oder zu aktualisieren (zum Beispiel: Channel, Stream Key)

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.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

Um Tags für eine AWS Ressource zu entfernen (zum Beispiel: Channel, Stream Key)

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.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-channel.

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 In Amazon S3 aufzeichnen 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.

  • Einzelheiten zur API finden Sie UpdateChannelin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-playback-restriction-policy.

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.