REST Resource: projects.locations.workflows.subtasks

Recurso: MigrationSubtask

Una subtarea para una migración que contiene detalles sobre la configuración de la subtarea. El contenido de los detalles no debe importar al usuario final, pero es un contrato entre el creador de la subtarea y el trabajador de la subtarea.

Representación JSON
{
  "name": string,
  "taskId": string,
  "type": string,
  "state": enum (State),
  "processingError": {
    object (ErrorInfo)
  },
  "resourceErrorDetails": [
    {
      object (ResourceErrorDetail)
    }
  ],
  "resourceErrorCount": integer,
  "createTime": string,
  "lastUpdateTime": string,
  "metrics": [
    {
      object (TimeSeries)
    }
  ]
}
Campos
name

string

Solo salida. Inmutable. El nombre del recurso de la subtarea de migración. El ID lo genera el servidor.

Ejemplo: projects/123/locations/us/workflows/345/subtasks/678

taskId

string

El ID único de la tarea a la que pertenece esta subtarea.

type

string

El tipo de subtarea. El servicio de migración no verifica si se trata de un tipo conocido. Depende del creador de la tarea (es decir, el organizador o el trabajador) asegurarse de que solo cree subtareas para las que haya trabajadores compatibles que consulten subtareas.

state

enum (State)

Solo salida. El estado actual de la subtarea.

processingError

object (ErrorInfo)

Solo salida. Una explicación que se puede propagar cuando la tarea está en estado FAILED.

resourceErrorDetails[]

object (ResourceErrorDetail)

Solo salida. Proporciona detalles sobre los errores y problemas detectados mientras se procesa la subtarea. La presencia de detalles de errores no significa que la subtarea falló.

resourceErrorCount

integer

La cantidad o los recursos con errores. Nota: Esta no es la cantidad total de errores, ya que cada recurso puede tener más de un error. Esto se usa para indicar el truncamiento con un resourceErrorCount que es mayor que el tamaño de resourceErrorDetails.

createTime

string (Timestamp format)

Hora en la que se creó la subtarea.

lastUpdateTime

string (Timestamp format)

Hora en la que se actualizó la subtarea por última vez.

metrics[]

object (TimeSeries)

Las métricas de la subtarea.

Estado

Estados posibles de una subtarea de migración.

Enums
STATE_UNSPECIFIED El estado no se especifica.
ACTIVE La subtarea está lista, es decir, está lista para ejecutarse.
RUNNING La subtarea está en ejecución, es decir, se asigna a un trabajador para que la ejecute.
SUCCEEDED La subtarea finalizó correctamente.
FAILED La subtarea no finalizó correctamente.
PAUSED La subtarea está detenida, es decir, no se programará. Si ya se asignó, es posible que finalice, pero no se otorgarán renovaciones de asignaciones de tiempo nuevas.
PENDING_DEPENDENCY La subtarea tiene una dependencia pendiente. Se programará una vez que finalicen sus dependencias.

TimeSeries

El objeto de métricas para una subtarea.

Representación JSON
{
  "metric": string,
  "valueType": enum (ValueType),
  "metricKind": enum (MetricKind),
  "points": [
    {
      object (Point)
    }
  ]
}
Campos
metric

string

Obligatorio. Es el nombre de la métrica.

Si el servicio aún no conoce la métrica, se creará de forma automática.

valueType

enum (ValueType)

Obligatorio. El tipo de valor de la serie temporal.

metricKind

enum (MetricKind)

Opcional. El tipo de métrica de la serie temporal.

Si está presente, debe ser el mismo que el tipo de métrica de la métrica asociada. Si el descriptor de la métrica asociada se debe crear automáticamente, este campo especifica el tipo de métrica del descriptor nuevo y debe ser GAUGE (predeterminado) o CUMULATIVE.

points[]

object (Point)

Obligatorio. Los datos de esta serie temporal. Cuando se enumeran series temporales, los puntos se muestran en orden de tiempo inverso.

Cuando creas una serie temporal, este campo debe contener exactamente un punto y el tipo de punto debe ser el mismo que el tipo de valor de la métrica asociada. Si el descriptor de la métrica asociada debe crearse automáticamente, el tipo de valor del descriptor se determina por el tipo del punto, que debe ser BOOL, INT64, DOUBLE o DISTRIBUTION.

Punto

Un único dato en una serie temporal.

Representación JSON
{
  "interval": {
    object (TimeInterval)
  },
  "value": {
    object (TypedValue)
  }
}
Campos
interval

object (TimeInterval)

El intervalo de tiempo al que se aplican los datos. Para las métricas GAUGE, no es necesario proporcionar la hora de inicio, pero, si se proporciona, debe ser igual a la hora de finalización. Para las métricas DELTA, la hora de inicio y finalización deben especificar un intervalo distinto de cero, en el que los puntos posteriores especifiquen intervalos contiguos y no superpuestos. Para las métricas CUMULATIVE, la hora de inicio y finalización deben especificar un intervalo distinto de cero, en el que los puntos posteriores especifiquen la misma hora de inicio y mayores horas de finalización, hasta que un evento restablezca el valor acumulativo en cero y establezca una nueva hora de inicio para el siguientes puntos.

value

object (TypedValue)

El valor del dato.

TimeInterval

Un intervalo de tiempo que se extiende justo después de una hora de inicio hasta una hora de finalización. Si la hora de inicio es la misma que la de finalización, el intervalo representa un solo punto en el tiempo.

Representación JSON
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Opcional. El comienzo del intervalo de tiempo. El valor predeterminado para la hora de inicio es la hora de finalización. La hora de inicio no debe ser posterior a la de finalización.

endTime

string (Timestamp format)

Obligatorio. El final del intervalo de tiempo.

TypedValue

Un valor único de tipo fuerte.

Representación JSON
{

  // Union field value can be only one of the following:
  "boolValue": boolean,
  "int64Value": string,
  "doubleValue": number,
  "stringValue": string,
  "distributionValue": {
    object (Distribution)
  }
  // End of list of possible types for union field value.
}
Campos
Campo de unión value. El campo de valor escrito. value puede ser solo uno de los siguientes:
boolValue

boolean

Un valor booleano: true o false.

int64Value

string (int64 format)

Un número entero de 64 bits. Su rango es aproximadamente +/-9.2x10^18.

doubleValue

number

Un número de punto flotante de doble precisión de 64 bits. Su magnitud es aproximadamente +/-10^(+/-300) y tiene 16 dígitos significativos de precisión.

stringValue

string

Un valor de cadena de longitud variable.

distributionValue

object (Distribution)

Un valor de distribución.

Métodos

get

Obtiene una subtarea de migración creada con anterioridad.

list

Enumera las subtareas de migración creadas antes.