GetDataEndpoint - Amazon Kinesis Video Streams

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

GetDataEndpoint

Ottiene un endpoint per un determinato flusso per la lettura o la scrittura. Utilizzare questo endpoint nell'applicazione per leggere dallo stream specificato (utilizzando ilGetMediaoGetMediaForFragmentListoperazioni) o scrivici (usando ilPutMediaoperazione).

Nota

L'endpoint restituito non ha aggiunto il nome API. Il client deve aggiungere il nome API all'endpoint restituito.

Nella richiesta, specifica il flusso perStreamNameoStreamARN.

Sintassi della richiesta

POST /getDataEndpoint HTTP/1.1 Content-type: application/json { "APIName": "string", "StreamARN": "string", "StreamName": "string" }

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

APIName

Nome dell'operazione API per la quale ottenere un endpoint.

Type: Stringa

Valori validi: 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

campo obbligatorio: Sì

StreamARN

L'Amazon Resource Name (ARN) dello stream per il quale intendi ottenere l'endpoint. È necessario specificare questo parametro oStreamNamenella richiesta.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.

Modello: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

campo obbligatorio: No

StreamName

Nome dello stream per il quale intendi ottenere l'endpoint. È necessario specificare questo parametro oStreamARNnella richiesta.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z0-9_.-]+

campo obbligatorio: No

Sintassi della risposta

HTTP/1.1 200 Content-type: application/json { "DataEndpoint": "string" }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

DataEndpoint

Valore di endpoint. Per leggere i dati dal flusso o per scrivervi dati, specificate questo endpoint nell'applicazione.

Type: Stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché hai superato il limite delle chiamate client consentite. Prova a effettuare la chiamata più tardi.

Codice di stato HTTP: 400

InvalidArgumentException

Il valore per questo parametro di input non è valido.

Codice di stato HTTP: 400

NotAuthorizedException

L'intermediario non è autorizzato a eseguire questa operazione.

Codice di stato HTTP: 401

ResourceNotFoundException

Amazon Kinesis Video Streams non riesce a trovare lo stream specificato.

Codice di stato HTTP: 404

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: