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

Consulta informações estatísticas de ativos com base em dimensões de agregação especificadas.

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

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:\n- zh: Chinês\n- en: Inglês.	zh
MachineTypes	string	Não	O tipo de ativos a serem consultados. Defina o valor como ecs, que indica instâncias do Elastic Compute Service (ECS).	ecs
GroupField	string	Sim	A condição de filtro para consulta de ativos. Valores válidos:\n\n- groupId: consulta ativos por grupo de ativos.\n- regionId: consulta ativos por região.\n- vpcInstanceId: consulta ativos por nuvem privada virtual (VPC).	groupId
FieldValue	string	Não	O nome do grupo de ativos a ser consultado. Há suporte para correspondência aproximada.	test-01
NoPage	boolean	Não	Configurações para especificar se a consulta paginada deve ser ativada. Valor padrão: true. Valores válidos:\n- true: A paginação está ativada.\n- false: A paginação está desativada.	true
PageSize	integer	Não	O número de entradas por página em uma consulta paginada. Valor padrão: 20, o que indica que 20 entradas de informações de ativos são exibidas por página.	20
CurrentPage	integer	Não	O número da primeira página a ser retornada. Valor padrão: 1, o que indica que os resultados são retornados a partir da página 1.	1
Vendor	integer	Não	O fornecedor do servidor. Valores válidos:\n\n- 0: ativo do Alibaba Cloud\n- 1: ativo não cloud\n- 2: ativo de IDC\n- 3, 4, 5, 7: ativo de nuvem de terceiros\n- 8: ativo leve.	0
Vendors	string	Não	Os fornecedores de servidores. Separe vários fornecedores com vírgulas (,). Valores válidos:\n\n- 0: ativo do Alibaba Cloud\n- 1: ativo não cloud\n- 2: ativo de IDC\n- 3, 4, 5, 7: ativo de nuvem de terceiros\n- 8: ativo leve.	0,8
SaleVersionCheckCode	string	Não	A condição de filtro baseada em edição para consulta de ativos. Valores válidos:\n\n- sas_gte_advanced: Advanced Edition ou superior\n- sas_gte_enterprise: Enterprise Edition ou superior\n- sas_gt_basic: edição paga\n- sas_eq_advanced: Advanced Edition\n- sas_gt_anti_virus: superior à Anti-virus Edition.	sas_gt_basic
ResourceDirectoryAccountId	integer	Não	O ID da conta do Alibaba Cloud que está associada às contas de membro em uma pasta de recursos.\n>Invoque 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 pelo Alibaba Cloud para a solicitação. Você pode usar este ID para solucionar problemas.	52A3AEE6-114A-499D-8990-4BA9B27FE0AA
PageInfo	object	As informações de paginação dos resultados da consulta.
CurrentPage	integer	O número da página atual em uma consulta paginada.	5
PageSize	integer	O número de entradas por página em uma consulta paginada. Valor padrão: 20, o que indica que 20 entradas de informações de ativos são exibidas por página.	20
TotalCount	integer	O número total de entradas de ativos retornadas.	100
Count	integer	O número de ativos exibidos na página atual em uma consulta paginada.	20
Instances	array<object>	A lista de informações de ativos retornadas.
	object	As informações do ativo.
AsapVulInstanceCount	integer	O número de ativos que possuem vulnerabilidades de alta prioridade.	11
UnProtectedInstanceCount	string	O número de ativos que não estão protegidos pelo Security Center.	32
FieldAliasName	string	O nome do grupo de servidores.	testA
InstanceCount	string	O número total de ativos do tipo de ativo especificado.\n\n> Se o parâmetro de solicitação MachineTypes não for definido, este parâmetro retornará o número total de ativos de todos os tipos.	205
RiskInstanceCount	string	O número de ativos que apresentam riscos de segurança.	172
GroupFlag	integer	O tipo de grupo de servidores. Valores válidos:\n- 0: grupo padrão\n- 1: outro grupo.	1
AuthVersionCheckCount	integer	O número de ativos que atendem à condição de filtro baseada em edição.	205
Os	string	O tipo de sistema operacional do ativo. Valores válidos:\n- windows\n- linux\n Importante Este campo é retornado apenas quando Lang é definido como zh.	windows
InstanceCoreCount	integer	O número total de núcleos de computação para todos os ativos do tipo de ativo especificado.\n\n> Se o parâmetro de solicitação MachineTypes não for definido, este parâmetro retornará o número total de núcleos de computação para ativos de todos os tipos.	610

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "52A3AEE6-114A-499D-8990-4BA9B27FE0AA",
  "PageInfo": {
    "CurrentPage": 5,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 20
  },
  "Instances": [
    {
      "AsapVulInstanceCount": 11,
      "UnProtectedInstanceCount": "32",
      "FieldAliasName": "testA",
      "InstanceCount": "205",
      "RiskInstanceCount": "172",
      "GroupFlag": 1,
      "AuthVersionCheckCount": 205,
      "Os": "windows",
      "InstanceCoreCount": 610
    }
  ]
}

Códigos de erro

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