Conexiones Microsoft.Web

Definición de recursos de Bicep

El tipo de recurso connections se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/connections, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Web/connections@2016-06-01' = {
  scope: resourceSymbolicName or scope
  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'
  }
}

Valores de propiedad

Microsoft.Web/conexiones

ApiConnectionDefinitionProperties

ApiConnectionDefinitionPropertiesCustomParameterValues

ApiConnectionDefinitionPropertiesNonSecretParameterValues

ApiConnectionDefinitionPropertiesParameterValues

ApiConnectionTestLink

ApiReference (Referencia de API)

ConnectionError

ConnectionErrorProperties

ConnectionStatusDefinition

Diccionario de Etiquetas

Diccionario de Etiquetas

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Definición de recursos de plantilla de ARM

El tipo de recurso connections se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/connections, agregue el siguiente JSON a la plantilla.

{
  "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"
  }
}

Valores de propiedad

Microsoft.Web/conexiones

ApiConnectionDefinitionProperties

ApiConnectionDefinitionPropertiesCustomParameterValues

ApiConnectionDefinitionPropertiesNonSecretParameterValues

ApiConnectionDefinitionPropertiesParameterValues

ApiConnectionTestLink

ApiReference (Referencia de API)

ConnectionError

ConnectionErrorProperties

ConnectionStatusDefinition

Diccionario de Etiquetas

Diccionario de Etiquetas

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla	Descripción
Alerta a la cola con de aplicación lógica	Esta plantilla le permite crear una aplicación lógica que tenga un webhook. Cuando se desencadene la aplicación lógica, agregará la carga que pase a una cola de Azure Storage que especifique. Puede agregar este webhook a una alerta de Azure y, a continuación, cada vez que se active la alerta, obtendrá ese elemento en la cola.
alerta a Slack con la aplicación lógica	Esta plantilla permite crear una aplicación lógica que tenga un webhook que se usará desde una alerta de Azure. Cuando se desencadene la alerta, publicará un mensaje en un canal de slack que especifique. Debe tener una cuenta de Slack para usar esta plantilla.
mensaje de alerta al texto con de aplicación lógica	Esta plantilla permite crear una aplicación lógica que tenga un webhook que se usará desde una alerta de Azure. Cuando se desencadene la alerta, le enviará un mensaje de texto con los detalles de la alerta. Usa el go.gl servicio de acortamiento de direcciones URL para incluir un vínculo al portal para ver el recurso.
Azure Logic Apps: de recepción de envío as2	Crea cuentas de integración para dos asociados, Contoso y Fabrikam, incluidos los artefactos para asociados y contratos. La plantilla también crea aplicaciones lógicas entre Fabrikam Sales y Contoso para demostrar la recepción de envío as2 sincrónica. La plantilla también crea aplicaciones lógicas entre Fabrikam Finance y Contoso, que muestran la recepción asincrónica de envío asincrónica de AS2.
Azure Logic Apps: replicación de recuperación ante desastres B2B	Crea aplicaciones lógicas de replicación para MIC AS2, generadas y recibidas números de control X12. El desencadenador de cada aplicación lógica apunta a una cuenta de integración de sitio primario. La acción de cada aplicación lógica apunta a una cuenta de integración de sitio secundario.
copia de archivos FTP en una aplicación lógica de blobs de Azure	Esta plantilla permite crear desencadenadores de aplicación lógica en archivos de un servidor FTP y copiarlos en un contenedor de blobs de Azure. Puede agregar desencadenadores o acciones adicionales para personalizarlos a sus necesidades.
correlacionar mensajes a través de Logic Apps mediante service Bus	que muestra cómo podemos correlacionar los mensajes a través de Logic Apps mediante Azure Service Bus
Implementación de una aplicación lógica de ejemplo para usarla como extensiones personalizadas de administración de derechos	Esta plantilla crea una aplicación lógica sencilla con toda la configuración de la directiva de autorización, el servicio ahora connetion para crear vales y esquema para el desencadenador http que necesita la API de extensión personalizada de Administración de derechos.
Aplicación lógica para enviar por correo electrónico informes detallados de copia de seguridad	Cree una aplicación lógica para enviar informes sobre instancias de copia de seguridad, uso, trabajos, directivas, cumplimiento de directivas y oportunidades de optimización por correo electrónico.
Aplicación lógica para enviar informes por correo electrónico sobre trabajos de copia de seguridad y restauración	Creación de una aplicación lógica para enviar informes en los trabajos de copia de seguridad y restauración por correo electrónico
Aplicación lógica para enviar informes por correo electrónico sobre la optimización de costos de copia de seguridad	Esta plantilla implementa una aplicación lógica que envía informes periódicos sobre recursos de copia de seguridad inactivos, posibles optimizaciones de programación de copia de seguridad y posibles optimizaciones de retención de copia de seguridad, a un conjunto especificado de direcciones de correo electrónico.
Aplicación lógica para enviar por correo electrónico informes sobre instancias de copia de seguridad	Creación de una aplicación lógica para enviar informes en instancias de copia de seguridad protegidas mediante Azure Backup por correo electrónico
Aplicación lógica para enviar informes por correo electrónico sobre las directivas de copia de seguridad	Creación de una aplicación lógica para enviar informes en las directivas de copia de seguridad por correo electrónico
aplicación lógica para enviar informes por correo electrónico sobre el cumplimiento de directivas de copia de seguridad	Creación de una aplicación lógica para enviar informes sobre el cumplimiento de la directiva de copia de seguridad de las instancias de copia de seguridad por correo electrónico
Aplicación lógica para enviar informes por correo electrónico en el de facturación de Azure Backup	Esta plantilla implementa una aplicación lógica que envía informes periódicos sobre los parámetros de facturación de copia de seguridad de claves (instancias protegidas y almacenamiento en la nube de copia de seguridad consumido) en un nivel de entidad de facturación, en un conjunto especificado de direcciones de correo electrónico.
logic App to email summary reports on backups	Cree una aplicación lógica para enviar informes de resumen en las copias de seguridad por correo electrónico.
Recuperación de claves de acceso de Azure Storage en de plantilla de ARM	Esta plantilla creará una cuenta de almacenamiento, después de la cual creará una conexión de API mediante la recuperación dinámica de la clave principal de la cuenta de almacenamiento. Después, la conexión de API se usa en una aplicación lógica como sondeo de desencadenador para los cambios de blobs.
Ejecutar un procedimiento almacenado de SQL según una programación a través de una aplicación lógica	Esta plantilla permite crear una aplicación lógica que ejecute un procedimiento almacenado de SQL según la programación. Los argumentos del procedimiento se pueden colocar en la sección cuerpo de la plantilla.
Enviar correo electrónico con la aplicación lógica	Esta plantilla le permite crear una aplicación lógica que envíe un correo electrónico. Puede agregar desencadenadores o acciones adicionales para personalizarlos a sus necesidades.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso connections se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/connections, agregue el siguiente terraform a la plantilla.

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"
        }
      ]
    }
  }
}

Valores de propiedad

Microsoft.Web/conexiones

ApiConnectionDefinitionProperties

ApiConnectionDefinitionPropertiesCustomParameterValues

ApiConnectionDefinitionPropertiesNonSecretParameterValues

ApiConnectionDefinitionPropertiesParameterValues

ApiConnectionTestLink

ApiReference (Referencia de API)

ConnectionError

ConnectionErrorProperties

ConnectionStatusDefinition

Diccionario de Etiquetas

Diccionario de Etiquetas

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de API Connection.

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    = ["*"]
}