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 uno stream specificato per la lettura o la scrittura. Utilizzate questo endpoint nell'applicazione per leggere dal flusso specificato (usando le GetMediaForFragmentList operazioni GetMedia o) o scrivervi (usando l'PutMediaoperazione).
Nota
All'endpoint restituito non è stato aggiunto il nome dell'API. Il client deve aggiungere il nome dell'API all'endpoint restituito.
Nella richiesta, specifica lo stream con StreamName oStreamARN.
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
-
Il nome dell'azione API per la quale ottenere un endpoint.
▬Tipo: 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_IMAGESCampo obbligatorio: sì
- StreamARN
-
L'Amazon Resource Name (ARN) dello stream per cui desideri ottenere l'endpoint. Devi specificare questo parametro o un
StreamNamenella richiesta.▬Tipo: stringa
Limitazioni 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
-
Il nome dello stream per il quale vuoi ottenere l'endpoint. È necessario specificare questo parametro o un
StreamARNnella richiesta.▬Tipo: stringa
Limitazioni 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
-
Il valore dell'endpoint. Per leggere o scrivere dati dallo stream, specifica questo endpoint nell'applicazione.
▬Tipo: stringa
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- ClientLimitExceededException
-
Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Il valore di questo parametro di input non è valido.
Codice di stato HTTP: 400
- NotAuthorizedException
-
Il chiamante 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 AWS SDK specifici della lingua, consulta quanto segue:
