Microsoft.Web connections 2015-08-01-preview

The connections resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

Template format

To create a Microsoft.Web/connections resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.Web/connections@2015-08-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  properties: {
    api: {
      id: 'string'
      kind: 'string'
      location: 'string'
      name: 'string'
      properties: {
        entity: {
          id: 'string'
          location: 'string'
          name: 'string'
          plan: {
            name: 'string'
            product: 'string'
            promotionCode: 'string'
            publisher: 'string'
            version: 'string'
          }
          properties: {
            id: 'string'
            kind: 'string'
            location: 'string'
            name: 'string'
            properties: {
              apiDefinitionUrl: 'string'
              backendService: {
                id: 'string'
                kind: 'string'
                location: 'string'
                name: 'string'
                properties: {
                  hostingEnvironmentServiceUrls: [
                    {
                      hostId: 'string'
                      hostingEnvironmentId: 'string'
                      serviceUrl: 'string'
                      useInternalRouting: bool
                    }
                  ]
                  serviceUrl: 'string'
                }
                tags: {
                  tagName1: 'tagValue1'
                  tagName2: 'tagValue2'
                }
                type: 'string'
              }
              capabilities: [ 'string' ]
              changedTime: 'string'
              connectionParameters: {}
              createdTime: 'string'
              generalInformation: {
                id: 'string'
                kind: 'string'
                location: 'string'
                name: 'string'
                properties: {
                  connectionDisplayName: 'string'
                  connectionPortalUrl: any()
                  description: 'string'
                  displayName: 'string'
                  iconUrl: 'string'
                  termsOfUseUrl: 'string'
                }
                tags: {
                  tagName1: 'tagValue1'
                  tagName2: 'tagValue2'
                }
                type: 'string'
              }
              metadata: any()
              name: 'string'
              path: 'string'
              policies: {
                id: 'string'
                kind: 'string'
                location: 'string'
                name: 'string'
                properties: {
                  content: 'string'
                }
                tags: {
                  tagName1: 'tagValue1'
                  tagName2: 'tagValue2'
                }
                type: 'string'
              }
              protocols: [ 'string' ]
              runtimeUrls: [ 'string' ]
            }
            tags: {
              tagName1: 'tagValue1'
              tagName2: 'tagValue2'
            }
            type: 'string'
          }
          sku: {
            capacity: int
            family: 'string'
            name: 'string'
            size: 'string'
            tier: 'string'
          }
          tags: {
            tagName1: 'tagValue1'
            tagName2: 'tagValue2'
          }
          type: 'string'
        }
        id: 'string'
      }
      tags: {
        tagName1: 'tagValue1'
        tagName2: 'tagValue2'
      }
      type: 'string'
    }
    changedTime: 'string'
    createdTime: 'string'
    customParameterValues: {}
    displayName: 'string'
    firstExpirationTime: 'string'
    keywords: [ 'string' ]
    metadata: any()
    name: 'string'
    nonSecretParameterValues: {}
    parameterValues: {}
    statuses: [
      {
        id: 'string'
        kind: 'string'
        location: 'string'
        name: 'string'
        properties: {
          error: {
            id: 'string'
            kind: 'string'
            location: 'string'
            name: 'string'
            properties: {
              code: 'string'
              message: 'string'
            }
            tags: {
              tagName1: 'tagValue1'
              tagName2: 'tagValue2'
            }
            type: 'string'
          }
          status: 'string'
          target: 'string'
        }
        tags: {
          tagName1: 'tagValue1'
          tagName2: 'tagValue2'
        }
        type: 'string'
      }
    ]
    tenantId: 'string'
  }
}

Property values

connections

Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.
'Microsoft.Web/connections'
apiVersion The resource api version

For Bicep, set this value in the resource declaration.
'2015-08-01-preview'
name The resource name string (required)
location Resource Location string (required)
tags Resource tags Dictionary of tag names and values. See Tags in templates
kind Kind of resource string
properties ConnectionProperties

ConnectionProperties

Name Description Value
api expanded parent object for expansion ExpandedParentApiEntity
changedTime Timestamp of last connection change. string
createdTime Timestamp of the connection creation string
customParameterValues Custom login setting values. object
displayName display name string
firstExpirationTime Time in UTC when the first expiration of OAuth tokens string
keywords List of Keywords that tag the acl string[]
metadata Any object For Bicep, you can use the any() function.
name connection name string
nonSecretParameterValues Tokens/Claim object
parameterValues Tokens/Claim object
statuses Status of the connection ConnectionStatus[]
tenantId string

ExpandedParentApiEntity

Name Description Value
id Resource Id string
kind Kind of resource string
location Resource Location string (required)
name Resource Name string
properties ExpandedParentApiEntityProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type Resource type string

ExpandedParentApiEntityProperties

Name Description Value
entity Message envelope that contains the common Azure resource manager properties and the resource provider specific content ResponseMessageEnvelopeApiEntity
id Id of connection provider string

ResponseMessageEnvelopeApiEntity

Name Description Value
id Resource Id. Typically id is populated only for responses to GET requests. Caller is responsible for passing in this
value for GET requests only.
For example: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupId}/providers/Microsoft.Web/sites/{sitename}
string
location Geo region resource belongs to e.g. SouthCentralUS, SouthEastAsia string
name Name of resource string
plan The plan object in an ARM, represents a marketplace plan ArmPlan
properties API Management ApiEntity
sku Describes a sku for a scalable resource SkuDescription
tags Tags associated with resource Dictionary of tag names and values. See Tags in templates
type Type of resource e.g Microsoft.Web/sites string

ArmPlan

Name Description Value
name The name string
product The product string
promotionCode The promotion code string
publisher The publisher string
version Version of product string

ApiEntity

Name Description Value
id Resource Id string
kind Kind of resource string
location Resource Location string (required)
name Resource Name string
properties ApiEntityProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type Resource type string

ApiEntityProperties

Name Description Value
apiDefinitionUrl API definition Url - url where the swagger can be downloaded from string
backendService API definitions with backend urls BackendServiceDefinition
capabilities Capabilities string[]
changedTime Timestamp of last connection change. string
connectionParameters Connection parameters object
createdTime Timestamp of the connection creation string
generalInformation General API information GeneralApiInformation
metadata Any object For Bicep, you can use the any() function.
name Name of the API
the URL path of this API when exposed via APIM
string
path the URL path of this API when exposed via APIM string
policies API policies ApiPolicies
protocols Protocols supported by the front end - http/https string[]
runtimeUrls Read only property returning the runtime endpoints where the API can be called string[]

BackendServiceDefinition

Name Description Value
id Resource Id string
kind Kind of resource string
location Resource Location string (required)
name Resource Name string
properties BackendServiceDefinitionProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type Resource type string

BackendServiceDefinitionProperties

Name Description Value
hostingEnvironmentServiceUrls Service Urls per Hosting environment HostingEnvironmentServiceDescriptions[]
serviceUrl Url from which the swagger payload will be fetched string

HostingEnvironmentServiceDescriptions

Name Description Value
hostId Host Id string
hostingEnvironmentId Hosting environment Id string
serviceUrl service url to use string
useInternalRouting When the backend url is in same ASE, for performance reason this flag can be set to true
If WebApp.DisableHostNames is also set it improves the security by making the back end accessible only
via API calls
Note: calls will fail if this option is used but back end is not on the same ASE
bool

GeneralApiInformation

Name Description Value
id Resource Id string
kind Kind of resource string
location Resource Location string (required)
name Resource Name string
properties GeneralApiInformationProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type Resource type string

GeneralApiInformationProperties

Name Description Value
connectionDisplayName DefaultConnectionNameTemplate string
connectionPortalUrl Any object For Bicep, you can use the any() function.
description Description string
displayName Display Name string
iconUrl Icon Url string
termsOfUseUrl a public accessible url of the Terms Of Use Url of this API string

ApiPolicies

Name Description Value
id Resource Id string
kind Kind of resource string
location Resource Location string (required)
name Resource Name string
properties ApiPoliciesProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type Resource type string

ApiPoliciesProperties

Name Description Value
content Content of xml policy string

SkuDescription

Name Description Value
capacity Current number of instances assigned to the resource int
family Family code of the resource sku string
name Name of the resource sku string
size Size specifier of the resource sku string
tier Service Tier of the resource sku string

ConnectionStatus

