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

Obtém uma lista de informações de imagens.

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

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Criteria	string	Não	Define as condições para pesquisar ativos. Este parâmetro está no formato JSON e contém os seguintes campos: name: O item de pesquisa. value: O valor do item de pesquisa. logicalExp: A relação lógica entre múltiplos valores de itens de pesquisa. Valores válidos: OR: Os múltiplos valores de itens de pesquisa estão em uma relação OR. AND: Os múltiplos valores de itens de pesquisa estão em uma relação AND. Nota Você pode chamar a operação DescribeImageRepoCriteria para consultar as condições de pesquisa suportadas.	[{"name":"instanceId","value":"390100182","logicalExp":"AND"}]
LogicalExp	string	Não	Define a relação lógica entre múltiplas condições de pesquisa. Valores válidos: OR: As múltiplas condições de pesquisa estão em uma relação OR. AND: As múltiplas condições de pesquisa estão em uma relação AND.	OR
PageSize	integer	Não	O número máximo de entradas a serem retornadas em cada página durante uma consulta paginada. O número padrão de entradas por página é 20. Se o parâmetro PageSize for deixado vazio, 20 entradas serão retornadas por padrão. Nota Recomendamos que você não deixe o parâmetro PageSize vazio.	20
CurrentPage	integer	Não	O número da página dos resultados retornados a partir da qual a exibição será iniciada. O valor inicial é 1. Valor padrão: 1, que indica que a página 1 é exibida.	1
Scanned	boolean	Não	Indica se a imagem foi verificada. Valores válidos: true: processada. false: não processada.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados de resposta.
RequestId	string	O ID da solicitação, que é um identificador único gerado pelo Alibaba Cloud para a solicitação. Você pode usar o ID para solucionar problemas.	BE120DAB-F4E7-4C53-ADC3-A97578ABF384
PageInfo	object	As informações de paginação do resultado da consulta.
CurrentPage	integer	O número da página atual na consulta paginada.	1
PageSize	integer	O número de entradas de informações de imagem exibidas em cada página na consulta paginada.	20
TotalCount	integer	O número total de imagens.	69
Count	integer	O número de imagens exibidas na página atual dos resultados retornados.	4
ImageInstanceList	array<object>	A lista de informações de imagens.
	object	As informações da imagem.
