

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# AWS DataSync Ressourcen filtern
<a name="query-resources"></a>

Sie können Ihre AWS DataSync Standorte und Aufgaben filtern, indem Sie die `ListTasks` API-Operationen `ListLocations` und in der verwenden AWS CLI. Rufen Sie beispielsweise eine Liste Ihrer letzten Aufgaben ab.

## Parameter für die Filterung
<a name="API-filter-parameters"></a>

Sie können API-Filter verwenden, um die Liste der von `ListTasks` und zurückgegebenen Ressourcen einzugrenzen`ListLocations`. Um beispielsweise alle Ihre Amazon S3 S3-Standorte abzurufen, können Sie `ListLocations` mit dem Filternamen `LocationType` *`S3`*und verwenden `Operator` *`Equals`*.

Um API-Ergebnisse zu filtern, müssen Sie einen Filternamen, einen Operator und einen Wert angeben.
+ `Name`— Der Name des Filters, der verwendet wird. Jeder API-Aufruf unterstützt eine Liste von Filtern, die für ihn verfügbar sind (z. B. `LocationType` für`ListLocations`).
+ `Values`— Die Werte, nach denen Sie filtern möchten. Beispielsweise möchten Sie möglicherweise nur Amazon S3 S3-Standorte anzeigen.
+ `Operator`— Der Operator, der zum Vergleichen von Filterwerten verwendet wird (z. B. `Equals` oder`Contains`). 

In der folgenden Tabelle sind die verfügbaren Operatoren aufgeführt.


| Operator | Schlüsseltypen | 
| --- | --- | 
| Equals | Zeichenfolge, Zahl | 
| NotEquals | Zeichenfolge, Zahl | 
| LessThan | Zahl | 
| LessThanOrEqual | Zahl | 
| GreaterThan | Zahl | 
| GreaterThanOrEqual | Zahl | 
| In | Zeichenfolge | 
| Contains | Zeichenfolge | 
| NotContains | Zeichenfolge | 
| BeginsWith | Zeichenfolge | 

## Nach Standort filtern
<a name="ListLocations"></a>

`ListLocations`unterstützt die folgenden Filternamen:
+ `LocationType`— Filtert nach dem Standorttyp:
  + `SMB`
  + `NFS`
  + `HDFS`
  + `OBJECT_STORAGE`
  + `S3`
  + `OUTPOST_S3`
  + `FSX_WINDOWS`
  + `FSX_LUSTRE`
  + `FSX_OPENZFS_NFS`
  + `FSX_ONTAP_NFS`
  + `FSX_ONTAP_SMB`
+ `LocationUri`— Filtert nach dem Uniform Resource Identifier (URI), der dem Standort zugewiesen wurde, wie er vom `DescribeLocation*` API-Aufruf zurückgegeben wurde (z. B. `s3://bucket-name/your-prefix` für Amazon S3 S3-Standorte).
+ `CreationTime`— Filtert nach dem Zeitpunkt, zu dem der Standort erstellt wurde. Das Eingabeformat ist `yyyy-MM-dd:mm:ss` in koordinierter Weltzeit (UTC) angegeben.

Das folgende AWS CLI Beispiel listet alle Standorte des Typs Amazon S3 auf, deren Standort-URI mit der Zeichenfolge beginnt `"s3://amzn-s3-demo-bucket"` und die am 15.12.2019 um 17:15:20 UTC oder danach erstellt wurden. 

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

Dieser Befehl gibt etwa die folgende Ausgabe zurück.

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

## Nach Aufgabe filtern
<a name="ListTasks"></a>

`ListTasks`unterstützt die folgenden Filternamen.
+ `LocationId`— Filtert sowohl nach Quell- als auch nach Zielorten nach Werten für Amazon Resource Name (ARN).
+ `CreationTime`— Filtert nach dem Zeitpunkt, zu dem die Aufgabe erstellt wurde. Das Eingabeformat ist `yyyy-MM-dd:mm:ss` in UTC.

Das folgende AWS CLI Beispiel zeigt die Syntax beim Filtern nach`LocationId`.

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

Die Ausgabe dieses Befehls sieht in etwa wie folgt aus.

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