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

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AccountId	integer	Não	O ID da conta de membro. Este parâmetro é aplicável apenas ao modo de avaliação de múltiplas 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	A condição de filtro.
Key	string	Não	A chave da condição 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 da condição de filtro.
	string	Não	O valor da condição de 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 (padrão): Realiza a avaliação de maturidade de governança de conta única, avaliando apenas a conta atual. ResourceDirectory: Realiza a avaliação de maturidade de governança de múltiplas contas, avaliando todas as contas de membro no diretório de recursos. Antes de realizar esta operação, você deve primeiro atualizar para a avaliação de maturidade de governança de múltiplas contas.	ResourceDirectory
LensCode	string	Não	O código de avaliação especial. Valores válidos: basic (padrão): Avaliação do modelo básico (maturidade de governança). ack: Avaliação especial de construção de contêineres. ai: Avaliação especial de aprendizado de máquina. nis: Avaliação especial 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	O resultado da resposta.
AccountId	integer	O ID da conta de 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 da avaliação dos subitens.
EvaluationTime	string	A hora de término da avaliação geral (UTC).	2023-12-13T03:35:00Z
MetricResults	array<object>	Os resultados da avaliação.
	array<object>	O resultado da avaliação.
ErrorInfo	object	Error information. null This error information is returned when `Status` is `Failed`.
Code	string	Error code.	EcsInsightEnableFailed
Message	string	Error message.	Unable to enable ECS Insight due to a server error.
EvaluationTime	string	Individual evaluation item end time (UTC).	2023-12-13T03:34:02Z
Id	string	Evaluation item ID.	r7xdcu****
ResourcesSummary	object	Evaluation item resource assessment summary.
NonCompliant	integer	Number of non-compliant resources.	2
Result	number	Evaluation item resource compliance rate.	0.67
Risk	string	Evaluation risk level. Valid values: Error: High risk. Warning: Medium risk. None: No risk.	Error
Status	string	Individual evaluation item status. Valid values: Running: Evaluation in progress. Finished: Evaluation completed. Failed: Evaluation failed.	Running
AccountSummary	object	Evaluation item account assessment summary.
NonCompliant	integer	Number of non-compliant accounts.	1
PotentialScoreIncrease	number	Potential score increase.	0.2
AvailableRemediation	array<object>	List of available remediations.
	object
RemediationTemplateId	string	Remediation template ID.
Status	string	O status geral da avaliação. Valores válidos: Running: Avaliação em andamento. Finished: Avaliação concluída. Failed: Falha na avaliação.	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.	A system error occurred.
404	InvalidEnterpriseRealName.NotFound	The specified account has not passed enterprise real name verification. Please complete the verification for the account first.	The specified account has not passed enterprise real-name verification. Please complete the verification for the account first.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.