Microsoft.ApiManagement service/backends 2022-08-01
Bicep resource definition
The service/backends resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.ApiManagement/service/backends resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.ApiManagement/service/backends@2022-08-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
credentials: {
authorization: {
parameter: 'string'
scheme: 'string'
}
certificate: [
'string'
]
certificateIds: [
'string'
]
header: {
{customized property}: [
'string'
]
}
query: {
{customized property}: [
'string'
]
}
}
description: 'string'
properties: {
serviceFabricCluster: {
clientCertificateId: 'string'
clientCertificatethumbprint: 'string'
managementEndpoints: [
'string'
]
maxPartitionResolutionRetries: int
serverCertificateThumbprints: [
'string'
]
serverX509Names: [
{
issuerCertificateThumbprint: 'string'
name: 'string'
}
]
}
}
protocol: 'string'
proxy: {
password: 'string'
url: 'string'
username: 'string'
}
resourceId: 'string'
title: 'string'
tls: {
validateCertificateChain: bool
validateCertificateName: bool
}
url: 'string'
}
}
Property values
service/backends
| Name | Description | Value |
|---|---|---|
| name | The resource name See how to set names and types for child resources in Bicep. |
string (required) Character limit: 1-80 Valid characters: Alphanumerics and hyphens. Start with letter and end with alphanumeric. |
| parent | In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource. |
Symbolic name for resource of type: service |
| properties | Backend entity contract properties. | BackendContractProperties |
BackendContractProperties
| Name | Description | Value |
|---|---|---|
| credentials | Backend Credentials Contract Properties | BackendCredentialsContract |
| description | Backend Description. | string Constraints: Min length = 1 Max length = 2000 |
| properties | Backend Properties contract | BackendProperties |
| protocol | Backend communication protocol. | 'http''soap' (required) |
| proxy | Backend gateway Contract Properties | BackendProxyContract |
| resourceId | Management Uri of the Resource in External System. This URL can be the Arm Resource Id of Logic Apps, Function Apps or API Apps. | string Constraints: Min length = 1 Max length = 2000 |
| title | Backend Title. | string Constraints: Min length = 1 Max length = 300 |
| tls | Backend TLS Properties | BackendTlsProperties |
| url | Runtime Url of the Backend. | string (required) Constraints: Min length = 1 Max length = 2000 |
BackendCredentialsContract
| Name | Description | Value |
|---|---|---|
| authorization | Authorization header authentication | BackendAuthorizationHeaderCredentials |
| certificate | List of Client Certificate Thumbprints. Will be ignored if certificatesIds are provided. | string[] Constraints: Max length = 32 |
| certificateIds | List of Client Certificate Ids. | string[] Constraints: Max length = 32 |
| header | Header Parameter description. | BackendCredentialsContractHeader |
| query | Query Parameter description. | BackendCredentialsContractQuery |
BackendAuthorizationHeaderCredentials
| Name | Description | Value |
|---|---|---|
| parameter | Authentication Parameter value. | string (required) Constraints: Min length = 1 Max length = 300 |
| scheme | Authentication Scheme name. | string (required) Constraints: Min length = 1 Max length = 100 |
BackendCredentialsContractHeader
| Name | Description | Value |
|---|---|---|
| {customized property} | string[] |
BackendCredentialsContractQuery
| Name | Description | Value |
|---|---|---|
| {customized property} | string[] |
BackendProperties
| Name | Description | Value |
|---|---|---|
| serviceFabricCluster | Backend Service Fabric Cluster Properties | BackendServiceFabricClusterProperties |
BackendServiceFabricClusterProperties
| Name | Description | Value |
|---|---|---|
| clientCertificateId | The client certificate id for the management endpoint. | string |
| clientCertificatethumbprint | The client certificate thumbprint for the management endpoint. Will be ignored if certificatesIds are provided | string |
| managementEndpoints | The cluster management endpoint. | string[] (required) |
| maxPartitionResolutionRetries | Maximum number of retries while attempting resolve the partition. | int |
| serverCertificateThumbprints | Thumbprints of certificates cluster management service uses for tls communication | string[] |
| serverX509Names | Server X509 Certificate Names Collection | X509CertificateName[] |
X509CertificateName
| Name | Description | Value |
|---|---|---|
| issuerCertificateThumbprint | Thumbprint for the Issuer of the Certificate. | string |
| name | Common Name of the Certificate. | string |
BackendProxyContract
| Name | Description | Value |
|---|---|---|
| password | Password to connect to the WebProxy Server | string |
| url | WebProxy Server AbsoluteUri property which includes the entire URI stored in the Uri instance, including all fragments and query strings. | string (required) Constraints: Min length = 1 Max length = 2000 |
| username | Username to connect to the WebProxy server | string |
BackendTlsProperties
| Name | Description | Value |
|---|---|---|
| validateCertificateChain | Flag indicating whether SSL certificate chain validation should be done when using self-signed certificates for this backend host. | bool |
| validateCertificateName | Flag indicating whether SSL certificate name validation should be done when using self-signed certificates for this backend host. | bool |
ARM template resource definition
The service/backends resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.ApiManagement/service/backends resource, add the following JSON to your template.
{
"type": "Microsoft.ApiManagement/service/backends",
"apiVersion": "2022-08-01",
"name": "string",
"properties": {
"credentials": {
"authorization": {
"parameter": "string",
"scheme": "string"
},
"certificate": [ "string" ],
"certificateIds": [ "string" ],
"header": {
"{customized property}": [ "string" ]
},
"query": {
"{customized property}": [ "string" ]
}
},
"description": "string",
"properties": {
"serviceFabricCluster": {
"clientCertificateId": "string",
"clientCertificatethumbprint": "string",
"managementEndpoints": [ "string" ],
"maxPartitionResolutionRetries": "int",
"serverCertificateThumbprints": [ "string" ],
"serverX509Names": [
{
"issuerCertificateThumbprint": "string",
"name": "string"
}
]
}
},
"protocol": "string",
"proxy": {
"password": "string",
"url": "string",
"username": "string"
},
"resourceId": "string",
"title": "string",
"tls": {
"validateCertificateChain": "bool",
"validateCertificateName": "bool"
},
"url": "string"
}
}
Property values
service/backends
| Name | Description | Value |
|---|---|---|
| type | The resource type | 'Microsoft.ApiManagement/service/backends' |
| apiVersion | The resource api version | '2022-08-01' |
| name | The resource name See how to set names and types for child resources in JSON ARM templates. |
string (required) Character limit: 1-80 Valid characters: Alphanumerics and hyphens. Start with letter and end with alphanumeric. |
| properties | Backend entity contract properties. | BackendContractProperties |
BackendContractProperties
| Name | Description | Value |
|---|---|---|
| credentials | Backend Credentials Contract Properties | BackendCredentialsContract |
| description | Backend Description. | string Constraints: Min length = 1 Max length = 2000 |
| properties | Backend Properties contract | BackendProperties |
| protocol | Backend communication protocol. | 'http''soap' (required) |
| proxy | Backend gateway Contract Properties | BackendProxyContract |
| resourceId | Management Uri of the Resource in External System. This URL can be the Arm Resource Id of Logic Apps, Function Apps or API Apps. | string Constraints: Min length = 1 Max length = 2000 |
| title | Backend Title. | string Constraints: Min length = 1 Max length = 300 |
| tls | Backend TLS Properties | BackendTlsProperties |
| url | Runtime Url of the Backend. | string (required) Constraints: Min length = 1 Max length = 2000 |
BackendCredentialsContract
| Name | Description | Value |
|---|---|---|
| authorization | Authorization header authentication | BackendAuthorizationHeaderCredentials |
| certificate | List of Client Certificate Thumbprints. Will be ignored if certificatesIds are provided. | string[] Constraints: Max length = 32 |
| certificateIds | List of Client Certificate Ids. | string[] Constraints: Max length = 32 |
| header | Header Parameter description. | BackendCredentialsContractHeader |
| query | Query Parameter description. | BackendCredentialsContractQuery |
BackendAuthorizationHeaderCredentials
| Name | Description | Value |
|---|---|---|
| parameter | Authentication Parameter value. | string (required) Constraints: Min length = 1 Max length = 300 |
| scheme | Authentication Scheme name. | string (required) Constraints: Min length = 1 Max length = 100 |
BackendCredentialsContractHeader
| Name | Description | Value |
|---|---|---|
| {customized property} | string[] |
BackendCredentialsContractQuery
| Name | Description | Value |
|---|---|---|
| {customized property} | string[] |
BackendProperties
| Name | Description | Value |
|---|---|---|
| serviceFabricCluster | Backend Service Fabric Cluster Properties | BackendServiceFabricClusterProperties |
BackendServiceFabricClusterProperties
| Name | Description | Value |
|---|---|---|
| clientCertificateId | The client certificate id for the management endpoint. | string |
| clientCertificatethumbprint | The client certificate thumbprint for the management endpoint. Will be ignored if certificatesIds are provided | string |
| managementEndpoints | The cluster management endpoint. | string[] (required) |
| maxPartitionResolutionRetries | Maximum number of retries while attempting resolve the partition. | int |
| serverCertificateThumbprints | Thumbprints of certificates cluster management service uses for tls communication | string[] |
| serverX509Names | Server X509 Certificate Names Collection | X509CertificateName[] |
X509CertificateName
| Name | Description | Value |
|---|---|---|
| issuerCertificateThumbprint | Thumbprint for the Issuer of the Certificate. | string |
| name | Common Name of the Certificate. | string |
BackendProxyContract
| Name | Description | Value |
|---|---|---|
| password | Password to connect to the WebProxy Server | string |
| url | WebProxy Server AbsoluteUri property which includes the entire URI stored in the Uri instance, including all fragments and query strings. | string (required) Constraints: Min length = 1 Max length = 2000 |
| username | Username to connect to the WebProxy server | string |
BackendTlsProperties
| Name | Description | Value |
|---|---|---|
| validateCertificateChain | Flag indicating whether SSL certificate chain validation should be done when using self-signed certificates for this backend host. | bool |
| validateCertificateName | Flag indicating whether SSL certificate name validation should be done when using self-signed certificates for this backend host. | bool |
Terraform (AzAPI provider) resource definition
The service/backends resource type can be deployed with operations that target:
- Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.ApiManagement/service/backends resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service/backends@2022-08-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
credentials = {
authorization = {
parameter = "string"
scheme = "string"
}
certificate = [
"string"
]
certificateIds = [
"string"
]
header = {
{customized property} = [
"string"
]
}
query = {
{customized property} = [
"string"
]
}
}
description = "string"
properties = {
serviceFabricCluster = {
clientCertificateId = "string"
clientCertificatethumbprint = "string"
managementEndpoints = [
"string"
]
maxPartitionResolutionRetries = int
serverCertificateThumbprints = [
"string"
]
serverX509Names = [
{
issuerCertificateThumbprint = "string"
name = "string"
}
]
}
}
protocol = "string"
proxy = {
password = "string"
url = "string"
username = "string"
}
resourceId = "string"
title = "string"
tls = {
validateCertificateChain = bool
validateCertificateName = bool
}
url = "string"
}
})
}
Property values
service/backends
| Name | Description | Value |
|---|---|---|
| type | The resource type | "Microsoft.ApiManagement/service/backends@2022-08-01" |
| name | The resource name | string (required) Character limit: 1-80 Valid characters: Alphanumerics and hyphens. Start with letter and end with alphanumeric. |
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: service |
| properties | Backend entity contract properties. | BackendContractProperties |
BackendContractProperties
| Name | Description | Value |
|---|---|---|
| credentials | Backend Credentials Contract Properties | BackendCredentialsContract |
| description | Backend Description. | string Constraints: Min length = 1 Max length = 2000 |
| properties | Backend Properties contract | BackendProperties |
| protocol | Backend communication protocol. | "http""soap" (required) |
| proxy | Backend gateway Contract Properties | BackendProxyContract |
| resourceId | Management Uri of the Resource in External System. This URL can be the Arm Resource Id of Logic Apps, Function Apps or API Apps. | string Constraints: Min length = 1 Max length = 2000 |
| title | Backend Title. | string Constraints: Min length = 1 Max length = 300 |
| tls | Backend TLS Properties | BackendTlsProperties |
| url | Runtime Url of the Backend. | string (required) Constraints: Min length = 1 Max length = 2000 |
BackendCredentialsContract
| Name | Description | Value |
|---|---|---|
| authorization | Authorization header authentication | BackendAuthorizationHeaderCredentials |
| certificate | List of Client Certificate Thumbprints. Will be ignored if certificatesIds are provided. | string[] Constraints: Max length = 32 |
| certificateIds | List of Client Certificate Ids. | string[] Constraints: Max length = 32 |
| header | Header Parameter description. | BackendCredentialsContractHeader |
| query | Query Parameter description. | BackendCredentialsContractQuery |
BackendAuthorizationHeaderCredentials
| Name | Description | Value |
|---|---|---|
| parameter | Authentication Parameter value. | string (required) Constraints: Min length = 1 Max length = 300 |
| scheme | Authentication Scheme name. | string (required) Constraints: Min length = 1 Max length = 100 |
BackendCredentialsContractHeader
| Name | Description | Value |
|---|---|---|
| {customized property} | string[] |
BackendCredentialsContractQuery
| Name | Description | Value |
|---|---|---|
| {customized property} | string[] |
BackendProperties
| Name | Description | Value |
|---|---|---|
| serviceFabricCluster | Backend Service Fabric Cluster Properties | BackendServiceFabricClusterProperties |
BackendServiceFabricClusterProperties
| Name | Description | Value |
|---|---|---|
| clientCertificateId | The client certificate id for the management endpoint. | string |
| clientCertificatethumbprint | The client certificate thumbprint for the management endpoint. Will be ignored if certificatesIds are provided | string |
| managementEndpoints | The cluster management endpoint. | string[] (required) |
| maxPartitionResolutionRetries | Maximum number of retries while attempting resolve the partition. | int |
| serverCertificateThumbprints | Thumbprints of certificates cluster management service uses for tls communication | string[] |
| serverX509Names | Server X509 Certificate Names Collection | X509CertificateName[] |
X509CertificateName
| Name | Description | Value |
|---|---|---|
| issuerCertificateThumbprint | Thumbprint for the Issuer of the Certificate. | string |
| name | Common Name of the Certificate. | string |
BackendProxyContract
| Name | Description | Value |
|---|---|---|
| password | Password to connect to the WebProxy Server | string |
| url | WebProxy Server AbsoluteUri property which includes the entire URI stored in the Uri instance, including all fragments and query strings. | string (required) Constraints: Min length = 1 Max length = 2000 |
| username | Username to connect to the WebProxy server | string |
BackendTlsProperties
| Name | Description | Value |
|---|---|---|
| validateCertificateChain | Flag indicating whether SSL certificate chain validation should be done when using self-signed certificates for this backend host. | bool |
| validateCertificateName | Flag indicating whether SSL certificate name validation should be done when using self-signed certificates for this backend host. | bool |