GetDataEndpoint - 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.

GetDataEndpoint

Ruft einen Endpunkt für einen angegebenen Stream zum Lesen oder Schreiben ab. Verwenden Sie diesen Endpunkt in Ihrer Anwendung, um aus dem angegebenen Stream zu lesen (mithilfe der GetMediaForFragmentList Operationen GetMedia oder) oder in ihn zu schreiben (mithilfe der PutMedia Operation).

Anmerkung

An den zurückgegebenen Endpunkt ist der API-Name nicht angehängt. Der Client muss den API-Namen zum zurückgegebenen Endpunkt hinzufügen.

Geben Sie in der Anfrage den Stream entweder mit StreamName oder anStreamARN.

Anforderungssyntax

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

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

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

APIName

Der Name der API-Aktion, für die ein Endpunkt abgerufen werden soll.

Typ: Zeichenfolge

Zulässige Werte: PUT_MEDIA | GET_MEDIA | LIST_FRAGMENTS | GET_MEDIA_FOR_FRAGMENT_LIST | GET_HLS_STREAMING_SESSION_URL | GET_DASH_STREAMING_SESSION_URL | GET_CLIP | GET_IMAGES

Erforderlich: Ja

StreamARN

Der Amazon-Ressourcenname (ARN) des Streams, für den Sie den Endpunkt abrufen möchten. Sie müssen entweder diesen Parameter oder a StreamName in der Anfrage 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, für den Sie den Endpunkt abrufen möchten. Sie müssen entweder diesen Parameter oder a StreamARN in der Anfrage angeben.

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
Content-type: application/json

{
   "DataEndpoint": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

DataEndpoint

Der Endpunktwert. Um Daten aus dem Stream zu lesen oder Daten in den Stream zu schreiben, geben Sie diesen Endpunkt in Ihrer Anwendung an.

Typ: Zeichenfolge

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

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

Weitere Informationen finden Sie unter:

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