Todos os produtos
Search
Central de documentação

:Modificar métricas exibidas do Enhanced Monitoring

Última atualização: Jun 26, 2026

Use a operação ModifyDBInstanceMetrics para alterar as métricas do Enhanced Monitoring exibidas em uma instância do ApsaraDB RDS for PostgreSQL.

Pré-requisitos

Antes de chamar esta operação, verifique se a instância executa o PostgreSQL.

Para obter mais informações, consulte Visualizar as métricas de Enhanced Monitoring de uma instância do ApsaraDB RDS for PostgreSQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para chamar esta operação. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ModifyDBInstanceMetrics

Operação a ser executada. Defina o valor como ModifyDBInstanceMetrics.

DBInstanceName String Sim pgm-bp1s1j103lo6****

ID da instância. Chame a operação DescribeDBInstances para consultar os IDs das instâncias.

MetricsConfig String Sim os.cpu_usage.sys.avg,os.cpu_usage.user.avg

Chaves das métricas do Enhanced Monitoring a serem exibidas para a instância. Insira no máximo 30 chaves de métrica. Para múltiplas chaves, separe-as por vírgulas (,).

Chame a operação DescribeAvailableMetrics para consultar as chaves das métricas.

Scope String Sim instance

Escopo de aplicação desta modificação. Valores válidos:

  • instance: A modificação aplica-se apenas à instância atual.
  • region: A modificação aplica-se a todas as instâncias do ApsaraDB RDS for PostgreSQL com o mesmo tipo de mídia de armazenamento da instância atual na mesma região. Por exemplo, se a instância atual usa SSDs padrão ou ESSDs, a alteração afeta todas as instâncias do ApsaraDB RDS for PostgreSQL com SSDs padrão ou ESSDs nessa região.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
DBInstanceId String pgm-bp1s1j103lo6****

ID da instância.

RequestId String B55934BB-FFAA-5276-80A8-E0FDB12810B3

ID da solicitação.

Scope String instance

Escopo de aplicação desta modificação. Valores válidos:

  • instance: A modificação aplica-se apenas à instância atual.
  • region: A modificação aplica-se a todas as instâncias do ApsaraDB RDS for PostgreSQL com o mesmo tipo de mídia de armazenamento da instância atual na mesma região.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceMetrics
&DBInstanceName=pgm-bp1s1j103lo6****
&MetricsConfig=os.cpu_usage.sys.avg,os.cpu_usage.user.avg
&Scope=instance
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ModifyDBInstanceMetrics>
  <data>
        <RequestId>B55934BB-FFAA-5276-80A8-E0FDB12810B3</RequestId>
        <Scope>instance</Scope>
        <DBInstanceId>pgm-bp1s1j103lo6****</DBInstanceId>
  </data>
</ModifyDBInstanceMetrics>

Formato JSON

{
    "data": {
        "RequestId": "B55934BB-FFAA-5276-80A8-E0FDB12810B3",
        "Scope": "instance",
        "DBInstanceId": "pgm-bp1s1j103lo6****"
    }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidMetricsConfig

The specified metrics config is invalid.

Mensagem retornada porque as métricas do Enhanced Monitoring especificadas são inválidas.

400

InvalidScope

The specified scope is invalid

Mensagem retornada porque o escopo de aplicação especificado é inválido.

404

InvalidDBInstanceName.NotFound

The database instance does not exist.

Mensagem retornada porque o nome da instância especificado não foi encontrado. Verifique se o nome da instância está correto.

Para obter uma lista de códigos de erro, visite o API Error Center.