Jämförelsefunktioner för ARM-mallar

  • Artikel

Resource Manager innehåller flera funktioner för att göra jämförelser i din Azure Resource Manager-mall (ARM-mall):

Tips

Vi rekommenderar Bicep eftersom det har samma funktioner som ARM-mallar och syntaxen är enklare att använda. Mer information finns i den logiska operatorn coalesce och jämförelseoperatorer .

coalesce

coalesce(arg1, arg2, arg3, ...)

Returnerar det första icke-null-värdet från parametrarna. Tomma strängar, tomma matriser och tomma objekt är inte null.

I Bicep använder du operatorn ?? i stället. Se Coalesce ??.

Parametrar

Parameter Krävs Typ Beskrivning
arg1 Yes int, string, array eller object Det första värdet som ska testas för null.
fler args No int, string, array eller object Fler värden att testa för null.

Returvärde

Värdet för de första parametrarna som inte är null, som kan vara en sträng, int, matris eller objekt. Null om alla parametrar är null.

Exempel

Följande exempelmall visar utdata från olika användningar av sammanfall.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "objectToTest": {
      "type": "object",
      "defaultValue": {
        "null1": null,
        "null2": null,
        "string": "default",
        "int": 1,
        "object": { "first": "default" },
        "array": [ 1 ]
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "stringOutput": {
      "type": "string",
      "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').string)]"
    },
    "intOutput": {
      "type": "int",
      "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').int)]"
    },
    "objectOutput": {
      "type": "object",
      "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').object)]"
    },
    "arrayOutput": {
      "type": "array",
      "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').array)]"
    },
    "emptyOutput": {
      "type": "bool",
      "value": "[empty(coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2))]"
    }
  }
}

Utdata från föregående exempel med standardvärdena är:

Namn Typ Värde
stringOutput Sträng standard
intOutput Int 1
objectOutput Objekt {"first": "default"}
arrayOutput Matris  [1]
emptyOutput Bool Sant

lika med

equals(arg1, arg2)

Kontrollerar om två värden är lika med varandra.

I Bicep använder du operatorn == i stället. Se Lika med ==.

Parametrar

Parameter Krävs Typ Beskrivning
arg1 Yes int, string, array eller object Det första värdet för att söka efter likhet.
arg2 Yes int, string, array eller object Det andra värdet för att söka efter likhet.

Returvärde

Returnerar True om värdena är lika med; annars Falskt.

Kommentarer

Funktionen equals används ofta med -elementet condition för att testa om en resurs har distribuerats.

{
  "condition": "[equals(parameters('newOrExisting'),'new')]",
  "type": "Microsoft.Storage/storageAccounts",
  "name": "[variables('storageAccountName')]",
  "apiVersion": "2022-09-01",
  "location": "[resourceGroup().location]",
  "sku": {
    "name": "[variables('storageAccountType')]"
  },
  "kind": "Storage",
  "properties": {}
}

Exempel

I följande exempel kontrolleras olika typer av värden för likhet. Alla standardvärden returnerar True.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstInt": {
      "type": "int",
      "defaultValue": 1
    },
    "secondInt": {
      "type": "int",
      "defaultValue": 1
    },
    "firstString": {
      "type": "string",
      "defaultValue": "a"
    },
    "secondString": {
      "type": "string",
      "defaultValue": "a"
    },
    "firstArray": {
      "type": "array",
      "defaultValue": [ "a", "b" ]
    },
    "secondArray": {
      "type": "array",
      "defaultValue": [ "a", "b" ]
    },
    "firstObject": {
      "type": "object",
      "defaultValue": { "a": "b" }
    },
    "secondObject": {
      "type": "object",
      "defaultValue": { "a": "b" }
    }
  },
  "resources": [
  ],
  "outputs": {
    "checkInts": {
      "type": "bool",
      "value": "[equals(parameters('firstInt'), parameters('secondInt') )]"
    },
    "checkStrings": {
      "type": "bool",
      "value": "[equals(parameters('firstString'), parameters('secondString'))]"
    },
    "checkArrays": {
      "type": "bool",
      "value": "[equals(parameters('firstArray'), parameters('secondArray'))]"
    },
    "checkObjects": {
      "type": "bool",
      "value": "[equals(parameters('firstObject'), parameters('secondObject'))]"
    }
  }
}

Utdata från föregående exempel med standardvärdena är:

Namn Typ Värde
checkInts Bool Sant
checkStrings Bool Sant
checkArrays Bool Sant
checkObjects Bool Sant

I följande exempelmall används inte med lika med.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
  ],
  "outputs": {
    "checkNotEquals": {
      "type": "bool",
      "value": "[not(equals(1, 2))]"
    }
  }
}

Utdata från föregående exempel är:

Namn Typ Värde
checkNotEquals Bool Sant

större än

greater(arg1, arg2)

Kontrollerar om det första värdet är större än det andra värdet.

I Bicep använder du operatorn > i stället. Se Större än >.

Parametrar

Parameter Krävs Typ Beskrivning
arg1 Yes int eller sträng Det första värdet för den större jämförelsen.
arg2 Yes int eller sträng Det andra värdet för den större jämförelsen.

Returvärde