Name Description Value
id Resource Id string
kind Kind of resource string
location Resource Location string (required)
name Resource Name string
properties ConnectionStatusProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type Resource type string

ConnectionStatusProperties

Name Description Value
error Connection error ConnectionError
status Status string
target Target of the error string

ConnectionError

Name Description Value
id Resource Id string
kind Kind of resource string
location Resource Location string (required)
name Resource Name string
properties ConnectionErrorProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type Resource type string

ConnectionErrorProperties

Name Description Value
code code of the status string
message Description of the status string

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Alert to queue with Logic app

Deploy to Azure
This template allows you to create a Logic app that has a webhook. When the Logic app is triggered, it will add the payload you pass to an Azure Storage queue that you specify. You can add this webhook to an Azure Alert and then whenever the Alert fires, you'll get that item in the queue.
Alert to Slack with Logic app

Deploy to Azure
This template allows you to create a Logic app that has a webhook to be used from an Azure Alert. When the Alert is triggered, it will post a message to a slack channel that you specify. You need to have a slack account to use this template.
Alert to text message with Logic app

Deploy to Azure
This template allows you to create a Logic app that has a webhook to be used from an Azure Alert. When the Alert is triggered, it will send you a text message with the details of the alert. It uses the go.gl URL shortening service to include a link to the portal to see the resource.
Retrieve Azure Storage access keys in ARM template

Deploy to Azure
This template will create a Storage account, after which it will create a API connection by dynamically retrieving the primary key of the Storage account. The API connection is then used in a Logic App as a trigger polling for blob changes. The complete scenario can be found on https://blog.eldert.net/retrieve-azure-storage-access-keys-in-arm-template.
Logic App to email detailed backup reports

Deploy to Azure
Create a Logic App to send reports on backup instances, usage, jobs, policies, policy adherence, and optimization opportunities via email.
Logic App to email reports on backup instances

Deploy to Azure
Create a Logic App to send reports on backup instances protected using Azure Backup via email
Logic App to email reports on backup and restore jobs

Deploy to Azure
Create a Logic App to send reports on your backup and restore jobs via email
Logic App to email reports on backup cost optimizmation

Deploy to Azure
This template deploys a Logic App that sends periodic reports on inactive backup resources, possible backup schedule optimizations and possible backup retention optimizations, to a specified set of email addresses.
Logic App to email reports on backup policies

Deploy to Azure
Create a Logic App to send reports on your backup policies via email
Logic App to email reports on backup policy adherence

Deploy to Azure
Create a Logic App to send reports on backup policy adherence of your backup instances via email
Logic App to email summary reports on backups

Deploy to Azure
Create a Logic App to send summary reports on your backups via email.
Logic App to email reports on your Azure Backup billing

Deploy to Azure
This template deploys a Logic App that sends periodic reports on key backup billing parameters (protected instances and backup cloud storage consumed) at a billing-entity level, to a specified set of email addresses.
Azure Logic Apps - AS2 Send Receive

Deploy to Azure
Creates integration accounts for two partners, Contoso and Fabrikam, including the artifacts for partners and agreements. The template also creates logic apps between Fabrikam Sales and Contoso to demonstrate synchronous AS2 Send Receive. The template also creates logic apps between Fabrikam Finance and Contoso, which demonstrate asynchronous AS2 Send Receive.
Azure Logic Apps - B2B Disaster Recovery replication

Deploy to Azure
Creates replication Logic Apps for AS2 MIC, generated and received X12 control numbers. Each Logic App's trigger points to a primary site integration account. Each Logic App's action points to a secondary site integration account.
Correlating messages over Logic Apps using Service Bus

Deploy to Azure
which shows how we can correlate messages over Logic Apps using Azure Service Bus
Copy FTP files to Azure Blob logic app

Deploy to Azure
This template allows you to create a Logic app triggers on files in an FTP server and copies them to an Azure Blob container. You can add an additional triggers or actions to customize it to your needs.
Send email with Logic app

Deploy to Azure
This template allows you to create a Logic app that sends an email. You can add an additional triggers or actions to customize it to your needs.
Run a SQL stored procedure on a schedule via a logic app

Deploy to Azure
This template allows you to create a Logic App that will run a SQL stored procedure on schedule. Any arguments for the procedure can be put into the body section of the template.