Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::CMS::MonitoringAgent

Última atualização: Jun 27, 2026

Instala o agente do CloudMonitor em hosts da Alibaba Cloud.

Sintaxe

{
  "Type": "ALIYUN::CMS::MonitoringAgent",
  "Properties": {
    "Force": Boolean,
    "InstallCommand": String,
    "InstanceIds": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Force

Boolean

Não

Não

Define se a instalação do agente do CloudMonitor será forçada.

Valores válidos:

  • true (padrão)

  • false

InstallCommand

String

Não

Não

Especifica a estratégia de instalação ou atualização do agente do CloudMonitor nos hosts da conta atual da Alibaba Cloud.

Valores válidos:

  • onlyInstallNotHasAgent: instala a versão mais recente do agente apenas em hosts onde ele ainda não está presente.

  • onlyUpgradeAgent: atualiza o agente para a versão mais recente somente em hosts que já possuem uma versão anterior instalada.

  • installAndUpgrade: instala o agente em hosts sem ele e atualiza a versão naqueles com versões desatualizadas.

InstanceIds

List

Não

Não

IDs dos hosts da Alibaba Cloud.

Especifique até 10 IDs.

Nota

Especifique InstallCommand ou InstanceIds.

Valores de retorno

Fn::GetAtt

Nenhum.

Exemplos

Formato YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  Force:
    Description:
      en: 'Specifies whether to install the CloudMonitor agent. Valid values:

        true (default value): yes

        false: no'
    Required: false
    Type: Boolean
  InstanceIds:
    Description:
      en: 'Alibaba Cloud host ID.
        The range of n: 1 ~ 10.
        Explain that InstallCommand and InstanceIds must be selected one by one.'
    MaxLength: 10
    MinLength: 1
    Required: false
    Type: Json
Resources:
  MonitoringAgent:
    Properties:
      Force:
        Ref: Force
      InstanceIds:
        Ref: InstanceIds
    Type: ALIYUN::CMS::MonitoringAgent
                        

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Force": {
      "Type": "Boolean",
      "Description": {
        "en": "Specifies whether to install the CloudMonitor agent. Valid values:\ntrue (default value): yes\nfalse: no"
      },
      "Required": false
    },
    "InstanceIds": {
      "Type": "Json",
      "Description": {
        "en": "Alibaba Cloud host ID.\nThe range of n: 1 ~ 10.\nExplain that InstallCommand and InstanceIds must be selected one by one."
      },
      "Required": false,
      "MinLength": 1,
      "MaxLength": 10
    }
  },
  "Resources": {
    "MonitoringAgent": {
      "Type": "ALIYUN::CMS::MonitoringAgent",
      "Properties": {
        "Force": {
          "Ref": "Force"
        },
        "InstanceIds": {
          "Ref": "InstanceIds"
        }
      }
    }
  }
}