ALIYUN::ENS::VSwitch

ALIYUN::ENS::VSwitch类型用于创建交换机。

语法

{
  "Type": "ALIYUN::ENS::VSwitch",
  "Properties": {
    "Description": String,
    "CidrBlock": String,
    "VSwitchName": String,
    "NetworkId": String,
    "EnsRegionId": String
  }
}

属性

属性名称

类型

必须

允许更新

描述

约束

Description

String

交换机的描述信息。

描述长度为2~256个字符,必须以字母或中文开头,但不能以http://https://开头。

CidrBlock

String

交换机的网段。

交换机网段要求如下:

  • 交换机的网段的掩码长度范围为16~29位。

  • 交换机的网段必须从属于所在VPC的网段。

  • 交换机的网段不能与所在VPC中路由条目的目标网段相同,但可以是目标网段的子集。

VSwitchName

String

交换机名称。

命名规则如下:

  • 长度为2~128个英文或中文字符。

  • 必须以大小字母或中文开头,不能以http://https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

NetworkId

String

要创建的交换机所属的网络ID。

EnsRegionId

String

ENS节点ID。

返回值

Fn::GetAtt

VSwitchId:交换机ID。

示例

  • YAML格式

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      CidrBlock:
        Description:
          en: 'The CIDR block of the vSwitch. Take note of the following limits:
    
            The subnet mask must be 16 to 29 bits in length.
    
            The CIDR block of the vSwitch must fall within the CIDR block of the VPC to
            which the vSwitch belongs.
    
            The CIDR block of the vSwitch cannot be the same as the destination CIDR block
            in a route entry of the VPC. However, it can be a subset of the destination
            CIDR block.'
        Required: true
        Type: String
      Description:
        AssociationProperty: TextArea
        Description:
          en: 'The description of the vSwitch.
    
            The description must be 2 to 256 characters in length. It must start with
            a letter but cannot start with http:// or https://.'
        Required: false
        Type: String
      EnsRegionId:
        Description:
          en: The ID of the edge node.
        Required: true
        Type: String
      NetworkId:
        Description:
          en: The ID of the network to which the vSwitch that you want to create belongs.
        Required: true
        Type: String
      VSwitchName:
        Description:
          en: 'The name of the vSwitch. The name must meet the following requirements:
    
            The name must be 2 to 128 characters in length.
    
            The name must start with a letter and cannot start with http:// or https://.
            It can contain letters, digits, colons (:), underscores (_), and hyphens (-).
    
            Default value: null.'
        Required: false
        Type: String
    Resources:
      VSwitch:
        Properties:
          CidrBlock:
            Ref: CidrBlock
          Description:
            Ref: Description
          EnsRegionId:
            Ref: EnsRegionId
          NetworkId:
            Ref: NetworkId
          VSwitchName:
            Ref: VSwitchName
        Type: ALIYUN::ENS::VSwitch
    Outputs:
      VSwitchId:
        Description: The ID of the vSwitch.
        Value:
          Fn::GetAtt:
          - VSwitch
          - VSwitchId
                            
  • JSON格式

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "Description": {
          "AssociationProperty": "TextArea",
          "Type": "String",
          "Description": {
            "en": "The description of the vSwitch.\nThe description must be 2 to 256 characters in length. It must start with a letter but cannot start with http:// or https://."
          },
          "Required": false
        },
        "CidrBlock": {
          "Type": "String",
          "Description": {
            "en": "The CIDR block of the vSwitch. Take note of the following limits:\nThe subnet mask must be 16 to 29 bits in length.\nThe CIDR block of the vSwitch must fall within the CIDR block of the VPC to which the vSwitch belongs.\nThe CIDR block of the vSwitch cannot be the same as the destination CIDR block in a route entry of the VPC. However, it can be a subset of the destination CIDR block."
          },
          "Required": true
        },
        "VSwitchName": {
          "Type": "String",
          "Description": {
            "en": "The name of the vSwitch. The name must meet the following requirements:\nThe name must be 2 to 128 characters in length.\nThe name must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).\nDefault value: null."
          },
          "Required": false
        },
        "NetworkId": {
          "Type": "String",
          "Description": {
            "en": "The ID of the network to which the vSwitch that you want to create belongs."
          },
          "Required": true
        },
        "EnsRegionId": {
          "Type": "String",
          "Description": {
            "en": "The ID of the edge node."
          },
          "Required": true
        }
      },
      "Resources": {
        "VSwitch": {
          "Type": "ALIYUN::ENS::VSwitch",
          "Properties": {
            "Description": {
              "Ref": "Description"
            },
            "CidrBlock": {
              "Ref": "CidrBlock"
            },
            "VSwitchName": {
              "Ref": "VSwitchName"
            },
            "NetworkId": {
              "Ref": "NetworkId"
            },
            "EnsRegionId": {
              "Ref": "EnsRegionId"
            }
          }
        }
      },
      "Outputs": {
        "VSwitchId": {
          "Description": "The ID of the vSwitch.",
          "Value": {
            "Fn::GetAtt": [
              "VSwitch",
              "VSwitchId"
            ]
          }
        }
      }
    }