Üzembehelyezési függvények a Bicep-hez

Ez a cikk a Bicep-függvényeket ismerteti az aktuális üzembe helyezéshez kapcsolódó értékek lekéréséhez.

üzembe helyezés

deployment()

Az aktuális üzembe helyezési művelettel kapcsolatos információkat adja vissza.

Névtér: az.

Visszaadott érték

Ez a függvény az üzembe helyezés során átadott objektumot adja vissza. A visszaadott objektum tulajdonságai a következőktől függően különböznek:

• helyi Bicep-fájl üzembe helyezése.
• üzembe helyezés egy erőforráscsoportban, vagy üzembe helyezés az egyik másik hatókörben (Azure-előfizetés, felügyeleti csoport vagy bérlő).

Ha helyi Bicep-fájlt helyez üzembe egy erőforráscsoportban, a függvény a következő formátumot adja vissza:

{
  "name": "",
  "properties": {
    "template": {
      "$schema": "",
      "contentVersion": "",
      "parameters": {},
      "variables": {},
      "resources": [],
      "outputs": {}
    },
    "templateHash": "",
    "parameters": {},
    "mode": "",
    "provisioningState": ""
  }
}

Azure-előfizetésben, felügyeleti csoportban vagy bérlőben történő üzembe helyezéskor a visszatérési objektum tartalmaz egy tulajdonságot location . A location tulajdonság nem szerepel a helyi Bicep-fájlok üzembe helyezésekor. A formátum a következő:

{
  "name": "",
  "location": "",
  "properties": {
    "template": {
      "$schema": "",
      "contentVersion": "",
      "resources": [],
      "outputs": {}
    },
    "templateHash": "",
    "parameters": {},
    "mode": "",
    "provisioningState": ""
  }
}

Példa

Az alábbi példa az üzembehelyezési objektumot adja vissza:

output deploymentOutput object = deployment()

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

{
  "name": "deployment",
  "properties": {
    "template": {
      "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
      "contentVersion": "1.0.0.0",
      "resources": [],
      "outputs": {
        "deploymentOutput": {
          "type": "Object",
          "value": "[deployment()]"
        }
      }
    },
    "templateHash": "13135986259522608210",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Accepted"
  }
}

környezet

environment()

Az üzembe helyezéshez használt Azure-környezettel kapcsolatos információkat adja vissza. A environment() függvény nem ismeri az erőforrás-konfigurációkat. Csak egyetlen alapértelmezett DNS-utótagot tud visszaadni az egyes erőforrástípusokhoz.

Névtér: az.

Megjegyzések

A fiókhoz tartozó regisztrált környezetek listájának megtekintéséhez használja az az cloud listát vagy a Get-AzEnvironmentet.

Visszaadott érték

Ez a függvény az aktuális Azure-környezet tulajdonságait adja vissza. Az alábbi példa a globális Azure tulajdonságait mutatja be. A szuverén felhők némileg eltérő tulajdonságokat adhatnak vissza.

{
  "name": "",
  "gallery": "",
  "graph": "",
  "portal": "",
  "graphAudience": "",
  "activeDirectoryDataLake": "",
  "batch": "",
  "media": "",
  "sqlManagement": "",
  "vmImageAliasDoc": "",
  "resourceManager": "",
  "authentication": {
    "loginEndpoint": "",
    "audiences": [
      "",
      ""
    ],
    "tenant": "",
    "identityProvider": ""
  },
  "suffixes": {
    "acrLoginServer": "",
    "azureDatalakeAnalyticsCatalogAndJob": "",
    "azureDatalakeStoreFileSystem": "",
    "azureFrontDoorEndpointSuffix": "",
    "keyvaultDns": "",
    "sqlServerHostname": "",
    "storage": ""
  }
}

Példa

Az alábbi példa Bicep-fájl a környezeti objektumot adja vissza.

output environmentOutput object = environment()

Az előző példa a következő objektumot adja vissza a globális Azure-ban való üzembe helyezéskor:

{
  "name": "AzureCloud",
  "gallery": "https://gallery.azure.com/",
  "graph": "https://graph.windows.net/",
  "portal": "https://portal.azure.com",
  "graphAudience": "https://graph.windows.net/",
  "activeDirectoryDataLake": "https://datalake.azure.net/",
  "batch": "https://batch.core.windows.net/",
  "media": "https://rest.media.azure.net",
  "sqlManagement": "https://management.core.windows.net:8443/",
  "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json",
  "resourceManager": "https://management.azure.com/",
  "authentication": {
    "loginEndpoint": "https://login.microsoftonline.com/",
    "audiences": [ "https://management.core.windows.net/", "https://management.azure.com/" ],
    "tenant": "common",
    "identityProvider": "AAD"
  },
  "suffixes": {
    "acrLoginServer": ".azurecr.io",
    "azureDatalakeAnalyticsCatalogAndJob": "azuredatalakeanalytics.net",
    "azureDatalakeStoreFileSystem": "azuredatalakestore.net",
    "azureFrontDoorEndpointSuffix": "azurefd.net",
    "keyvaultDns": ".vault.azure.net",
    "sqlServerHostname": ".database.windows.net",
    "storage": "core.windows.net"
  }
}

Következő lépések

• Az erőforrások, erőforráscsoportok vagy előfizetések értékeinek lekéréséhez tekintse meg az Erőforrásfüggvényeket.