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.

# AWS DataSync Recursos de filtrado
<a name="query-resources"></a>

Puede filtrar sus AWS DataSync ubicaciones y tareas mediante las `ListLocations` operaciones de `ListTasks` API del AWS CLI. Por ejemplo, recupere una lista de sus tareas más recientes.

## Parámetros de filtrado
<a name="API-filter-parameters"></a>

Puede utilizar filtros de API para acotar la lista de recursos devueltos por `ListTasks` y `ListLocations`. Por ejemplo, para recuperar todas las ubicaciones de Amazon S3, puede utilizars `ListLocations` con el nombre del filtro `LocationType` *`S3`*y `Operator` *`Equals`*.

Para filtrar los resultados de la API, debe especificar un nombre, un operador y un valor de filtro.
+ `Name`: el nombre del filtro que se está utilizando. Cada llamada a la API admite una lista de filtros que están disponibles para ella (por ejemplo, `LocationType` para `ListLocations`).
+ `Values`: los valores por los que quiere filtrar. Por ejemplo, es posible que desee mostrar solo las ubicaciones de Amazon S3.
+ `Operator`: el operador que se utiliza para comparar los valores de los filtros (por ejemplo, `Equals` o `Contains`). 

En la siguiente tabla se muestran los operadores disponibles.


| Operador | Tipos de clave | 
| --- | --- | 
| Equals | Cadena, número | 
| NotEquals | Cadena, número | 
| LessThan | Número | 
| LessThanOrEqual | Número | 
| GreaterThan | Número | 
| GreaterThanOrEqual | Número | 
| In | Cadena | 
| Contains | Cadena | 
| NotContains | Cadena | 
| BeginsWith | Cadena | 

## Filtrado por ubicación
<a name="ListLocations"></a>

`ListLocations` admite los siguientes nombres de filtro:
+ `LocationType`: filtra según el tipo de ubicación:
  + `SMB`
  + `NFS`
  + `HDFS`
  + `OBJECT_STORAGE`
  + `S3`
  + `OUTPOST_S3`
  + `FSX_WINDOWS`
  + `FSX_LUSTRE`
  + `FSX_OPENZFS_NFS`
  + `FSX_ONTAP_NFS`
  + `FSX_ONTAP_SMB`
+ `LocationUri`: filtra el identificador uniforme de recursos (URI) asignado a la ubicación, tal como lo devuelve la llamada a la API `DescribeLocation*` (por ejemplo, `s3://bucket-name/your-prefix` para las ubicaciones de Amazon S3).
+ `CreationTime`: filtra según el momento en que se creó la ubicación. El formato de entrada es `yyyy-MM-dd:mm:ss`, en Hora Universal Coordinada (UTC).

En el siguiente AWS CLI ejemplo, se enumeran todas las ubicaciones de tipo Amazon S3 que tienen un URI de ubicación que comienza con la cadena `"s3://amzn-s3-demo-bucket"` y que se crearon el 15 de diciembre de 2019 a las 17:15:20 UTC o después. 

```
aws datasync list-locations \
    --filters [{Name=LocationType, Values=["S3"], Operator=Equals}, {Name=LocationUri, Values=["s3://amzn-s3-demo-bucket"], Operator=BeginsWith}, {Name=CreationTime,Values=["2019-12-15 17:15:20"],Operator=GreaterThanOrEqual}]
```

Este comando devuelve un resultado similar al siguiente.

```
{
    "Locations": [
        {
            "LocationArn": "arn:aws:datasync:us-east-1:111122223333:location/loc-333333333abcdef0",
            "LocationUri": "s3://amzn-s3-demo-bucket1/"
        },
        {
            "LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-987654321abcdef0",
            "LocationUri": "s3://amzn-s3-demo-bucket2/"
        }
    ]
}
```

## Filtrado por etiquetas
<a name="ListTasks"></a>

`ListTasks` admite los siguientes nombres de filtro.
+ `LocationId`: filtra las ubicaciones de origen y destino en los valores del nombre de recurso de Amazon (ARN).
+ `CreationTime`: filtra según el momento en que se creó la ubicación. El formato de entrada es `yyyy-MM-dd:mm:ss` en UTC.

En el siguiente AWS CLI ejemplo, se muestra la sintaxis al filtrar. `LocationId`

```
aws datasync list-tasks \
    --filters Name=LocationId,Values=arn:aws:datasync:us-east-1:your-account-id:location/your-location-id,Operator=Contains
```

El resultado de este comando debería ser similar a lo siguiente.

```
{
    "Tasks": [
        {
            "TaskArn": "arn:aws:datasync:us-east-1:your-account-id:task/your-task-id",
            "Status": "AVAILABLE",
            "Name": "amzn-s3-demo-bucket"
        }
    ]
}
```