Status	string	O status da imagem. Valores válidos: NORMAL: normal.	NORMAL
Digest	string	O valor de digest da imagem.	a5ccdd9b166b67e02954aa9b618fe19b7968bd56a15463d2ad7f2643ba5b****
RegistryType	string	O tipo de registro da imagem. Valores válidos: acr: ACR. harbor: Harbor. quay: Quay. CI/CD: tipo de repositório CI/CD.	acr
Tag	string	A tag da imagem.	mysql_5.7
ImageUpdate	string	O timestamp de quando a imagem foi atualizada. Unidade: milissegundos.	1600069948849
RepoType	string	O tipo de repositório. Valores válidos: private: repositório privado. public: repositório público.	private
ImageSize	string	O tamanho da imagem. Unidade: MB.	1604487690
HcStatus	string	O status de risco de baseline. Valores válidos: NO: não existe risco de baseline. YES: existe risco de baseline.	NO
VulCount	integer	O número de vulnerabilidades na imagem.	0
ImageId	string	O ID da imagem.	c20987f18b130f9d144c9828df630417e2a9523148930dc3963e9d0dab30****
Endpoints	string	Os endereços de endpoint do recurso de imagem.	[]
RiskStatus	string	Indica se existe um risco. Valores válidos: NO: sem risco. YES: existe risco.	NO
ImageCreate	string	O timestamp de quando a imagem foi criada. Unidade: milissegundos.	1600069948849
VulStatus	string	Indica se existem vulnerabilidades na imagem. Valores válidos: YES: existem vulnerabilidades. NO: não existem vulnerabilidades.	NO
AlarmStatus	string	Indica se existem alertas de segurança para a imagem. Valores válidos: YES: existem alertas de segurança. NO: não existem alertas de segurança.	NO
ScaProgress	integer	O progresso da verificação da imagem. Intervalo de valores: 0 a 100.	100
InstanceId	string	O ID da instância do ativo de imagem.	39010****
RegionId	string	O ID da região onde a imagem está localizada.	cn-hangzhou
ScaStatus	string	O status de verificação da imagem. Valores válidos: INIT: verificação da imagem pendente. START: verificação da imagem iniciada. MESSAGE_SEND: mensagem de verificação da imagem enviada. START_RUN: tarefa de análise da imagem iniciada. DOWNLOAD: download da verificação da imagem concluído. PRE_ANALYZER: pré-análise da imagem iniciada. WEB_SHELL_ANALYZER: análise de WebShell da imagem concluída. CVE_ANALYZER: análise de CVE da imagem concluída. BIN_ANALYZER: análise binária da imagem concluída. OTHER_ANALYZER: análise estendida da imagem concluída. SUCCESS: verificação da imagem concluída. PRE_ANALYZER_SUCCESS: pré-análise da imagem concluída. FAIL: verificação da imagem falhou. TIMEOUT: verificação da imagem expirou.	SUCCESS
Uuid	string	O UUID do servidor.	12f80307-60aa-4efa-863a-56d72fb****
RepoId	string	O ID do repositório de imagens.	f2b86d20bf0855af6aa268ce90fd****
HcCount	integer	O número de riscos de baseline.	0
ScaResult	string	O código de erro do resultado da verificação da imagem. Valores válidos: TASK_NOT_EXISTS: a tarefa não existe. TASK_NOT_SUPPORT_REGION: a tarefa não suporta a região. forbid_create_repeat_task: tarefas repetidas não são permitidas.	TASK_NOT_SUPPORT_REGION
RepoName	string	O nome do repositório de imagens.	sas-script-test
AlarmCount	integer	O número de alertas de segurança para a imagem.	0
RepoNamespace	string	O namespace do repositório de imagens.	N/A
Deployed	integer	Indica se a imagem foi implantada. Valores válidos: 0: não implantada. 1: implantada.	1
LastScanTime	integer	O timestamp da verificação mais recente. Unidade: milissegundos.	1721363159000
SourceBizTag	string	A tag de negócio da imagem.	PAI

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "BE120DAB-F4E7-4C53-ADC3-A97578ABF384",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 69,
    "Count": 4
  },
  "ImageInstanceList": [
    {
      "Status": "NORMAL",
      "Digest": "a5ccdd9b166b67e02954aa9b618fe19b7968bd56a15463d2ad7f2643ba5b****",
      "RegistryType": "acr",
      "Tag": "mysql_5.7",
      "ImageUpdate": "1600069948849",
      "RepoType": "private",
      "ImageSize": "1604487690",
      "HcStatus": "NO",
      "VulCount": 0,
      "ImageId": "c20987f18b130f9d144c9828df630417e2a9523148930dc3963e9d0dab30****",
      "Endpoints": "[]",
      "RiskStatus": "NO",
      "ImageCreate": "1600069948849",
      "VulStatus": "NO",
      "AlarmStatus": "NO",
      "ScaProgress": 100,
      "InstanceId": "39010****",
      "RegionId": "cn-hangzhou",
      "ScaStatus": "SUCCESS",
      "Uuid": "12f80307-60aa-4efa-863a-56d72fb****",
      "RepoId": "f2b86d20bf0855af6aa268ce90fd****",
      "HcCount": 0,
      "ScaResult": "TASK_NOT_SUPPORT_REGION",
      "RepoName": "sas-script-test",
      "AlarmCount": 0,
      "RepoNamespace": "N/A",
      "Deployed": 1,
      "LastScanTime": 1721363159000,
      "SourceBizTag": "PAI"
    }
  ]
}

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.