Todos os produtos
Search
Central de documentação

Cloud Control API:GetTask

Última atualização: Jun 28, 2026

Consulta uma tarefa assíncrona especificada.

Descrição da operação

GET /api/v1/tasks/{taskId}.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

GET /api/v1/tasks/{taskId} HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

taskId

string

Sim

O ID da tarefa.

task-433aead756057fff8189a7ce5****

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados retornados.

requestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

task

object

As informações sobre a tarefa.

createTime

string

O horário em que a tarefa foi criada.

2022-10-09T00:46:03Z

error

object

O erro retornado para a tarefa.

code

string

The error code.

OperationFailure.OperationFailed

message

string

The error message.

{ "requestId": "123****", "errorCode": "InvalidRamUser.NoPermission", "errorMsg": "Ram user is not authorized to perform the operation." }

product

string

O código do serviço.

ECS

regionId

string

O ID da região.

cn-beijing

resourceId

string

O ID do recurso.

i-8vbascjthm7kzhp3****

resourcePath

string

O caminho dos recursos. O ID relativo do recurso. O caminho do recurso contém a localização completa do recurso (recurso pai/recurso filho).

Instance/i-8vbascjthm7kzhp3**** Instance/r-8vbf5abe31c9c4d4/Account/cctest

resourceType

string

O tipo de recurso.

Instance

status

string

O estado da tarefa.\n\nPending\n\nRunning\n\nSucceeded\n\nFailed\n\nCancelling\n\nCancelled.

Valores válidos:

  • Succeeded :

    Bem-sucedido.

  • Failed :

    Falha.

  • Running :

    Em execução.

  • Cancelled :

    Cancelado.

  • Pending :

    Pendente.

  • Cancelling :

    Cancelando.

Succeeded

taskAction

string

O tipo da operação da tarefa. Valores válidos: Create, Update e Delete.

Valores válidos:

  • Delete :

    Excluir.

  • Create :

    Criar.

  • Update :

    Atualizar.

Create

taskId

string

O ID da tarefa.

task-433aead756057fff8189a7ce5****

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "task": {
    "createTime": "2022-10-09T00:46:03Z",
    "error": {
      "code": "OperationFailure.OperationFailed",
      "message": "{\n     \"requestId\": \"123****\",\n     \"errorCode\": \"InvalidRamUser.NoPermission\",\n     \"errorMsg\": \"Ram user is not authorized to perform the operation.\"\n}"
    },
    "product": "ECS",
    "regionId": "cn-beijing",
    "resourceId": "i-8vbascjthm7kzhp3****\n",
    "resourcePath": "Instance/i-8vbascjthm7kzhp3****\nInstance/r-8vbf5abe31c9c4d4/Account/cctest",
    "resourceType": "Instance",
    "status": "Succeeded",
    "taskAction": "Create",
    "taskId": "task-433aead756057fff8189a7ce5****"
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.