AWS DataSync Ressourcen filtern

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

Sie können API-Filter verwenden, um die Liste der von ListTasks und zurückgegebenen Ressourcen einzugrenzenListLocations. Um beispielsweise alle Ihre Amazon S3 S3-Standorte abzurufen, können Sie ListLocations mit dem Filternamen LocationType S3und 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ürListLocations).

• 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 oderContains).

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

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

Nach Standort filtern

ListLocationsunterstü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

ListTasksunterstü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 nachLocationId.

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