Todos os produtos
Search

Este produto

    Security Center:DescribeCriteria

    Central de documentação

    Security Center:DescribeCriteria

    Última atualização: Sep 17, 2026

    Consulta as condições de correspondência aproximada para propriedades de ativos que podem ser exibidas ao consultar ativos.

    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:DescribeCriteria

    get

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    MachineTypes

    string

    Não

    O tipo de ativo a ser consultado. Valores válidos:

    • ecs: consulta todos os servidores ECS.

    ecs
    Value

    string

    Não

    O valor de correspondência aproximada inserido ao consultar ativos.

    47.96
    SupportAutoTag

    boolean

    Não

    Especifica se o campo de consulta aproximada suporta correspondência automática. Valor padrão: false. Valores válidos:

    • true: Suportado.

    • false: Não suportado.

    true
    ResourceDirectoryAccountId

    integer

    Não

    O ID da conta Alibaba Cloud das contas de membro no diretório de recursos.

    Nota

    Invoque a operação DescribeMonitorAccounts para obter este parâmetro.

    127608589417****

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    RequestId

    string

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

    8E6DDACF-99AF-5939-AFFD-FCCD3B01E724
    CriteriaList

    array<object>

    A lista de condições de consulta de ativos.

    object

    As informações da condição de consulta de ativos.

    Type

    string

    O tipo da condição de consulta. Valores válidos:

    • input: Você deve inserir manualmente o campo de consulta.

    • select: Você deve selecionar um subtipo da condição de consulta na lista suspensa.

    input
    Name

    string

    O nome da condição de consulta.

    • internetIp: endereço IP público.

    • intranetIp: endereço IP privado.

    • instanceName: nome da instância.

    • instanceId: ID da instância.

    • machineType: tipo de instância.

    • clusterIdList: lista de IDs de cluster.

    • vpcInstanceId: ID da VPC.

    • osName: sistema operacional.

    • osType: tipo de sistema.

    • hcStatus: se existem problemas de linha de base.

    • vulStatus: se existem problemas de vulnerabilidade.

    • asapVulStatus: se existem vulnerabilidades de alta prioridade.

    • alarmStatus: se existem alertas de segurança.

    • riskStatus: se existem riscos.

    • clientStatus: se o cliente está online.

    • clientSubStatus: substatus do cliente.

    • runningStatus: status de execução.

    • tagName: nome da tag.

    • vendorAuthAlias: alias da conta autorizada.

    • vendorUid: ID da conta autorizada.

    • vendorUserName: nome da conta autorizada.

    • namespace: namespace.

    • appName: nome do aplicativo.

    • groupName: nome do grupo.

    • regionId: região.

    • groupId: ID do grupo.

    • newInstance: se o ativo foi adicionado recentemente.

    • containerStatus: se existem contêineres.

    • importance: importância do ativo.

    • exposedStatus: se o servidor está exposto.

    • clusterId: ID do cluster.

    • authVersion: versão da autorização.

    • flag: provedor de nuvem.

    • ipList: lista de IPs.

    • uuidList: UUID.

    • aiStatus: se existem componentes de IA.

    • tagKeyValue: tag do ECS.

    • ecsType: tipo de servidor.

    • alisecguardStatus: status de autoproteção.

    • alihipsStatus: status do AliHips.

    • alinetStatus: status do AliNet.

    • alidetectStatus: status do mecanismo de endpoint.

    • yundunMonitorStatus: status do componente de coleta de informações.

    • clusterNodeStatus: se o ativo é um nó de cluster.

    internetIp
    Values

    string

    Os valores específicos de propriedade do ativo que correspondem ao valor de correspondência aproximada.

    Nota

    • Quando Name for machineType, os valores válidos são:

    Nota

    • 38: Elastic Container Instance.

    • 51: Instância de contêiner RunD.

    • 52: Instância de contêiner RunC.

    • Quando Name for osType, os valores válidos são:

    Nota

    • linux: Linux.

    • windows: Windows.

    • Quando Name for hcStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • Quando Name for vulStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • Quando Name for asapVulStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • Quando Name for alarmStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • Quando Name for riskStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • UNKNOWN: Desconhecido.

    • Quando Name for clientStatus, os valores válidos são:

    Nota

    • online: Online.

    • offline: Offline.

    • pause: Proteção pausada.

    • Quando Name for clientSubStatus, os valores válidos são:

    Nota

    • online: Online.

    • offline: Offline.

    • pause: Proteção pausada.

    • stopped: Desligado.

    • uninstalled: Não instalado.

    • Quando Name for runningStatus, os valores válidos são:

    Nota

    • Running: Em execução.

    • notRunning: Desligado.

    • UNKNOWN: Desconhecido.

    • Quando Name for importance, os valores válidos são:

    Nota

    • important: Importante.

    • general: Geral.

    • test: Teste.

    • Quando Name for containerStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • Quando Name for exposedStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • Quando Name for authVersion, os valores válidos são:

    Nota

    • 1: Edição Gratuita.

    • 3: Edição Empresarial.

    • 5: Edição Premium.

    • 6: Edição Antivírus.

    • 7: Edição Ultimate.

    • Quando Name for flag, os valores válidos são:

    Nota

    • 0|8|15: Alibaba Cloud.

    • 1: Servidor não nuvem.

    • 2: IDC.

    • 3: Tencent Cloud.

    • 4: Huawei Cloud.

    • 5: Azure.

    • 7: AWS.

    • 9: SAE.

    • 10: PAI.

    • 13: ACS.

    • 14: Volcengine.

    • 16: Google Cloud.

    • Quando Name for aiStatus, os valores válidos são:

    Nota

    • NO: Não.

    • YES: Sim.

    • Quando Name for ecsType, os valores válidos são:

    Nota

    • 8: Servidor de aplicativo simples.

    • 11: Lingjun.

    • 15: RDS Custom.

    • !8: Servidor host.

    • Quando Name for alisecguardStatus, os valores válidos são:

    Nota

    • 0: Plugin online.

    • 1: Não ativado.

    • 2: Plugin offline.

    • -99: Falha na instalação.

    • Quando Name for alihipsStatus, os valores válidos são:

    Nota

    • 0: Plugin online.

    • 1: Não ativado.

    • 2: Plugin offline.

    • -99: Falha na instalação.

    • Quando Name for alinetStatus, os valores válidos são:

    Nota

    • 0: Plugin online.

    • 1: Não ativado.

    • 2: Plugin offline.

    • -99: Falha na instalação.

    • Quando Name for alidetectStatus, os valores válidos são:

    Nota

    • 0: Plugin online.

    • 1: Não ativado.

    • 2: Plugin offline.

    • -99: Falha na instalação.

    • Quando Name for yundunMonitorStatus, os valores válidos são:

    Nota

    • 0: Plugin online.

    • 1: Não ativado.

    • 2: Plugin offline.

    • -99: Falha na instalação.

    • Quando Name for clusterNodeStatus, os valores válidos são:

    Nota

    • false: Não.

    • true: Sim.

    47.96.XX.XX
    MultiValues

    string

    Os valores de propriedade estruturados do ativo que correspondem ao valor de correspondência aproximada. O valor está no formato JSON e contém os seguintes campos:

    • vendor: o provedor.

    • regionIds: as regiões suportadas.

    [{"vendor":0,"regionIds":{"default":["ap-southeast-1","ap-northeast-2","ap-southeast-3","ap-southeast-5","ap-southeast-7","me-central-1"]}},{"vendor":1,"regionIds":{"default":["outside-of-aliyun"]}}]

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "8E6DDACF-99AF-5939-AFFD-FCCD3B01E724",
  "CriteriaList": [
    {
      "Type": "input",
      "Name": "internetIp",
      "Values": "47.96.XX.XX",
      "MultiValues": "[{\"vendor\":0,\"regionIds\":{\"default\":[\"ap-southeast-1\",\"ap-northeast-2\",\"ap-southeast-3\",\"ap-southeast-5\",\"ap-southeast-7\",\"me-central-1\"]}},{\"vendor\":1,\"regionIds\":{\"default\":[\"outside-of-aliyun\"]}}]"
    }
  ]
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 NoPermission no permission
    400 RdCheckNoPermission Resource directory account verification has no permission.
    500 ServerError ServerError
    500 RdCheckInnerError Resource directory account service internal error.
    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.