Filtrare gli oggetti di origine in base all'ora di modifica

Console Google Cloud

Per specificare un filtro temporale nella console Google Cloud:

1. Vai alla pagina Crea job di trasferimento o Modifica job di trasferimento.
2. Nella sezione Scegli i dati da trasferire, seleziona Date e ore come Tipo di filtro.
3. Inserisci una data e un'ora per l'intervallo di tempo assoluto o una durata per l'intervallo di tempo relativo. È possibile specificare più filtri contemporaneamente.

gcloud CLI

Per filtrare in base all'ora di modifica utilizzando gcloud CLI, trasmetti i flag di filtro basati sul tempo 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"

Dove:

• --include-modified-before-absolute include gli oggetti modificati per ultimi prima di una data/ora assoluta. Ad esempio, se specifichi 2020-01-01, il trasferimento include gli oggetti modificati l'ultima volta prima del 1° gennaio 2020. Utilizza il formato %Y-%m-%dT%H:%M:%S%z per data e ora.
• --include-modified-after-absolute include gli oggetti modificati l'ultima volta dopo una data/ora assoluta. Ad esempio, se specifichi "2020-01-01", il trasferimento include gli oggetti modificati l'ultima volta dopo il 1° gennaio 2020. Utilizza il formato %Y-%m-%dT%H:%M:%S%z per data e ora.
• --include-modified-before-relative include gli oggetti modificati al di fuori di un determinato periodo di tempo trascorso. Ad esempio, specificando una durata di 10d vengono trasferiti gli oggetti modificati l'ultima volta più di 10 giorni prima dell'ora di inizio del trasferimento. Utilizza il formato della durata assoluta. Ad esempio, 1m per 1 mese; 1h30m per 1 ora e 30 minuti.
• --include-modified-after-relative include gli oggetti modificati entro un periodo di tempo specificato. Ad esempio, se specifichi una durata di 10d, vengono trasferiti gli oggetti modificati l'ultima volta meno di 10 giorni prima dell'ora di inizio del trasferimento. Utilizza il formato della durata assoluta. Ad esempio, 1m per 1 mese; 1h30m per 1 ora e 30 minuti.

Esempio (modificato dopo):

Il seguente comando trasferisce solo gli oggetti modificati a partire dal 1° ottobre 2025.

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

Esempio (intervallo di tempo):

Il seguente comando trasferisce solo gli oggetti modificati durante il mese di ottobre 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"

Esempio (tempo trascorso):

Il seguente comando trasferisce solo gli oggetti modificati negli ultimi 7 giorni.

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

REST

Per filtrare in base all'ora di modifica utilizzando l'API REST, specifica i campi di filtro basati sul tempo in objectConditions di 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",

    }
  }
}

Dove:

• lastModifiedBefore include gli oggetti modificati per ultimi prima di una data/ora assoluta. Ad esempio, se specifichi 2020-01-01, il trasferimento include gli oggetti modificati l'ultima volta prima del 1° gennaio 2020. Utilizza il formato %Y-%m-%dT%H:%M:%S%z per data e ora.
• lastModifiedSince include gli oggetti modificati l'ultima volta dopo una data/ora assoluta. Ad esempio, se specifichi "2020-01-01", il trasferimento include gli oggetti modificati l'ultima volta dopo il 1° gennaio 2020. Utilizza il formato %Y-%m-%dT%H:%M:%S%z per data e ora.
• minTimeElapsedSinceLastModification include gli oggetti modificati al di fuori di un determinato periodo di tempo trascorso. Ad esempio, specificando una durata di 10d vengono trasferiti gli oggetti modificati l'ultima volta più di 10 giorni prima dell'ora di inizio del trasferimento. Utilizza il formato della durata assoluta. Ad esempio, 1m per 1 mese; 1h30m per 1 ora e 30 minuti.
• maxTimeElapsedSinceLastModification include gli oggetti modificati entro un periodo di tempo specificato. Ad esempio, se specifichi una durata di 10d, vengono trasferiti gli oggetti modificati l'ultima volta meno di 10 giorni prima dell'ora di inizio del trasferimento. Utilizza il formato della durata assoluta. Ad esempio, 1m per 1 mese; 1h30m per 1 ora e 30 minuti.

Esempio (intervallo di tempo):

Il seguente corpo JSON configura un job per trasferire solo gli oggetti modificati nel mese di ottobre 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"
    }
  }
}

Per ulteriori informazioni, consulta il riferimento ObjectConditions.