Recursos de filtragem AWS DataSync - AWS DataSync
Parâmetros para filtragemFiltrando por localFiltrando 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á.

Recursos de filtragem AWS DataSync

Você pode filtrar seus AWS DataSync locais e tarefas usando as operações ListLocations e ListTasks da API no AWS 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 por ListTasks e ListLocations. Por exemplo, para recuperar todos os seus locais do Amazon S3, você pode usar o ListLocations com o nome do filtro LocationType S3 e Operator Equals.

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

  • Name: nome do filtro que está sendo usado. Cada chamada de API é compatível com uma lista de filtros que estão disponíveis para ela (por exemplo, LocationType para ListLocations).

  • Values: os valores que você deseja filtrar. Por exemplo, talvez você queira exibir somente locais do Amazon S3.

  • Operator: operador usado para comparar valores de filtro (por exemplo, Equals ou Contains).

A tabela a seguir lista os operadores disponíveis.

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

Filtrando por local

ListLocations fornece suporte aos seguintes nomes de filtro:

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

  • CreationTime: filtra no horário em que a localização foi criada. O formato de entrada é yyyy-MM-dd:mm:ss, em Universal Coordinated Time (UTC – Tempo universal coordenado).

O AWS 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://amzn-s3-demo-bucket" e que foram criados em ou após 15/12/2019 às 17:15:20 UTC. 

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

Esse comando retorna uma saída semelhante à seguinte:

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

Filtrando por tarefa

ListTasks oferece suporte aos seguintes nomes de filtro.

  • LocationId: filtra nos locais de origem e destino nos valores do nome do recurso da Amazon (ARN).

  • CreationTime: filtra no horário em que a tarefa foi criada. O formato de entrada é yyyy-MM-dd:mm:ss em UTC.

O AWS CLI exemplo a seguir mostra a sintaxe durante a filtragem. LocationId

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 deste comando é parecida com o exemplo a seguir.

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