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
<a name="API_GetDataEndpoint"></a>

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'`PutMedia`operazione). 

**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` o`StreamARN`.

## Sintassi della richiesta
<a name="API_GetDataEndpoint_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_GetDataEndpoint_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_GetDataEndpoint_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [APIName](#API_GetDataEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetDataEndpoint-request-APIName"></a>
Il nome dell'azione API per la quale ottenere un endpoint.  
Tipo: String  
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`   
Obbligatorio: sì

 ** [StreamARN](#API_GetDataEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetDataEndpoint-request-StreamARN"></a>
L'Amazon Resource Name (ARN) dello stream per cui desideri ottenere l'endpoint. Devi specificare questo parametro o un `StreamName` nella richiesta.   
Tipo: String  
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]+`   
Obbligatorio: no

 ** [StreamName](#API_GetDataEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetDataEndpoint-request-StreamName"></a>
Il nome dello stream per il quale vuoi ottenere l'endpoint. È necessario specificare questo parametro o un `StreamARN` nella richiesta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: no

## Sintassi della risposta
<a name="API_GetDataEndpoint_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DataEndpoint": "string"
}
```

## Elementi di risposta
<a name="API_GetDataEndpoint_ResponseElements"></a>

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

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

 ** [DataEndpoint](#API_GetDataEndpoint_ResponseSyntax) **   <a name="KinesisVideo-GetDataEndpoint-response-DataEndpoint"></a>
Il valore dell'endpoint. Per leggere o scrivere dati dallo stream, specifica questo endpoint nell'applicazione.  
Tipo: String

## Errori
<a name="API_GetDataEndpoint_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** 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
<a name="API_GetDataEndpoint_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/GetDataEndpoint)