Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

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

Puoi filtrare gli oggetti da trasferire in base all'ora dell'ultima modifica. In questo modo puoi trasferire solo gli oggetti modificati:

Prima o dopo una data e un'ora specifiche
Prima o dopo un periodo di tempo trascorso specificato rispetto al job di trasferimento

Questa funzionalità è utile per configurare i trasferimenti incrementali o per ignorare gli oggetti che non rientrano in un intervallo di tempo.

Il filtro in base all'ora dell'ultima modifica è supportato per i trasferimenti da tutte le origini, ad eccezione degli elenchi di URL.

Filtri basati sul tempo

Il filtro è definito con i valori last modified since, last modified before, minimum time elapsed since modified e maximum time elapsed since modified. Puoi utilizzare i filtri singolarmente o insieme per creare una finestra temporale.

Campo	Descrizione
Ultima modifica dal giorno	Include gli oggetti nel trasferimento che sono stati modificati per l'ultima volta in corrispondenza o dopo questo timestamp.
Ultima modifica prima del giorno	Include gli oggetti nel trasferimento che sono stati modificati per l'ultima volta prima di questo timestamp.
Tempo minimo trascorso dall'ultima modifica	Include gli oggetti nel trasferimento che sono stati modificati per l'ultima volta almeno questo tempo fa. Ad esempio, questo filtro può essere utilizzato per includere solo gli oggetti modificati almeno un mese fa. Vengono trasferiti anche gli oggetti senza "ora dell'ultima modifica".
Tempo massimo trascorso dall'ultima modifica	Include gli oggetti nel trasferimento che sono stati modificati per l'ultima volta non più di questo periodo di tempo fa. Ad esempio, questo filtro può essere utilizzato per includere solo gli oggetti modificati negli ultimi 7 giorni. Vengono trasferiti anche gli oggetti senza "ora dell'ultima modifica".

Specificare un filtro basato sul tempo

Puoi specificare i filtri dell'ora di modifica quando crei o aggiorni un job di trasferimento.

I timestamp devono essere in formato UTC e formattati come una stringa RFC 3339 (ad es. 2025-10-31T10:00:00Z). Le durate utilizzano il formato di durata assoluta (ad es. 1m per 1 mese; 1h30m per 1 ora e 30 minuti).

Console Google Cloud

Per specificare un filtro temporale nella console Google Cloud:

Vai alla pagina Crea job di trasferimento o Modifica job di trasferimento.
Nella sezione Scegli i dati da trasferire, seleziona Date e ore come Tipo di filtro.
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, passa i flag dei filtri 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 l'ultima volta prima di una data/ora assoluta. Ad esempio, se specifichi 2020-01-01, il trasferimento include gli oggetti modificati per l'ultima volta prima del 1° gennaio 2020. Utilizza il formato di data e ora %Y-%m-%dT%H:%M:%S%z.
--include-modified-after-absolute include gli oggetti modificati per l'ultima volta dopo una data/ora assoluta. Ad esempio, se specifichi "2020-01-01", il trasferimento include gli oggetti modificati per l'ultima volta dopo il 1° gennaio 2020. Utilizza il formato di data e ora %Y-%m-%dT%H:%M:%S%z.
--include-modified-before-relative include gli oggetti modificati al di fuori di un periodo di tempo trascorso specificato. Ad esempio, se specifichi una durata di 10d, vengono trasferiti gli oggetti modificati per l'ultima volta più di 10 giorni prima dell'ora di inizio del trasferimento. Utilizza il formato di 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 per l'ultima volta meno di 10 giorni prima dell'ora di inizio del trasferimento. Utilizza il formato di 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 (finestra temporale):

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

Esempio (finestra temporale):

Il seguente corpo JSON configura un job per trasferire solo gli oggetti modificati durante il 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 ObjectConditions.

Interazione con altri filtri

Quando utilizzi più filtri, Storage Transfer Service li applica nel seguente ordine:

Includi prefissi: limita gli oggetti da considerare.
Condizioni degli oggetti (ora dell'ultima modifica): filtra gli oggetti che corrispondono al prefisso di inclusione.
Escludi prefissi: rimuove gli oggetti dal risultato.

Scopri di più sul filtro per prefisso.

Esempio: combinazione di tutti i filtri

Supponiamo che tu abbia la seguente configurazione dei filtri:

include_prefix: "logs/"
lastModifiedSince: "2025-10-31T00:00:00Z"
exclude_prefix: "logs/temp/"

Risultato: il servizio eseguirà il trasferimento nel seguente modo:

Innanzitutto, considera solo gli oggetti nella directory logs/.
Poi, cerca gli oggetti modificati a partire dal 31 ottobre 2025.
Infine, rimuove dalla lista tutti gli oggetti presenti nella directory logs/temp/.