Todos os produtos
Search
Central de documentação

ApsaraDB for ClickHouse:DescribeActiveOperationTasks

Última atualização: Jun 28, 2026

Consulta as tarefas de operação ativas de uma instância ClickHouse.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

clickhouse:DescribeActiveOperationTasks

get

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Region

string

Não

O ID da região.

cn-beijing

TaskType

string

Não

O tipo de tarefa. Valores válidos:

  • rds_apsaradb_upgrade: Atualização de versão secundária.

  • all: Todos os tipos de tarefa.

all

PageSize

integer

Não

O número de entradas a serem retornadas em cada página. Valores válidos:

  • 30 (Padrão)

  • 50

  • 100

30

PageNumber

integer

Não

O número da página.

1

ProductId

string

Não

O ID do produto.

clickhouse

DbType

string

Não

O tipo de banco de dados.

clickhouse

Status

integer

Não

O status da tarefa. Este parâmetro é usado para filtrar tarefas.

  • -1: Todas as tarefas.

  • 3: Tarefas a serem processadas.

  • 4: Tarefas em andamento.

  • 5: Tarefas concluídas com sucesso.

  • 6: Tarefas com falha.

  • 7: Tarefas canceladas.

-1

InsName

string

Não

O nome da instância.

cc-bp191w*******

AllowChange

integer

Não

Especifica se o horário pode ser alterado. Valores válidos:

  • 0: O horário não pode ser alterado.

  • 1: O horário pode ser alterado.

-1

AllowCancel

integer

Não

Especifica se a tarefa pode ser cancelada. Valores válidos:

  • 0: A tarefa não pode ser cancelada.

  • 1: A tarefa pode ser cancelada.

-1

ChangeLevel

string

Não

O nível da tarefa. Valores válidos:

  • all (Padrão): Todos os níveis.

  • S0: Retorna tarefas para correção de exceções.

  • S1: Retorna tarefas para O&M do sistema.

all

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

PageNumber

integer

O número da página.

1

RequestId

string

O ID da solicitação.

F5178C10-1407-4987-9133-DE4DC9119F76

PageSize

integer

O número de entradas retornadas por página. Valores válidos:

  • 30 (Padrão)

  • 50

  • 100

30

TotalRecordCount

integer

O número total de registros.

1

Items

array<object>

A lista de tarefas de O&M.

object

A lista de tarefas de O&M.

Status

integer

O status de execução da tarefa. Valores de retorno:

  • 2: Aguardando o usuário especificar um horário.

  • 3: A ser processada.

  • 4: Em andamento.

  • 5: Bem-sucedida.

  • 6: Com falha.

  • 7: Cancelada.

2

ChangeLevelEn

string

O nome em inglês do nível de alteração.

S1

TaskType

string

O tipo de tarefa do evento de O&M.

rds_apsaradb_upgrade

InsName

string

O nome da instância.

cc-bp191w*******

Region

string

O ID da região.

cn-beijing

ImpactZh

string

O impacto no negócio em chinês.

实例闪断。

CreatedTime

string

O horário de criação. O horário está no formato UTC (YYYY-MM-DDTHH:mm:ssZ).

2018-05-30T14:30:00Z

SwitchTime

string

O horário em que o backend inicia o switchover. O horário está no formato UTC (YYYY-MM-DDTHH:mm:ssZ).

2018-05-30T14:30:00Z

ChangeLevelZh

string

O nível do evento em chinês.

系统运维

Deadline

string

O horário limite para o qual o horário de execução da tarefa pode ser ajustado. O horário está no formato UTC (YYYY-MM-DDTHH:mm:ssZ).

2018-05-30T23:59:59Z

PrepareInterval

string

O tempo de preparação necessário entre o horário de início e o horário do switchover. O formato é HH:mm:ss.

04:00:00

Impact

string

O impacto do evento.

TransientDisconnection

TaskTypeZh

string

O motivo da tarefa em chinês.

小版本升级

CurrentAVZ

string

A zona de disponibilidade atual.

cn-beijing-h

AllowChange

string

Indica se o horário pode ser alterado. Valores de retorno:

  • -1: Todos

  • 0: Não

  • 1: Sim

-1

DbVersion

string

A versão do kernel do cluster.

23.8

ImpactEn

string

O impacto do evento em inglês.

Transient instance disconnection

InsComment

string

A descrição da instância.

test

StartTime

string

O horário em que o backend executa a tarefa. O horário está no formato UTC (YYYY-MM-DDTHH:mm:ssZ).

2025-04-22T01:06Z

ModifiedTime

string

O horário de modificação. O horário está no formato UTC (YYYY-MM-DDTHH:mm:ssZ).

2023-11-15T06:17:54Z

AllowCancel

string

Indica se a tarefa pode ser cancelada. Valores de retorno:

  • -1: Todos

  • 0: Não

  • 1: Sim

-1

DbType

string

O tipo de banco de dados.

clickhouse

ChangeLevel

string

O código do nível do evento.

  • S1: O&M do sistema.

  • S0: Correção de ameaças.

S1

TaskTypeEn

string

O tipo de tarefa em inglês.

Minor version update

ResultInfo

string

A descrição do resultado da execução.

userCancel

Id

integer

O ID da tarefa.

11

SubInsNames

array

Os IDs das subinstâncias.

string

O ID de uma subinstância.

1

TaskParams

string

Os parâmetros do evento de O&M.

{ "Action": "UpgradeDBInstance" }

Exemplos

Resposta de sucesso

JSON formato

{
  "PageNumber": 1,
  "RequestId": "F5178C10-1407-4987-9133-DE4DC9119F76",
  "PageSize": 30,
  "TotalRecordCount": 1,
  "Items": [
    {
      "Status": 2,
      "ChangeLevelEn": "S1",
      "TaskType": "rds_apsaradb_upgrade",
      "InsName": "cc-bp191w*******\n",
      "Region": "cn-beijing",
      "ImpactZh": "实例闪断。",
      "CreatedTime": "2018-05-30T14:30:00Z\n",
      "SwitchTime": "2018-05-30T14:30:00Z\n",
      "ChangeLevelZh": "系统运维\n",
      "Deadline": "2018-05-30T23:59:59Z\n",
      "PrepareInterval": "04:00:00\n",
      "Impact": "TransientDisconnection\n",
      "TaskTypeZh": "小版本升级\n",
      "CurrentAVZ": "cn-beijing-h\n",
      "AllowChange": "-1",
      "DbVersion": "23.8",
      "ImpactEn": "Transient instance disconnection\n",
      "InsComment": "test",
      "StartTime": "2025-04-22T01:06Z",
      "ModifiedTime": "2023-11-15T06:17:54Z",
      "AllowCancel": "-1",
      "DbType": "clickhouse",
      "ChangeLevel": "S1",
      "TaskTypeEn": "Minor version update\n",
      "ResultInfo": "userCancel",
      "Id": 11,
      "SubInsNames": [
        "1"
      ],
      "TaskParams": "{\n      \"Action\": \"UpgradeDBInstance\"\n}"
    }
  ]
}

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.