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.
ListLocations
Devuelve una lista de ubicaciones de origen y destino.
Si tiene más ubicaciones de las que se devuelven en una respuesta (es decir, la respuesta solo devuelve una lista truncada de sus agentes), la respuesta contiene un token que puede especificar en su próxima solicitud para acceder a la siguiente página de ubicaciones.
Sintaxis de la solicitud
{
"Filters": [
{
"Name": "string
",
"Operator": "string
",
"Values": [ "string
" ]
}
],
"MaxResults": number
,
"NextToken": "string
"
}
Parámetros de solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- Filters
-
Puede utilizar los filtros de la API para acotar la lista de los recursos que se muestran
ListLocations
. Por ejemplo, para recuperar todas las tareas en una ubicación de origen específica, puede utilizarlasListLocations
con el nombre del filtroLocationType S3
yOperator Equals
.Tipo: Matriz de objetos LocationFilter
Obligatorio: no
- MaxResults
-
El número máximo de ubicaciones para devolver.
Tipo: entero
Rango válido: valor mínimo de 0. Valor máximo de 100.
Obligatorio: no
- NextToken
-
Cadena opaca que indica la posición en la que debe comenzar la siguiente lista de ubicaciones.
Tipo: String
Limitaciones de longitud: longitud máxima de 65535 caracteres.
Patrón:
[a-zA-Z0-9=_-]+
Obligatorio: no
Sintaxis de la respuesta
{
"Locations": [
{
"LocationArn": "string",
"LocationUri": "string"
}
],
"NextToken": "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.
- Locations
-
Matriz que contiene una lista de ubicaciones.
Tipo: Matriz de objetos LocationListEntry
- NextToken
-
Cadena opaca que indica la posición en la que se debe empezar a devolver la siguiente lista de ubicaciones.
Tipo: String
Limitaciones de longitud: longitud máxima de 65535 caracteres.
Patrón:
[a-zA-Z0-9=_-]+
Errores
Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.
- InternalException
-
Esta excepción se produce cuando se produce un error en elAWS DataSync servicio.
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con formato incorrecto.
Código de estado HTTP: 400
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: