REST Resource: transferOperations

Risorsa: TransferOperation

Una descrizione dell'esecuzione di un trasferimento.

Rappresentazione JSON 
{
  "name": string,
  "projectId": string,
  "transferSpec": {
    object (TransferSpec)
  },
  "notificationConfig": {
    object (NotificationConfig)
  },
  "loggingConfig": {
    object (LoggingConfig)
  },
  "startTime": string,
  "endTime": string,
  "status": enum (Status),
  "counters": {
    object (TransferCounters)
  },
  "errorBreakdowns": [
    {
      object (ErrorSummary)
    }
  ],
  "transferJobName": string
}
Campi
name

string

Un ID univoco a livello globale assegnato dal sistema.
projectId

string

L'ID del progetto Google Cloud proprietario dell'operazione.
transferSpec

object (TransferSpec)

Specifiche di trasferimento.
notificationConfig

object (NotificationConfig)

Configurazione delle notifiche.
loggingConfig

object (LoggingConfig)

Configurazione di Cloud Logging.
startTime

string (Timestamp format)

Ora di inizio dell'esecuzione di questo trasferimento.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Ora di fine dell'esecuzione di questo trasferimento.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
status

enum (Status)

Stato dell'operazione di trasferimento.
counters

object (TransferCounters)

Informazioni sullo stato di avanzamento dell'operazione di trasferimento.
errorBreakdowns[]

object (ErrorSummary)

Riassume gli errori rilevati con le voci di log degli errori di esempio.
transferJobName

string

Il nome del job di trasferimento che attiva questa operazione di trasferimento.

Stato

Lo stato di un'operazione di trasferimento.

Enum
STATUS_UNSPECIFIED Zero è un valore non valido.
IN_PROGRESS In corso.
PAUSED In pausa
SUCCESS Operazione completata correttamente.
FAILED Interrotto a causa di un errore non recuperabile.
ABORTED Interrotto dall'utente.
QUEUED Ritardo temporaneo del sistema. Non è richiesta alcuna azione da parte dell'utente.
SUSPENDING L'operazione sta sospendendo e terminando il lavoro in corso.

TransferCounters

Una raccolta di contatori che segnalano l'avanzamento di un'operazione di trasferimento.

Rappresentazione JSON 
{
  "objectsFoundFromSource": string,
  "bytesFoundFromSource": string,
  "objectsFoundOnlyFromSink": string,
  "bytesFoundOnlyFromSink": string,
  "objectsFromSourceSkippedBySync": string,
  "bytesFromSourceSkippedBySync": string,
  "objectsCopiedToSink": string,
  "bytesCopiedToSink": string,
  "objectsDeletedFromSource": string,
  "bytesDeletedFromSource": string,
  "objectsDeletedFromSink": string,
  "bytesDeletedFromSink": string,
  "objectsFromSourceFailed": string,
  "bytesFromSourceFailed": string,
  "objectsFailedToDeleteFromSink": string,
  "bytesFailedToDeleteFromSink": string,
  "directoriesFoundFromSource": string,
  "directoriesFailedToListFromSource": string,
  "directoriesSuccessfullyListedFromSource": string,
  "intermediateObjectsCleanedUp": string,
  "intermediateObjectsFailedCleanedUp": string
}
Campi
objectsFoundFromSource

string (int64 format)

Oggetti trovati nell'origine dati che sono pianificati per il trasferimento, esclusi quelli filtrati in base alle condizioni degli oggetti o ignorati a causa della sincronizzazione.
bytesFoundFromSource

string (int64 format)

Byte trovati nell'origine dati che sono pianificati per il trasferimento, esclusi quelli filtrati in base alle condizioni degli oggetti o ignorati a causa della sincronizzazione.
objectsFoundOnlyFromSink

string (int64 format)

Oggetti trovati solo nell'elemento di destinazione dati e la cui eliminazione è pianificata.
bytesFoundOnlyFromSink

string (int64 format)

Byte trovati solo nell'elemento di destinazione dati che sono pianificati per l'eliminazione.
objectsFromSourceSkippedBySync

string (int64 format)

Oggetti nell'origine dati che non vengono trasferiti perché esistono già nell'elemento di destinazione dati.
bytesFromSourceSkippedBySync

string (int64 format)

Byte nell'origine dati che non vengono trasferiti perché esistono già nell'elemento di destinazione dati.
objectsCopiedToSink

string (int64 format)

Oggetti che vengono copiati nell'elemento di destinazione dati.
bytesCopiedToSink

string (int64 format)

Byte che vengono copiati nell'area di destinazione dei dati.
objectsDeletedFromSource

string (int64 format)

Oggetti eliminati dall'origine dati.
bytesDeletedFromSource

string (int64 format)

Byte eliminati dall'origine dati.
objectsDeletedFromSink

string (int64 format)

Oggetti eliminati dall'elemento di destinazione dati.
bytesDeletedFromSink

string (int64 format)

