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
Obtiene un punto de enlace para una transmisión específica para su lectura o la 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 oStreamARN.
Sintaxis de la solicitud
POST /getDataEndpoint HTTP/1.1
Content-type: application/json
{
"APIName": "string",
"StreamARN": "string",
"StreamName": "string"
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- APIName
-
El nombre de la acción de la API para la que se obtiene un punto final.
Tipo: String
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_IMAGESObligatorio: sí
- StreamARN
-
El nombre de recurso de Amazon (ARN) de la transmisión para la que desea obtener el punto de enlace. Debe especificar este parámetro o un
StreamNameen la solicitud.Tipo: String
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
-
El nombre de la transmisión para la que desea obtener el punto de enlace. Debe especificar este parámetro o un
StreamARNen la solicitud.Tipo: String
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
HTTP/1.1 200
Content-type: application/json
{
"DataEndpoint": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- DataEndpoint
-
El valor del punto final. Para leer datos de la transmisión o escribir datos en ella, especifique este punto final en la aplicación.
Tipo: String
Errores
Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.
- ClientLimitExceededException
-
Kinesis Video Streams ha limitado la solicitud porque ha superado el límite de llamadas de cliente permitidas. Intenta hacer 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 para realizar esta operación.
Código
- ResourceNotFoundException
-
Amazon Kinesis Video Streams no encuentra la transmisión que especificó.
Código de estado HTTP: 404
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
