All Products
Search
Document Center

Agentic Cloud Governance Center:ListEvaluationMetadata

Last Updated:Jun 24, 2026

Retrieves information about all available governance evaluation items, including names, IDs, descriptions, stages, resource detail metadata, and remediation guidance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

governance:ListEvaluationMetadata

get

*All Resource

*

None None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

No

The region ID.

cn-hangzhou

Language

string

No

The language type. Governance evaluation definitions are returned in this language. Valid values:

  • en: English.

  • zh: Chinese.

zh

LensCode

string

No

The specialized evaluation code. Valid values:

  • basic (default): foundation model (governance maturity) evaluation.

  • ack: container building specialized evaluation.

  • ai: machine learning specialized evaluation.

  • nis: network service specialized evaluation.

ack

TopicCode

string

No

The governance topic code.

ResourceUtilization

Response elements

Element

Type

Description

Example

object

The response parameters.

EvaluationMetadata

array<object>

The governance evaluation definition metadata.

array<object>

The governance evaluation definition metadata.

Metadata

array<object>

The list of metadata objects under a specific metadata type.

array<object>

The list of metadata objects under a specific metadata type.

Category

string

The pillar to which the check item belongs.

Security

Description

string

The description of the check item.

If you use an AccessKey pair of an Alibaba Cloud account, you have full permissions that cannot be restricted by conditions such as source IP address or access time. Once leaked, the risk is extremely high. If an AccessKey pair exists for the Alibaba Cloud account, it is considered non-compliant.

DisplayName

string

The display name of the check item.

An AccessKey pair is enabled for the Alibaba Cloud account.

Id

string

The unique ID of the metadata entry.

pxgtda****

RecommendationLevel

string

The recommended governance level.

High

RemediationMetadata

object

The remediation metadata.

Remediation

array<object>

The remediation items.

array<object>

The remediation item.

Actions

array<object>

The remediation actions.

array<object>

The remediation action.

Classification

string

The category of the remediation method.

Note

This parameter is returned only when RemediationType is set to Analysis.

UnusedAccessKeyInRamUser

CostDescription

string

The cost of the remediation.

You are not charged for this operation.

Description

string

The description of the remediation.

Note

This parameter is returned only when RemediationType is set to Analysis.

A RAM user has both console logon and an AccessKey pair enabled, but the AccessKey pair has never been used.

Guidance

array<object>

Remediation guidance steps.

object

A single step of remediation guidance.

ButtonName

string

The display name of the button for the remediation step.

Manual fix

ButtonRef

string

The redirect URL for the remediation button.

https://ram.console.alibabacloud.com/users

Content

string

The content of the remediation step.

You must replace the AccessKey pair of your Alibaba Cloud account. To do so, perform the following steps:1. Log on to the RAM console. In the left-side navigation pane, choose Identities > Users. On the Users page, click Create User.2. On the Create User page, enter a logon name and select OpenAPI Access for the Access Mode parameter.3. After the RAM user is created, save the AccessKey pair. Then, find the user that you created on the Users page and click Add Permissions in the Actions column. In the Grant Permission panel, find the AdministratorAccess policy and attach it to the RAM user.4. In a program, replace the AccessKey pair of the Alibaba Cloud account with the AccessKey pair of the RAM user created in the previous step and check whether the program runs as expected in the test environment.5. If the program runs as expected, publish the program to the production environment and disable the previous AccessKey pair of your Alibaba Cloud account. Then, check whether the program runs as expected.6. If the program runs as expected, delete the disabled AccessKey pair after the specified period of time, such as 90 days.

Title

string

The title of the remediation step.

Scenario 3: AccessKey pair that is used within the last 90 days

Notice

string

Notes about the remediation.

This governance item enables the Best Practices for AccessKey and Permission Governance compliance package in Cloud Config to check the settings and usage of AccessKey pairs, Alibaba Cloud accounts, and RAM users.

Suggestion

string

The suggestion for remediation.

Note

This parameter is returned only when RemediationType is set to Analysis.

Console logon is enabled for the RAM user and the RAM user owns an AccessKey pair, while the AccessKey pair has never been used by the RAM user. We recommend that you disable the AccessKey pair for 90 days. If no related issue occurs during this period, you can delete the AccessKey pair.

RemediationType

string

The remediation type. Valid values:

  • Manual: manual remediation.

  • QuickFix: quick fix.

  • Analysis: analysis-assisted decision.

Manual

ResourceMetadata

object

The resource metadata of the check item.

ResourcePropertyMetadata

array<object>

The resource property metadata.

object

The resource property metadata.

DisplayName

string

The display name of the property.

Last time the AccessKey pair was used

PropertyName

string

The name of the resource property.

AkLastUsedTime

PropertyType

string

The type of the resource property.

String

Scope

string

The scope of the check item. Valid values:

  • Account: The check item applies to a single account.

  • ResourceDirectory: The check item applies to multiple accounts within a Resource Directory.

Account

Stage

string

The stage of the check item. Valid values:

  • Released: The check item is officially released.

  • Beta: The check item is in beta.

Released

TopicCode

string

The code of the topic to which the check item belongs.

ResourceUtilization

Type

string

The metadata type. Valid values:

  • Metric: evaluation item.

Metric

RequestId

string

The request ID.

16B208DD-86BD-5E7D-AC93-FFD44B6FBDF1

Examples

Success response

JSON format

{
  "EvaluationMetadata": [
    {
      "Metadata": [
        {
          "Category": "Security",
          "Description": "If you use an AccessKey pair of an Alibaba Cloud account, you have full permissions that cannot be restricted by conditions such as source IP address or access time. Once leaked, the risk is extremely high. If an AccessKey pair exists for the Alibaba Cloud account, it is considered non-compliant.",
          "DisplayName": "An AccessKey pair is enabled for the Alibaba Cloud account.",
          "Id": "pxgtda****",
          "RecommendationLevel": "High",
          "RemediationMetadata": {
            "Remediation": [
              {
                "Actions": [
                  {
                    "Classification": "UnusedAccessKeyInRamUser",
                    "CostDescription": "You are not charged for this operation.",
                    "Description": "A RAM user has both console logon and an AccessKey pair enabled, but the AccessKey pair has never been used.",
                    "Guidance": [
                      {
                        "ButtonName": "Manual fix",
                        "ButtonRef": "https://ram.console.alibabacloud.com/users",
                        "Content": "You must replace the AccessKey pair of your Alibaba Cloud account. To do so, perform the following steps:1. Log on to the RAM console. In the left-side navigation pane, choose Identities > Users. On the Users page, click Create User.2. On the Create User page, enter a logon name and select OpenAPI Access for the Access Mode parameter.3. After the RAM user is created, save the AccessKey pair. Then, find the user that you created on the Users page and click Add Permissions in the Actions column. In the Grant Permission panel, find the AdministratorAccess policy and attach it to the RAM user.4. In a program, replace the AccessKey pair of the Alibaba Cloud account with the AccessKey pair of the RAM user created in the previous step and check whether the program runs as expected in the test environment.5. If the program runs as expected, publish the program to the production environment and disable the previous AccessKey pair of your Alibaba Cloud account. Then, check whether the program runs as expected.6. If the program runs as expected, delete the disabled AccessKey pair after the specified period of time, such as 90 days.",
                        "Title": "Scenario 3: AccessKey pair that is used within the last 90 days"
                      }
                    ],
                    "Notice": "This governance item enables the Best Practices for AccessKey and Permission Governance compliance package in Cloud Config to check the settings and usage of AccessKey pairs, Alibaba Cloud accounts, and RAM users.",
                    "Suggestion": "Console logon is enabled for the RAM user and the RAM user owns an AccessKey pair, while the AccessKey pair has never been used by the RAM user. We recommend that you disable the AccessKey pair for 90 days. If no related issue occurs during this period, you can delete the AccessKey pair."
                  }
                ],
                "RemediationType": "Manual"
              }
            ]
          },
          "ResourceMetadata": {
            "ResourcePropertyMetadata": [
              {
                "DisplayName": "Last time the AccessKey pair was used",
                "PropertyName": "AkLastUsedTime",
                "PropertyType": "String"
              }
            ]
          },
          "Scope": "Account",
          "Stage": "Released",
          "TopicCode": "ResourceUtilization"
        }
      ],
      "Type": "Metric"
    }
  ],
  "RequestId": "16B208DD-86BD-5E7D-AC93-FFD44B6FBDF1"
}

Error codes

HTTP status code

Error code

Error message

Description

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.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.