REST Resource: transferOperations

Recurso: TransferOperation

Es una descripción de la ejecución de una transferencia.

Representación 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
}
Campos
name

string

Un ID único a nivel global que asigna el sistema.
projectId

string

El ID del proyecto de Google Cloud al que pertenece la operación
transferSpec

object (TransferSpec)

Especificación de transferencia.
notificationConfig

object (NotificationConfig)

Configuración de notificaciones.
loggingConfig

object (LoggingConfig)

Configuración de Cloud Logging.
startTime

string (Timestamp format)

Es la hora de inicio de esta ejecución de transferencia.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Es la hora de finalización de esta ejecución de transferencia.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
status

enum (Status)

Es el estado de la operación de transferencia.
counters

object (TransferCounters)

Es la información sobre el progreso de la operación de transferencia.
errorBreakdowns[]

object (ErrorSummary)

Resume los errores encontrados con las entradas de registro de errores de muestra.
transferJobName

string

Es el nombre del trabajo de transferencia que activa esta operación de transferencia.

Estado

Es el estado de una TransferOperation.

Enums
STATUS_UNSPECIFIED Cero es un valor no permitido.
IN_PROGRESS En curso.
PAUSED En pausa.
SUCCESS Se completó correctamente.
FAILED Se cerró debido a una falla irrecuperable.
ABORTED El usuario lo anuló.
QUEUED El sistema lo retrasó temporalmente. No se requiere que el usuario realice ninguna acción.
SUSPENDING La operación suspende y agota el trabajo en curso hasta que se completa.

TransferCounters

Es una colección de contadores que informan el progreso de una operación de transferencia.

Representación 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
}
Campos
objectsFoundFromSource

string (int64 format)

Son los objetos que se encuentran en la fuente de datos y que están programados para transferirse, excepto los que se filtran según las condiciones del objeto o se omiten debido a la sincronización.
bytesFoundFromSource

string (int64 format)

Bytes que se encuentran en la fuente de datos y que están programados para transferirse, sin incluir los que se filtran según las condiciones del objeto o se omiten debido a la sincronización.
objectsFoundOnlyFromSink

string (int64 format)

Son objetos que solo se encuentran en el destino de datos y que están programados para borrarse.
bytesFoundOnlyFromSink

string (int64 format)

Bytes que se encuentran solo en el sumidero de datos que se programaron para borrarse.
objectsFromSourceSkippedBySync

string (int64 format)

Son objetos de la fuente de datos que no se transfieren porque ya existen en el receptor de datos.
bytesFromSourceSkippedBySync

string (int64 format)

Bytes en la fuente de datos que no se transfieren porque ya existen en el receptor de datos.
objectsCopiedToSink

string (int64 format)

Son objetos que se copian en el sumidero de datos.
bytesCopiedToSink

string (int64 format)

Bytes que se copian en el sumidero de datos.
objectsDeletedFromSource

string (int64 format)

Son los objetos que se borran de la fuente de datos.
bytesDeletedFromSource

string (int64 format)

Bytes que se borran de la fuente de datos.
objectsDeletedFromSink

string (int64 format)

Son los objetos que se borran del sumidero de datos.
bytesDeletedFromSink

string (int64 format)

Bytes que se borran del sumidero de datos.
objectsFromSourceFailed

string (int64 format)

Objetos de la fuente de datos que no se pudieron transferir o que no se pudieron borrar después de la transferencia.
bytesFromSourceFailed

string (int64 format)

Bytes de la fuente de datos que no se pudieron transferir o que no se pudieron borrar después de la transferencia.
objectsFailedToDeleteFromSink

string (int64 format)

Objetos que no se pudieron borrar del sumidero de datos
bytesFailedToDeleteFromSink

string (int64 format)

Bytes que no se pudieron borrar del sumidero de datos.
directoriesFoundFromSource

string (int64 format)

Solo para transferencias que involucran PosixFilesystem.

Es la cantidad de directorios que se encontraron durante la creación de la lista. Por ejemplo, si el directorio raíz de la transferencia es base/ y hay otros dos directorios, a/ y b/, debajo de este directorio, el recuento después de enumerar base/, base/a/ y base/b/ es 3.
directoriesFailedToListFromSource

