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 relativo al job di trasferimento
Questa funzionalità è utile per configurare trasferimenti incrementali o per saltare oggetti che non rientrano in un intervallo di tempo.
Il filtro per 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 nel trasferimento gli oggetti che sono stati modificati l'ultima volta in corrispondenza o dopo questo timestamp. |
| Ultima modifica prima del giorno | Include gli oggetti nel trasferimento che sono stati modificati l'ultima volta prima di questo timestamp. |
| Tempo minimo trascorso dall'ultima modifica | Include gli oggetti nel trasferimento che sono stati modificati 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 un "ora dell'ultima modifica". |
| Tempo massimo trascorso dall'ultima modifica | Include nel trasferimento gli oggetti che sono stati modificati l'ultima volta non più di questo periodo di tempo fa. Ad esempio, questo filtro può essere utilizzato per includere solo gli oggetti che sono stati modificati negli ultimi 7 giorni. Vengono trasferiti anche gli oggetti senza un "ora dell'ultima modifica". |
Specifica un filtro basato sul tempo
Puoi specificare i filtri per l'ora di modifica durante la creazione o l'aggiornamento di un job di trasferimento.
I timestamp devono essere in formato UTC e formattati come stringa RFC 3339 (ad es. 2025-10-31T10:00:00Z). Le durate utilizzano il formato di durata assoluta (ad es. P1M 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 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-absoluteinclude gli oggetti modificati per ultimi prima di una data/ora assoluta. Ad esempio, se specifichi2020-01-01, il trasferimento include gli oggetti modificati l'ultima volta prima del 1° gennaio 2020. Utilizza il formato data e ora%Y-%m-%dT%H:%M:%S%z.--include-modified-after-absoluteinclude 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 l'ultima volta dopo il 1° gennaio 2020. Utilizza il formato data e ora%Y-%m-%dT%H:%M:%S%z.--include-modified-before-relativeinclude gli oggetti che sono stati modificati al di fuori di un periodo di tempo trascorso specificato. Ad esempio, se specifichi una durata di10d, 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,P1Mper 1 mese o1h30mper 1 ora e 30 minuti).--include-modified-after-relativeinclude gli oggetti modificati entro un periodo di tempo specificato. Ad esempio, se specifichi una durata di10d, vengono trasferiti gli oggetti modificati l'ultima volta meno di 10 giorni prima dell'ora di inizio del trasferimento. Utilizza il formato di durata assoluta (ad esempio,P1Mper 1 mese o1h30mper 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 nel 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:
lastModifiedBeforeinclude gli oggetti modificati per l'ultima volta prima dell'ora specificata. Utilizza un timestamp RFC 3339, ad esempio2020-01-01T00:00:00Z.lastModifiedSinceinclude gli oggetti modificati l'ultima volta alla data e ora specificate o in un momento successivo. Utilizza un timestamp RFC 3339, ad esempio2020-01-01T00:00:00Z.minTimeElapsedSinceLastModificationinclude gli oggetti modificati l'ultima volta almeno questo periodo di tempo prima dell'ora di inizio del trasferimento. Specifica la durata in secondi seguita das. Ad esempio,864000s(10 giorni) trasferisce gli oggetti modificati l'ultima volta 10 o più giorni prima dell'ora di inizio del trasferimento.maxTimeElapsedSinceLastModificationinclude gli oggetti modificati l'ultima volta meno di questo periodo di tempo prima dell'ora di inizio del trasferimento. Specifica la durata in secondi seguita das. Ad esempio,864000s(10 giorni) trasferisce gli oggetti modificati l'ultima volta meno di 10 giorni prima dell'ora di inizio del trasferimento.
Esempio (finestra temporale):
Il seguente corpo JSON configura un job per trasferire solo gli oggetti modificati durante 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 saperne di più, consulta il riferimento ObjectConditions.
Interazione con altri filtri
Quando utilizzi più filtri, Storage Transfer Service li applica nel seguente ordine:
Includi prefissi: restringe gli oggetti da considerare.
Condizioni degli oggetti (pattern glob e ora dell'ultima modifica): filtra gli oggetti che corrispondono al prefisso di inclusione. Un oggetto deve corrispondere sia al filtro glob sia al filtro dell'ultima modifica per essere incluso nel risultato.
Escludi prefissi: rimuove gli oggetti dal risultato.
Scopri di più sul filtraggio per prefisso e sul filtraggio con pattern glob.
Esempio: combinazione di tutti i filtri
Immagina di avere la seguente configurazione di filtri per un trasferimento da AWS S3 o Azure:
- include_prefix: "logs/"
- match_glob: "**/*.log"
- lastModifiedSince: "2025-10-31T00:00:00Z"
- exclude_prefix: "logs/temp/"
Risultato: il servizio eseguirà il trasferimento come segue:
- Innanzitutto, prende in considerazione solo gli oggetti nella directory
logs/. - Successivamente, cerca gli oggetti che terminano con
.logE che sono stati modificati il 31 ottobre 2025 o dopo questa data. - Infine, rimuove da questo elenco tutti gli oggetti che si trovano nella directory
logs/temp/.