REST Resource: projects.locations.workflows.subtasks

Recurso: MigrationSubtask

Uma subtarefa de uma migração que carrega detalhes sobre a configuração da subtarefa. O conteúdo dos detalhes não deve importar para o usuário final, mas é um contrato entre o criador da subtarefa e o worker da subtarefa.

Representação 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

Apenas saída. Imutável. O nome do recurso da subtarefa de migração. O ID é gerado pelo servidor.

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

taskId

string

O ID exclusivo da tarefa a que essa subtarefa pertence.

type

string

O tipo da subtarefa. O serviço de migração não verifica se esse é um tipo conhecido. Cabe ao criador da tarefa (ou seja, orquestrador ou worker) garantir que ela crie apenas subtarefas para as quais há workers compatíveis pesquisando subtarefas.

state

enum (State)

Apenas saída. O estado atual da subtarefa.

processingError

object (ErrorInfo)

Apenas saída. Uma explicação que pode ser preenchida quando a tarefa está no estado FAILED.

resourceErrorDetails[]

object (ResourceErrorDetail)

Apenas saída. Fornece detalhes dos erros e problemas encontrados durante o processamento da subtarefa. A presença de detalhes do erro não significa que a subtarefa falhou.

resourceErrorCount

integer

O número de recursos com erros. Observação: esse não é o número total de erros, já que cada recurso pode ter mais de um erro. Isso é usado para indicar truncamento, tendo um resourceErrorCount maior que o tamanho de resourceErrorDetails.

createTime

string (Timestamp format)

Hora em que a subtarefa foi criada.

lastUpdateTime

string (Timestamp format)

Hora em que a subtarefa foi atualizada pela última vez.

metrics[]

object (TimeSeries)

As métricas da subtarefa.

Estado

Estados possíveis de uma subtarefa de migração.

Enums
STATE_UNSPECIFIED O estado não foi especificado.
ACTIVE A subtarefa está pronta, ou seja, está pronta para execução.
RUNNING A subtarefa está em execução, ou seja, foi atribuída a um worker para execução.
SUCCEEDED A subtarefa foi concluída.
FAILED A subtarefa foi concluída sem sucesso.
PAUSED A subtarefa está pausada, ou seja, não será programada. Se já tiver sido atribuída, ela ainda poderá ser concluída, mas nenhuma nova renovação será concedida.
PENDING_DEPENDENCY A subtarefa tem uma dependência pendente. Ela será programada quando as dependências forem concluídas.

TimeSeries

O objeto de métricas para uma SubTask.

Representação JSON
{
  "metric": string,
  "valueType": enum (ValueType),
  "metricKind": enum (MetricKind),
  "points": [
    {
      object (Point)
    }
  ]
}
Campos
metric

string

Obrigatório. O nome da métrica.

Se o serviço ainda não souber a métrica, ela será criada automaticamente.

valueType

enum (ValueType)

Obrigatório. O tipo de valor da série temporal.

metricKind

enum (MetricKind)

Opcional. O tipo de métrica da série temporal.

Se estiver presente, ele precisa ser igual ao tipo da métrica associada. Se o descritor da métrica associada precisar ser criado automaticamente, esse campo especificará o tipo de métrica do novo descritor e precisará ser GAUGE (o padrão) ou CUMULATIVE.

points[]

object (Point)

Obrigatório. Os pontos de dados desta série temporal. Ao listar séries temporais, os pontos são retornados em ordem inversa.

Ao criar uma série temporal, esse campo precisa conter exatamente um ponto, e o tipo do ponto precisa ser igual ao tipo de valor da métrica associada. Se o descritor da métrica associada precisar ser criado automaticamente, o tipo de valor do descritor será determinado pelo tipo do ponto, que precisa ser BOOL, INT64, DOUBLE ou DISTRIBUTION.

Point

Um único ponto de dados em uma série temporal.

Representação JSON
{
  "interval": {
    object (TimeInterval)
  },
  "value": {
    object (TypedValue)
  }
}
Campos
interval

object (TimeInterval)

O intervalo de tempo a que o ponto de dados se aplica. Para métricas GAUGE, o horário de início não precisa ser fornecido, mas, se for fornecido, precisa ser igual ao horário de término. Para métricas DELTA, os horários de início e término precisam especificar um intervalo diferente de zero, com os pontos subsequentes especificando intervalos contíguos e não sobrepostos. Para métricas de CUMULATIVE, os horários de início e de término precisam especificar um intervalo diferente de zero, com os pontos subsequentes especificando o mesmo horário de início e horários de término crescentes, até que um evento redefina o valor cumulativo para zero e defina um novo horário de início para os pontos a seguir.

value

object (TypedValue)

O valor do ponto de dados.

TimeInterval

Um intervalo de tempo que se estende logo após um horário de início até um horário de término. Se o horário de início for igual ao de término, o intervalo vai representar um único ponto no tempo.

Representação JSON
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Opcional. O início do intervalo de tempo. O valor padrão para o horário de início é o horário de término. O horário de início não pode ser posterior ao horário de término.

endTime

string (Timestamp format)

Obrigatório. O fim do intervalo de tempo.

TypedValue

Um único valor fortemente digitado.

Representação 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ão value. O campo de valor digitado. value pode ser apenas de um dos tipos a seguir:
boolValue

boolean

Um valor booleano: true ou false.

int64Value

string (int64 format)

Um número inteiro de 64 bits. Seu intervalo é de aproximadamente +/-9.2x10^18.

doubleValue

number

Um número de ponto flutuante de dupla precisão de 64 bits. A magnitude é de aproximadamente +/-10^(+/-300) e tem 16 dígitos significativos de precisão.

stringValue

string

Um valor de string de comprimento variável.

distributionValue

object (Distribution)

Um valor de distribuição.

Métodos

get

Recebe uma subtarefa de migração criada anteriormente.

list

Lista subtarefas de migração criadas anteriormente.