string (int64 format)

Solo para transferencias que involucran PosixFilesystem.

Cantidad de fallas de fichas para cada directorio que se encuentra en la fuente. Entre las posibles fallas cuando se crea una lista de directorios, se incluyen fallas de permisos o de bloqueo. Si la creación de una lista de directorios falla, no se transfieren los archivos del directorio.
directoriesSuccessfullyListedFromSource

string (int64 format)

Solo para transferencias que involucran PosixFilesystem.

Cantidad de fichas correctas para cada directorio que se encuentra en la fuente.
intermediateObjectsCleanedUp

string (int64 format)

Cantidad de objetos intermedios que se limpiaron correctamente.
intermediateObjectsFailedCleanedUp

string (int64 format)

Cantidad de objetos intermedios que no se pudieron limpiar

ErrorSummary

Un resumen de los errores por código de error, además de un recuento y muestras de entradas de registro de errores.

Representación JSON 
{
  "errorCode": enum (Code),
  "errorCount": string,
  "errorLogEntries": [
    {
      object (ErrorLogEntry)
    }
  ]
}
Campos
errorCode

enum (Code)

Obligatorio.
errorCount

string (int64 format)

Obligatorio. Es el recuento de este tipo de error.
errorLogEntries[]

object (ErrorLogEntry)

Muestras de errores.

Se registran, como máximo, 5 entradas de registro de errores para un código de error determinado en una sola operación de transferencia.

Código

Los códigos de error canónicos para las APIs de Google.

Enums
OK

No es un error, que se muestra con éxito.

Asignación HTTP: 200 OK
CANCELLED

La operación se canceló (por lo general, la cancela el emisor).

Asignación HTTP: 499 Solicitudes cerradas por el cliente
UNKNOWN

Error desconocido Por ejemplo, este error puede mostrarse cuando un valor Status recibido de otro espacio de direcciones pertenece a un espacio de error desconocido en este espacio de direcciones. Además, los errores generados por API que no muestran suficiente información sobre el error pueden convertirse en este error.

Asignación HTTP: Error interno del servidor 500
INVALID_ARGUMENT

El cliente especificó un argumento no válido. Ten en cuenta que esto difiere de FAILED_PRECONDITION. INVALID_ARGUMENT indica los argumentos que son problemáticos sin importar el estado del sistema (p.ej., un nombre de archivo con formato incorrecto).

Asignación HTTP: 400 Solicitud incorrecta
DEADLINE_EXCEEDED

El plazo venció antes de que la operación se pudiera completar. En el caso de las operaciones que cambian el estado del sistema, es probable que se muestre este error incluso si la operación se completó correctamente. Por ejemplo, una respuesta correcta desde un servidor podría haberse retrasado lo suficiente como para que el plazo venciera.

Asignación HTTP: Tiempo de espera de la puerta de enlace 504
NOT_FOUND

No se encontró alguna entidad solicitada (p. ej., un archivo o un directorio).

Nota para los desarrolladores de servidores: si se niega una solicitud a una clase completa de usuarios, como el lanzamiento gradual de funciones o una lista de permisos no documentada, se puede usar NOT_FOUND. Si se niega una solicitud para algunos usuarios dentro de una clase de usuarios, como el control de acceso basado en usuarios, se debe usar PERMISSION_DENIED

Asignación HTTP: 404 No encontrado
ALREADY_EXISTS

La entidad que un cliente intentó crear (p.ej., un archivo o un directorio) ya existe.

Asignación HTTP: 409 Conflicto
PERMISSION_DENIED

El emisor de la llamada no tiene permiso para ejecutar la operación especificada. No se debe usar PERMISSION_DENIED para los rechazos causados por el agotamiento de algún recurso (en su lugar, usa RESOURCE_EXHAUSTED para esos errores). No se debe usar PERMISSION_DENIED si no se puede identificar al emisor (en su lugar, usa UNAUTHENTICATED para esos errores). Este código de error no sugiere que la solicitud sea válida o que la entidad solicitada exista o satisfaga otras condiciones previas.

Asignación HTTP: 403 Prohibido
UNAUTHENTICATED

La solicitud no tiene credenciales de autenticación válidas para la operación.

