API Connection

Overview

This example defines an API Connection.

{
	"app_service_plan": {
		"name": "apic-example-{env}",
		"display_name": "My Display Name",
		"details": {
			"type": "ApplicationInsights",
			"@application_insights_name": "appi-my-insights-name-{env}",
			"@key_vault_name": "kv-example-{env}",
			"secret_name": "TheNameOfTheSecretContainingApiKey",
		},
		"location": "northeurope",
		"external": false,
		"resource_group_name": "my-rg-name",
		"tags": { "example": "S0" }
	}
}

API Connection Reference

KeyValueDescription
name (required)stringThe name of the plan (see how to name)
display_name (required)stringThe name of the plan (see how to name)
details (required)One of DetailsTypeKind of the App Service Plan
locationstringResource Location (defaults to the resource group location)
externalboolA reference to an existing App Service Plan (defaults to false)
resource_group_namestringThe name of the resource group where the resource is located, only with external resources (defaults to the resource group of the deployment)
tagsobjectAdditional tags for the resource (defaults to no additional tags)

Details Type

ValueType
ApplicationInsightsApplicationInsightsType
AzureLogAnalyticsAzureLogAnalyticsType
AzureLogAnalyticsDataCollectorAzureLogAnalyticsDataCollector
AzureBlobAzureBlobType
DynamicDynamicType
SendgridSendgridType

Application Insights Type

KeyTypeDescription
@application_insights_name (required)stringA reference to an application insights resource
@key_vault_name (required)stringA reference to a key vault resource
secret_name (required)stringThe name of the secret inside of the vault

Azure Log Analytics Type

KeyTypeDescription
@log_analytics_name (required)stringA reference to log analytics resource
@key_vault_name (required)stringA reference to a key vault resource
service_principal_id (required)stringthe id of the service principal to use

Azure Log Analytics Data Collector Type

KeyTypeDescription
@log_analytics_name (required)stringA reference to log analytics resource

Azure Blob Type

KeyTypeDescription
@storage_account_name (required)stringA reference to a storage account resource

Dynamic Type

KeyTypeDescription
type (required)stringThe type of the API Connection
parameter_values (required)array of ApiConnectionParamThe type of the API Connection

Api Connection Param

KeyTypeDescription
name (required)stringThe name of the parameter
value (required)stringValue of the parameter

Sendgrid Type

KeyTypeDescription
@key_vault_name (required)stringA reference to a key vault resource
secret_name (required)stringThe name of the secret inside of the vault