Microsoft.ApiManagement service/backends 2017-03-01

The service/backends 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.ApiManagement/service/backends resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.ApiManagement/service/backends@2017-03-01' = {
  name: 'string'
  parent: parentSymbolicName
  properties: {
    credentials: {
      authorization: {
        parameter: 'string'
        scheme: 'string'
      certificate: [ 'string' ]
      header: {}
      query: {}
    description: 'string'
    properties: {
      serviceFabricCluster: {
        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


Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.
apiVersion The resource api version

For Bicep, set this value in the resource declaration.
name The resource name

See how to set names and types for child resources in Bicep or JSON ARM templates.
string (required)
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.
properties Parameters supplied to the Create Backend operation. BackendContractProperties


Name Description Value
credentials Details of the Credentials used to connect to Backend. BackendCredentialsContract
description Backend Description. string
properties Properties specific to the Backend Type. BackendProperties
protocol Backend communication protocol. 'http'
proxy Details of the Backend WebProxy Server to use in the Request to Backend. 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 Properties controlling TLS Certificate Validation. BackendTlsProperties
url Runtime Url of the Backend. string (required)


Name Description Value
authorization Authorization header information. BackendAuthorizationHeaderCredentials
certificate List of Client Certificate Thumbprint. string[]
header Header Parameter description. object
query Query Parameter description. object


Name Description Value
parameter Authentication Parameter value. string (required)
scheme Authentication Scheme name. string (required)


Name Description Value
serviceFabricCluster Properties of the Service Fabric Type Backend. BackendServiceFabricClusterProperties


Name Description Value
clientCertificatethumbprint The client certificate thumbprint for the management endpoint. string (required)
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[]


Name Description Value
issuerCertificateThumbprint Thumbprint for the Issuer of the Certificate. string
name Common Name of the Certificate. string


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


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