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.
UpdateImageGenerationConfiguration
Aktualisiert die ImageProcessingConfiguration
Felder StreamInfo
und.
Anforderungssyntax
POST /updateImageGenerationConfiguration HTTP/1.1
Content-type: application/json
{
"ImageGenerationConfiguration": {
"DestinationConfig": {
"DestinationRegion": "string
",
"Uri": "string
"
},
"Format": "string
",
"FormatConfig": {
"string
" : "string
"
},
"HeightPixels": number
,
"ImageSelectorType": "string
",
"SamplingInterval": number
,
"Status": "string
",
"WidthPixels": number
},
"StreamARN": "string
",
"StreamName": "string
"
}
URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- ImageGenerationConfiguration
-
Die Struktur, die die Informationen enthält, die für die Lieferung von KVS-Images erforderlich sind. Wenn die Struktur Null ist, wird die Konfiguration aus dem Stream gelöscht.
Typ: ImageGenerationConfiguration Objekt
Erforderlich: Nein
- StreamARN
-
Der Amazon-Ressourcenname (ARN) des Kinesis-Videostreams, von dem aus Sie die Konfiguration der Imagegenerierung aktualisieren möchten. Sie müssen entweder den
StreamName
oder denStreamARN
angeben.Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.
Pattern:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+
Erforderlich: Nein
- StreamName
-
Der Name des Streams, aus dem die Konfiguration der Image-Generierung aktualisiert werden soll. Sie müssen entweder den
StreamName
oder den angebenStreamARN
.Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.
Pattern:
[a-zA-Z0-9_.-]+
Erforderlich: Nein
Antwortsyntax
HTTP/1.1 200
Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- AccessDeniedException
-
Sie verfügen nicht über die erforderlichen Berechtigungen, um diesen Vorgang auszuführen.
HTTP-Statuscode: 401
- ClientLimitExceededException
-
Kinesis Video Streams hat die Anfrage gedrosselt, weil Sie das Limit der erlaubten Client-Aufrufe überschritten haben. Versuchen Sie später, den Anruf zu tätigen.
HTTP Status Code: 400
- InvalidArgumentException
-
Der Wert für diesen Eingabeparameter ist ungültig.
HTTP Status Code: 400
- NoDataRetentionException
-
Die Stream-Datenspeicherung in Stunden ist gleich Null.
HTTP Status Code: 400
- ResourceInUseException
-
Wenn der Eingang
StreamARN
oderChannelARN
Eingang bereits einer anderen Kinesis Video Stream-Ressource zugeordnetCLOUD_STORAGE_MODE
ist oder wenn sich der angegebene EingangStreamARN
oder Eingang nicht im Status AktivChannelARN
befindet, versuchen Sie es mit einer der folgenden Methoden:-
Die
DescribeMediaStorageConfiguration
API, um zu ermitteln, welchem Stream der angegebene Kanal zugeordnet ist. -
Die
DescribeMappedResourceConfiguration
API zur Bestimmung des Kanals, dem der angegebene Stream zugeordnet ist. -
Die
DescribeStream
oderDescribeSignalingChannel
API zur Bestimmung des Status der Ressource.
HTTP Status Code: 400
-
- ResourceNotFoundException
-
Amazon Kinesis Video Streams kann den von Ihnen angegebenen Stream nicht finden.
HTTP Status Code: 404
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: