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

Obtém a lista de ativos que contêm um tipo específico de arquivo sensível detectado pelo recurso de detecção sem agente.

Descrição da operação

Somente contas Alibaba Cloud que ativaram o método de cobrança pay-as-you-go para o recurso de detecção sem agente do Security Center podem chamar esta operação.

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

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
SensitiveFileKey	string	Não	O tipo do arquivo sensível.	sshpasswd
Status	string	Não	O status de correção do risco de baseline. Valores válidos: 0: não corrigido 1: corrigido.	0
InstanceId	string	Não	O ID da instância do ativo a ser consultado. Você pode obter esse valor em Gerenciamento de Nós > Detalhes > Objetos de Detecção.	i-bp1fu4aqltf1huhc****
Remark	string	Não	O nome do ativo ou endereço IP.	1.2.XX.XX
PageSize	integer	Não	O número máximo de entradas por página em uma consulta paginada. Valor padrão: 20. Se você deixar este parâmetro vazio, 20 entradas serão retornadas por página. Nota Não deixe PageSize vazio.	50
CurrentPage	integer	Não	O número da página a ser retornada. Valor padrão: 1.	1
ScanRange	array	Não	A coleção de intervalos de varredura.
	string	Não	O intervalo de varredura. Valores válidos: agentless_image: imagem do host. agentless_snapshot: snapshot do host. ecs_image: imagem personalizada. ecs_snapshot: snapshot do usuário.	agentless_image
ImageUuid	string	Não	O UUID do ativo a ser verificado. Você pode obter esse valor na página Ativos de Host e Produtos em Nuvem. Em cenários de detecção de segurança de host, este parâmetro especifica o UUID do host a ser verificado. Em cenários de detecção de segurança de snapshot e detecção de segurança de imagem personalizada, este parâmetro especifica o ID da imagem ou do snapshot a ser verificado.	06293273b67d19516cfcc712194f****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Schema da resposta.
RequestId	string	O ID da solicitação, que é um identificador único gerado pelo Alibaba Cloud para a solicitação. Você pode usar este ID para solucionar problemas.	FBBEB173-1F43-505F-A876-C03ECDF6CE4C
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 entradas por página em uma consulta paginada.	20
TotalCount	integer	O número total de entradas retornadas.	100
Count	integer	O número total de entradas na página atual em uma consulta paginada.	20
SensitiveFileList	array<object>	As informações de arquivos sensíveis detectados pelo recurso de detecção sem agente.
	object	As informações de arquivos sensíveis detectados pelo recurso de detecção sem agente.
SensitiveFileKey	string	O tipo do arquivo sensível.	pem
RiskLevel	string	O nível de risco. Valores válidos: high: risco alto. medium: risco médio. low: risco baixo.	high
InternetIp	string	O endereço IP público do ativo detectado pelo recurso de detecção sem agente.	95.214.XX.XX
IntranetIp	string	O endereço IP privado do ativo detectado pelo recurso de detecção sem agente.	10.68.XX.XX
Uuid	string	O UUID do ativo detectado pelo recurso de detecção sem agente.	73e6a851-e63b-49ef-9d7a-5542d765****
TargetName	string	O nome do alvo de varredura do recurso de detecção sem agente.	SAS_Agentless_171869952****
Status	integer	O status do arquivo sensível. Valores válidos: 0: não tratado. 1: ignorado. 2: falso positivo.	0
InstanceName	string	O nome da instância do ativo detectado pelo recurso de detecção sem agente.	test-server
FirstScanTime	integer	O timestamp da primeira varredura. Unidade: milissegundos.	1663321552000
LastScanTime	integer	O timestamp da varredura mais recente. Unidade: milissegundos.	1663691592000
Md5	string	O hash MD5 do arquivo sensível.	b484b0dff093f358897486b58266****
FilePath	string	O caminho do arquivo sensível.	/usr/lib/abc.txt
Prompt	string	O conteúdo do arquivo sensível.	mysql -u -p****
Id	integer	O ID do alerta de arquivo sensível.	423505573
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true: bem-sucedida. false: falhou.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "FBBEB173-1F43-505F-A876-C03ECDF6CE4C",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 20
  },
  "SensitiveFileList": [
    {
      "SensitiveFileKey": "pem",
      "RiskLevel": "high",
      "InternetIp": "95.214.XX.XX",
      "IntranetIp": "10.68.XX.XX",
      "Uuid": "73e6a851-e63b-49ef-9d7a-5542d765****",
      "TargetName": "SAS_Agentless_171869952****",
      "Status": 0,
      "InstanceName": "test-server",
      "FirstScanTime": 1663321552000,
      "LastScanTime": 1663691592000,
      "Md5": "b484b0dff093f358897486b58266****",
      "FilePath": "/usr/lib/abc.txt",
      "Prompt": "mysql -u -p****",
      "Id": 423505573
    }
  ],
  "Success": true
}

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.