Microsoft.ApiManagement service/backends 2022-04-01-preview
Article 01/17/2024
1 contributor
Feedback
In this article
Bicep resource definition
The service/backends resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log .
To create a Microsoft.ApiManagement/service/backends resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.ApiManagement/service/backends@2022-04-01-preview' = {
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
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
title
Backend Title.
string
tls
Backend TLS Properties
BackendTlsProperties
url
Runtime Url of the Backend.
string (required)
BackendCredentialsContract
Name
Description
Value
parameter
Authentication Parameter value.
string (required)
scheme
Authentication Scheme name.
string (required)
Name
Description
Value
{customized property}
string[]
BackendCredentialsContractQuery
Name
Description
Value
{customized property}
string[]
BackendProperties
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)
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:
For a list of changed properties in each API version, see change log .
To create a Microsoft.ApiManagement/service/backends resource, add the following JSON to your template.
{
"type": "Microsoft.ApiManagement/service/backends",
"apiVersion": "2022-04-01-preview",
"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-04-01-preview'
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
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
title
Backend Title.
string
tls
Backend TLS Properties
BackendTlsProperties
url
Runtime Url of the Backend.
string (required)
BackendCredentialsContract
Name
Description
Value
parameter
Authentication Parameter value.
string (required)
scheme
Authentication Scheme name.
string (required)
Name
Description
Value
{customized property}
string[]
BackendCredentialsContractQuery
Name
Description
Value
{customized property}
string[]
BackendProperties
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)
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
The service/backends resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log .
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-04-01-preview"
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-04-01-preview"
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
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
title
Backend Title.
string
tls
Backend TLS Properties
BackendTlsProperties
url
Runtime Url of the Backend.
string (required)
BackendCredentialsContract
Name
Description
Value
parameter
Authentication Parameter value.
string (required)
scheme
Authentication Scheme name.
string (required)
Name
Description
Value
{customized property}
string[]
BackendCredentialsContractQuery
Name
Description
Value
{customized property}
string[]
BackendProperties
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)
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