TagStream - Amazon Kinesis Video Streams
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

TagStream

Fügt einem Stream ein oder mehrere Tags hinzu. Ein Tag ist ein Schlüssel-Wert-Paar (der Wert ist optional), das Sie definieren und Ressourcen zuweisen AWS können. Wenn Sie ein Tag spezifizieren, das bereits existiert, wird der Tag-Wert durch den Wert ersetzt, den Sie in der Anfrage angeben. Weitere Informationen finden Sie unter Verwenden von Kostenzuordnungs-Tags im AWS Billing and Cost Management and Cost Management-Benutzerhandbuch.

Sie müssen entweder den StreamName oder den angebenStreamARN.

Diese Operation setzt eine Berechtigung für die KinesisVideo:TagStream-Aktion voraus.

Ein Kinesis-Videostream kann bis zu 50 Tags unterstützen.

Anforderungssyntax

POST /tagStream HTTP/1.1
Content-type: application/json

{
   "StreamARN": "string",
   "StreamName": "string",
   "Tags": { 
      "string" : "string" 
   }
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

StreamARN

Der Amazon-Ressourcenname (ARN) der Ressource, zu der Sie das Tag oder die Tags hinzufügen möchten.

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, zu dem Sie das Tag oder die Tags hinzufügen möchten.

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

Tags

Eine Liste von Tags, die dem angegebenen Stream zugeordnet werden sollen. Jedes Tag ist ein Schlüssel-Wert-Paar (der Wert ist optional).

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Karteneinträge: Maximale Anzahl von 50 Elementen.

Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.

Schlüssel-Muster: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.

Wertemuster: [\p{L}\p{Z}\p{N}_.:/=+\-@]*

Erforderlich: Ja

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.

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

InvalidResourceFormatException

Das Format von StreamARN ist ungültig.

HTTP Status Code: 400

NotAuthorizedException

Der Anrufer ist nicht autorisiert, diesen Vorgang auszuführen.

HTTP-Statuscode: 401

ResourceNotFoundException

Amazon Kinesis Video Streams kann den von Ihnen angegebenen Stream nicht finden.

HTTP Status Code: 404

TagsPerResourceExceededLimitException

Sie haben das Limit an Tags überschritten, die Sie der Ressource zuordnen können. Ein Kinesis-Videostream kann bis zu 50 Tags unterstützen.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: