Todos os produtos
Search

Este produto

    Security Center:DescribeOnceTask

    Central de documentação

    Security Center:DescribeOnceTask

    Última atualização: Jun 26, 2026

    Consulta uma lista de tarefas do cliente.

    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

    yundun-sas:DescribeOnceTask

    get

    *全部资源

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    TaskType

    string

    Não

    O tipo de nó. Valores válidos:

    • VUL_CHECK_TASK: nó de verificação de vulnerabilidades

    • CLIENT_PROBLEM_CHECK: nó do cliente

    • CLIENT_DEV_OPS: nó de O&M em nuvem

    • ASSET_SECURITY_CHECK: nó de coleta de informações de ativos

    • ASSET_REFRESH_HOST: nó de sincronização de ativos de host

    Nota

    TaskType e RootTaskId não podem estar ambos vazios.

    CLIENT_PROBLEM_CHECK
    RootTaskId

    string

    Não

    O ID da tarefa raiz.

    Nota

    TaskType e RootTaskId não podem estar ambos vazios.

    bb5d657479bba5e1d308b6c9e85c9174
    StartTimeQuery

    integer

    Não

    O timestamp de início da tarefa raiz. Unidade: milissegundos.

    1651737301000
    EndTimeQuery

    integer

    Não

    O timestamp de término da tarefa raiz. Unidade: milissegundos.

    1651766520000
    CurrentPage

    integer

    Não

    O número da página a ser retornada. Valor padrão: 1, que indica a primeira página.

    1
    PageSize

    integer

    Não

    Configuração do número de tarefas do cliente em cada página em uma consulta paginada. Valor padrão: 20, que indica que cada página contém 20 tarefas do cliente.

    20
    Source

    string

    Não

    A origem do nó. Os valores válidos incluem, mas não se limitam a:

    • schedule: agendamento automático de verificação de vulnerabilidades

    • console: detecção com um clique no console de verificação de vulnerabilidades.

    console
    TaskId

    string

    Não

    O ID da tarefa.

    d7b2acf8d362742123e4a84e1bf8****

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os dados de resposta das tarefas do cliente.

    RequestId

    string

    O ID da solicitação, que é um identificador exclusivo gerado pelo Alibaba Cloud para a solicitação. Você pode usar este ID para solucionar problemas.

    7E0618A9-D5EF-4220-9471-C42B5E92719F
    PageInfo

    object

    As informações de paginação.

    CurrentPage

    integer

    O número da página atual em uma consulta paginada.

    1
    PageSize

    integer

    O número de tarefas do cliente em cada página em uma consulta paginada. Valor padrão: 20, que indica que cada página contém 20 tarefas do cliente.

    20
    TotalCount

    integer

    O número total de tarefas do cliente retornadas.

    100
    Count

    integer

    O número de tarefas do cliente exibidas na página atual em uma consulta paginada.

    2
    TaskManageResponseList

    array<object>

    A lista de resultados da consulta de tarefas do cliente.

    object

    O resultado da consulta de tarefa do cliente.

    TaskType

    string

    O tipo de tarefa. Valores válidos:

    • CLIENT_PROBLEM_CHECK: tarefa do cliente

    • CLIENT_DEV_OPS: tarefa de O&M em nuvem

    • ASSET_SECURITY_CHECK: tarefa de coleta de informações de ativos.

    CLIENT_PROBLEM_CHECK
    Progress

    string

    O progresso da tarefa, em porcentagem.

    10%
    TaskStatus

    integer

    O status da tarefa. Valores válidos:

    • 1: Iniciada.

    • 2: Concluída.

    • 3: Falhou.

    • 4: Tempo esgotado.

    1
    DetailData

    string

    Os detalhes de execução da tarefa. Este parâmetro está no formato JSON.

    • causeCode: o código de retorno da causa da solução de problemas.

    • causeMsg: a mensagem de retorno da causa da solução de problemas.

    • resCode: o código de retorno da solução de problemas.

    • resMsg: a mensagem de retorno da solução de problemas.

    • problemType: o tipo de problema.

    • dispatchType: o método de despacho da tarefa.

    • uuid: o UUID do servidor.

    • instanceId: o ID da instância do servidor.

    • internetIp: o endereço IP público do servidor.

    • intranetIp: o endereço IP privado do servidor.

    • instanceName: o nome da instância do servidor.

    • url: a URL de download do log de solução de problemas.

    [ { "dispatchType": "manual", "causeMsg": [], "causeCode": [], "resCode": [ "1003" ], "resMsg": [ "powershell -executionpolicy bypass -c \"(New-Object Net.WebClient).DownloadFile('http://aegis.alicdn.com/download/aegis_client_self_check/win32/aegis_checker.exe', $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath('.\\\\aegis_checker.exe'))\"; \"./aegis_checker.exe -b eyJtb2RlIjoxLCJqc3J2X2RvbWFpbiI6W10sImlzc3VlIjoib2ZmbGluZSIsInVwZGF0ZV9kb21haW4iOltdLCJ1dWlkIjoiaW5ldC1lYWUwNDg2Ny0wMDJmLTQyM2QtYWYwMC1jNzJjZDYyOWIyNDgiLCJjbWRfaWR4IjoiNDRjZThiZWI3ZGYyYTQxMjQ1NGM4ZDc5OTE1ODI1MzMifQ==\"" ], "problemType": "offline", "uuid": "inet-eae04867-002f-423d-af00-c72cd629****" } ]
    TaskStatusText

    string

    A representação textual do status da tarefa. Valores válidos:

    • INIT: Pendente.

    • START: Iniciada.

    • DISPATCH: Comando de autodiagnóstico despachado.

    • SUCCESS: Autodiagnóstico concluído.

    • FAIL: Falha na execução.

    • TIMEOUT: Tempo esgotado.

    INIT
    TaskName

    string

    O nome da tarefa.

    CLIENT_PROBLEM_CHECK
    TaskStartTime

    integer

    O timestamp de início real da tarefa. Unidade: milissegundos.

    1649732012000
    TaskEndTime

    integer

    O timestamp de término real da tarefa. Unidade: milissegundos.

    1650267989000
    TaskId

    string

    O ID da tarefa.

    e900f528f5a6229bb640ca27cb44c98e
    SuccessCount

    integer

    O número de tarefas executadas com sucesso.

    7
    FailCount

    integer

    O número de tarefas que falharam na execução.

    2
    ResultInfo

    string

    O resultado da execução da tarefa.

    successful

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "7E0618A9-D5EF-4220-9471-C42B5E92719F",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 2
  },
  "TaskManageResponseList": [
    {
      "TaskType": "CLIENT_PROBLEM_CHECK",
      "Progress": "10%",
      "TaskStatus": 1,
      "DetailData": "[\n      {\n            \"dispatchType\": \"manual\",\n            \"causeMsg\": [],\n            \"causeCode\": [],\n            \"resCode\": [\n                  \"1003\"\n            ],\n            \"resMsg\": [\n                  \"powershell -executionpolicy bypass -c \\\"(New-Object Net.WebClient).DownloadFile('http://aegis.alicdn.com/download/aegis_client_self_check/win32/aegis_checker.exe', $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath('.\\\\\\\\aegis_checker.exe'))\\\"; \\\"./aegis_checker.exe -b eyJtb2RlIjoxLCJqc3J2X2RvbWFpbiI6W10sImlzc3VlIjoib2ZmbGluZSIsInVwZGF0ZV9kb21haW4iOltdLCJ1dWlkIjoiaW5ldC1lYWUwNDg2Ny0wMDJmLTQyM2QtYWYwMC1jNzJjZDYyOWIyNDgiLCJjbWRfaWR4IjoiNDRjZThiZWI3ZGYyYTQxMjQ1NGM4ZDc5OTE1ODI1MzMifQ==\\\"\"\n            ],\n            \"problemType\": \"offline\",\n            \"uuid\": \"inet-eae04867-002f-423d-af00-c72cd629****\"\n      }\n]",
      "TaskStatusText": "INIT",
      "TaskName": "CLIENT_PROBLEM_CHECK",
      "TaskStartTime": 1649732012000,
      "TaskEndTime": 1650267989000,
      "TaskId": "e900f528f5a6229bb640ca27cb44c98e",
      "SuccessCount": 7,
      "FailCount": 2,
      "ResultInfo": "successful"
    }
  ]
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    500 ServerError ServerError
    403 NoPermission caller has no permission

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.