Todos os produtos
Search

Este produto

    :PutMetricRuleTargets

    Central de documentação

    :PutMetricRuleTargets

    Última atualização: Jun 26, 2026

    Associa recursos a uma regra de alerta especificada ou modifica os recursos associados à regra de alerta.

    Limite

    Esta operação oferece suporte apenas a recursos do Message Service (MNS).

    Notas de uso

    Este tópico apresenta um exemplo de como associar um recurso a uma regra de alerta cujo id é ae06917_75a8c43178ab66****. Neste exemplo, o Alibaba Cloud Resource Name (ARN) do recurso é acs:mns:cn-hangzhou:120886317861****:/queues/test/message para uma regra de alerta, e o id do recurso para o qual os alertas são acionados é 1. A resposta indica que o recurso foi associado à regra de alerta especificada.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

    Parâmetros de solicitação

    Parameter Type Required Example Description
    Action String Yes PutMetricRuleTargets

    A operação a ser executada. Defina o valor como PutMetricRuleTargets.

    RuleId String Yes ae06917_75a8c43178ab66****

    O id da regra de alerta.

    Para saber como obter o id de uma regra de alerta, consulte DescribeMetricRuleList.

    Targets.N.Id String Yes 1

    O id do recurso para o qual os alertas são acionados.

    Para saber como obter o id do recurso para o qual os alertas são acionados, consulte DescribeMetricRuleTargets.

    Targets.N.Arn String Yes acs:mns:cn-hangzhou:120886317861****:/queues/test/message

    O ARN do recurso.

    Para saber como obter o ARN de um recurso, consulte DescribeMetricRuleTargets.

    Formato: acs:{Service name abbreviation}:{regionId}:{userId}:/{Resource type}/{Resource name}/message. Exemplo: acs:mns:cn-hangzhou:120886317861****:/queues/test123/message. Campos:

    • {Service name abbreviation}: a abreviação do nome do serviço. Valor válido: mns.
    • {userId}: o id da conta da Alibaba Cloud.
    • {regionId}: o id da região da fila de mensagens ou do tópico.
    • {Resource type}: the type of the resource for which alerts are triggered. Valid values: - **queues** - **topics** {Resource name}: the name of the resource. - If the resource type is set to **queues**, the resource name is the name of the message queue. - If the resource type is set to **topics**, the resource name is the name of the topic.
    Targets.N.Level String No ["INFO", "WARN", "CRITICAL"]

    O nível do alerta. Valores válidos:

    • INFO: informação
    • WARN: aviso
    • CRITICAL: crítico
    Targets.N.JsonParams String No {"customField1":"value1","customField2":"$.name"}

    Os parâmetros do callback de alerta no formato JSON.

    Para obter mais informações sobre os parâmetros de solicitação comuns, consulte Parâmetros comuns.

    Parâmetros de resposta

    Parameter Type Example Description
    Code String 200

    O código de status HTTP.

    Nota O código de status 200 indica que a chamada foi bem-sucedida.
    Message String The request processing has failed due to some unknown error.

    A mensagem de erro.

    RequestId String 6A569B0D-9055-58AF-9E82-BAEAF95C0FD5

    O id da solicitação.

    Success Boolean true

    Indica se a chamada foi bem-sucedida. Valores válidos:

    • true: a chamada foi bem-sucedida.
    • false: a chamada falhou.
    FailData Object

    A lista de recursos que não puderam ser criados ou modificados.

    Targets Array of Target

    As informações sobre o recurso para o qual os alertas são acionados.

    Target
    Id String 1

    O id do recurso para o qual os alertas são acionados.

    Arn String acs:mns:cn-hangzhou:111:/queues/test/message

    O ARN do recurso.

    Formato: acs:{Service name abbreviation}:{regionId}:{userId}:/{Resource type}/{Resource name}/message. Exemplo: acs:mns:cn-hangzhou:120886317861****:/queues/test123/message. Campos:

    • {Service name abbreviation}: a abreviação do nome do serviço. Valor válido: mns.
    • {userId}: o id da conta da Alibaba Cloud.
    • {regionId}: o id da região da fila de mensagens ou do tópico.
    • {Resource type}: the type of the resource for which alerts are triggered. Valid values: - **queues** - **topics** {Resource name}: the name of the resource. - If the resource type is set to **queues**, the resource name is the name of the message queue. - If the resource type is set to **topics**, the resource name is the name of the topic.
    Level String ["INFO", "WARN", "CRITICAL"]

    O nível do alerta. Valores válidos:

    • INFO: informação
    • WARN: aviso
    • CRITICAL: crítico

    Exemplos

    Exemplos de solicitações

    http(s)://[Endpoint]/?Action=PutMetricRuleTargets
&RuleId=ae06917_75a8c43178ab66****
&Targets.1.Arn=acs:mns:cn-hangzhou:120886317861****:/queues/test/message
&Targets.1.Id=1
&<Common request parameters>

    Exemplos de respostas bem-sucedidas

    Formato XML

    HTTP/1.1 200 OK
Content-Type:application/xml

<PutMetricRuleTargetsResponse>
	<RequestId>6A569B0D-9055-58AF-9E82-BAEAF95C0FD5</RequestId>
	<Code>200</Code>
	<Success>true</Success>
</PutMetricRuleTargetsResponse>

    Formato JSON

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "6A569B0D-9055-58AF-9E82-BAEAF95C0FD5",
  "Code" : "200",
  "Success" : true
}

    Códigos de erro

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