DescribeUuidsByVulNames - Security Center: Central de Documentação do Alibaba Cloud

Obtém a lista de servidores que suportam a correção de vulnerabilidades com base nos nomes das vulnerabilidades.

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

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Lang	string	Não	O tipo de idioma para as mensagens de solicitação e resposta. Valor padrão: zh. Valores válidos: zh: Chinês en: Inglês	zh
Type	string	Sim	O tipo de vulnerabilidade a ser consultado. Valores válidos: cve: Vulnerabilidade de software Linux sys: Vulnerabilidade de sistema Windows	cve
StatusList	string	Não	O status de correção da vulnerabilidade. Separe vários status com vírgulas (,). Valores válidos: 1: Não corrigida. 2: Falha na correção.	1,2
Tag	string	Não	A tag da vulnerabilidade.	oval
Level	string	Não	O nível de gravidade da vulnerabilidade. Separe vários níveis com vírgulas (,). Valores válidos: high: Alto. medium: Médio. low: Baixo.	high,low
Dealed	string	Não	Especifica se a vulnerabilidade foi tratada. Valores válidos: y: Tratada. n: Não tratada.	n
GroupId	integer	Não	O ID do grupo de ativos.	11286014
VpcInstanceIds	string	Não	Os IDs das instâncias conectadas à VPC para consultar vulnerabilidades. Separe vários IDs de instância com vírgulas (,).	vpc-uf6ssrvbrwe37ekw**,vpc-bp1aevy8sofi8mh1q**
Remark	string	Não	As informações do ativo para a consulta de vulnerabilidade. Você pode definir este parâmetro como o nome do ativo, o endereço IP público ou o endereço IP privado. Há suporte para correspondência aproximada.	10.7.
SearchTags	string	Não	A tag para consulta de vulnerabilidades.	oval
FieldName	string	Não	O nome do campo de pesquisa do contêiner.	namespace
FieldValue	string	Não	O valor do campo de pesquisa do contêiner.	cas-adad-qeqwe
TargetType	string	Não	O tipo de consulta. Valores válidos: containerId: ID do contêiner uuid: ID do ativo	uuid
Necessity	string	Não	O nível de prioridade de correção de vulnerabilidade a ser consultado. Separe vários níveis com vírgulas (,). Valores válidos: asap: Alto. later: Médio. nntf: Baixo.	asap,later,nntf
VulNames	array	Sim	A coleção de nomes de vulnerabilidades. Nota Você pode chamar a operação DescribeGroupedVul para obter este parâmetro.
	string	Não	O nome da vulnerabilidade.	centos:8:rhsa-2020:1665
ResourceDirectoryAccountId	integer	Não	O ID da conta Alibaba Cloud das contas membro no diretório de recursos. Nota Você pode chamar 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 usá-lo para solucionar problemas.	97286A-4A6B-4A4-95FA-EC7E3E2451
MachineInfoStatistics	array<object>	A lista de informações estatísticas de ativos.
	object	As informações estatísticas do ativo.
Uuid	string	O UUID do servidor.	18375c64-eaa2-4702-92b0-4ee7******
MachineIp	string	O endereço IP do servidor.	192.168.XX.XX
Os	string	O nome do sistema operacional do servidor.	windows
MachineName	string	O nome do servidor.	TestMachine
MachineInstanceId	string	O ID da instância do servidor.	i-wz9gd1os5talju****
RegionId	string	O ID da região da instância.	cn-hangzhou
InternetIp	string	O endereço IP público da instância associada.	47.98.XX.XX
IntranetIp	string	O endereço IP privado da instância associada.	172.18.XX.XX
VulCount	integer	O número total de vulnerabilidades no servidor.	2

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "97286A-4A6B-4A4-95FA-EC7E3E2451",
  "MachineInfoStatistics": [
    {
      "Uuid": "18375c64-eaa2-4702-92b0-4ee7******",
      "MachineIp": "192.168.XX.XX",
      "Os": "windows",
      "MachineName": "TestMachine",
      "MachineInstanceId": "i-wz9gd1os5talju****",
      "RegionId": "cn-hangzhou",
      "InternetIp": "47.98.XX.XX",
      "IntranetIp": "172.18.XX.XX"
    }
  ],
  "VulCount": 2
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
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.