調用ALIYUN::ECS::PrefixList建立首碼列表 -

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地址塊的詳細資料，請參見專用網路FAQ。

預設值：空。

說明

首碼列表的條目數量不能大於最大條目容量（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"
        ]
      }
    }
  }
}