Byte eliminati dall'elemento di destinazione dati.
objectsFromSourceFailed

string (int64 format)

Oggetti dell'origine dati che non sono stati trasferiti o che non sono stati eliminati dopo il trasferimento.
bytesFromSourceFailed

string (int64 format)

Byte nell'origine dati che non sono stati trasferiti o che non sono stati eliminati dopo il trasferimento.
objectsFailedToDeleteFromSink

string (int64 format)

Oggetti che non è stato possibile eliminare dall'elemento di destinazione dati.
bytesFailedToDeleteFromSink

string (int64 format)

Byte che non è stato possibile eliminare dall'elemento di destinazione dati.
directoriesFoundFromSource

string (int64 format)

Solo per i trasferimenti che coinvolgono PosixFilesystem.

Numero di directory trovate durante l'elenco. Ad esempio, se la directory principale del trasferimento è base/ e ci sono altre due directory, a/ e b/, in questa directory, il conteggio dopo l'elenco di base/, base/a/ e base/b/ è 3.
directoriesFailedToListFromSource

string (int64 format)

Solo per i trasferimenti che coinvolgono PosixFilesystem.

Numero di errori relativi alle schede per ogni directory trovata all'origine. I potenziali errori durante l'elenco di una directory includono errori di autorizzazione o di blocco. Se l'elenco di una directory non va a buon fine, nessun file della directory viene trasferito.
directoriesSuccessfullyListedFromSource

string (int64 format)

Solo per i trasferimenti che coinvolgono PosixFilesystem.

Numero di schede corrette per ogni directory trovata all'origine.
intermediateObjectsCleanedUp

string (int64 format)

Numero di oggetti intermedi di cui è stato eseguito il cleanup.
intermediateObjectsFailedCleanedUp

string (int64 format)

Numero di oggetti intermedi di cui non è stato possibile eseguire la pulizia.

ErrorSummary

Un riepilogo degli errori per codice di errore, oltre a un conteggio e voci di log degli errori di esempio.

Rappresentazione JSON 
{
  "errorCode": enum (Code),
  "errorCount": string,
  "errorLogEntries": [
    {
      object (ErrorLogEntry)
    }
  ]
}
Campi
errorCode

enum (Code)

Obbligatorio.
errorCount

string (int64 format)

Obbligatorio. Conteggio di questo tipo di errore.
errorLogEntries[]

object (ErrorLogEntry)

Esempi di errori.

Per un determinato codice di errore di una singola operazione di trasferimento vengono registrate al massimo 5 voci di log di errore.

Codice

I codici di errore canonici per le API di Google.

Enum
OK

Non è un errore; viene restituito in caso di esito positivo.

Mappatura HTTP: 200 OK
CANCELLED

L'operazione è stata annullata, in genere dal chiamante.

Mappatura HTTP: 499 Client Closed Request
UNKNOWN

Errore sconosciuto. Ad esempio, questo errore può essere restituito quando un valore Status ricevuto da un altro spazio degli indirizzi appartiene a uno spazio di errore non noto in questo spazio degli indirizzi. Anche gli errori generati da API che non restituiscono informazioni sufficienti sugli errori possono essere convertiti in questo errore.

Mappatura HTTP: 500 Internal Server Error (Errore interno del server)
INVALID_ARGUMENT

Il client ha specificato un argomento non valido. Tieni presente che questo valore è diverso da FAILED_PRECONDITION. INVALID_ARGUMENT indica gli argomenti problematici indipendentemente dallo stato del sistema (ad es. un nome file con formato non corretto).

Mappatura HTTP: 400 Bad Request (Richiesta non valida)
DEADLINE_EXCEEDED

La scadenza è scaduta prima del completamento dell'operazione. Per le operazioni che modificano lo stato del sistema, questo errore può essere restituito anche se l'operazione è stata completata correttamente. Ad esempio, una risposta positiva da un server potrebbe aver subito un ritardo sufficientemente lungo da far scadere la scadenza.

Mappatura HTTP: timeout del gateway (504)
NOT_FOUND

Impossibile trovare alcune entità richieste (ad es. file o directory).

Nota per gli sviluppatori di server: se una richiesta viene rifiutata per un'intera classe di utenti, ad esempio per l'implementazione graduale di funzionalità o per le liste consentite non documentate, può essere utilizzato NOT_FOUND. Se una richiesta viene rifiutata per alcuni utenti all'interno di una classe di utenti, ad esempio il controllo dell'accesso basato sugli utenti, deve essere utilizzato PERMISSION_DENIED.

Mappatura HTTP: 404 Not Found
ALREADY_EXISTS

L'entità che un client ha tentato di creare (ad es. file o directory) esiste già.

Mappatura HTTP: conflitto (409)
PERMISSION_DENIED

