Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::SAG::SmartAccessGateway

Última atualização: Jun 27, 2026

O recurso ALIYUN::SAG::SmartAccessGateway cria uma instância do Smart Access Gateway (SAG).

Sintaxe

{
  "Type": "ALIYUN::SAG::SmartAccessGateway",
  "Properties": {
    "ReceiverCountry": String,
    "Description": String,
    "ReceiverZip": String,
    "BuyerMessage": String,
    "CidrBlock": String,
    "ReceiverTown": String,
    "HardWareSpec": String,
    "Name": String,
    "ReceiverPhone": String,
    "ReceiverCity": String,
    "RoutingStrategy": String,
    "SecurityLockThreshold": Integer,
    "ReceiverAddress": String,
    "AlreadyHaveSag": Boolean,
    "HaType": String,
    "Period": Integer,
    "MaxBandWidth": Integer,
    "AutoPay": Boolean,
    "ReceiverMobile": String,
    "ReceiverDistrict": String,
    "Activate": Boolean,
    "ChargeType": String,
    "ReceiverState": String,
    "ReceiverName": String,
    "ReceiverEmail": String
  }
}

Propriedades

PropriedadeTipoObrigatórioEditávelDescriçãoRestrição
ReceiverCountryStringSimNãoPaís de recebimento do dispositivo SAG. Exemplo: China.
DescriptionStringNãoSimDescrição da instância SAG. Deve ter entre 2 e 256 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra.
ReceiverZipStringSimNãoCEP do endereço de entrega do dispositivo SAG. Nenhuma.
BuyerMessageStringSimNãoObservações do comprador. Nenhuma.
CidrBlockStringNãoSimBloco CIDR privado. Nenhuma.
ReceiverTownStringSimNãoMunicípio de recebimento do dispositivo SAG. Nenhuma.
HardWareSpecStringSimNãoTipo da instância SAG. Valores válidos:
  • sag-100wm: instância SAG de hardware. Usa o modelo SAG-100WM e conecta portais ou pequenas filiais à Alibaba Cloud.
  • sag-1000: instância SAG de hardware. Usa o modelo SAG-1000 e permite instalação em bancada ou rack.
  • sag-vcpe: instância SAG do tipo equipamento virtual nas instalações do cliente (vCPE). Ao implantar essa instância em um host, você pode usar o host como dispositivo CPE para migrar serviços para a Alibaba Cloud.
NameStringNãoSimNome da instância SAG. Deve ter entre 2 e 128 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra.
ReceiverPhoneStringNãoNãoNúmero de telefone fixo do destinatário. Nenhuma.
ReceiverCityStringSimNãoCidade de recebimento do dispositivo SAG. Nenhuma.
RoutingStrategyStringNãoSimPolítica de roteamento do dispositivo SAG. Nenhuma.
SecurityLockThresholdIntegerNãoSimLimiar de tempo. O sistema bloqueia o dispositivo SAG se ele permanecer offline pelo período especificado. Unidade: segundos.
ReceiverAddressStringSimNãoEndereço completo do destinatário. Nenhuma.
AlreadyHaveSagBooleanNãoNãoIndica se já existe um dispositivo SAG. Valor padrão: false. Valores válidos:
  • true
  • false
HaTypeStringSimNãoModo de implantação do dispositivo SAG. Valores válidos:
  • no_backup: apenas um dispositivo SAG adquirido e implantado para conexão com a Alibaba Cloud.
  • cold_backup: dois dispositivos SAG adquiridos e implantados no modo ativo-standby. Um atua como dispositivo ativo e o outro como standby. Somente o dispositivo ativo se conecta à Alibaba Cloud. Caso o dispositivo ativo apresente falhas, realize o failover manualmente.
  • warm_backup: dois dispositivos SAG adquiridos e implantados no modo ativo-ativo. Ambos se conectam à Alibaba Cloud. Se um dos dispositivos ativos falhar, o failover ocorre automaticamente.
    Nota Se você definir a propriedade HardWareSpec como sag-vcpe, defina esta propriedade como warm_backup.
