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

Obtém instâncias que falharam em um item de verificação de configuração da plataforma de nuvem.

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

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CheckId	integer	Sim	O ID do item de verificação.	23
Statuses	array	Não	A coleção de status do item de verificação.
	string	Não	O status do item de verificação. Valores válidos: PASS: Aprovado. NOT_PASS: Reprovado. CHECKING: Em verificação. NOT_CHECK: Não verificado. WHITELIST: Na lista de permissões. FAILED: Falha.	PASS
InstanceIdKey	string	Não	O ID da instância do item de verificação.	i-uf64w4q6p9jti5gl****
InstanceNameKey	string	Não	O nome da instância do item de verificação.	i-uf64w4q6p9jti5gl****
RegionIdKey	string	Não	O ID da região da instância.	cn-qingdao
CurrentPage	integer	Não	O número da página atual em uma consulta paginada. Este parâmetro é usado para paginação.	1
PageSize	integer	Não	O número máximo de entradas por página em uma consulta paginada. Valor máximo: 100. Este parâmetro é usado para paginação.	20
InstanceIds	array	Não	A coleção de IDs de instâncias de serviço de nuvem a serem consultados.
	string	Não	O ID da instância de serviço de nuvem a ser consultado.	i-uf64w4q6p9jti5gl****
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
SortTypes	array	Não	A lista de tipos de classificação para o item de verificação.
	string	Não	O tipo de classificação do item de verificação. Atualmente, o valor é fixo como STATUS.	STATUS

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A estrutura da resposta.
RequestId	string	O ID da solicitação, que é um identificador exclusivo gerado pela Alibaba Cloud para esta solicitação. Você pode usá-lo para solucionar problemas.	3AB18264-8A1B-52A6-A9AF-A886556E0F2E
BasicData	array<object>	A lista de informações básicas sobre as instâncias afetadas.
	array<object>	As informações básicas sobre uma instância afetada.
Id	integer	O ID do resultado da verificação da instância.	300054
Status	string	A lista de status do item de verificação. Vários status são separados por vírgulas (,). Valores válidos: PASS: Aprovado. NOT_PASS: Reprovado. CHECKING: Em verificação. NOT_CHECK: Não verificado. WHITELIST: Na lista de permissões. FAILED: Falha.	NOT_PASS
RegionId	string	O ID da região da instância.	ap-southeast-1
InstanceId	string	O ID da instância do servidor.	rm-m5es7ch1s62i4****
InstanceName	string	O nome da instância do servidor.	sg-t4nbk2aodzio52xv****
StatusMessage	string	A mensagem de status de exceção do item de verificação.	Falha na tarefa de verificação
InstanceInfo	object	As informações da instância exibidas para o item de verificação correspondente.
FirstUpdateTime	integer	A hora da primeira verificação. O valor é um timestamp UNIX. Unidade: milissegundos.	1716447535531
LastUpdateTime	integer	A hora da última verificação. O valor é um timestamp UNIX. Unidade: milissegundos.	1716447535531
Config	array<object>	As informações atuais da instância exibidas para a configuração de correção correspondente.
	object	A estrutura de informações da instância.
Name	string	O nome exclusivo da configuração correspondente.	prot
Value	string	O valor da configuração correspondente para o ativo atual.	8080
ShowName	string	O nome internacionalizado do item de configuração correspondente.	prot
VendorUserName	string	O nome da conta do fornecedor de multinuvem.	test
Columns	array<object>	Os metadados da lista de exibição de informações das instâncias afetadas.
	array<object>	As informações de metadados da lista de exibição de informações das instâncias afetadas.
Type	string	O tipo de propriedade do resultado da instância de verificação. Valores válidos: text: texto link: link	text
Key	string	A chave da propriedade da lista.	RegionIdShow
ShowName	string	O nome de exibição.	Region
Search	boolean	Indica se a pesquisa é suportada. Valores válidos: true: Suportado. false: Não suportado.	true
SearchKey	string	A chave usada para pesquisa.	InstanceIdKey
Grids	array<object>	A lista de metadados do tipo lista.
	object	Os metadados do tipo lista.
Type	string	O tipo do resultado da instância de verificação. Valores válidos: text: texto link: link	text
Key	string	O valor de pesquisa.	RegionIdShow
ShowName	string	O nome de exibição da pesquisa.	Region
Checks	array<object>	A lista de informações estendidas sobre as instâncias afetadas.	[{ "SecurityGroupNameShow": { "value": "Sas_Malicious_Ip_Security_Group" }, "InstanceIdShow": { "link": "https://ecs.console.alibabacloud.com/#/securityGroupDetail/region/ap-southeast-1/groupId/sg-t4nbk2aodzio52xvj00s/rule/intranetIngress", "value": "sg-t4nbk2aodzio52xv****" } }]
	object	As informações estendidas sobre uma instância afetada.	[{ "SecurityGroupNameShow": { "value": "Sas_Malicious_Ip_Security_Group" }, "InstanceIdShow": { "link": "https://ecs.console.alibabacloud.com/#/securityGroupDetail/region/ap-southeast-1/groupId/sg-t4nbk2aodzio52xvj00s/rule/intranetIngress", "value": "sg-t4nbk2aodzio52xv****" } }]
	any	As informações do item de verificação.	{ "InstanceIdShow": { "link": "https://vpcnext.console.alibabacloud.com/vpc/cn-beijing/vpcs", "value": "ngw-2zenx8j1lf5w8rcdhdqs5" }, "RegionIdShow": { "value": "China (Pequim)" } }
PageInfo	object	As informações de paginação exibidas na página em uma consulta paginada.
CurrentPage	integer	O número da página atual em uma consulta paginada. Este parâmetro é usado para paginação.	1
PageSize	integer	O número máximo de entradas por página em uma consulta paginada. Este parâmetro é usado para paginação.	20
TotalCount	integer	O número total de entradas.	100
Count	string	O número de entradas retornadas na página atual.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "3AB18264-8A1B-52A6-A9AF-A886556E0F2E",
  "BasicData": [
    {
      "Id": 300054,
      "Status": "NOT_PASS",
      "RegionId": "ap-southeast-1",
      "InstanceId": "rm-m5es7ch1s62i4****",
      "InstanceName": "sg-t4nbk2aodzio52xv****",
      "StatusMessage": "检查任务失败。",
      "InstanceInfo": {
        "FirstUpdateTime": 1716447535531,
        "LastUpdateTime": 1716447535531,
        "Config": [
          {
            "Name": "prot",
            "Value": "8080",
            "ShowName": "prot"
          }
        ]
      },
      "VendorUserName": "test"
    }
  ],
  "Columns": [
    {
      "Type": "text",
      "Key": "RegionIdShow",
      "ShowName": "Region",
      "Search": true,
      "SearchKey": "InstanceIdKey",
      "Grids": [
        {
          "Type": "text",
          "Key": "RegionIdShow",
          "ShowName": "Region"
        }
      ]
    }
  ],
  "Checks": [
    {
      "key": "{\n      \"InstanceIdShow\": {\n        \"link\": \"https://vpcnext.console.alibabacloud.com/vpc/cn-beijing/vpcs\",\n        \"value\": \"ngw-2zenx8j1lf5w8rcdhdqs5\"\n      },\n      \"RegionIdShow\": {\n        \"value\": \"China(Beijing)\"\n      }\n    }"
    }
  ],
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": "20"
  }
}

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.