Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# GetDataEndpoint
<a name="API_GetDataEndpoint"></a>

Obtiene un punto final para un flujo específico para lectura o escritura. Utilice este punto final de la aplicación para leer el flujo especificado (mediante las `GetMediaForFragmentList` operaciones `GetMedia` o) o escribir en él (mediante la `PutMedia` operación). 

**nota**  
El punto final devuelto no tiene el nombre de la API adjunto. El cliente debe añadir el nombre de la API al punto final devuelto.

En la solicitud, especifique la transmisión mediante `StreamName` o`StreamARN`.

## Sintaxis de la solicitud
<a name="API_GetDataEndpoint_RequestSyntax"></a>

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

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

## Parámetros de solicitud del URI
<a name="API_GetDataEndpoint_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_GetDataEndpoint_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [APIName](#API_GetDataEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetDataEndpoint-request-APIName"></a>
El nombre de la acción de API para la que se va a obtener un punto final.  
Tipo: cadena  
Valores válidos: `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`   
Obligatorio: sí

 ** [StreamARN](#API_GetDataEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetDataEndpoint-request-StreamARN"></a>
El nombre del recurso de Amazon (ARN) de la transmisión para la que desea obtener el punto final. Debe especificar este parámetro o un `StreamName` en la solicitud.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Obligatorio: no

 ** [StreamName](#API_GetDataEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetDataEndpoint-request-StreamName"></a>
El nombre de la transmisión para la que desea obtener el punto final. Debe especificar este parámetro o un `StreamARN` en la solicitud.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z0-9_.-]+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_GetDataEndpoint_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_GetDataEndpoint_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [DataEndpoint](#API_GetDataEndpoint_ResponseSyntax) **   <a name="KinesisVideo-GetDataEndpoint-response-DataEndpoint"></a>
El valor del punto final. Para leer los datos de la transmisión o escribirlos en ella, especifique este punto final en la aplicación.  
Tipo: cadena

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ClientLimitExceededException **   
Kinesis Video Streams ha limitado la solicitud porque ha superado el límite de llamadas de clientes permitidas. Intente realizar la llamada más tarde.  
Código de estado HTTP: 400

 ** InvalidArgumentException **   
El valor de este parámetro de entrada no es válido.  
Código de estado HTTP: 400

 ** NotAuthorizedException **   
La persona que llama no está autorizada a realizar esta operación.  
Código de estado HTTP: 401

 ** ResourceNotFoundException **   
Amazon Kinesis Video Streams no encuentra la transmisión que ha especificado.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetDataEndpoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/GetDataEndpoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/GetDataEndpoint)