PeriodIntegerSimNãoPeríodo de assinatura da instância SAG. Valores válidos: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24 e 36.

Unidade: meses.

MaxBandWidthIntegerSimNãoLargura de banda da instância SAG. Valores válidos:
  • Se a propriedade HardWareSpec for sag-100wm: 2 a 50.
  • Se a propriedade HardWareSpec for sag-1000: 10 a 500.
  • Se a propriedade HardWareSpec for sag-vcpe: 10 a 1000.

Unidade: Mbit/s.

AutoPayBooleanNãoNãoDefina se o pagamento automático está ativado para a instância SAG por assinatura. Valor padrão: false. Valores válidos:
  • true
  • false
ReceiverMobileStringSimNãoNúmero de celular do destinatário. Nenhuma.
ReceiverDistrictStringSimNãoBairro de recebimento do dispositivo SAG. Nenhuma.
ActivateBooleanNãoSimIndica se a instância SAG deve ser ativada. Valor padrão: false. Valores válidos:
  • true
  • false
ChargeTypeStringSimNãoMétodo de faturamento da instância SAG. Defina o valor como PREPAY, que representa o método de faturamento por assinatura.
ReceiverStateStringSimNãoEstado de recebimento do dispositivo SAG. Nenhuma.
ReceiverNameStringSimNãoNome do destinatário. Nenhuma.
ReceiverEmailStringSimNãoEndereço de e-mail do destinatário. Nenhuma.

Valores de retorno

Fn::GetAtt

  • OrderId: o ID do pedido.

  • SmartAGId: o ID da instância SAG.

