AWS DataSyncRecursos de filtragem - AWS DataSync
Parâmetros para filtragemFiltrar por localizaçãoFiltrar por tarefa

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á.

AWS DataSyncRecursos de filtragem

Você pode filtrar seusAWS DataSync locais e tarefas usando as operações deListTasks APIListLocations e noAWS CLI. Por exemplo, recupere uma lista de suas tarefas mais recentes.

Parâmetros para filtragem

Você pode usar filtros de API para refinar a lista de recursos retornados porListTasksListLocations e. Por exemplo, para recuperar todas as suas localizações do Amazon S3, você pode usarListLocations com o nome do filtroLocationType S3OperatorEqualse.

Para filtrar os resultados da API, você deve especificar um nome, operador e valor do filtro.

  • Name— O nome do filtro que está sendo usado. Cada chamada de API oferece suporte a uma lista de filtros que estão disponíveis para ela (por exemplo,LocationType paraListLocations).

  • Values— Os valores que você deseja filtrar. Por exemplo, digamos que você faça uma exibição apenas de locais do Amazon S3.

  • Operator— O operador usado para comparar valores de filtro (por exemplo,Equals ouContains).

A tabela a seguir lista os operadores disponíveis.

Operador Tipos de chave
Equals Sequência de caracteres, número
NotEquals Sequência de caracteres, número
LessThan Número
LessThanOrEqual Número
GreaterThan Número
GreaterThanOrEqual Número
In String
Contains String
NotContains String
BeginsWith String

Filtrar por localização

ListLocationssuporta os seguintes nomes de filtro:

  • LocationType— Filtros 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— Filtros no identificador uniforme de recurso (URI) atribuído ao local, conforme retornado pela chamada deDescribeLocation* API (por exemplo,s3://bucket-name/your-prefix para locais do Amazon S3).

  • CreationTime— Filtros na hora em que o local foi criado. O formato de entrada estáyyyy-MM-dd:mm:ss em Tempo Universal Coordenado (UTC).

OAWS 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://DOC-EXAMPLE-BUCKET" e que foram criados em ou após 2019-12-15 17:15:20 UTC. 

aws datasync list-locations \
    --filters [{Name=LocationType, Values=["S3"], Operator=Equals}, {Name=LocationUri, Values=["s3://DOC-EXAMPLE-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://DOC-EXAMPLE-BUCKET-examples/"
        },
        {
            "LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-987654321abcdef0",
            "LocationUri": "s3://DOC-EXAMPLE-BUCKET-examples-2/"
        }
    ]
}

Filtrar por tarefa

ListTaskssuporta os seguintes nomes de filtro.

  • LocationId— Filtros nos locais de origem e de destino nos valores do Amazon Resource Name (ARN).

  • CreationTime— Filtrar a hora em que a tarefa foi criada. O formato de entrada estáyyyy-MM-dd:mm:ss em UTC.

OAWS CLI exemplo a seguir mostra a sintaxe ao filtrarLocationId.

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 desse comando será parecida com o exemplo a seguir.

{
    "Tasks": [
        {
            "TaskArn": "arn:aws:datasync:us-east-1:your-account-id:task/your-task-id",
            "Status": "AVAILABLE",
            "Name": "DOC-EXAMPLE-BUCKET"
        }
    ]
}