Asignación HTTP: 401 No autorizado
RESOURCE_EXHAUSTED

Algunos recursos se agotaron, tal vez una cuota por usuario, o tal vez se agotó el espacio de todo el sistema de archivos.

Asignación HTTP: 429 Demasiadas solicitudes
FAILED_PRECONDITION

La operación se rechazó debido a que el sistema no se encuentra en un estado necesario para la ejecución de la operación. Por ejemplo, el directorio que se borrará no está vacío, se aplicará una operación rmdir a un directorio que no sea de directorio, etcétera.

Los implementadores de servicios pueden usar los siguientes lineamientos para decidir entre FAILED_PRECONDITION, ABORTED y UNAVAILABLE: (a) Usa UNAVAILABLE si el cliente puede reintentar solo la llamada con errores. (b) Usa ABORTED si el cliente debe reintentar en un nivel superior. Por ejemplo, cuando falla una prueba y un conjunto especificado por el cliente, lo que indica que el cliente debe reiniciar una secuencia de lectura, modificación y escritura. (c) Usa FAILED_PRECONDITION si el cliente no debe volver a intentar hasta que el estado del sistema se haya corregido de forma explícita. Por ejemplo, si un "rmdir" falla porque el directorio no está vacío, se debe mostrar FAILED_PRECONDITION, ya que el cliente no debe reintentar, a menos que se borren los archivos del directorio.

Asignación HTTP: 400 Solicitud incorrecta
ABORTED

La operación se anuló, generalmente debido a un problema de simultaneidad, como una falla en la verificación del secuenciador o la anulación de la transacción.

Consulta los lineamientos anteriores para decidir entre FAILED_PRECONDITION, ABORTED y UNAVAILABLE.

Asignación HTTP: 409 Conflicto
OUT_OF_RANGE

La operación se intentó fuera del rango válido. Por ejemplo, buscar o leer el final del archivo.

A diferencia de INVALID_ARGUMENT, este error indica un problema que se puede solucionar si cambia el estado del sistema. Por ejemplo, un sistema de archivos de 32 bits generará INVALID_ARGUMENT si se le pide que lea en un desplazamiento que no esté en el rango [0,2^32-1], pero generará OUT_OF_RANGE si se le pide leer. desde un desplazamiento después del tamaño de archivo actual

Hay una leve superposición entre FAILED_PRECONDITION y OUT_OF_RANGE. Recomendamos usar OUT_OF_RANGE (el error más específico) cuando se aplique para que los emisores que iteran a través de un espacio puedan buscar con facilidad un error OUT_OF_RANGE a fin de detectar cuando finalicen.

Asignación HTTP: 400 Solicitud incorrecta
UNIMPLEMENTED

La operación no se implementó, no se admite o no está habilitada en este servicio.

Asignación HTTP: 501 No implementado
INTERNAL

Errores internos. Esto significa que algunos invariantes que espera el sistema subyacente están rotos. Este código de error está reservado para errores graves.

Asignación HTTP: Error interno del servidor 500
UNAVAILABLE

El servicio no está disponible actualmente. Lo más probable es que esta sea una condición transitoria y que se pueda corregir si vuelves a intentar una retirada. Ten en cuenta que no siempre es seguro reintentar operaciones no idempotentes.

Consulta los lineamientos anteriores para decidir entre FAILED_PRECONDITION, ABORTED y UNAVAILABLE.

Asignación HTTP: 503 Servicio no disponible
DATA_LOSS

Daño o pérdida de datos no recuperable.

Asignación HTTP: Error interno del servidor 500

ErrorLogEntry

Es una entrada que describe un error que se produjo.

Representación JSON 
{
  "url": string,
  "errorDetails": [
    string
  ]
}
Campos
url

string

Obligatorio. Es una URL que hace referencia al destino (una fuente de datos, un objeto o un receptor de datos) con el que está asociado el error.
errorDetails[]

string

Una lista de mensajes que contienen los detalles del error.

Métodos

cancel

 Cancela una transferencia.

get

 Obtiene el último estado de una operación de larga duración.

list

 Muestra una lista de las operaciones de transferencia.

pause

 Pausa una operación de transferencia.

resume

 Reanuda una operación de transferencia que está pausada.