Exemplos

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ReceiverCountry": {
      "Type": "String",
      "Description": "The country of the recipient address.",
      "Default": "China"
    },
    "ReceiverZip": {
      "Type": "String",
      "Description": "The postcode of the recipient address.",
      "Default": "310000"
    },
    "BuyerMessage": {
      "Type": "String",
      "Description": "The remarks left by the buyer.",
      "Default": "Message"
    },
    "ReceiverTown": {
      "Type": "String",
      "Description": "The town of the recipient address.",
      "Default": "Zhuantang"
    },
    "HardWareSpec": {
      "Type": "String",
      "Description": "The type of the SAG instance. Valid values:\nsag-100wm\nsag-1000\nsag-vcpe",
      "Default": "sag-100wm"
    },
    "Name": {
      "Type": "String",
      "Description": "The name of the SAG instance.\nThe name must be 2 to 128 characters in length and can contain digits, periods (.),\nunderscores (_), and hyphens (-). It must start with a letter.",
      "Default": "test"
    },
    "ReceiverCity": {
      "Type": "String",
      "Description": "The city of the recipient address.",
      "Default": "Hangzhou"
    },
    "ReceiverAddress": {
      "Type": "String",
      "Description": "The detailed address of the recipient.",
      "Default": "No. XX"
    },
    "HaType": {
      "Type": "String",
      "Description": "The deployment mode. Valid values:\nno_backup: You buy only one SAG device to connect private networks to Alibaba Cloud.\ncold_backup: You buy two SAG devices in active-standby mode. One SAG device serves as an active\ndevice and the other serves as a standby device. Only the active device is connected\nto Alibaba Cloud. If the active device is not working as expected, you must manually\nperform a switchover.\nwarm_backup: You buy two SAG devices in active-active mode. Both SAG devices are connected to\nAlibaba Cloud. If an active device is not working as expected, a failover is automatically\nperformed.\nNote If you want to create an SAG vCPE instance, set the value to warm_backup.",
      "AllowedValues": [
        "cold_backup",
        "no_backup",
        "warm_backup"
      ],
      "Default": "cold_backup"
    },
    "Period": {
      "Type": "Number",
      "Description": "The subscription period of the SAG instance. Unit: months.\nValid values: 1 to 9, 12, 24, and 36.",
      "Default": 12
    },
    "MaxBandWidth": {
      "Type": "Number",
      "Description": "The bandwidth of the SAG instance.\nIf you want to create an SAG CPE instance and the model is sag-100wm, valid values of this parameter are 2 to 50. Unit: Mbit/s.\nIf you want to create an SAG CPE instance and the model is sag-1000, valid values of this parameter are 10 to 500. Unit: Mbit/s.\nIf you want to create an SAG vCPE instance, valid values of this parameter are 10 to 1000. Unit: Mbit/s.",
      "Default": 12
    },
    "AutoPay": {
      "Type": "Boolean",
      "Description": "Specifies whether to enable auto-payment for the instance. Valid values:\ntrue: yes\nfalse: no\nIf you set the parameter to false, go to Billing Management to complete the payment\nafter you call this operation. After you complete the payment, the instance can be\ncreated.",
      "AllowedValues": [
        "True",
        "true",
        "False",
        "false"
      ],
      "Default": "false"
    },
    "ReceiverMobile": {
      "Type": "String",
      "Description": "The mobile phone number of the recipient.",
      "Default": "1884085****"
    },
    "ReceiverDistrict": {
      "Type": "String",
      "Description": "The district of the recipient address.",
      "Default": "Xihu"
    },
    "Activate": {
      "Type": "Boolean",
      "Description": "Activate SAG or not. Default is False",
      "AllowedValues": [
        "True",
        "true",
        "False",
        "false"
      ],
      "Default": "true"
    },
    "ChargeType": {
      "Type": "String",
      "Description": "The billing method of the SAG instance. \nSet the value to PREPAY, which specifies the subscription billing method.",
      "Default": "PREPAY"
    },
    "ReceiverState": {
      "Type": "String",
      "Description": "The province of the recipient address.",
      "Default": "China"
    },
    "ReceiverName": {
      "Type": "String",
      "Description": "The name of the recipient.",
      "Default": "Zhang San"
    },
    "ReceiverEmail": {
      "Type": "String",
      "Description": "The email address of the recipient.",
      "Default": "xx@example.com"
    }
  },
  "Resources": {
    "SmartAccessGateway": {
      "Type": "ALIYUN::SAG::SmartAccessGateway",
      "Properties": {
        "ReceiverCountry": {
          "Ref": "ReceiverCountry"
        },
        "ReceiverZip": {
          "Ref": "ReceiverZip"
        },
        "BuyerMessage": {
          "Ref": "BuyerMessage"
        },
        "ReceiverTown": {
          "Ref": "ReceiverTown"
        },
        "HardWareSpec": {
          "Ref": "HardWareSpec"
        },
        "Name": {
          "Ref": "Name"
        },
        "ReceiverCity": {
          "Ref": "ReceiverCity"
        },
        "ReceiverAddress": {
          "Ref": "ReceiverAddress"
        },
        "HaType": {
          "Ref": "HaType"
        },
        "Period": {
          "Ref": "Period"
        },
        "MaxBandWidth": {
          "Ref": "MaxBandWidth"
        },
        "AutoPay": {
          "Ref": "AutoPay"
        },
        "ReceiverMobile": {
          "Ref": "ReceiverMobile"
        },
        "ReceiverDistrict": {
          "Ref": "ReceiverDistrict"
        },
        "Activate": {
          "Ref": "Activate"
        },
        "ChargeType": {
          "Ref": "ChargeType"
        },
        "ReceiverState": {
          "Ref": "ReceiverState"
        },
        "ReceiverName": {
          "Ref": "ReceiverName"
        },
        "ReceiverEmail": {
          "Ref": "ReceiverEmail"
        }
      }
    }
  },
  "Outputs": {
    "OrderId": {
      "Description": "The ID of the order.",
      "Value": {
        "Fn::GetAtt": [
          "SmartAccessGateway",
          "OrderId"
        ]
      }
    },
    "SmartAGId": {
      "Description": "The ID of the SAG instance.",
      "Value": {
        "Fn::GetAtt": [
          "SmartAccessGateway",
          "SmartAGId"
        ]
      }
    }
  }
}