Returnerar Sant om det första värdet är större än det andra värdet. annars falskt.

Exempel

I följande exempel kontrolleras om det ena värdet är större än det andra.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstInt": {
      "type": "int",
      "defaultValue": 1
    },
    "secondInt": {
      "type": "int",
      "defaultValue": 2
    },
    "firstString": {
      "type": "string",
      "defaultValue": "A"
    },
    "secondString": {
      "type": "string",
      "defaultValue": "a"
    }
  },
  "resources": [
  ],
  "outputs": {
    "checkInts": {
      "type": "bool",
      "value": "[greater(parameters('firstInt'), parameters('secondInt') )]"
    },
    "checkStrings": {
      "type": "bool",
      "value": "[greater(parameters('firstString'), parameters('secondString'))]"
    }
  }
}

Utdata från föregående exempel med standardvärdena är:

Namn Typ Värde
checkInts Bool Falskt
checkStrings Bool Sant

större än eller lika med

greaterOrEquals(arg1, arg2)

Kontrollerar om det första värdet är större än eller lika med det andra värdet.

I Bicep använder du operatorn >= i stället. Se Större än eller lika med >=.

Parametrar

Parameter Krävs Typ Beskrivning
arg1 Yes int eller sträng Det första värdet för jämförelsen större eller lika med.
arg2 Yes int eller sträng Det andra värdet för jämförelsen större eller lika med.

Returvärde

Returnerar Sant om det första värdet är större än eller lika med det andra värdet. annars falskt.

Exempel

I följande exempel kontrolleras om det ena värdet är större än eller lika med det andra.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstInt": {
      "type": "int",
      "defaultValue": 1
    },
    "secondInt": {
      "type": "int",
      "defaultValue": 2
    },
    "firstString": {
      "type": "string",
      "defaultValue": "A"
    },
    "secondString": {
      "type": "string",
      "defaultValue": "a"
    }
  },
  "resources": [
  ],
  "outputs": {
    "checkInts": {
      "type": "bool",
      "value": "[greaterOrEquals(parameters('firstInt'), parameters('secondInt') )]"
    },
    "checkStrings": {
      "type": "bool",
      "value": "[greaterOrEquals(parameters('firstString'), parameters('secondString'))]"
    }
  }
}

Utdata från föregående exempel med standardvärdena är:

Namn Typ Värde
checkInts Bool Falskt
checkStrings Bool Sant

mindre än

less(arg1, arg2)

Kontrollerar om det första värdet är mindre än det andra värdet.

I Bicep använder du operatorn < i stället. Se Mindre än <.

Parametrar

Parameter Krävs Typ Beskrivning
arg1 Yes int eller sträng Det första värdet för den mindre jämförelsen.
arg2 Yes int eller sträng Det andra värdet för den mindre jämförelsen.

Returvärde

Returnerar Sant om det första värdet är mindre än det andra värdet. annars falskt.

Exempel

I följande exempel kontrolleras om det ena värdet är mindre än det andra.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstInt": {
      "type": "int",
      "defaultValue": 1
    },
    "secondInt": {
      "type": "int",
      "defaultValue": 2
    },
    "firstString": {
      "type": "string",
      "defaultValue": "A"
    },
    "secondString": {
      "type": "string",
      "defaultValue": "a"
    }
  },
  "resources": [
  ],
  "outputs": {
    "checkInts": {
      "type": "bool",
      "value": "[less(parameters('firstInt'), parameters('secondInt') )]"
    },
    "checkStrings": {
      "type": "bool",
      "value": "[less(parameters('firstString'), parameters('secondString'))]"
    }
  }
}

Utdata från föregående exempel med standardvärdena är:

Namn Typ Värde
checkInts Bool Sant
checkStrings Bool Falskt

mindre än eller lika med

lessOrEquals(arg1, arg2)

Kontrollerar om det första värdet är mindre än eller lika med det andra värdet.

I Bicep använder du operatorn <= i stället. Se Mindre än eller lika med <=.

Parametrar

Parameter Krävs Typ Beskrivning
arg1 Yes int eller sträng Det första värdet för jämförelsen mindre eller lika med.
arg2 Yes int eller sträng Det andra värdet för jämförelsen mindre eller lika med.

Returvärde

Returnerar Sant om det första värdet är mindre än eller lika med det andra värdet. annars falskt.

Exempel

I följande exempel kontrolleras om det ena värdet är mindre än eller lika med det andra.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstInt": {
      "type": "int",
      "defaultValue": 1
    },
    "secondInt": {
      "type": "int",
      "defaultValue": 2
    },
    "firstString": {
      "type": "string",
      "defaultValue": "A"
    },
    "secondString": {
      "type": "string",
      "defaultValue": "a"
    }
  },
  "resources": [
  ],
  "outputs": {
    "checkInts": {
      "type": "bool",
      "value": "[lessOrEquals(parameters('firstInt'), parameters('secondInt') )]"
    },
    "checkStrings": {
      "type": "bool",
      "value": "[lessOrEquals(parameters('firstString'), parameters('secondString'))]"
    }
  }
}

Utdata från föregående exempel med standardvärdena är:

Namn Typ Värde
checkInts Bool Sant
checkStrings Bool Falskt

Nästa steg