ListEvaluationResults - Agentic Cloud Governance Center: Central de Documentação do Alibaba Cloud

Obtém os resultados e o status da avaliação de governança.

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

governance:ListEvaluationResults

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AccountId	integer	Não	O ID das contas-membro. Este parâmetro se aplica apenas ao padrão de avaliação de várias contas.	176618589410****
RegionId	string	Não	O ID da região.	cn-hangzhou
Filters	array<object>	Não	As condições de filtro.
	object	Não	As condições de filtro.
Key	string	Não	A chave de filtro. Valores válidos: ResourceId: o ID do recurso. ResourceName: o nome do recurso. ResourceType: o tipo de recurso.	ResourceId
Values	array	Não	A lista de valores de filtro.
	string	Não	O valor do filtro.	c191**************b4f
SnapshotId	string	Não	O ID do snapshot de avaliação.	es-bp1r**************
Scope	string	Não	O escopo da avaliação de maturidade de governança. Valores válidos: Account: realiza uma avaliação de maturidade de governança de conta única e avalia apenas a conta atual. Este é o valor padrão. ResourceDirectory: realiza uma avaliação de maturidade de governança de várias contas e avalia todas as contas-membro no diretório de recursos. Você deve fazer upgrade para a avaliação de maturidade de governança de várias contas antes de realizar esta operação.	ResourceDirectory
LensCode	string	Não	O código de avaliação de lente. Valores válidos: basic: a avaliação do modelo de base (maturidade de governança). Este é o valor padrão. ack: a avaliação de lente de construção de contêineres. ai: a avaliação de lente de aprendizado de máquina. nis: a avaliação de lente de serviço de rede.	basic
TopicCode	string	Não	O código do tópico de governança.	IdentityAndAccessManagement
EvaluationDomain	string	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
AccountId	integer	O ID das contas-membro.	176618589410****
RequestId	string	O ID da solicitação.	BD57329E-131A-59F4-8746-E1CD8D7B****
Results	object	Os resultados da avaliação, incluindo o status geral da avaliação e os resultados dos subitens.
EvaluationTime	string	A hora de término da avaliação geral em UTC.	2023-12-13T03:35:00Z
MetricResults	array<object>	Os resultados da avaliação.
	array<object>	Os resultados da avaliação.
ErrorInfo	object	A mensagem de erro. Nota Esta mensagem de erro é retornada quando ocorre uma falha e Status é Failed.
Code	string	O código de erro.	EcsInsightEnableFailed
Message	string	A mensagem de erro.	Unable to enable ECS Insight due to a server error.
EvaluationTime	string	A hora de término do item de avaliação individual em UTC.	2023-12-13T03:34:02Z
Id	string	O ID do item de avaliação.	r7xdcu****
ResourcesSummary	object	O resumo da avaliação de recursos do item de avaliação.
NonCompliant	integer	A contagem de recursos não compatíveis.	2
Result	number	A taxa de conformidade de recursos do item de avaliação.	0.67
Risk	string	O nível de risco da avaliação. Valores válidos: Error: alto risco. Warning: médio risco. None: sem risco.	Error
Status	string	O status do item de avaliação individual. Valores válidos: Running: a avaliação está em andamento. Finished: a avaliação foi concluída. Failed: a avaliação falhou.	Running
AccountSummary	object	O resumo da avaliação de contas do item de avaliação.
NonCompliant	integer	O número de contas não compatíveis.	1
PotentialScoreIncrease	number	O aumento potencial de pontuação.	0.2
AvailableRemediation	array<object>	A lista de correções disponíveis.
	object
RemediationTemplateId	string	O ID do modelo de correção.
Status	string	O status geral da avaliação. Valores válidos: Running: a avaliação está em andamento. Finished: a avaliação foi concluída. Failed: a avaliação falhou.	Running
TotalScore	number	A pontuação geral.	0.6453

Exemplos

Resposta de sucesso

JSON formato

{
  "AccountId": 0,
  "RequestId": "BD57329E-131A-59F4-8746-E1CD8D7B****",
  "Results": {
    "EvaluationTime": "2023-12-13T03:35:00Z\n",
    "MetricResults": [
      {
        "ErrorInfo": {
          "Code": "EcsInsightEnableFailed",
          "Message": "Unable to enable ECS Insight due to a server error."
        },
        "EvaluationTime": "2023-12-13T03:34:02Z",
        "Id": "r7xdcu****",
        "ResourcesSummary": {
          "NonCompliant": 2
        },
        "Result": 0.67,
        "Risk": "Error",
        "Status": "Running",
        "AccountSummary": {
          "NonCompliant": 1
        },
        "PotentialScoreIncrease": 0.2,
        "AvailableRemediation": [
          {
            "RemediationTemplateId": ""
          }
        ]
      }
    ],
    "Status": "Running",
    "TotalScore": 0.6453
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	InternalError	A system error occurred.	Ocorreu um erro do sistema.
404	InvalidEnterpriseRealName.NotFound	The specified account has not passed enterprise real name verification. Please complete the verification for the account first.	A conta atual não concluiu a verificação de nome real da empresa. Conclua primeiro a verificação de nome real da empresa.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.