ALIYUN::ECS::PrefixList类型用于创建前缀列表。

语法

{
  "Type": "ALIYUN::ECS::PrefixList",
  "Properties": {
    "MaxEntries": Integer,
    "Description": String,
    "PrefixListName": String,
    "Entries": List,
    "AddressFamily": String
  }
}

属性

属性名称 类型 必须 允许更新 描述 约束
MaxEntries Integer 前缀列表支持的最大条目容量。 取值范围:1~200。
Description String 前缀列表的描述信息。 长度为2~256个字符,不能以http://https://开头。默认值:空。
PrefixListName String 前缀列表的名称。 长度为2~128个字符,必须以大小写字母或中文开头,不能以http://https://com.aliyuncom.alibabacloud开头。可以包含中文、英文、数字、半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)。
Entries List 前缀列表的条目信息。 最多支持设置200个条目。

更多信息,请参见Entries属性

AddressFamily String 前缀列表的地址群。 取值:
  • IPv4
  • IPv6

Entries语法

"Entries": [
  {
    "Description": String,
    "Cidr": String
  }
]

Entries属性

属性名称 类型 必须 允许更新 描述 约束
Description String 前缀列表条目的描述信息。 长度为2~32个字符,可以是英文或中文字符,不能以http://https://开头。
Cidr String 前缀列表条目的CIDR地址块信息。

CIDR地址块需满足如下条件:

  • CIDR地址块类型根据地址群决定,一个前缀列表不能同时包含IPv4和IPv6的CIDR地址块。
  • 多个条目中的CIDR地址块不能重复。例如,您不能设置两个192.168.1.0/24。
  • 支持设置单IP地址,系统会自动转换为CIDR地址块。例如,您设置192.168.1.100,系统会自动转换成192.168.1.100/32。
  • 如果使用IPv6 CIDR地址块,系统会自动转换成零压缩的形式且字母转换为小写。例如,您设置2001:0DB8:0000:0000:0000:0000:0000:0000/32,系统会自动转换成2001:db8::/32。关于CIDR地址块的详细信息,请参见什么是CIDR?

默认值:空。

说明 前缀列表的条目数量不能大于最大条目容量(MaxEntries)。

返回值

Fn::GetAtt

PrefixListId:前缀列表的ID。

示例

JSON格式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "MaxEntries": {
      "Type": "Number",
      "Description": "The maximum number of entries that the prefix list can contain. Valid values: 1 to 200.",
      "MinValue": 1,
      "MaxValue": 200,
      "Default": 1
    },
    "PrefixListName": {
      "Type": "String",
      "Description": "The name of the prefix. The name must be 2 to 128 characters in length. It must start with a letter and cannot start with http://, https://, com.aliyun, or com.alibabacloud. It can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).",
      "Default": "PrefixListNameSample"
    },
    "Entries": {
      "Type": "Json",
      "Default": [{
        "Cidr": "192.168.1.0/24"
      }],
      "MaxLength": 200
    },
    "AddressFamily": {
      "Type": "String",
      "Description": "The IP address family. Valid values: IPv4 IPv6",
      "AllowedValues": [
        "Ipv4",
        "Ipv6"
      ],
      "Default": "Ipv4"
    }
  },
  "Resources": {
    "PrefixList": {
      "Type": "ALIYUN::ECS::PrefixList",
      "Properties": {
        "MaxEntries": {
          "Ref": "MaxEntries"
        },
        "PrefixListName": {
          "Ref": "PrefixListName"
        },
        "Entries": {
          "Ref": "Entries"
        },
        "AddressFamily": {
          "Ref": "AddressFamily"
        }
      }
    }
  },
  "Outputs": {
    "PrefixListId": {
      "Description": "The ID of the prefix list.",
      "Value": {
        "Fn::GetAtt": [
          "PrefixList",
          "PrefixListId"
        ]
      }
    }
  }
}