Filtraggio delle risorse AWS DataSync - AWS DataSync
Parametri per il filtraggioFiltraggio per localitàFiltraggio per attività

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

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

Puoi utilizzare i filtri API per restringere l'elenco delle risorse restituite da ListTasks andListLocations. Ad esempio, per recuperare tutte le tue sedi Amazon S3, puoi ListLocations utilizzare il nome del filtro LocationType S3e. 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 perListLocations).

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

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à

ListLocationssupporta 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à

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