DescribeActiveOperationTasks - PolarDB: Central de Documentação do Alibaba Cloud

Consulta eventos de operação e manutenção para instâncias.

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

polardb:DescribeActiveOperationTasks

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do evento pendente. Nota Você pode chamar a operação DescribeRegions para consultar as regiões disponíveis.	cn-beijing
TaskType	string	Não	O tipo da tarefa de evento pendente. Valores válidos: DatabaseSoftwareUpgrading: atualização de software do banco de dados DatabaseHardwareMaintenance: manutenção e atualização de hardware DatabaseStorageUpgrading: atualização de armazenamento do banco de dados DatabaseProxyUpgrading: atualização de versão secundária do proxy all: retorna todos os tipos de eventos pendentes Nota Quando `Region` é definido como all, `TaskType` também deve ser definido como all.	DatabaseProxyUpgrading
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. O valor deve ser maior que 0 e não pode exceder o valor máximo do tipo de dados Integer. Valor padrão: 1.	1
DBType	string	Não	O tipo de mecanismo de banco de dados. Valores válidos: MySQL PostgreSQL Oracle	MySQL
Status	integer	Não	O status da tarefa. Valores válidos: -1: todas as tarefas. 3: tarefas pendentes. 4: tarefas em andamento. 5: tarefas concluídas com sucesso. 6: tarefas com falha. 7: tarefas canceladas.	-1
DBClusterId	string	Não	O ID do cluster. Nota Você pode chamar a operação DescribeDBClusters para consultar informações detalhadas sobre todos os clusters em sua conta, incluindo IDs de cluster.	pc-3ns***********d5d
AllowChange	integer	Não	Especifica se a modificação de horário é permitida. Valores válidos: -1 (padrão): todos. 0: retorna apenas tarefas que não permitem modificação de horário. 1: retorna apenas tarefas que permitem modificação de horário.	-1
AllowCancel	integer	Não	Especifica se o cancelamento é permitido. Valores válidos: -1 (padrão): todos. 0: retorna apenas tarefas que não permitem cancelamento. 1: retorna apenas tarefas que permitem cancelamento.	-1
ChangeLevel	string	Não	O nível da tarefa. Valores válidos: all (padrão): todos. S0: retorna tarefas no nível de reparo anormal. S1: retorna tarefas no nível de manutenção do sistema.	all

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalRecordCount	integer	O número de registros de tarefas retornados.	1
RequestId	string	O ID da solicitação.	FAF88508-D5F8-52B1-8824-262601769E31
PageSize	integer	O número de entradas retornadas por página. Valores válidos: 30 50 100 Valor padrão: 30.	30
PageNumber	integer	O número da página. O valor deve ser maior que 0 e não pode exceder o valor máximo do tipo de dados Integer. Valor padrão: 1.	1
Items	array<object>	A lista de tarefas de O&M.
	object	A lista de tarefas de O&M.