Il chiamante non dispone dell'autorizzazione per eseguire l'operazione specificata. PERMISSION_DENIED non deve essere utilizzato per i rifiuti causati dall'esaurimento di una risorsa (per questi errori, utilizza invece RESOURCE_EXHAUSTED). PERMISSION_DENIED non deve essere utilizzato se non è possibile identificare l'utente che chiama (per questi errori, utilizza UNAUTHENTICATED). Questo codice di errore non implica che la richiesta sia valida o che l'entità richiesta esista o soddisfi altre pre-condizioni.

Mappatura HTTP: 403 accesso negato
UNAUTHENTICATED

La richiesta non ha credenziali di autenticazione valide per l'operazione.

Mappatura HTTP: 401 Non autorizzato
RESOURCE_EXHAUSTED

Una risorsa è stata esaurita, ad esempio una quota per utente, oppure l'intero file system non dispone di spazio.

Mappatura HTTP: 429 Too Many Requests
FAILED_PRECONDITION

L'operazione è stata rifiutata perché il sistema non è nello stato richiesto per l'esecuzione dell'operazione. Ad esempio, la directory da eliminare non è vuota, un'operazione rmdir viene applicata a una non directory e così via.

Gli implementatori di servizi possono utilizzare le seguenti linee guida per scegliere tra FAILED_PRECONDITION, ABORTED e UNAVAILABLE: (a) Utilizza UNAVAILABLE se il client può riprovare solo la chiamata con errore. (b) Utilizza ABORTED se il client deve riprovare a un livello superiore. Ad esempio, quando un test-and-set specificato dal client non va a buon fine, il client deve riavviare una sequenza di lettura, modifica e scrittura. (c) Utilizza FAILED_PRECONDITION se il client non deve riprovare finché lo stato del sistema non è stato corretto esplicitamente. Ad esempio, se un comando "rmdir" non va a buon fine perché la directory non è vuota, deve essere restituito FAILED_PRECONDITION, poiché il client non deve riprovare a meno che i file non vengano eliminati dalla directory.

Mappatura HTTP: 400 Bad Request (Richiesta non valida)
ABORTED

L'operazione è stata interrotta, in genere a causa di un problema di concorrenza, ad esempio un errore di controllo del sequenziatore o l'interruzione della transazione.

Consulta le linee guida sopra per decidere tra FAILED_PRECONDITION, ABORTED e UNAVAILABLE.

Mappatura HTTP: conflitto (409)
OUT_OF_RANGE

L'operazione è stata tentata oltre l'intervallo valido. Ad esempio, ricerca o lettura oltre il fine file.

A differenza di INVALID_ARGUMENT, questo errore indica un problema che potrebbe essere risolto se lo stato del sistema cambia. Ad esempio, un file system a 32 bit genererà INVALID_ARGUMENT se gli viene chiesto di leggere in un offset non compreso nell'intervallo [0,2^32-1], ma genererà OUT_OF_RANGE se gli viene chiesto di leggere da un offset superiore alle dimensioni attuali del file.

Esiste una discreta sovrapposizione tra FAILED_PRECONDITION e OUT_OF_RANGE. Ti consigliamo di utilizzare OUT_OF_RANGE (l'errore più specifico) quando è applicabile, in modo che gli utenti che eseguono l'iterazione in uno spazio possano cercare facilmente un errore OUT_OF_RANGE per rilevare quando hanno terminato.

Mappatura HTTP: 400 Bad Request (Richiesta non valida)
UNIMPLEMENTED

L'operazione non è implementata o non è supportata/attivata in questo servizio.

Mappatura HTTP: 501 Not Implemented
INTERNAL

Errori interni. Ciò significa che alcune invarianti previste dal sistema di base sono state violate. Questo codice di errore è riservato agli errori gravi.

Mappatura HTTP: 500 Internal Server Error (Errore interno del server)
UNAVAILABLE

Il servizio non è al momento disponibile. Molto probabilmente si tratta di una condizione temporanea, che può essere corretta riprovando con un backoff. Tieni presente che non è sempre sicuro riprovare le operazioni non idempotenti.

Consulta le linee guida sopra per decidere tra FAILED_PRECONDITION, ABORTED e UNAVAILABLE.

Mappatura HTTP: 503 Servizio non disponibile
DATA_LOSS

Perdita di dati non recuperabili o danneggiamento dei dati.

Mappatura HTTP: 500 Internal Server Error (Errore interno del server)

ErrorLogEntry

Una voce che descrive un errore che si è verificato.

Rappresentazione JSON 
{
  "url": string,
  "errorDetails": [
    string
  ]
}
Campi
url

string

Obbligatorio. Un URL che fa riferimento al target (un'origine dati, un'area di destinazione dei dati o un oggetto) a cui è associato l'errore.
errorDetails[]

string

Un elenco di messaggi che contengono i dettagli dell'errore.

Metodi

cancel

 Annullare un trasferimento.

get

 Recupera lo stato più recente di un'operazione a lunga esecuzione.

list

 Elenca le operazioni di trasferimento.

pause

 Mette in pausa un'operazione di trasferimento.

resume

 Riprende un'operazione di trasferimento in pausa.