Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Filtraggio delle risorse AWS DataSync
<a name="query-resources"></a>

Puoi filtrare le tue AWS DataSync sedi e le tue attività utilizzando le operazioni `ListLocations` e `ListTasks` API in AWS CLI. Ad esempio, recupera un elenco delle tue attività più recenti.

## Parametri per il filtraggio
<a name="API-filter-parameters"></a>

Puoi utilizzare i filtri API per restringere l'elenco delle risorse restituite da `ListTasks` and`ListLocations`. Ad esempio, per recuperare tutte le tue sedi Amazon S3, puoi `ListLocations` utilizzare il nome del filtro `LocationType` *`S3`*e. `Operator` *`Equals`*

Per filtrare i risultati dell'API, devi specificare un nome, un operatore e un valore del filtro.
+ `Name`— Il nome del filtro che viene utilizzato. Ogni chiamata API supporta un elenco di filtri disponibili (ad esempio, `LocationType` per`ListLocations`).
+ `Values`— I valori in base ai quali si desidera filtrare. Ad esempio, potresti voler visualizzare solo le sedi Amazon S3.
+ `Operator`— L'operatore utilizzato per confrontare i valori dei filtri (ad esempio, `Equals` o`Contains`). 

La tabella seguente elenca gli operatori disponibili.


| Operatore | Tipi di chiave | 
| --- | --- | 
| Equals | Stringa, numero | 
| NotEquals | Stringa, numero | 
| LessThan | Numero | 
| LessThanOrEqual | Numero | 
| GreaterThan | Numero | 
| GreaterThanOrEqual | Numero | 
| In | Stringa | 
| Contains | Stringa | 
| NotContains | Stringa | 
| BeginsWith | Stringa | 

## Filtraggio per località
<a name="ListLocations"></a>

`ListLocations`supporta i seguenti nomi di filtro:
+ `LocationType`— Filtri in base al tipo di posizione:
  + `SMB`
  + `NFS`
  + `HDFS`
  + `OBJECT_STORAGE`
  + `S3`
  + `OUTPOST_S3`
  + `FSX_WINDOWS`
  + `FSX_LUSTRE`
  + `FSX_OPENZFS_NFS`
  + `FSX_ONTAP_NFS`
  + `FSX_ONTAP_SMB`
+ `LocationUri`— Filtri sull'URI (Uniform Resource Identifier) assegnato alla posizione, come restituito dalla chiamata `DescribeLocation*` API (ad esempio, `s3://bucket-name/your-prefix` per le sedi Amazon S3).
+ `CreationTime`— Filtri in base all'ora in cui la posizione è stata creata. Il formato di input è `yyyy-MM-dd:mm:ss` in UTC (Coordinated Universal Time).

L' AWS CLI esempio seguente elenca tutte le posizioni di tipo Amazon S3 che hanno un URI di posizione che inizia con la stringa `"s3://amzn-s3-demo-bucket"` e che sono state create alle 17:15:20 UTC del 15/12/2019 o successivamente. 

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

Questo comando restituisce un output simile al seguente.

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

## Filtraggio per attività
<a name="ListTasks"></a>

`ListTasks`supporta i seguenti nomi di filtro.
+ `LocationId`— Filtri sulle posizioni di origine e di destinazione sui valori di Amazon Resource Name (ARN).
+ `CreationTime`— Filtri in base all'ora in cui l'attività è stata creata. Il formato di input è `yyyy-MM-dd:mm:ss` in UTC.

L' AWS CLI esempio seguente mostra la sintassi utilizzata per il filtraggio. `LocationId`

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

L'output di questo comando è simile al seguente.

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