As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Você pode filtrar seus AWS DataSync locais e tarefas usando as operações `ListLocations` e `ListTasks` da API no AWS CLI. Por exemplo, recupere uma lista de suas tarefas mais recentes.

## Parâmetros para filtragem
<a name="API-filter-parameters"></a>

Você pode usar filtros de API para refinar a lista de recursos retornados por `ListTasks` e `ListLocations`. Por exemplo, para recuperar todos os seus locais do Amazon S3, você pode usar o `ListLocations` com o nome do filtro `LocationType` *`S3`* e `Operator` *`Equals`*.

Para filtrar os resultados da API, você deve especificar o nome, o operador e o valor do filtro.
+ `Name`: nome do filtro que está sendo usado. Cada chamada de API é compatível com uma lista de filtros que estão disponíveis para ela (por exemplo, `LocationType` para `ListLocations`).
+ `Values`: os valores que você deseja filtrar. Por exemplo, talvez você queira exibir somente locais do Amazon S3.
+ `Operator`: operador usado para comparar valores de filtro (por exemplo, `Equals` ou `Contains`). 

A tabela a seguir lista os operadores disponíveis.


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

## Filtrando por local
<a name="ListLocations"></a>

`ListLocations` fornece suporte aos seguintes nomes de filtro:
+ `LocationType`: filtra no tipo de localização:
  + `SMB`
  + `NFS`
  + `HDFS`
  + `OBJECT_STORAGE`
  + `S3`
  + `OUTPOST_S3`
  + `FSX_WINDOWS`
  + `FSX_LUSTRE`
  + `FSX_OPENZFS_NFS`
  + `FSX_ONTAP_NFS`
  + `FSX_ONTAP_SMB`
+ `LocationUri`: filtra o identificador uniforme de recursos (URI) atribuído ao local, conforme retornado pela chamada da API `DescribeLocation*` (por exemplo, `s3://bucket-name/your-prefix` para locais do Amazon S3).
+ `CreationTime`: filtra no horário em que a localização foi criada. O formato de entrada é `yyyy-MM-dd:mm:ss`, em Universal Coordinated Time (UTC – Tempo universal coordenado).

O AWS CLI exemplo a seguir lista todos os locais do tipo Amazon S3 que têm um URI de localização começando com a string `"s3://amzn-s3-demo-bucket"` e que foram criados em ou após 15/12/2019 às 17:15:20 UTC. 

```
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}]
```

Esse comando retorna uma saída semelhante à seguinte:

```
{
    "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/"
        }
    ]
}
```

## Filtrando por tarefa
<a name="ListTasks"></a>

`ListTasks` oferece suporte aos seguintes nomes de filtro.
+ `LocationId`: filtra nos locais de origem e destino nos valores do nome do recurso da Amazon (ARN).
+ `CreationTime`: filtra no horário em que a tarefa foi criada. O formato de entrada é `yyyy-MM-dd:mm:ss` em UTC.

O AWS CLI exemplo a seguir mostra a sintaxe ao 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
```

A saída deste comando é parecida com o exemplo a seguir.

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