Megosztás:


Microsoft.Web-kapcsolatok

Bicep-erőforrásdefiníció

A kapcsolatok erőforrástípusa üzembe helyezhető a következő célműveletekkel:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Web/connections erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.

resource symbolicname 'Microsoft.Web/connections@2016-06-01' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    api: {
      brandColor: 'string'
      description: 'string'
      displayName: 'string'
      iconUri: 'string'
      id: 'string'
      name: 'string'
      swagger: any(...)
      type: 'string'
    }
    changedTime: 'string'
    createdTime: 'string'
    customParameterValues: {
      {customized property}: 'string'
    }
    displayName: 'string'
    nonSecretParameterValues: {
      {customized property}: 'string'
    }
    parameterValues: {
      {customized property}: 'string'
    }
    statuses: [
      {
        error: {
          etag: 'string'
          location: 'string'
          properties: {
            code: 'string'
            message: 'string'
          }
          tags: {
            {customized property}: 'string'
          }
        }
        status: 'string'
        target: 'string'
      }
    ]
    testLinks: [
      {
        method: 'string'
        requestUri: 'string'
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Tulajdonságértékek

Microsoft.Web/kapcsolatok

Név Leírás Érték
ETag Erőforráscímke karakterlánc
hely Erőforrás helye karakterlánc
név Az erőforrás neve sztring (kötelező)
kellékek ApiConnectionDefinitionProperties
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

ApiConnectionDefinitionProperties

Név Leírás Érték
Api ApiReferencia
changedTime Az utolsó kapcsolatváltozás időbélyege karakterlánc
létrehozási idő A kapcsolat létrehozásának időbélyege karakterlánc
customParameterValues Egyéni paraméterértékek szótára ApiConnectionDefinitionPropertiesCustomParameterValues
kijelző neve Megjelenítendő név karakterlánc
nonSecretParameterValues Nemsecret paraméterértékek szótára ApiConnectionDefinitionPropertiesNonSecretParameterValues
paraméterértékek Paraméterértékek szótára ApiConnectionDefinitionPropertiesParameterValues
Állapotok A kapcsolat állapota ConnectionStatusDefinition[]
tesztLinkek Az API-kapcsolat teszteléséhez szükséges hivatkozások ApiConnectionTestLink[]

ApiConnectionDefinitionPropertiesCustomParameterValues

Név Leírás Érték

ApiConnectionDefinitionPropertiesNonSecretParameterValues

Név Leírás Érték

ApiConnectionDefinitionPropertiesParameterValues

Név Leírás Érték
Név Leírás Érték
metódus HTTP-metódus karakterlánc
requestUri Hivatkozáskérési URI tesztelése karakterlánc

ApiReferencia

Név Leírás Érték
márkaSzín Márka színe karakterlánc
leírás Az egyéni API leírása karakterlánc
kijelző neve A megjelenítendő név karakterlánc
iconUri Az ikon URI-ja karakterlánc
azonosító Erőforrás-referencia azonosítója karakterlánc
név Az API neve karakterlánc
henceg A swagger JSON-ábrázolása bármely
típus Erőforrás-referencia típusa karakterlánc

Csatlakozási hiba

Név Leírás Érték
ETag Erőforráscímke karakterlánc
hely Erőforrás helye karakterlánc
kellékek ConnectionErrorProperties
Címkék Erőforráscímkék CímkékSzótár

ConnectionErrorProperties

Név Leírás Érték
kód Az állapot kódja karakterlánc
üzenet Az állapot leírása karakterlánc

ConnectionStatusDefinition

Név Leírás Érték
hiba Csatlakozási hiba Csatlakozási hiba
állapot Az átjáró állapota karakterlánc
céladatbázis A hiba célja karakterlánc

Címkeszótár

Név Leírás Érték

Címkeszótár

Név Leírás Érték

Használati példák

Azure gyorsútmutató-minták

Az alábbi Azure rövid útmutatósablonok bicep-mintákat tartalmaznak az erőforrástípus üzembe helyezéséhez.

Bicep-fájl Leírás
Azure Logic Apps – AS2 Fogadás küldése Integrációs fiókokat hoz létre két partner, a Contoso és a Fabrikam számára, beleértve a partnerek és a szerződések összetevőit is. A sablon logikai alkalmazásokat is létrehoz a Fabrikam Sales és a Contoso között, hogy bemutassa a szinkron AS2 Fogadás küldése funkciót. A sablon logikai alkalmazásokat is létrehoz a Fabrikam Finance és a Contoso között, amelyek az aszinkron AS2 Fogadás küldése funkciót mutatják be.
FTP-fájlok másolása az Azure Blob logikai alkalmazásba Ez a sablon lehetővé teszi, hogy logikai alkalmazás-eseményindítókat hozzon létre egy FTP-kiszolgálón lévő fájlokon, és átmásolja őket egy Azure Blob-tárolóba. További eseményindítókat vagy műveleteket is hozzáadhat, amelyekkel testre szabhatja az igényeinek megfelelően.
Azure Storage hozzáférési kulcsok lekérése ARM-sablonban Ez a sablon létrehoz egy Storage-fiókot, amely után létrehoz egy API-kapcsolatot a Tárfiók elsődleges kulcsának dinamikus lekérésével. Az API-kapcsolatot ezután egy logikai alkalmazásban használják a blobmódosítások eseményindító lekérdezéseként.

ARM-sablon erőforrásdefiníciója

A kapcsolatok erőforrástípusa üzembe helyezhető a következő célműveletekkel:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Web/connections erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

{
  "type": "Microsoft.Web/connections",
  "apiVersion": "2016-06-01",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "api": {
      "brandColor": "string",
      "description": "string",
      "displayName": "string",
      "iconUri": "string",
      "id": "string",
      "name": "string",
      "swagger": {},
      "type": "string"
    },
    "changedTime": "string",
    "createdTime": "string",
    "customParameterValues": {
      "{customized property}": "string"
    },
    "displayName": "string",
    "nonSecretParameterValues": {
      "{customized property}": "string"
    },
    "parameterValues": {
      "{customized property}": "string"
    },
    "statuses": [
      {
        "error": {
          "etag": "string",
          "location": "string",
          "properties": {
            "code": "string",
            "message": "string"
          },
          "tags": {
            "{customized property}": "string"
          }
        },
        "status": "string",
        "target": "string"
      }
    ],
    "testLinks": [
      {
        "method": "string",
        "requestUri": "string"
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Tulajdonságértékek

Microsoft.Web/kapcsolatok

Név Leírás Érték
apiVersion Az API verziója '2016-06-01'
ETag Erőforráscímke karakterlánc
hely Erőforrás helye karakterlánc
név Az erőforrás neve sztring (kötelező)
kellékek ApiConnectionDefinitionProperties
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
típus Az erőforrás típusa "Microsoft.Web/connections"

ApiConnectionDefinitionProperties

Név Leírás Érték
Api ApiReferencia
changedTime Az utolsó kapcsolatváltozás időbélyege karakterlánc
létrehozási idő A kapcsolat létrehozásának időbélyege karakterlánc
customParameterValues Egyéni paraméterértékek szótára ApiConnectionDefinitionPropertiesCustomParameterValues
kijelző neve Megjelenítendő név karakterlánc
nonSecretParameterValues Nemsecret paraméterértékek szótára ApiConnectionDefinitionPropertiesNonSecretParameterValues
paraméterértékek Paraméterértékek szótára ApiConnectionDefinitionPropertiesParameterValues
Állapotok A kapcsolat állapota ConnectionStatusDefinition[]
tesztLinkek Az API-kapcsolat teszteléséhez szükséges hivatkozások ApiConnectionTestLink[]

ApiConnectionDefinitionPropertiesCustomParameterValues

Név Leírás Érték

ApiConnectionDefinitionPropertiesNonSecretParameterValues

Név Leírás Érték

ApiConnectionDefinitionPropertiesParameterValues

Név Leírás Érték
Név Leírás Érték
metódus HTTP-metódus karakterlánc
requestUri Hivatkozáskérési URI tesztelése karakterlánc

ApiReferencia

Név Leírás Érték
márkaSzín Márka színe karakterlánc
leírás Az egyéni API leírása karakterlánc
kijelző neve A megjelenítendő név karakterlánc
iconUri Az ikon URI-ja karakterlánc
azonosító Erőforrás-referencia azonosítója karakterlánc
név Az API neve karakterlánc
henceg A swagger JSON-ábrázolása bármely
típus Erőforrás-referencia típusa karakterlánc

Csatlakozási hiba

Név Leírás Érték
ETag Erőforráscímke karakterlánc
hely Erőforrás helye karakterlánc
kellékek ConnectionErrorProperties
Címkék Erőforráscímkék CímkékSzótár

ConnectionErrorProperties

Név Leírás Érték
kód Az állapot kódja karakterlánc
üzenet Az állapot leírása karakterlánc

ConnectionStatusDefinition

Név Leírás Érték
hiba Csatlakozási hiba Csatlakozási hiba
állapot Az átjáró állapota karakterlánc
céladatbázis A hiba célja karakterlánc

Címkeszótár

Név Leírás Érték

Címkeszótár

Név Leírás Érték

Használati példák

Azure gyorsútmutató-sablonok

Az alábbi Azure rövid útmutatósablonok üzembe helyezni ezt az erőforrástípust.

Sablon Leírás
Riasztás a logikai alkalmazás

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy webhookot tartalmazó logikai alkalmazás létrehozását. A logikai alkalmazás aktiválása után hozzáadja a megadott Azure Storage-üzenetsorhoz átadott hasznos adatokat. Ezt a webhookot hozzáadhatja egy Azure-riasztáshoz, majd amikor a riasztás aktiválódik, az elemet az üzenetsorba fogja helyezni.
Slack-riasztás logikai alkalmazással

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy olyan logikai alkalmazás létrehozását, amely egy Azure Alertből használható webhookkal rendelkezik. Amikor a riasztás aktiválódik, üzenetet küld egy ön által megadott tartalékidő-csatornára. A sablon használatához tartalékidő-fiókkal kell rendelkeznie.
Sms-riasztás a Logikai alkalmazás

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy olyan logikai alkalmazás létrehozását, amely egy Azure Alertből használható webhookkal rendelkezik. Amikor a riasztás aktiválódik, egy szöveges üzenetet küld a riasztás részleteivel. A go.gl URL-rövidítési szolgáltatást használja, hogy a portálra mutató hivatkozást tartalmazzon az erőforrás megtekintéséhez.
Azure Logic Apps – AS2 Fogadás küldése

Üzembe helyezés az Azure
Integrációs fiókokat hoz létre két partner, a Contoso és a Fabrikam számára, beleértve a partnerek és a szerződések összetevőit is. A sablon logikai alkalmazásokat is létrehoz a Fabrikam Sales és a Contoso között, hogy bemutassa a szinkron AS2 Fogadás küldése funkciót. A sablon logikai alkalmazásokat is létrehoz a Fabrikam Finance és a Contoso között, amelyek az aszinkron AS2 Fogadás küldése funkciót mutatják be.
Azure Logic Apps – B2B Vészhelyreállítás replikációs

Üzembe helyezés az Azure
Létrehoz egy replikációs Logic Apps-alkalmazást az AS2 MIC-hez, generálja és fogadja az X12-vezérlőszámokat. Minden logikai alkalmazás eseményindítója egy elsődleges helyintegrációs fiókra mutat. Minden logikai alkalmazás művelete egy másodlagos helyintegrációs fiókra mutat.
FTP-fájlok másolása az Azure Blob logikai alkalmazásba

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi, hogy logikai alkalmazás-eseményindítókat hozzon létre egy FTP-kiszolgálón lévő fájlokon, és átmásolja őket egy Azure Blob-tárolóba. További eseményindítókat vagy műveleteket is hozzáadhat, amelyekkel testre szabhatja az igényeinek megfelelően.
Üzenetek korrelálása a Logic Apps szolgáltatáson keresztül a Service Bus

Üzembe helyezés az Azure
amely bemutatja, hogyan korrelálhatjuk az üzeneteket a Logic Appsben az Azure Service Bus használatával
Minta logikai alkalmazás üzembe helyezése jogosultságkezelési egyéni bővítményként való használatra

Üzembe helyezés az Azure
Ez a sablon létrehoz egy egyszerű logikai alkalmazást az összes engedélyezési házirend-beállítással, a szolgáltatás mostantól lehetővé teszi a jogosultságkezelési egyéni bővítmény API által igényelt jegyek és séma http-eseményindítóhoz való létrehozását.
Logikai alkalmazás részletes biztonsági mentési jelentések e-mailben való elküldéséhez

Üzembe helyezés az Azure
Hozzon létre egy logikai alkalmazást, amely e-mailben küld jelentéseket a biztonsági mentési példányokról, a használatról, a feladatokról, a szabályzatokról, a szabályzatok betartásáról és az optimalizálási lehetőségekről.
Logikai alkalmazás a biztonsági mentési és visszaállítási feladatokról szóló jelentések e-mailben való elküldéséhez

Üzembe helyezés az Azure
Logikai alkalmazás létrehozása a biztonsági mentési és visszaállítási feladatok e-mailben történő küldéséhez
Logikai alkalmazás a biztonsági mentési költségek optimalizálásával kapcsolatos jelentések e-mailben való elküldéséhez

Üzembe helyezés az Azure
Ez a sablon üzembe helyez egy logikai alkalmazást, amely rendszeres jelentéseket küld az inaktív biztonsági mentési erőforrásokról, a biztonsági mentés ütemezésének lehetséges optimalizálásairól és a biztonsági mentések megőrzési optimalizálásáról egy megadott e-mail-címre.
Logikai alkalmazás a biztonsági mentési példányokról szóló jelentések e-mailben való elküldéséhez

Üzembe helyezés az Azure
Logikai alkalmazás létrehozása, amely e-mailben küld jelentéseket az Azure Backup használatával védett biztonsági mentési példányokról
Logikai alkalmazás a biztonsági mentési szabályzatokról szóló jelentések e-mailben való elküldéséhez

Üzembe helyezés az Azure
Logikai alkalmazás létrehozása a biztonsági mentési szabályzatokkal kapcsolatos jelentések e-mailben történő küldéséhez
Logikai alkalmazás a biztonsági mentési szabályzat betartásáról szóló jelentések e-mailben való elküldéséhez

Üzembe helyezés az Azure
Logikai alkalmazás létrehozása a biztonsági mentési példányok biztonsági mentési szabályzatának betartásáról e-mailben történő küldéséhez
Logic Appot az Azure Backup számlázási

Üzembe helyezés az Azure
Ez a sablon üzembe helyez egy logikai alkalmazást, amely rendszeres jelentéseket küld a fő biztonsági mentési számlázási paraméterekről (a védett példányokról és a felhasznált felhőbeli tárolókról) egy számlázási entitás szintjén, egy megadott e-mail-címre.
Logikai alkalmazás a biztonsági mentések összefoglaló jelentéseinek e-mail-küldéséhez

Üzembe helyezés az Azure
Hozzon létre egy logikai alkalmazást, amellyel összefoglaló jelentéseket küldhet a biztonsági másolatokról e-mailben.
Azure Storage hozzáférési kulcsok lekérése ARM-sablonban

Üzembe helyezés az Azure
Ez a sablon létrehoz egy Storage-fiókot, amely után létrehoz egy API-kapcsolatot a Tárfiók elsődleges kulcsának dinamikus lekérésével. Az API-kapcsolatot ezután egy logikai alkalmazásban használják a blobmódosítások eseményindító lekérdezéseként.
SQL-ben tárolt eljárás futtatása ütemezés szerint egy logikai alkalmazáson keresztül

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy logikai alkalmazás létrehozását, amely ütemezés szerint futtat egy SQL-ben tárolt eljárást. Az eljárás argumentumai a sablon törzsszakaszába helyezhetők.
E-mail küldése a Logic App

Üzembe helyezés az Azure
Ez a sablon lehetővé teszi egy logikai alkalmazás létrehozását, amely e-mailt küld. További eseményindítókat vagy műveleteket is hozzáadhat, amelyekkel testre szabhatja az igényeinek megfelelően.

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

A kapcsolatok erőforrástípusa üzembe helyezhető a következő célműveletekkel:

  • erőforráscsoportok

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Web/connections erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/connections@2016-06-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    etag = "string"
    properties = {
      api = {
        brandColor = "string"
        description = "string"
        displayName = "string"
        iconUri = "string"
        id = "string"
        name = "string"
        swagger = ?
        type = "string"
      }
      changedTime = "string"
      createdTime = "string"
      customParameterValues = {
        {customized property} = "string"
      }
      displayName = "string"
      nonSecretParameterValues = {
        {customized property} = "string"
      }
      parameterValues = {
        {customized property} = "string"
      }
      statuses = [
        {
          error = {
            etag = "string"
            location = "string"
            properties = {
              code = "string"
              message = "string"
            }
            tags = {
              {customized property} = "string"
            }
          }
          status = "string"
          target = "string"
        }
      ]
      testLinks = [
        {
          method = "string"
          requestUri = "string"
        }
      ]
    }
  }
}

Tulajdonságértékek

Microsoft.Web/kapcsolatok

Név Leírás Érték
ETag Erőforráscímke karakterlánc
hely Erőforrás helye karakterlánc
név Az erőforrás neve sztring (kötelező)
kellékek ApiConnectionDefinitionProperties
Címkék Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft.Web/connections@2016-06-01"

ApiConnectionDefinitionProperties

Név Leírás Érték
Api ApiReferencia
changedTime Az utolsó kapcsolatváltozás időbélyege karakterlánc
létrehozási idő A kapcsolat létrehozásának időbélyege karakterlánc
customParameterValues Egyéni paraméterértékek szótára ApiConnectionDefinitionPropertiesCustomParameterValues
kijelző neve Megjelenítendő név karakterlánc
nonSecretParameterValues Nemsecret paraméterértékek szótára ApiConnectionDefinitionPropertiesNonSecretParameterValues
paraméterértékek Paraméterértékek szótára ApiConnectionDefinitionPropertiesParameterValues
Állapotok A kapcsolat állapota ConnectionStatusDefinition[]
tesztLinkek Az API-kapcsolat teszteléséhez szükséges hivatkozások ApiConnectionTestLink[]

ApiConnectionDefinitionPropertiesCustomParameterValues

Név Leírás Érték

ApiConnectionDefinitionPropertiesNonSecretParameterValues

Név Leírás Érték

ApiConnectionDefinitionPropertiesParameterValues

Név Leírás Érték
Név Leírás Érték
metódus HTTP-metódus karakterlánc
requestUri Hivatkozáskérési URI tesztelése karakterlánc

ApiReferencia

Név Leírás Érték
márkaSzín Márka színe karakterlánc
leírás Az egyéni API leírása karakterlánc
kijelző neve A megjelenítendő név karakterlánc
iconUri Az ikon URI-ja karakterlánc
azonosító Erőforrás-referencia azonosítója karakterlánc
név Az API neve karakterlánc
henceg A swagger JSON-ábrázolása bármely
típus Erőforrás-referencia típusa karakterlánc

Csatlakozási hiba

Név Leírás Érték
ETag Erőforráscímke karakterlánc
hely Erőforrás helye karakterlánc
kellékek ConnectionErrorProperties
Címkék Erőforráscímkék CímkékSzótár

ConnectionErrorProperties

Név Leírás Érték
kód Az állapot kódja karakterlánc
üzenet Az állapot leírása karakterlánc

ConnectionStatusDefinition

Név Leírás Érték
hiba Csatlakozási hiba Csatlakozási hiba
állapot Az átjáró állapota karakterlánc
céladatbázis A hiba célja karakterlánc

Címkeszótár

Név Leírás Érték

Címkeszótár

Név Leírás Érték

Használati példák

Terraform minták

Alapvető példa az API-kapcsolat telepítésére.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

provider "azurerm" {
  features {
  }
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "eastus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "workflows" {
  type      = "Microsoft.Logic/workflows@2019-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    identity = {
      type                   = "None"
      userAssignedIdentities = null
    }
    properties = {
      definition = {
        "$schema"      = "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#"
        contentVersion = "1.0.0.0"
      }
      state = "Enabled"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "namespaces" {
  type      = "Microsoft.ServiceBus/namespaces@2022-10-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    identity = {
      type                   = "None"
      userAssignedIdentities = null
    }
    properties = {
      disableLocalAuth           = false
      minimumTlsVersion          = "1.2"
      premiumMessagingPartitions = 0
      publicNetworkAccess        = "Enabled"
    }
    sku = {
      capacity = 0
      name     = "Basic"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azurerm_managed_api" "test" {
  name     = "servicebus"
  location = var.location

  depends_on = [azapi_resource.workflows, azapi_resource.namespaces]
}

resource "azapi_resource" "connection" {
  type      = "Microsoft.Web/connections@2016-06-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      api = {
        id = data.azurerm_managed_api.test.id
      }
      displayName = "Service Bus"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}