Status	integer	O status da tarefa. Valores válidos: 0: indica aguardando notificação. 1: indica nova tentativa de notificação. 2: indica aguardando horário especificado pelo usuário. 3: indica aguardando processamento. 4: indica em andamento. 5: indica concluída com sucesso. 6: indica falha. 7: indica cancelada.	3
PrepareInterval	string	O tempo de preparação necessário entre o horário de início e o horário de alternância. Formato: HH:mm:ss.	04:00:00
Deadline	string	O prazo final mais recente para o intervalo ajustável do horário de execução da tarefa. Formato: YYYY-MM-DDTHH:mm:ssZ.	2020-06-11T15:59:59Z
DBType	string	O tipo de mecanismo de banco de dados. Valores válidos: MySQL PostgreSQL Oracle	MySQL
TaskType	string	O tipo da tarefa de evento pendente. Valores válidos: DatabaseSoftwareUpgrading: atualização de software do banco de dados. DatabaseHardwareMaintenance: manutenção e atualização de hardware. DatabaseStorageUpgrading: atualização de armazenamento do banco de dados. DatabaseProxyUpgrading: atualização de versão secundária do proxy. all: retorna todos os tipos de eventos pendentes.	DatabaseSoftwareUpgrading
StartTime	string	O horário em que a tarefa em segundo plano é executada. Formato: YYYY-MM-DDTHH:mm:ssZ.	2023-05-19T02:48:17Z
DBVersion	string	O número da versão do kernel.	8.0
ModifiedTime	string	O horário de modificação. Formato: YYYY-MM-DDTHH:mm:ssZ.	2020-06-09T22:00:42Z
DBClusterId	string	O ID do cluster.	pc-*****************
Region	string	O código da região.	cn-hangzhou
ResultInfo	string	As informações do resultado da execução.	userCancel
CreatedTime	string	O horário de criação. Formato: YYYY-MM-DDTHH:mm:ssZ.	2020-06-09T22:00:42Z
TaskId	integer	O ID da tarefa.	107202351
SwitchTime	string	O horário em que o sistema em segundo plano inicia a operação de alternância. Formato: YYYY-MM-DDTHH:mm:ssZ.	2020-06-09T22:00:00Z
CurrentAVZ	string	A zona atual.	cn-beijing-h
InsComment	string	O alias ou comentário do cluster.	test
TaskTypeZh	string	O motivo da tarefa em chinês.	小版本升级
TaskTypeEn	string	O motivo da tarefa em inglês.	Minor version update
ChangeLevel	string	O código do nível do evento. Valores válidos: S1: manutenção do sistema. S0: correção de ameaça.	S0
ChangeLevelZh	string	O nível do evento (chinês).	系统运维
ChangeLevelEn	string	O nível do evento (inglês).	System maintenance
ImpactZh	string	O impacto do evento (chinês).	集群闪断
ImpactEn	string	O impacto do evento (inglês).	Transient instance disconnection
AllowChange	integer	Indica se a modificação de horário é permitida. Valores válidos: 1: indica que os usuários podem modificar o horário. 0: indica que os usuários não podem modificar o horário.	0
AllowCancel	integer	Indica se o cancelamento é permitido. Valores válidos: 1: indica que os usuários podem cancelar a tarefa. 0: indica que o cancelamento não é permitido.	0
Impact	string	O impacto do evento.	TransientDisconnection
DBNodeIds	array	A lista de IDs de nós.
	string	O ID do nó. Vários IDs de nós podem ser inseridos, separados por vírgulas (,).	pi-t4n*********0ni,pi-t4n*******334,pi-t4n*******h07,pi-t4n*********q5i
TaskParams	string	Os parâmetros da tarefa.	{ "Action": "UpgradeDBInstance" }

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalRecordCount": 1,
  "RequestId": "FAF88508-D5F8-52B1-8824-262601769E31",
  "PageSize": 30,
  "PageNumber": 1,
  "Items": [
    {
      "Status": 3,
      "PrepareInterval": "04:00:00",
      "Deadline": "2020-06-11T15:59:59Z",
      "DBType": "MySQL",
      "TaskType": "DatabaseSoftwareUpgrading",
      "StartTime": "2023-05-19T02:48:17Z",
      "DBVersion": "8.0",
      "ModifiedTime": "2020-06-09T22:00:42Z",
      "DBClusterId": "pc-*****************",
      "Region": "cn-hangzhou",
      "ResultInfo": "userCancel",
      "CreatedTime": "2020-06-09T22:00:42Z",
      "TaskId": 107202351,
      "SwitchTime": "2020-06-09T22:00:00Z",
      "CurrentAVZ": "cn-beijing-h",
      "InsComment": "test",
      "TaskTypeZh": "小版本升级",
      "TaskTypeEn": "Minor version update",
      "ChangeLevel": "S0",
      "ChangeLevelZh": "系统运维",
      "ChangeLevelEn": "System maintenance",
      "ImpactZh": "集群闪断",
      "ImpactEn": "Transient instance disconnection",
      "AllowChange": 0,
      "AllowCancel": 0,
      "Impact": "TransientDisconnection",
      "DBNodeIds": [
        "pi-t4n***********0ni,pi-t4n***********334,pi-t4n***********h07,pi-t4n***********q5i"
      ],
      "TaskParams": "{\n      \"Action\": \"UpgradeDBInstance\"\n}"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidPageParam.Format	Page param should be a positive integer.	The page value must be a positive integer. Check and modify the value.
400	RequiredParam.NotFound	Required input param is not found.	The specified parameter does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.