Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
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.
# Beispiele für Amazon IVS Real-Time Streaming mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Real-Time Streaming AWS Command Line Interface mit Amazon IVS Aktionen ausführen und allgemeine Szenarien implementieren.
*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 Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-encoder-configuration`
Das folgende Codebeispiel zeigt, wie Sie`create-encoder-configuration`.
**AWS CLI**
**So erstellen Sie eine Encoder-Konfiguration einer Komposition**
Im folgenden Beispiel für `create-encoder-configuration` wird eine Encoder-Konfiguration für eine Komposition mit den angegebenen Eigenschaften erstellt.
```
aws ivs-realtime create-encoder-configuration \
--name test-ec --video bitrate=3500000,framerate=30.0,height=1080,width=1920
```
Ausgabe:
```
{
"encoderConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef",
"name": "test-ec",
"tags": {},
"video": {
"bitrate": 3500000,
"framerate": 30,
"height": 1080,
"width": 1920
}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [CreateEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-encoder-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `create-ingest-configuration`
Das folgende Codebeispiel zeigt die Verwendung`create-ingest-configuration`.
**AWS CLI**
**So erstellen Sie eine Erfassungskonfiguration**
Im folgenden Beispiel für `create-ingest-configuration` wird eine Erfassungskonfiguration mithilfe des RTMPS-Protokolls erstellt.
```
aws ivs-realtime create-ingest-configuration \
--name ingest1 \
--ingest-protocol rtmps
```
Ausgabe:
```
{
"ingestConfiguration": {
"name": "ingest1",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
"ingestProtocol": "RTMPS",
"streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
"stageArn": "",
"participantId": "xyZ654abC321",
"state": "INACTIVE",
"userId": "",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [CreateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `create-participant-token`
Das folgende Codebeispiel zeigt die Verwendung`create-participant-token`.
**AWS CLI**
**So erstellen Sie ein Stufen-Teilnehmer-Token**
Im folgenden Beispiel für `create-participant-token` wird ein Teilnehmer-Token für die angegebene Stufe erstellt.
```
aws ivs-realtime create-participant-token \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--user-id bob
```
Ausgabe:
```
{
"participantToken": {
"expirationTime": "2023-03-07T09:47:43+00:00",
"participantId": "ABCDEfghij01234KLMN6789",
"token": "abcd1234defg5678"
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [CreateParticipantToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-participant-token.html)in der *AWS CLI Befehlsreferenz*.
### `create-stage`
Das folgende Codebeispiel zeigt die Verwendung`create-stage`.
**AWS CLI**
**Beispiel 1: So erstellen Sie eine Stufe**
Im folgenden Beispiel für `create-stage` wird ein Token für Stufe und Stufenteilnehmer für einen angegebenen Benutzer erstellt.
```
aws ivs-realtime create-stage \
--name stage1 \
--participant-token-configurations userId=alice
```
Ausgabe:
```
{
"participantTokens": [
{
"participantId": "ABCDEfghij01234KLMN5678",
"token": "a1b2c3d4567890ab",
"userId": "alice"
}
],
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "",
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "DISABLED"
},
"recordingReconnectWindowSeconds": 0,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "stage1",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 2: Um eine Phase zu erstellen und die Aufzeichnung einzelner Teilnehmer zu konfigurieren**
Im folgenden Beispiel für `create-stage` wird eine Stufe erstellt und die Aufzeichnung einzelner Teilnehmer konfiguriert.
```
aws ivs-realtime create-stage \
--name stage1 \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}'
```
Ausgabe:
```
{
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh"
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "DISABLED"
},
"recordingReconnectWindowSeconds": 100,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "stage1",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 3: Um eine Phase zu erstellen und die Aufzeichnung einzelner Teilnehmer mit aktivierter Miniaturansicht zu konfigurieren**
Im folgenden Beispiel für `create-stage` wird eine Stufe erstellt und die Aufzeichnung einzelner Teilnehmer mit aktivierter Thumbnail-Aufzeichnung konfiguriert.
```
aws ivs-realtime create-stage \
--name stage1 \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", \
"thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}}'
```
Ausgabe:
```
{
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "INTERVAL"
},
"recordingReconnectWindowSeconds": 0,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "stage1",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
+ Einzelheiten zur API finden Sie [CreateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-stage.html)in der *AWS CLI Befehlsreferenz.*
### `create-storage-configuration`
Das folgende Codebeispiel zeigt die Verwendung`create-storage-configuration`.
**AWS CLI**
**So erstellen Sie eine Speicherkonfiguration für eine Komposition**
Im folgenden Beispiel für `create-storage-configuration` wird eine Speicherkonfiguration für eine Komposition mit den angegebenen Eigenschaften erstellt.
```
aws ivs-realtime create-storage-configuration \
--name "test-sc" --s3 "bucketName=amzn-s3-demo-bucket"
```
Ausgabe:
```
{
"storageConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef",
"name": "test-sc",
"s3": {
"bucketName": "amzn-s3-demo-bucket"
},
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [CreateStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/create-storage-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `delete-encoder-configuration`
Das folgende Codebeispiel zeigt die Verwendung`delete-encoder-configuration`.
**AWS CLI**
**So löschen Sie eine Encoder-Konfiguration für eine Komposition**
Im folgenden Beispiel für `delete-encoder-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Encoder-Konfiguration für die Komposition gelöscht.
```
aws ivs-realtime delete-encoder-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [DeleteEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-encoder-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `delete-ingest-configuration`
Das folgende Codebeispiel zeigt die Verwendung`delete-ingest-configuration`.
**AWS CLI**
**Beispiel 1: So löschen Sie eine inaktive Erfassungskonfiguration**
Im folgenden Beispiel für `delete-ingest-configuration` wird die inaktive Erfassungskonfiguration für einen angegebenen ARN (Amazon Resource Name) einer Erfassungskonfiguration gelöscht.
```
aws ivs-realtime delete-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
**Beispiel 2: So erzwingen Sie das Löschen einer aktiven Erfassungskonfiguration**
Im folgenden Beispiel für `delete-ingest-configuration` wird die Löschung der aktiven Erfassungskonfiguration für einen angegebenen ARN (Amazon Resource Name) einer Erfassungskonfiguration erzwungen.
```
aws ivs-realtime delete-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
--force
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [DeleteIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `delete-public-key`
Das folgende Codebeispiel zeigt die Verwendung`delete-public-key`.
**AWS CLI**
**So löschen Sie einen öffentlichen Schlüssel**
Im folgenden Beispiel für `delete-public-key` wird der angegebene öffentliche Schlüssel gelöscht.
```
aws ivs-realtime delete-public-key \
--arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*.
+ Einzelheiten zur API finden Sie [DeletePublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-public-key.html)in der *AWS CLI Befehlsreferenz*.
### `delete-stage`
Das folgende Codebeispiel zeigt die Verwendung`delete-stage`.
**AWS CLI**
**So löschen Sie eine Stufe**
Im folgenden Beispiel für `delete-stage` wird die angegebene Stufe gelöscht.
```
aws ivs-realtime delete-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [DeleteStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-stage.html)in der *AWS CLI Befehlsreferenz*.
### `delete-storage-configuration`
Das folgende Codebeispiel zeigt die Verwendung`delete-storage-configuration`.
**AWS CLI**
**So löschen Sie eine Speicherkonfiguration für eine Komposition**
Im folgenden Beispiel für `delete-storage-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Speicherkonfiguration für die Komposition gelöscht.
```
aws ivs-realtime delete-storage-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [DeleteStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/delete-storage-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `disconnect-participant`
Das folgende Codebeispiel zeigt die Verwendung`disconnect-participant`.
**AWS CLI**
**So trennen Sie einen Stufenteilnehmer**
Im folgenden Beispiel für `disconnect-participant` wird der angegebene Teilnehmer von der angegebenen Stufe getrennt.
```
aws ivs-realtime disconnect-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--participant-id ABCDEfghij01234KLMN5678
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [DisconnectParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/disconnect-participant.html)in der *AWS CLI Befehlsreferenz*.
### `get-composition`
Das folgende Codebeispiel zeigt die Verwendung`get-composition`.
**AWS CLI**
**Beispiel 1: So rufen Sie eine Komposition mit Standard-Layouteinstellungen ab**
Im folgenden Beispiel für `get-composition` wird die Komposition für den angegebenen ARN (Amazon Resource Name) abgerufen.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Ausgabe:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "ACTIVE"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": "",
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "ACTIVE",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*.
**Beispiel 2: So rufen Sie eine Komposition mit PiP-Layout ab**
Im folgenden Beispiel für `get-composition` wird die Komposition für den angegebenen ARN (Amazon Resource Name) abgerufen, die das PiP-Layout verwendet.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs"
```
Ausgabe:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "ACTIVE"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "STARTING"
}
],
"layout": {
"pip": {
"featuredParticipantAttribute": "abcdefg",
"gridGap": 0,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"pipBehavior": "STATIC",
"pipOffset": 0,
"pipParticipantAttribute": "",
"pipPosition": "BOTTOM_RIGHT",
"videoFillMode": "COVER"
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "ACTIVE",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*.
**Beispiel 3: So rufen Sie eine Komposition mit aktivierter Thumbnail-Aufzeichnung ab**
Im folgenden Beispiel für `get-composition` wird die Komposition für den angegebenen ARN (Amazon Resource Name) abgerufen, bei dem die Thumbnail-Erfassung über die Standardeinstellungen aktiviert ist.
```
aws ivs-realtime get-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Ausgabe:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "ACTIVE"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
"thumbnailConfigurations": [
{
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"startTime": "2023-10-16T23:26:00+00:00",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": "" }
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "ACTIVE",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [GetComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-composition.html)in der *AWS CLI Befehlsreferenz.*
### `get-encoder-configuration`
Das folgende Codebeispiel zeigt die Verwendung`get-encoder-configuration`.
**AWS CLI**
**So rufen Sie die Encoder-Konfiguration für eine Komposition ab**
Im folgenden Beispiel für `get-encoder-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Encoder-Konfiguration für die Komposition abgerufen.
```
aws ivs-realtime get-encoder-configuration \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh"
```
Ausgabe:
```
{
"encoderConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh",
"name": "test-ec",
"tags": {},
"video": {
"bitrate": 3500000,
"framerate": 30,
"height": 1080,
"width": 1920
}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [GetEncoderConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-encoder-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `get-ingest-configuration`
Das folgende Codebeispiel zeigt die Verwendung`get-ingest-configuration`.
**AWS CLI**
**So rufen Sie Informationen zur Erfassungskonfiguration ab**
Im folgenden Beispiel für `get-ingest-configuration` wird die Erfassungskonfiguration für einen angegebenen ARN (Amazon Resource Name) einer Erfassungskonfiguration abgerufen.
```
aws ivs-realtime get-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234
```
Ausgabe:
```
{
"ingestConfiguration": {
"name": "ingest1",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
"ingestProtocol": "RTMPS",
"streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
"stageArn": "",
"participantId": "xyZ654abC321",
"state": "INACTIVE",
"userId": "",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [GetIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `get-participant`
Das folgende Codebeispiel zeigt die Verwendung`get-participant`.
**AWS CLI**
**Beispiel 1: So rufen Sie einen Stufenteilnehmer ab**
Im folgenden Beispiel für `get-participant` wird der Stufenteilnehmer für eine angegebene Teilnehmer-ID und Sitzungs-ID im angegebenen Stufen-ARN (Amazon Resource Name) abgerufen.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"participant": {
"browserName": "Google Chrome",
"browserVersion": "116",
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"ispName": "Comcast",
"osName": "Microsoft Windows 10 Pro",
"osVersion": "10.0.19044",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingS3BucketName": "bucket-name",
"recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
"recordingState": "ACTIVE",
"sdkVersion": "",
"state": "CONNECTED",
"userId": ""
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 2: So rufen Sie einen Stufenteilnehmer ab, der auf eine andere Stufe repliziert wurde**
Im folgenden Beispiel für `get-participant` wird der Stufenteilnehmer für eine angegebene Teilnehmer-ID und Sitzungs-ID im angegebenen Stufen-ARN (Amazon Resource Name) abgerufen, wenn der Teilnehmer auch auf eine andere Stufe repliziert wurde.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"participant": {
"browserName": "Google Chrome",
"browserVersion": "116",
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"ispName": "Comcast",
"osName": "Microsoft Windows 10 Pro",
"osVersion": "10.0.19044",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingS3BucketName": "bucket-name",
"recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
"recordingState": "ACTIVE",
"replicationState": "ACTIVE",
"replicationType": "SOURCE",
"sdkVersion": "",
"state": "CONNECTED",
"userId": ""
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 3: So rufen Sie einen Stufenteilnehmer ab, der von einer anderen Stufe repliziert wurde**
Im folgenden Beispiel für `get-participant` wird der Stufenteilnehmer für eine angegebene Teilnehmer-ID und Sitzungs-ID im angegebenen Stufen-ARN (Amazon Resource Name) abgerufen, wenn der Teilnehmer von einer anderen Stufe repliziert wurde.
```
aws ivs-realtime get-participant \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"participant": {
"browserName": "Google Chrome",
"browserVersion": "116",
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"ispName": "Comcast",
"osName": "Microsoft Windows 10 Pro",
"osVersion": "10.0.19044",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingS3BucketName": "bucket-name",
"recordingS3Prefix": "abcdABCDefgh/st-a1b2c3d4e5f6g/abCDEf12GHIj/1234567890",
"recordingState": "ACTIVE",
"replicationState": "ACTIVE",
"replicationType": "REPLICA",
"sdkVersion": "",
"state": "CONNECTED",
"userId": ""
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
+ Einzelheiten zur API finden Sie [GetParticipant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-participant.html)in der *AWS CLI Befehlsreferenz*.
### `get-public-key`
Das folgende Codebeispiel zeigt die Verwendung`get-public-key`.
**AWS CLI**
**So rufen Sie einen vorhandenen öffentlichen Schlüssel ab, der zum Signieren von Stufenteilnehmer-Token verwendet wird**
Im folgenden Beispiel für `get-public-key` wird ein durch den bereitgestellten ARN angegebener öffentlicher Schlüssel zum Signieren von Stufenteilnehmer-Token abgerufen.
```
aws ivs-realtime get-public-key \
--arn arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2
```
Ausgabe:
```
{
"publicKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
"name": "",
"publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----",
"fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*.
+ Einzelheiten zur API finden Sie [GetPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-public-key.html)in der *AWS CLI Befehlsreferenz*.
### `get-stage-session`
Das folgende Codebeispiel zeigt die Verwendung`get-stage-session`.
**AWS CLI**
**So rufen Sie eine Stufensitzung ab**
Im folgenden Beispiel für `get-stage-session` wird die Stufensitzung für eine angegebene Sitzungs-ID des angegebenen Stufen-ARN (Amazon Resource Name) abgerufen.
```
aws ivs-realtime get-stage-session \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Ausgabe:
```
{
"stageSession": {
"endTime": "2023-04-26T20:36:29+00:00",
"sessionId": "st-a1b2c3d4e5f6g",
"startTime": "2023-04-26T20:30:29.602000+00:00"
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [GetStageSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage-session.html)in der *AWS CLI Befehlsreferenz*.
### `get-stage`
Das folgende Codebeispiel zeigt die Verwendung`get-stage`.
**AWS CLI**
**So rufen Sie die Konfigurationsinformationen einer Stufe ab**
Im folgenden Beispiel für `get-stage` wird die Stufenkonfiguration für einen angegebenen Stufen-ARN (Amazon Resource Name) abgerufen.
```
aws ivs-realtime get-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Ausgabe:
```
{
"stage": {
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"storageConfigurationArn": "",
"mediaTypes": [
"AUDIO_VIDEO"
],
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "DISABLED"
},
"recordingReconnectWindowSeconds": 0,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://9x0y8z7s6t5u.global-bm.whip.live-video.net"
},
"name": "test",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
+ Einzelheiten zur API finden Sie [GetStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-stage.html)in der *AWS CLI Befehlsreferenz*.
### `get-storage-configuration`
Das folgende Codebeispiel zeigt die Verwendung`get-storage-configuration`.
**AWS CLI**
**So rufen Sie die Speicherkonfiguration für eine Komposition ab**
Im folgenden Beispiel für `get-storage-configuration` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Speicherkonfiguration für die Komposition abgerufen.
```
aws ivs-realtime get-storage-configuration \
--name arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh"
```
Ausgabe:
```
{
"storageConfiguration": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
"name": "test-sc",
"s3": {
"bucketName": "amzn-s3-demo-bucket"
},
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [GetStorageConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/get-storage-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `import-public-key`
Das folgende Codebeispiel zeigt die Verwendung`import-public-key`.
**AWS CLI**
**So importieren Sie einen vorhandenen öffentlichen Schlüssel, der zum Signieren von Stufenteilnehmer-Token verwendet wird**
Im folgenden Beispiel für `import-public-key` wird ein öffentlicher Schlüssel aus einer Materialdatei importiert, der zum Signieren von Stufenteilnehmer-Token verwendet werden soll.
```
aws ivs-realtime import-public-key \
--public-key-material="`cat public.pem`"
```
Ausgabe:
```
{
"publicKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
"name": "",
"publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEqVWUtqs6EktQMR1sCYmEzGvRwtaycI16\n9pmzcpiWu/uhNStGlteJ5odRfRwVkoQUMnSZXTCcbn9bBTTmiWo4mJcFOOAzsthH\n0UAb8NdD4tUE0At4a9hYP9IETEXAMPLE\n-----END PUBLIC KEY-----",
"fingerprint": "12:a3:44:56:bc:7d:e8:9f:10:2g:34:hi:56:78:90:12",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*.
+ Einzelheiten zur API finden Sie [ImportPublicKey](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/import-public-key.html)in der *AWS CLI Befehlsreferenz*.
### `list-compositions`
Das folgende Codebeispiel zeigt die Verwendung`list-compositions`.
**AWS CLI**
**So rufen Sie eine Liste von Kompositionen ab**
Im Folgenden `list-compositions` werden alle Kompositionen für Ihr AWS Konto in der AWS Region aufgeführt, in der die API-Anfrage bearbeitet wird.
```
aws ivs-realtime list-compositions
```
Ausgabe:
```
{
"compositions": [
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"id": "AabBCcdDEefF",
"startTime": "2023-10-16T23:25:23+00:00",
"state": "ACTIVE"
}
],
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:25:21+00:00",
"state": "ACTIVE",
"tags": {}
},
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/ABcdabCDefgh",
"destinations": [
{
"endTime": "2023-10-16T23:25:00.786512+00:00",
"id": "aABbcCDdeEFf",
"startTime": "2023-10-16T23:24:01+00:00",
"state": "STOPPED"
},
{
"endTime": "2023-10-16T23:25:00.786512+00:00",
"id": "deEFfaABbcCD",
"startTime": "2023-10-16T23:24:01+00:00",
"state": "STOPPED"
}
],
"endTime": "2023-10-16T23:25:00+00:00",
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/efghabcdABCD",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STOPPED",
"tags": {}
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [ListCompositions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-compositions.html)in der *AWS CLI Befehlsreferenz*.
### `list-encoder-configurations`
Das folgende Codebeispiel zeigt die Verwendung`list-encoder-configurations`.
**AWS CLI**
**So listen Sie die Konfigurationen des Kompositions-Encoders auf**
Im Folgenden `list-encoder-configurations` sind alle Composition Encoder-Konfigurationen für Ihr AWS Konto in der AWS Region aufgeführt, in der die API-Anfrage verarbeitet wird.
```
aws ivs-realtime list-encoder-configurations
```
Ausgabe:
```
{
"encoderConfigurations": [
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/abcdABCDefgh",
"name": "test-ec-1",
"tags": {}
},
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABCefgEFGabc",
"name": "test-ec-2",
"tags": {}
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [ListEncoderConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-encoder-configurations.html)in der *AWS CLI Befehlsreferenz.*
### `list-ingest-configurations`
Das folgende Codebeispiel zeigt die Verwendung`list-ingest-configurations`.
**AWS CLI**
**So rufen Sie zusammenfassende Informationen zu allen Erfassungskonfigurationen ab**
Das folgende `list-ingest-configurations` Beispiel listet alle Aufnahmekonfigurationen für Ihr AWS Konto in der AWS Region auf, in der die API-Anfrage verarbeitet wird.
```
aws ivs-realtime list-ingest-configurations
```
Ausgabe:
```
{
"ingestConfigurations": [
{
"name": "",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/XYZuvwSt4567",
"ingestProtocol": "RTMPS",
"stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"participnatId": "abC789Xyz456",
"state": "INACTIVE"
"userId": "",
}
]
}
```
Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [ListIngestConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-ingest-configurations.html)in der *AWS CLI Befehlsreferenz.*
### `list-participant-events`
Das folgende Codebeispiel zeigt die Verwendung`list-participant-events`.
**AWS CLI**
**Beispiel 1: So rufen Sie eine Liste der Ereignisse von Stufenteilnehmern ab**
Im folgenden Beispiel für `list-participant-events` werden alle Teilnehmerereignisse für eine angegebene Teilnehmer-ID und Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet.
```
aws ivs-realtime list-participant-events \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"events": [
{
"eventTime": "2023-04-26T20:36:28+00:00",
"name": "LEFT",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2023-04-26T20:36:28+00:00",
"name": "PUBLISH_STOPPED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2023-04-26T20:30:34+00:00",
"name": "JOINED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2023-04-26T20:30:34+00:00",
"name": "PUBLISH_STARTED",
"participantId": "abCDEf12GHIj"
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 2: So rufen Sie eine Liste der Ereignisse von Stufenteilnehmern ab, einschließlich Stopp und Start der Replikation von Teilnehmern**
Im folgenden Beispiel für `list-participant-events` werden alle Teilnehmerereignisse für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet, in denen ein Teilnehmer auf eine andere Stufe repliziert wird.
```
aws ivs-realtime list-participant-events \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"events": [
{
"eventTime": "2025-04-26T20:36:28+00:00",
"name": "LEFT",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2025-04-26T20:36:28+00:00",
"name": "PUBLISH_STOPPED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2025-04-26T20:30:34+00:00",
"name": "JOINED",
"participantId": "abCDEf12GHIj"
},
{
"eventTime": "2025-04-26T20:30:34+00:00",
"name": "PUBLISH_STARTED",
"participantId": "abCDEf12GHIj"
},
{
"name": "REPLICATION_STARTED",
"participantId": "abCDEf12GHIj",
"eventTime": "2025-04-26T20:30:34+00:00",
"destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
"destinationSessionId": "st-b1c2d3e4f5g6a"
},
{
"name": "REPLICATION_STOPPED",
"participantId": "abCDEf12GHIj",
"eventTime": "2025-04-26T20:32:34+00:00",
"destinationStageArn": "arn:aws:ivs:us-west-2:12345678901:stage/ABCDabcdefgh",
"destinationSessionId": "st-b1c2d3e4f5g6a"
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
+ Einzelheiten zur API finden Sie [ListParticipantEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-events.html)in der *AWS CLI Befehlsreferenz*.
### `list-participant-replicas`
Das folgende Codebeispiel zeigt die Verwendung`list-participant-replicas`.
**AWS CLI**
**So rufen Sie eine Liste der Replikate von Stufenteilnehmern ab**
Im folgenden Beispiel für `list-participant-replicas` werden alle Teilnehmer der Stufe aufgelistet, die von dem angegebenen Quellstufen-ARN (Amazon Resource Name) auf eine andere Stufe repliziert wurden.
```
aws ivs-realtime list-participant-replicas \
--source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"replicas": [
{
"sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"participantId": "abCDEf12GHIj",
"sourceSessionId": "st-a1b2c3d4e5f6g",
"destinationStageArn": "arn:aws:ivs:us-west-2:012345678901:stage/ABCDabcdefgh",
"destinationSessionId": "st-b1c2d3e4f5g6a",
"replicationState": "ACTIVE"
}
]
}
```
Weitere Informationen finden Sie unter [IVS-Teilnehmerreplikation](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*.
+ Einzelheiten zur API finden Sie [ListParticipantReplicas](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participant-replicas.html)in der *AWS CLI Befehlsreferenz*.
### `list-participants`
Das folgende Codebeispiel zeigt die Verwendung`list-participants`.
**AWS CLI**
**Beispiel 1: So rufen Sie eine Liste von Stufenteilnehmern ab**
Im folgenden Beispiel für `list-participants` werden alle Teilnehmer für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Ausgabe:
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": ""
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 2: So rufen Sie eine Liste von Stufenteilnehmern ab, wenn ein Teilnehmer auf eine andere Stufe repliziert wurde**
Im folgenden Beispiel für `list-participants` werden alle Teilnehmer für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet, wenn ein Teilnehmer auf eine andere Stufe repliziert wurde.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Ausgabe:
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": "",
"replicationState": "ACTIVE",
"replicationType": "SOURCE",
"sourceStageArn": "",
"sourceSessionId": ""
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 3: So rufen Sie eine Liste von Stufenteilnehmern ab, wenn ein Teilnehmer aus einer anderen Stufe repliziert wurde**
Im folgenden Beispiel für `list-participants` werden alle Teilnehmer für eine angegebene Sitzungs-ID eines bestimmten Phasen-ARN (Amazon Resource Name) aufgelistet, wenn ein Teilnehmer von einer anderen Stufe repliziert wurde.
```
aws ivs-realtime list-participants \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--session-id st-a1b2c3d4e5f6g
```
Ausgabe:
```
{
"participants": [
{
"firstJoinTime": "2023-04-26T20:30:34+00:00",
"participantId": "abCDEf12GHIj",
"published": true,
"recordingState": "STOPPED",
"state": "DISCONNECTED",
"userId": "",
"replicationState": "ACTIVE",
"replicationType": "REPLICA",
"sourceStageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"sourceSessionId": "st-a1b2c3d4e5f6g"
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
+ Einzelheiten zur API finden Sie [ListParticipants](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-participants.html)in der *AWS CLI Befehlsreferenz*.
### `list-public-keys`
Das folgende Codebeispiel zeigt die Verwendung`list-public-keys`.
**AWS CLI**
**So listen Sie bestehende öffentliche Schlüssel auf, die zum Signieren von Stufenteilnehmer-Token verfügbar sind**
Das folgende `list-public-keys` Beispiel listet alle öffentlichen Schlüssel auf, die in der AWS Region, in der die API-Anfrage verarbeitet wird, zum Signieren von Token für Phasenteilnehmer verfügbar sind.
```
aws ivs-realtime list-public-keys
```
Ausgabe:
```
{
"publicKeys": [
{
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/abcdABC1efg2",
"name": "",
"tags": {}
},
{
"arn": "arn:aws:ivs:us-west-2:123456789012:public-key/3bcdABCDefg4",
"name": "",
"tags": {}
}
]
}
```
Weitere Informationen finden Sie unter [Verteilen von Teilnehmertoken](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*.
+ Einzelheiten zur API finden Sie [ListPublicKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-public-keys.html)in der *AWS CLI Befehlsreferenz.*
### `list-stage-sessions`
Das folgende Codebeispiel zeigt die Verwendung`list-stage-sessions`.
**AWS CLI**
**So rufen Sie eine Liste der Stufensitzungen auf**
Im folgenden Beispiel für `list-stage-sessions` werden alle Sitzungen für einen angegebenen Phasen-ARN (Amazon Resource Name) aufgelistet.
```
aws ivs-realtime list-stage-sessions \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Ausgabe:
```
{
"stageSessions": [
{
"endTime": "2023-04-26T20:36:29+00:00",
"sessionId": "st-a1b2c3d4e5f6g",
"startTime": "2023-04-26T20:30:29.602000+00:00"
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/userguide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [ListStageSessions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stage-sessions.html)in der *AWS CLI Befehlsreferenz*.
### `list-stages`
Das folgende Codebeispiel zeigt die Verwendung`list-stages`.
**AWS CLI**
**So rufen Sie zusammenfassende Informationen über alle Stufen ab**
Das folgende `list-stages` Beispiel listet alle Phasen Ihres AWS Kontos in der AWS Region auf, in der die API-Anfrage verarbeitet wird.
```
aws ivs-realtime list-stages
```
Ausgabe:
```
{
"stages": [
{
"activeSessionId": "st-a1b2c3d4e5f6g",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"name": "stage1",
"tags": {}
},
{
"activeSessionId": "st-a123bcd456efg",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcd1234ABCD",
"name": "stage2",
"tags": {}
},
{
"activeSessionId": "st-abcDEF1234ghi",
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/ABCD1234efgh",
"name": "stage3",
"tags": {}
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [ListStages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-stages.html)in der *AWS CLI Befehlsreferenz*.
### `list-storage-configurations`
Das folgende Codebeispiel zeigt die Verwendung`list-storage-configurations`.
**AWS CLI**
**So listen Sie die Konfigurationen des Kompositionsspeichers auf**
Im Folgenden `list-storage-configurations` werden alle Konfigurationen des Kompositionsspeichers für Ihr AWS Konto in der AWS Region aufgeführt, in der die API-Anfrage verarbeitet wird.
```
aws ivs-realtime list-storage-configurations
```
Ausgabe:
```
{
"storageConfigurations": [
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
"name": "test-sc-1",
"s3": {
"bucketName": "amzn-s3-demo-bucket-1"
},
"tags": {}
},
{
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABCefgEFGabc",
"name": "test-sc-2",
"s3": {
"bucketName": "amzn-s3-demo-bucket-2"
},
"tags": {}
}
]
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [ListStorageConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/list-storage-configurations.html)in der *AWS CLI Befehlsreferenz*.
### `start-composition`
Das folgende Codebeispiel zeigt die Verwendung`start-composition`.
**AWS CLI**
**Beispiel 1: So starten Sie eine Komposition mit Standard-Layouteinstellungen**
Im folgenden Beispiel für `start-composition` wird eine Komposition für die angegebene Stufe gestartet, die an die angegebenen Speicherorte gestreamt wird.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"recordingConfiguration": {"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}, \
"storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]'
```
Ausgabe:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*.
**Beispiel 2: So starten Sie eine Komposition mit PiP-Layout**
Im folgenden Beispiel für `start-composition` wird eine Komposition für die angegebene Stufe gestartet, die mithilfe des PiP-Layouts an die angegebenen Speicherorte gestreamt wird.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3":{"encoderConfigurationArns":["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"storageConfigurationArn":"arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"}}]' \
--layout pip='{featuredParticipantAttribute="abcdefg"}'
```
Ausgabe:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/wxyzWXYZpqrs",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE"
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"pip": {
"featuredParticipantAttribute": "abcdefg",
"gridGap": 0,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"pipBehavior": "STATIC",
"pipOffset": 0,
"pipParticipantAttribute": "",
"pipPosition": "BOTTOM_RIGHT",
"videoFillMode": "COVER"
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*.
**Beispiel 3: So starten Sie eine Komposition mit aktivierter Thumbnail-Aufzeichnung**
Im folgenden Beispiel für `start-composition` wird eine Komposition für die angegebene Stufe gestartet, die an die angegebenen Speicherorte mit aktivierter Thumbnail-Aufzeichnung gestreamt wird.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3": {"encoderConfigurationArns": ["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", \
"thumbnailConfigurations": [{"storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}]}}]'
```
Ausgabe:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
"thumbnailConfigurations": [
{
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
]
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Composite Recording (Echtzeit-Streaming)](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*.
**Beispiel 4: So starten Sie eine Komposition mit Rasterlayout und benutzerdefinierter Reihenfolge der Teilnehmer**
Im folgenden `start-composition` Beispiel wird eine Komposition für die angegebene Phase gestartet, die mithilfe eines Rasterlayouts mit benutzerdefinierter Reihenfolge der Teilnehmer an die angegebenen Standorte gestreamt wird.
```
aws ivs-realtime start-composition \
--stage-arn arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd \
--destinations '[{"channel": {"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg", \
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"}}, \
{"s3": {"encoderConfigurationArns": ["arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"], \
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE", \
"thumbnailConfigurations": [{"storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}]}}]' \
--layout grid='{participantOrderAttribute="abcdefg"}'
```
Ausgabe:
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh",
"destinations": [
{
"configuration": {
"channel": {
"channelArn": "arn:aws:ivs:ap-northeast-1:123456789012:channel/abcABCdefDEg",
"encoderConfigurationArn": "arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
},
"name": ""
},
"id": "AabBCcdDEefF",
"state": "STARTING"
},
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:arn:aws:ivs:ap-northeast-1:123456789012:encoder-configuration/ABabCDcdEFef"
],
"recordingConfiguration": {
"format": "HLS",
"hlsConfiguration": {
"targetSegmentDurationSeconds": 2
}
},
"storageConfigurationArn": "arn:arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/FefABabCDcdE",
"thumbnailConfigurations": [
{
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
]
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "aBcDeFgHhGfE/AbCdEfGhHgFe/GHFabcgefABC/composite"
}
},
"id": "GHFabcgefABC",
"state": "STARTING"
}
],
"layout": {
"grid": {
"featuredParticipantAttribute": ""
"gridGap": 2,
"omitStoppedVideo": false,
"participantOrderAttribute": "abcdefg",
"videoAspectRatio": "VIDEO",
"videoFillMode": ""
}
},
"stageArn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/defgABCDabcd",
"startTime": "2023-10-16T23:24:00+00:00",
"state": "STARTING",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS Composite Recording \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) im *Amazon Interactive Video Service-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [StartComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-composition.html)in der *AWS CLI Befehlsreferenz.*
### `start-participant-replication`
Das folgende Codebeispiel zeigt die Verwendung`start-participant-replication`.
**AWS CLI**
**So starten Sie die Replikation eines Teilnehmers von einer Stufe auf eine andere**
Im folgenden Beispiel für `start-participant-replication` wird ein Teilnehmer von einer Quellstufe in eine Zielstufe repliziert, wobei jede Stufe durch ihren ARN (Amazon Resource Name) angegeben wird.
```
aws ivs-realtime start-participant-replication \
--source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"accessControlAllowOrigin": "*",
"accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
"cacheControl": "no-store, no-cache",
"contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
"strictTransportSecurity": "max-age:47304000; includeSubDomains",
"xContentTypeOptions": "nosniff",
"xFrameOptions": "DENY"
}
```
Weitere Informationen finden Sie unter [IVS-Teilnehmerreplikation](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*.
+ Einzelheiten zur API finden Sie [StartParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/start-participant-replication.html)in der *AWS CLI Befehlsreferenz*.
### `stop-composition`
Das folgende Codebeispiel zeigt die Verwendung`stop-composition`.
**AWS CLI**
**So stoppen Sie eine Komposition**
Im folgenden Beispiel für `stop-composition` wird die durch den angegebenen ARN (Amazon Resource Name) festgelegte Komposition gestoppt.
```
aws ivs-realtime stop-composition \
--arn "arn:aws:ivs:ap-northeast-1:123456789012:composition/abcdABCDefgh"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [StopComposition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-composition.html)in der *AWS CLI Befehlsreferenz*.
### `stop-participant-replication`
Das folgende Codebeispiel zeigt die Verwendung`stop-participant-replication`.
**AWS CLI**
**So stoppen Sie die Replikation eines Teilnehmers von einer Stufe auf eine andere**
Im folgenden Beispiel für `stop-participant-replication` wird die Replikation eines Teilnehmers von einer Quellstufe in eine Zielstufe gestoppt, wobei jede Stufe durch ihren ARN (Amazon Resource Name) angegeben wird.
```
aws ivs-realtime stop-participant-replication \
--source-stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--destination-stage-arn arn:aws:ivs:us-west-2:234567890123:stage/bcdABCDefghi \
--participant-id abCDEf12GHIj
```
Ausgabe:
```
{
"accessControlAllowOrigin": "*",
"accessControlExposeHeaders": "Access-Control-Allow-Origin,Access-Control-Expose-Headers,Cache-Control,Content-Length, \
Content-Security-Policy,Content-Type,date,Strict-Transport-Security,x-amz-apigw-id,x-amzn-errormessage,x-amzn-errortype, \
x-amzn-requestid,x-amzn-trace-id,X-Content-Type-Options,X-Frame-Options",
"cacheControl": "no-store, no-cache",
"contentSecurityPolicy": "default-src 'self'; upgrade-insecure-requests;",
"strictTransportSecurity": "max-age:47304000; includeSubDomains",
"xContentTypeOptions": "nosniff",
"xFrameOptions": "DENY"
}
```
Weitere Informationen finden Sie unter [IVS-Teilnehmerreplikation](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-participant-replication.html) im *Benutzerhandbuch für Amazon-IVS-Streaming in Echtzeit*.
+ Einzelheiten zur API finden Sie [StopParticipantReplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/stop-participant-replication.html)in der *AWS CLI Befehlsreferenz*.
### `update-ingest-configuration`
Das folgende Codebeispiel zeigt die Verwendung`update-ingest-configuration`.
**AWS CLI**
**So aktualisieren Sie eine Erfassungskonfiguration**
Im folgenden Beispiel für `update-inegst-configuration` wird eine Erfassungskonfiguration aktualisiert, um sie an eine Stufe anzuhängen.
```
aws ivs-realtime update-ingest-configuration \
--arn arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234 \
--stage-arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh
```
Ausgabe:
```
{
"ingestConfiguration": {
"name": "ingest1",
"arn": "arn:aws:ivs:us-west-2:123456789012:ingest-configuration/AbCdEfGh1234",
"ingestProtocol": "RTMPS",
"streamKey": "rt_123456789012_us-west-2_AbCdEfGh1234_abcd1234efgh5678ijkl9012MNOP34",
"stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"participantId": "xyZ654abC321",
"state": "INACTIVE",
"userId": "",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [IVS-Streamerfassung \$1 Echtzeit-Streaming](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/rt-stream-ingest.html) im *Benutzerhandbuch für Amazon Interactive Video Service*.
+ Einzelheiten zur API finden Sie [UpdateIngestConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-ingest-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `update-stage`
Das folgende Codebeispiel zeigt die Verwendung`update-stage`.
**AWS CLI**
**Beispiel 1: So aktualisieren Sie die Konfiguration einer Stufe**
Im folgenden Beispiel für `update-stage` wird eine Stufe für einen angegebenen Stufen-ARN aktualisiert, um den Stufennamen zu aktualisieren und die Aufzeichnung einzelner Teilnehmer mit aktivierter Thumbnail-Aufzeichnung zu konfigurieren.
```
aws ivs-realtime update-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
"thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}} \
"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \
--name stage1a
```
Ausgabe:
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"mediaTypes": [
"AUDIO_VIDEO"
],
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "INTERVAL"
},
"recordingReconnectWindowSeconds": 100,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
},
"recordParticipantReplicas": true
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
},
"name": "stage1a",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
**Beispiel 2: So aktualisieren Sie die Konfiguration einer Stufe, einschließlich der Deaktivierung der Aufzeichnung von Teilnehmerreplikaten**
Im folgenden Beispiel für `update-stage` wird eine Stufe für einen angegebenen Stufen-ARN aktualisiert, um den Stufennamen zu aktualisieren und die Aufzeichnung einzelner Teilnehmer mit aktivierter Thumbnail-Aufzeichnung und deaktivierter Aufzeichnung von Teilnehmerreplikaten zu konfigurieren.
```
aws ivs-realtime update-stage \
--arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh \
--auto-participant-recording-configuration '{"mediaTypes": ["AUDIO_VIDEO"],"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh", "recordingReconnectWindowSeconds": 100, \
"thumbnailConfiguration": {"recordingMode": "INTERVAL","storage": ["SEQUENTIAL"],"targetIntervalSeconds": 60}, "recordParticipantReplicas":false} \
"hlsConfiguration": {"targetSegmentDurationSeconds": 5}}' \
--name stage1a
```
Ausgabe:
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh",
"autoParticipantRecordingConfiguration": {
"mediaTypes": [
"AUDIO_VIDEO"
],
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/abcdABCDefgh",
"thumbnailConfiguration": {
"targetIntervalSeconds": 60,
"storage": [
"SEQUENTIAL"
],
"recordingMode": "INTERVAL"
},
"recordingReconnectWindowSeconds": 100,
"hlsConfiguration": {
"targetSegmentDurationSeconds": 5
},
"recordParticipantReplicas": false
},
"endpoints": {
"events": "wss://global.events.live-video.net",
"rtmp": "rtmp://9x0y8z7s6t5u.global-contribute-staging.live-video.net/app/",
"rtmps": "rtmps://9x0y8z7s6t5u.global-contribute-staging.live-video.net:443/app/",
"whip": "https://1a2b3c4d5e6f.global-bm.whip.live-video.net"
},
"name": "stage1a",
"tags": {}
}
}
```
Weitere Informationen finden Sie unter [Aktivieren mehrerer Hosts in einem Amazon-IVS-Stream](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html) im *Benutzerhandbuch zu Amazon-IVS-Streaming mit niedriger Latenz*.
+ Einzelheiten zur API finden Sie [UpdateStage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ivs-realtime/update-stage.html)in der *AWS CLI Befehlsreferenz*.