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

Devuelve una lista de ubicaciones de origen y destino.

Si tiene más ubicaciones de las que se muestran en una respuesta (es decir, la respuesta devuelve solo una lista truncada de sus agentes), la respuesta incluye un token que puede especificar en su próxima solicitud para buscar la siguiente página de ubicaciones.

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

```
{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListLocations_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Filters](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-Filters"></a>
Puede utilizar filtros de API para acotar la lista de recursos devueltos por `ListLocations`. Por ejemplo, para recuperar todas las tareas en una ubicación de origen específica, puede utilizar `ListLocations` con el nombre del filtro `LocationType S3` y `Operator Equals`.  
Tipo: matriz de objetos [LocationFilter](API_LocationFilter.md)  
Obligatorio: no

 ** [MaxResults](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-MaxResults"></a>
Número máximo de ubicaciones que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-NextToken"></a>
Es una cadena opaca que indica la posición en la que debe comenzar la siguiente lista de ubicaciones.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+`   
Obligatorio: no

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

```
{
   "Locations": [ 
      { 
         "LocationArn": "string",
         "LocationUri": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListLocations_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.

 ** [Locations](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-Locations"></a>
Es una matriz que incluye una lista de ubicaciones.  
Tipo: matriz de objetos [LocationListEntry](API_LocationListEntry.md)

 ** [NextToken](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-NextToken"></a>
Es una cadena opaca que indica la posición en la que debe comenzar a arrojar la siguiente lista de ubicaciones.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 65 535 caracteres.  
Patrón: `[a-zA-Z0-9=_-]+` 

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

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

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

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