Filtra objetos de origen por hora de modificación

Consola de Google Cloud

Para especificar un filtro de tiempo en la consola de Google Cloud, sigue estos pasos:

1. Ve a la página Crear trabajo de transferencia o Editar trabajo de transferencia.
2. En la sección Elige los datos que deseas transferir, selecciona Fechas y horas como el Tipo de filtro.
3. Ingresa una fecha y hora para el Intervalo de tiempo absoluto o una duración para el Intervalo de tiempo relativo. Se pueden especificar varios filtros juntos.

gcloud CLI

Para filtrar por hora de modificación con la gcloud CLI, pasa las marcas de filtro basadas en el tiempo al comando gcloud transfer jobs create o gcloud transfer jobs update:

gcloud transfer jobs create SOURCE DESTINATION \
  --include-modified-before-absolute="DATETIME" \
  --include-modified-after-absolute="DATETIME" \
  --include-modified-before-relative="DURATION" \
  --include-modified-after-relative="DURATION"

Aquí:

• --include-modified-before-absolute incluye los objetos que se modificaron por última vez antes de una fecha y hora absolutas. Por ejemplo, si especificas 2020-01-01, la transferencia incluye los objetos que se modificaron por última vez antes del 1 de enero de 2020. Usa el formato de fecha y hora %Y-%m-%dT%H:%M:%S%z.
• --include-modified-after-absolute incluye los objetos que se modificaron por última vez después de una fecha y hora absolutas. Por ejemplo, si especificas "2020-01-01", la transferencia incluirá los objetos que se modificaron por última vez después del 1 de enero de 2020. Usa el formato de fecha y hora %Y-%m-%dT%H:%M:%S%z.
• --include-modified-before-relative incluye objetos que se modificaron fuera de un período transcurrido especificado. Por ejemplo, especificar una duración de 10d transfiere objetos modificados por última vez más de 10 días antes de la hora de inicio de la transferencia. Usa el formato de duración absoluta. P. ej., 1m por 1 mes y 1h30m por 1 hora y 30 minutos.
• --include-modified-after-relative incluye los objetos modificados dentro de un período especificado. Por ejemplo, si especificas una duración de 10d, se transfieren los objetos que se modificaron por última vez menos de 10 días antes de la hora de inicio de la transferencia. Usa el formato de duración absoluta. P. ej., 1m por 1 mes y 1h30m por 1 hora y 30 minutos.

Ejemplo (modificado después):

El siguiente comando solo transfiere los objetos modificados a partir del 1 de octubre de 2025.

gcloud transfer jobs create gs://my-source-bucket gs://my-sink-bucket
  --include-modified-after-absolute="2025-10-01T00:00:00Z"

Ejemplo (período):

El siguiente comando solo transfiere los objetos modificados durante el mes de octubre de 2025.

gcloud transfer jobs create gs://my-source-bucket gs://my-sink-bucket
  --include-modified-after-absolute="2025-10-01T00:00:00Z"
  --include-modified-before-absolute="2025-11-01T00:00:00Z"

Ejemplo (tiempo transcurrido):

El siguiente comando solo transfiere los objetos modificados en los últimos 7 días.

gcloud transfer jobs create gs://my-source-bucket gs://my-sink-bucket
  --include-modified-after-relative="7d"

REST

Para filtrar por hora de modificación con la API de REST, especifica los campos de filtro basados en el tiempo en el objectConditions de tu transferSpec.

{
  "description": "DESCRIPTION",
  "status": "ENABLED",
  "projectId": "PROJECT_ID",
  "transferSpec": {
    "gcsDataSource": {
      "bucketName": "SOURCE_BUCKET"
    },
    "gcsDataSink": {
      "bucketName": "DESTINATION_BUCKET"
    },
    "objectConditions": {
      "lastModifiedBefore": "DATETIME",
      "lastModifiedSince": "DATETIME",
      "minTimeElapsedSinceLastModification": "DURATION",
      "maxTimeElapsedSinceLastModification": "DURATION",

    }
  }
}

Aquí:

• lastModifiedBefore incluye los objetos que se modificaron por última vez antes de una fecha y hora absolutas. Por ejemplo, si especificas 2020-01-01, la transferencia incluirá los objetos que se modificaron por última vez antes del 1 de enero de 2020. Usa el formato de fecha y hora %Y-%m-%dT%H:%M:%S%z.
• lastModifiedSince incluye los objetos que se modificaron por última vez después de una fecha y hora absolutas. Por ejemplo, si especificas "2020-01-01", la transferencia incluirá los objetos que se modificaron por última vez después del 1 de enero de 2020. Usa el formato de fecha y hora %Y-%m-%dT%H:%M:%S%z.
• minTimeElapsedSinceLastModification incluye objetos que se modificaron fuera de un período transcurrido especificado. Por ejemplo, especificar una duración de 10d transfiere objetos modificados por última vez más de 10 días antes de la hora de inicio de la transferencia. Usa el formato de duración absoluta. P. ej., 1m por 1 mes y 1h30m por 1 hora y 30 minutos.
• maxTimeElapsedSinceLastModification incluye los objetos modificados dentro de un período especificado. Por ejemplo, si especificas una duración de 10d, se transfieren los objetos que se modificaron por última vez menos de 10 días antes de la hora de inicio de la transferencia. Usa el formato de duración absoluta. P. ej., 1m por 1 mes y 1h30m por 1 hora y 30 minutos.

Ejemplo (período):

El siguiente cuerpo JSON configura un trabajo para transferir solo los objetos modificados durante octubre de 2025.

{
  "description": "Transfer October 2025 data",
  "status": "ENABLED",
  "projectId": "PROJECT_ID",
  "transferSpec": {
    "gcsDataSource": {
      "bucketName": "SOURCE_BUCKET"
    },
    "gcsDataSink": {
      "bucketName": "DESTINATION_BUCKET"
    },
    "objectConditions": {
      "lastModifiedSince": "2025-10-01T00:00:00Z",
      "lastModifiedBefore": "2025-11-01T00:00:00Z"
    }
  }
}

Para obtener más información, consulta la referencia de ObjectConditions.