FiltrarAWS DataSync recursos

Puede filtrar susAWS DataSync ubicaciones y tareas mediante las operacionesListLocations yListTasks de la API delAWS CLI. Por ejemplo, recupera una lista de tus tareas más recientes.

Parámetros de filtrado

Puede utilizar filtros de API para acotar la lista de recursos devueltos porListTasks yListLocations. Por ejemplo, para recuperar todas sus ubicaciones de Amazon S3, puede utilizarlasListLocations con el nombre del filtroLocationType S3yOperator Equals.

Para filtrar los resultados de la API, debe especificar un nombre, un operador y un valor de filtro.

• Name— El nombre del filtro que se utiliza. Cada llamada a la API admite una lista de filtros disponibles para ella (por ejemplo,LocationType paraListLocations).

• Values— Los valores por los que desea filtrar. Por ejemplo, es posible que desee mostrar solo las ubicaciones de Amazon S3.

• Operator— El operador que se usa para comparar los valores de los filtros (por ejemplo,Equals oContains).

En la tabla siguiente, se describen los operadores disponibles.

"."	Tipos de claves
Equals	Cadena, número
NotEquals	Cadena, número
LessThan	Número
LessThanOrEqual	Número
GreaterThan	Número
GreaterThanOrEqual	Número
In	Cadena
Contains	Cadena
NotContains	Cadena
BeginsWith	Cadena

Filtrado por ubicación

ListLocationsadmite los siguientes nombres de filtros:

• LocationType— Filtros por tipo de ubicación:

  • SMB

  • NFS

  • HDFS

  • OBJECT_STORAGE

  • S3

  • OUTPOST_S3

  • FSX_WINDOWS

  • FSX_LUSTRE

  • FSX_OPENZFS_NFS

  • FSX_ONTAP_NFS

  • FSX_ONTAP_SMB

• LocationUri— Filtra el identificador uniforme de recursos (URI) asignado a la ubicación, tal como lo devuelve la llamada a laDescribeLocation* API (por ejemplo,s3://bucket-name/your-prefix para las ubicaciones de Amazon S3).

• CreationTime— Filtra la hora en que se creó la ubicación. El formato de entrada estáyyyy-MM-dd:mm:ss en la tiempo universal coordinado (UTC).

El siguienteAWS CLI ejemplo muestra todas las ubicaciones de tipo Amazon S3 que tienen un URI de ubicación que comienza por la cadena"s3://DOC-EXAMPLE-BUCKET" y que se crearon el 15 de diciembre de 2019 a las 17:15:20 UTC o después.

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

Este comando regresa un resultado similar al siguiente.

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

Filtrado por tarea

ListTasksadmite los siguientes nombres de filtros.

• LocationId— Filtra las ubicaciones de origen y destino en los valores de Amazon Resource Name (ARN).

• CreationTime— Filtra la hora en que se creó la tarea. El formato de entrada estáyyyy-MM-dd:mm:ss en UTC.

En el siguienteAWS CLI ejemplo, se muestra la sintaxis durante el filtradoLocationId.

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

El resultado de este comando tiene un aspecto similar al siguiente.

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