Consulta uma lista de tarefas no centro de tarefas.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
dds:DescribeHistoryTasks |
list |
*Instance
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Não |
O ID da região do evento pendente. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. |
cn-beijing |
| PageSize |
integer |
Não |
O número de entradas por página. Valores válidos: 10 a 100. Valor padrão: 10. |
10 |
| PageNumber |
integer |
Não |
O número da página a ser retornada. O valor deve ser um inteiro positivo. Valor padrão: 1. |
1 |
| InstanceType |
string |
Não |
O tipo de instância da instância. Defina o valor como Instance. |
Instance |
| Status |
string |
Não |
O status da tarefa. Valores válidos:
Separe múltiplos estados com vírgulas (,). Este parâmetro é vazio por padrão, o que indica que tarefas em todos os estados são consultadas. |
Succeed,Running,Waiting |
| InstanceId |
string |
Não |
O ID da instância. Separe múltiplos IDs de instância com vírgulas (,). Você pode especificar até 30 IDs de instância. Este parâmetro é vazio por padrão, o que indica que tarefas de todas as instâncias são consultadas. |
dds-8vb38f0e7933xxxx |
| TaskId |
string |
Não |
O ID da tarefa. Separe múltiplos IDs de tarefa com vírgulas (,). Você pode especificar até 30 IDs de tarefa. Este parâmetro é vazio por padrão, o que indica que todas as tarefas são consultadas. |
t-0mq1yyhm3ffl2bxxxx |
| TaskType |
string |
Não |
O tipo de tarefa. Este parâmetro é deixado vazio por padrão, o que indica que todos os tipos de tarefas são consultados. Valores válidos:
|
DeleteInsNode |
| FromStartTime |
string |
Sim |
A hora de início da tarefa de O&M a ser realizada. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Você pode consultar dados dos últimos 30 dias. |
2023-03-15T03:41:26Z |
| ToStartTime |
string |
Sim |
A hora de término da tarefa de O&M a ser realizada. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Você pode consultar dados dos últimos 30 dias. |
2023-03-16T07:21:31Z |
| FromExecTime |
integer |
Não |
A duração mínima de execução da tarefa. Este parâmetro é usado para filtrar tarefas cuja duração de execução é maior que a duração mínima de execução. Unidade: segundos. O valor padrão é 0, o que indica que nenhum limite é imposto para a consulta. |
0 |
| ToExecTime |
integer |
Não |
A duração máxima de execução da tarefa. Este parâmetro é usado para filtrar tarefas cuja duração de execução é menor ou igual à duração máxima de execução. Unidade: segundos. O valor padrão é 0, o que indica que nenhum limite é imposto para a consulta. |
0 |
| ResourceGroupId |
string |
Não |
O ID do grupo de recursos. |
rg-aek2inrfrnw3xby |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| PageNumber |
integer |
O número da página retornada. |
1 |
| RequestId |
string |
O ID da solicitação. |
3C4A2494-XXXX-XXXX-93CF-548DB3375193 |
| PageSize |
integer |
O número máximo de entradas retornadas por página. |
10 |
| TotalCount |
integer |
O número total de tarefas que atendem a essas condições sem considerar a paginação. |
5 |
| Items |
array<object> |
Os objetos de tarefa. |
|
|
object |
|||
| Status |
string |
O status da tarefa. Valores válidos:
|
Succeed |
| TaskId |
string |
O ID da tarefa. |
t-0mq1yyhm3ffl2bxxxx |
| CurrentStepName |
string |
O nome da etapa atual. Se este parâmetro for deixado vazio, a tarefa não foi iniciada. |
exec_task |
| StartTime |
string |
A hora de início da tarefa de O&M realizada. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC. |
2023-02-11T02:33Z |
| EndTime |
string |
A hora de término da tarefa de O&M realizada. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC. |
2023-03-16T02:59Z |
| TaskType |
string |
O tipo de tarefa.
|
CreateIns |
| RemainTime |
integer |
O tempo estimado restante de execução. Unidade: segundos. O valor 0 indica que a tarefa foi concluída. |
1000 |
| Progress |
number |
O progresso atual da tarefa. Os valores válidos variam de 0 a 100. |
100.0 |
| RegionId |
string |
O ID da região da instância. |
cn-hangzhou |
| InstanceType |
string |
O tipo de instância da instância. O valor é fixo como Instance. |
Instance |
| InstanceId |
string |
O ID da instância. |
dds-t4n18194768fxxxx |
| InstanceName |
string |
O nome da instância. |
test-dds |
| DbType |
string |
O tipo de banco de dados. O valor é fixo como mongodb. |
mongodb |
| Product |
string |
O produto. O valor é fixo como dds. |
dds |
| TaskDetail |
string |
Os detalhes da tarefa. Os detalhes da tarefa variam com base no valor do parâmetro taskType. |
{\"callerUid\":\"test\"} |
| ReasonCode |
string |
O motivo pelo qual a tarefa atual foi iniciada. |
Minor version upgrade |
| ActionInfo |
string |
Um conjunto de ações permitidas que podem ser executadas na tarefa. O sistema faz a correspondência do nome da etapa atual e do status da tarefa com as ações disponíveis especificadas por ActionInfo. Se nenhuma ação correspondente for encontrada, o status atual da tarefa não suporta nenhuma ação. Exemplo:
O sistema pode suportar as seguintes ações:
|
`{\"steps\":[{\"action_info\":{\"Waiting\":[\"modifySwitchTime\"]},\"step_name\":\"exec_task\"}]}` |
| Uid |
string |
O ID do usuário ao qual o recurso pertence. |
141345906006**** |
| CallerSource |
string |
A origem da solicitação. Valores válidos: System e User. |
System |
| CallerUid |
string |
O ID do usuário que fez a solicitação. Se CallerSource estiver definido como User, CallerUid indica o ID exclusivo (UID) do usuário. |
141345906006**** |
Exemplos
Resposta de sucesso
JSON formato
{
"PageNumber": 1,
"RequestId": "3C4A2494-XXXX-XXXX-93CF-548DB3375193",
"PageSize": 10,
"TotalCount": 5,
"Items": [
{
"Status": "Succeed",
"TaskId": "t-0mq1yyhm3ffl2bxxxx",
"CurrentStepName": "exec_task",
"StartTime": "2023-02-11T02:33Z",
"EndTime": "2023-03-16T02:59Z",
"TaskType": "CreateIns",
"RemainTime": 1000,
"Progress": 100,
"RegionId": "cn-hangzhou",
"InstanceType": "Instance",
"InstanceId": "dds-t4n18194768fxxxx",
"InstanceName": "test-dds",
"DbType": "mongodb",
"Product": "dds",
"TaskDetail": "{\\\"callerUid\\\":\\\"test\\\"}",
"ReasonCode": "Minor version upgrade",
"ActionInfo": "`{\\\"steps\\\":[{\\\"action_info\\\":{\\\"Waiting\\\":[\\\"modifySwitchTime\\\"]},\\\"step_name\\\":\\\"exec_task\\\"}]}`",
"Uid": "141345906006****",
"CallerSource": "System",
"CallerUid": "141345906006****"
}
]
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | Param.Invalid | Param invalid | |
| 400 | Param.Invalid.TimeEndBeforeStart | Param invalid. End time before start time |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.