2026.9.9.2

Overview

Name apis
Tag 2026.9.9.2
FullName br:bicepacrdevwcom.azurecr.io/bicep/modules/apimanagement/apis:2026.9.9.2
Last updated 2026-09-09 12:43:18:+00:00
Created 2026-09-09 12:43:18:+00:00
Digest sha256:ec2f5932c5cbcda855e16108b55e075b3f7156f83b109c54fdb50dc4fc9c3636

Parameters

Name Type Required Description
apiManagementName string Yes The name of the API Management service. This should match an existing API Management instance.
appInsightsInstrumentationKey string Yes The Application Insights instrumentation key used for logging and monitoring. This key is stored as a named value for use by the logger.
globalPolicyValue string Yes The global policy value (typically an XML policy) that is applied to the API Management service, usually loaded via loadTextContent(). This policy governs behavior across the service.
globalPolicyFormat string No
'xml'
The format of the global policy (e.g., xml, rawxml). Defaults to xml.
apiDefinitions array Yes ### Description
An array of API definitions that configure individual APIs in the service. Each object should include:
- name: A unique identifier for the API.
- apimPath: The path segment for the API within API Management.
- description: A short description of the API (optional).
- format: The format of the API specification (optional, default "openapi").
- subscriptionRequired: Indicates if a subscription is required to access the API (optional, default true).
- apiSpecValue: The API specification content, usually loaded via loadTextContent().
- policy: The policy content for the API, typically loaded using loadTextContent().
- backendUrl: The URL of the backend service.
- backendHeaderValue: The value for the backend header used for authentication (optional).
- backendProtocol: The protocol used to access the backend service (optional, default "http").
- backendHeaderKey: The header key for backend authentication (optional, default "x-functions-key").

### Example
<br>var apiDefinitions = {<br> name: 'apiName'<br> apimPath: 'apiPath'<br> description: 'apiDescription'<br> format: 'openapi'<br> subscriptionRequired: true<br> apiSpecValue: loadTextContent('config/openapi/apiDefinition.yaml')<br> policy: loadTextContent('config/policies/policy.template.hbs')<br> backendUrl: 'https://myApi.azurewebsites.net'<br> backendHeaderValue: 'MyTopSecretKey'<br> backendProtocol: 'http'<br> backendHeaderKey: 'x-functions-key'<br>}<br>

Outputs

Name Type Description

Example

@description('The target environment.')
param env string

@description('The deployment version.')
param version string = '1.0.0.0'

@description('The name of the API Management service. This should match an existing API Management instance.')
param apiManagementName string

@description('The Application Insights instrumentation key used for logging and monitoring. This key is stored as a named value for use by the logger.')
param appInsightsInstrumentationKey string

@description('The global policy value (typically an XML policy) that is applied to the API Management service, usually loaded via loadTextContent(). This policy governs behavior across the service.')
param globalPolicyValue string

@description('### Description
An array of API definitions that configure individual APIs in the service. Each object should include:
- **name**: A unique identifier for the API.
- **apimPath**: The path segment for the API within API Management.
- **description**: A short description of the API (optional).
- **format**: The format of the API specification (optional, default "openapi").
- **subscriptionRequired**: Indicates if a subscription is required to access the API (optional, default true).
- **apiSpecValue**: The API specification content, usually loaded via loadTextContent().
- **policy**: The policy content for the API, typically loaded using loadTextContent().
- **backendUrl**: The URL of the backend service.
- **backendHeaderValue**: The value for the backend header used for authentication (optional).
- **backendProtocol**: The protocol used to access the backend service (optional, default "http").
- **backendHeaderKey**: The header key for backend authentication (optional, default "x-functions-key").

### Example

var apiDefinitions = { name: 'apiName' apimPath: 'apiPath' description: 'apiDescription' format: 'openapi' subscriptionRequired: true apiSpecValue: loadTextContent('config/openapi/apiDefinition.yaml') policy: loadTextContent('config/policies/policy.template.hbs') backendUrl: 'https://myApi.azurewebsites.net' backendHeaderValue: 'MyTopSecretKey' backendProtocol: 'http' backendHeaderKey: 'x-functions-key' }

')
param apiDefinitions array


module apis 'br:bicepacrdevwcom.azurecr.io/bicep/modules/apimanagement/apis:2026.9.9.2' = {
    name: 'apis${env}${version}'
    params: {
      apiManagementName: apiManagementName
      appInsightsInstrumentationKey: appInsightsInstrumentationKey
      globalPolicyValue: globalPolicyValue
      apiDefinitions: apiDefinitions
    }
}