Share via

CIDR-függvények ARM-sablonokhoz

  • Cikk

Ez a cikk az Azure Resource Manager-sablonban (ARM-sablonban) található CIDR-függvényeket ismerteti.

Tipp.

A Bicep használatát javasoljuk, mert ugyanazokkal a képességekkel rendelkezik, mint az ARM-sablonok, és a szintaxis használata egyszerűbb. További információ: cidr függvények.

parseCidr

parseCidr(network)

A CIDR-jelölésben szereplő IP-címtartomány elemzése a címtartomány különböző tulajdonságainak lekéréséhez.

A Bicepben használja a parseCidr függvényt.

Paraméterek

Paraméter Kötelező Típus Leírás
hálózat Igen húr A konvertálni kívánt IP-címtartományt tartalmazó CIDR-jelölésben szereplő sztring.

Visszaadott érték

A címtartomány különböző tulajdonságait tartalmazó objektum.

Példák

Az alábbi példa egy IPv4 CIDR-sztringet elemez:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "v4info": {
      "type": "object",
      "value": "[parseCidr('10.144.0.0/20')]"
    }
  }
}

Az előző példa a következő objektumot adja vissza:

{
  "network":"10.144.0.0",
  "netmask":"255.255.240.0",
  "broadcast":"10.144.15.255",
  "firstUsable":"10.144.0.1",
  "lastUsable":"10.144.15.254",
  "cidr":20
}

Az alábbi példa egy IPv6 CIDR-sztringet elemez:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "v6info": {
      "type": "object",
      "value": "[parseCidr('fdad:3236:5555::/48')]"
    }
  }
}

Az előző példa a következő objektumot adja vissza:

{
  "network":"fdad:3236:5555::",
  "netmask":"ffff:ffff:ffff::",
  "firstUsable":"fdad:3236:5555::",
  "lastUsable":"fdad:3236:5555:ffff:ffff:ffff:ffff:ffff",
  "cidr":48
}

cidrSubnet

cidrSubnet(network, newCIDR, subnetIndex)

A CIDR-jelölésben megadott IP-címtartományt alhálózatokra osztja egy új CIDR-értékkel, és visszaadja az alhálózat IP-címtartományát a megadott indexszel.

A Bicepben használja a cidrSubnet függvényt.

Paraméterek

Paraméter Kötelező Típus Leírás
hálózat Igen húr CIDR-jelölésben konvertálandó IP-címtartományt tartalmazó sztring.
newCIDR Igen egész Az alhálózathoz használandó CIDR-t jelölő egész szám. Ennek az értéknek egyenlőnek vagy nagyobbnak kell lennie, mint a network paraméter CIDR-értéke.
alhálózatindex Igen egész A visszaadni kívánt alhálózati IP-címtartomány indexe.

Visszaadott érték

Az alhálózat IP-címtartományának sztringje a megadott indexkel.

Példák

Az alábbi példa kiszámítja az első öt /24 alhálózati tartományt a megadott /20-tól:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "v4subnets": {
      "type": "array",
      "copy": {
        "count": "[length(range(0, 5))]",
        "input": "[cidrSubnet('10.144.0.0/20', 24, range(0, 5)[copyIndex()])]"
      }
    }
  }
}

Az előző példa a következő tömböt adja vissza:

[
  "10.144.0.0/24",
  "10.144.1.0/24",
  "10.144.2.0/24",
  "10.144.3.0/24",
  "10.144.4.0/24"
]

Az alábbi példa kiszámítja az első öt /52 alhálózati tartományt a megadott /48-tól:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "v6subnets": {
      "type": "array",
      "copy": {
        "count": "[length(range(0, 5))]",
        "input": "[cidrSubnet('fdad:3236:5555::/48', 52, range(0, 5)[copyIndex()])]"
      }
    }
  }
}

Az előző példa a következő tömböt adja vissza:

[
  "fdad:3236:5555::/52"
  "fdad:3236:5555:1000::/52"
  "fdad:3236:5555:2000::/52"
  "fdad:3236:5555:3000::/52"
  "fdad:3236:5555:4000::/52"
]

cidrHost

cidrHost(network, hostIndex)

Kiszámítja a gazdagép használható IP-címét a CIDR-jelölésben megadott IP-címtartomány megadott indexével. A fenntartott IP-címek esetében 192.168.1.0/24például vannak fenntartott IP-címek: 192.168.1.0 hálózati azonosító címként szolgál, míg 192.168.1.255 szórási címként funkcionál. Csak a különböző IP-címek 192.168.1.1192.168.1.254 rendelhetők hozzá a gazdagépekhez, amelyeket "használható" IP-címeknek neveznek. Így amikor a függvényt átadják, a függvény egy hostIndex of 0, 192.168.1.1 visszaadja.

A Bicepben használja a cidrHost függvényt.

Paraméterek

Paraméter Kötelező Típus Leírás
hálózat Igen húr Konvertálni kívánt IP-hálózatot tartalmazó sztring (helyes hálózati formátumnak kell lennie).
hostIndex Igen egész A visszaadni kívánt gazdagép IP-címének indexe.

Visszaadott érték

Az IP-cím sztringje.

Példák

Az alábbi példa kiszámítja az első öt használható gazdagép IP-címét a megadott /24-ből:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "v4hosts": {
      "type": "array",
      "copy": {
        "count": "[length(range(0, 5))]",
        "input": "[cidrHost('10.144.3.0/24', range(0, 5)[copyIndex()])]"
      }
    }
  }
}

Az előző példa a következő tömböt adja vissza:

[
  "10.144.3.1"
  "10.144.3.2"
  "10.144.3.3"
  "10.144.3.4"
  "10.144.3.5"
]

Az alábbi példa kiszámítja az első öt használható gazdagép IP-címét a megadott /52-ből:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "v6hosts": {
      "type": "array",
      "copy": {
        "count": "[length(range(0, 5))]",
        "input": "[cidrHost('fdad:3236:5555:3000::/52', range(0, 5)[copyIndex()])]"
      }
    }
  }
}

Az előző példa a következő tömböt adja vissza:

[
  "fdad:3236:5555:3000::1"
  "fdad:3236:5555:3000::2"
  "fdad:3236:5555:3000::3"
  "fdad:3236:5555:3000::4"
  "fdad:3236:5555:3000::5"
]

Következő lépések