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.aliyun和com.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"
        ]
      }
    }
  }
}