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

Consulta as instâncias que falharam em um item de verificação especificado da avaliação de configuraçã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:ListCheckInstanceResult

get

*All Resource

*

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	Os status dos itens de verificação.
	string	Não	O status do item de verificação. Valores válidos: PASS NOT_PASS CHECKING NOT_CHECK WHITELIST	PASS
InstanceIdKey	string	Não	O ID da instância.	i-uf64w4q6p9jti5gl****
InstanceNameKey	string	Não	O nome da instância.	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 a ser retornada.	1
PageSize	integer	Não	O número de entradas por página. Valor máximo: 100.	20
InstanceIds	array	Não	Os IDs das instâncias dos serviços em nuvem.
	string	Não	O ID da instância do serviço em nuvem.	i-uf64w4q6p9jti5gl****
Lang	string	Não	O idioma do conteúdo na solicitação e na resposta. Valor padrão: zh. Valores válidos: zh: Chinês en: Inglês	zh
SortTypes	array	Não	Os tipos das condições com base nas quais os itens de verificação são classificados.
	string	Não	O tipo da condição com base na qual os itens de verificação são classificados. Defina o valor como STATUS.	STATUS

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação, que é usado para localizar e solucionar problemas.	3AB18264-8A1B-52A6-A9AF-A886556E0F2E
BasicData	array<object>	As informações básicas sobre as instâncias afetadas.
	array<object>	As informações básicas sobre a instância.
Id	integer	O ID do resultado da verificação da instância.	300054
Status	string	Os estados dos itens de verificação. Vários estados são separados por vírgulas (,). Valores válidos: PASS: aprovado NOT_PASS: reprovado CHECKING: sendo verificado NOT_CHECK: não verificado WHITELIST: adicionado à lista de permissões	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 exceção do item de verificação.	检查任务失败。
InstanceInfo	object	As informações sobre a instância na qual o item de verificação é usado.
FirstUpdateTime	integer	The time of the first check.	1716447535531
LastUpdateTime	integer	The time of the last check.	1716447535531
Config	array<object>	The information about the configuration item whose risks are fixed for the instance.
	object
Name	string	The name of the configuration item, which is unique.	prot
Value	string	The value of the configuration item specified for the instance.	8080
ShowName	string	The display name of the configuration item for internationalization.	prot
VendorUserName	string	O nome da conta do provedor de multinuvem.	test
Columns	array<object>	As informações de metadados sobre as condições de pesquisa que podem ser usadas para filtrar instâncias.
	array<object>	As informações de metadados sobre a condição de pesquisa que pode ser usada para filtrar instâncias.
Type	string	O tipo do resultado da verificação da instância. Valores válidos: text link	text
Key	string	A condição de pesquisa.	RegionIdShow
ShowName	string	O nome de exibição da condição de pesquisa.	Region
Search	boolean	Indica se a condição de pesquisa é usada. Valores válidos: true false	true
SearchKey	string	A chave de pesquisa.	InstanceIdKey
Grids	array<object>	As informações de metadados sobre os detalhes da instância.
	object	As informações de metadados sobre cada item nos detalhes das instâncias.
Type	string	The format of the check result for the instance. Valid values: text link	text
Key	string	The search condition.	RegionIdShow
ShowName	string	The display name of the search condition.	Region
Checks	array<object>	As informações estendidas sobre as instâncias.	[{ "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 a instância.	[{ "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 sobre o item de verificação.	{ "InstanceIdShow": { "link": "https://vpc.console.alibabacloud.com/vpc/cn-beijing/vpcs", "value": "ngw-2zenx8j1lf5w8rcdhdqs5" }, "RegionIdShow": { "value": "China(Beijing)" } }
PageInfo	object	As informações de paginação.
CurrentPage	integer	O número da página retornada.	1
PageSize	integer	O número de entradas retornadas por página.	20
TotalCount	integer	O número total de entradas retornadas.	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://vpc.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.