Microsoft.ApiManagement-tjänst/serverdelar

Bicep-resursdefinition

Resurstypen tjänst/serverdel kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Resurs för Microsoft.ApiManagement/service/backends lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.ApiManagement/service/backends@2023-05-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    circuitBreaker: {
      rules: [
        {
          failureCondition: {
            count: int
            errorReasons: [
              'string'
            ]
            interval: 'string'
            percentage: int
            statusCodeRanges: [
              {
                max: int
                min: int
              }
            ]
          }
          name: 'string'
          tripDuration: 'string'
        }
      ]
    }
    credentials: {
      authorization: {
        parameter: 'string'
        scheme: 'string'
      }
      certificate: [
        'string'
      ]
      certificateIds: [
        'string'
      ]
      header: {
        {customized property}: [
          'string'
        ]
      }
      query: {
        {customized property}: [
          'string'
        ]
      }
    }
    description: 'string'
    pool: {
      services: [
        {
          id: '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
    }
    type: 'string'
    url: 'string'
  }
}

Egenskapsvärden

tjänst/serverdelar

Name Beskrivning Värde
name Resursnamnet

Se hur du anger namn och typer för underordnade resurser i Bicep.
sträng (krävs)

Teckengräns: 1–80

Giltiga tecken:
Alfanumeriska tecken och bindestreck.

Börja med bokstav och slut med alfanumeriskt.
parent I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför överordnad resurs.
Symboliskt namn för resurs av typen: tjänst
properties Egenskaper för serverdelsentitetskontrakt. BackendContractProperties

BackendContractProperties

Name Beskrivning Värde
circuitBreaker Konfiguration av backend-kretsbrytare BackendCircuitBreaker
autentiseringsuppgifter Egenskaper för kontrakt för serverdelsautentiseringsuppgifter BackendCredentialsContract
beskrivning Beskrivning av serverdelen. sträng
Pool BackendBaseParametersPool
properties Kontrakt för serverdelsegenskaper BackendProperties
Protokollet Protokoll för serverdelskommunikation. "http"
"soap" (krävs)
proxy Egenskaper för serverdelsgatewaykontrakt BackendProxyContract
resourceId Hanterings-URI för resursen i det externa systemet. Den här URL:en kan vara armresurs-ID för Logic Apps, Funktionsappar eller API Apps. sträng
title Serverdelsrubrik. sträng
Tls Egenskaper för serverdels-TLS BackendTlsProperties
typ Typ av serverdel. En serverdel kan vara antingen Enskild eller Pool. "Pool"
"Enkel"
url Körnings-URL för serverdelen. sträng (krävs)

BackendCircuitBreaker

Name Beskrivning Värde
regler Reglerna för att snubbla serverdelen. CircuitBreakerRule[]

CircuitBreakerRule

Name Beskrivning Värde
failureCondition Villkoren för att snubbla strömbrytaren. CircuitBreakerFailureCondition
name Regelnamnet. sträng
tripDuration Hur länge kretsen kommer att snubblas. sträng

CircuitBreakerFailureCondition

Name Beskrivning Värde
count Tröskelvärdet för att öppna kretsen. int
errorReasons De felorsaker som betraktas som fel. string[]
interval Det intervall under vilket felen räknas. sträng
percentage Tröskelvärdet för att öppna kretsen. int
statusCodeRanges De statuskodintervall som betraktas som fel. FailureStatusCodeRange[]

FailureStatusCodeRange

Name Beskrivning Värde
max Maximal http-statuskod. int
min Minsta http-statuskod. int

BackendCredentialsContract

Name Beskrivning Värde
auktorisering Autentisering med auktoriseringshuvud BackendAuthorizationHeaderCredentials
certifikat Lista över tumavtryck för klientcertifikat. Ignoreras om certificatesIds tillhandahålls. string[]
certificateIds Lista över klientcertifikat-ID:t. string[]
sidhuvud Beskrivning av rubrikparameter. BackendCredentialsContractHeader
query Beskrivning av frågeparameter. BackendCredentialsContractQuery

BackendAuthorizationHeaderCredentials

Name Beskrivning Värde
parameter Värdet för autentiseringsparametern. sträng (krävs)
System Namn på autentiseringsschema. sträng (krävs)

BackendCredentialsContractHeader

Name Beskrivning Värde
{anpassad egenskap} string[]

BackendCredentialsContractQuery

Name Beskrivning Värde
{anpassad egenskap} string[]

BackendBaseParametersPool

Name Beskrivning Värde
services Listan över serverdelsentiteter som tillhör en pool. BackendPoolItem[]

BackendPoolItem

Name Beskrivning Värde
id Det unika ARM-ID:t för serverdelsentiteten. ARM-ID:t bör referera till en redan befintlig serverdelsentitet. sträng (krävs)

BackendProperties

Name Beskrivning Värde
serviceFabricCluster Egenskaper för Service Fabric-kluster i serverdelen BackendServiceFabricClusterProperties

BackendServiceFabricClusterProperties

Name Beskrivning Värde
clientCertificateId Klientcertifikat-ID för hanteringsslutpunkten. sträng
clientCertificatethumbprint Tumavtrycket för klientcertifikatet för hanteringsslutpunkten. Ignoreras om certificatesIds tillhandahålls sträng
managementEndpoints Slutpunkten för klusterhantering. string[] (krävs)
maxPartitionResolutionRetries Maximalt antal återförsök vid försök att lösa partitionen. int
serverCertificateThumbprints Tumavtryck för certifikat som klusterhanteringstjänsten använder för tls-kommunikation string[]
serverX509Names Server X509-certifikatnamnsamling X509CertificateName[]

X509CertificateName

Name Beskrivning Värde
issuerCertificateThumbprint Tumavtryck för certifikatutfärdaren. sträng
name Eget namn på certifikatet. sträng

BackendProxyContract

Name Beskrivning Värde
password Lösenord för att ansluta till WebProxy Server sträng
url Egenskapen WebProxy Server AbsoluteUri som innehåller hela URI:n som lagras i URI-instansen, inklusive alla fragment och frågesträngar. sträng (krävs)
användarnamn Användarnamn för att ansluta till WebProxy-servern sträng

BackendTlsEgenskaper

Name Beskrivning Värde
validateCertificateChain Flagga som anger om validering av SSL-certifikatkedja ska utföras när du använder självsignerade certifikat för den här serverdelsvärden. boolesk
validateCertificateName Flagga som anger om validering av SSL-certifikatnamn ska göras när du använder självsignerade certifikat för den här serverdelsvärden. boolesk

Resursdefinition för ARM-mall

Resurstypen tjänst/serverdelar kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.ApiManagement/service/backends-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.ApiManagement/service/backends",
  "apiVersion": "2023-05-01-preview",
  "name": "string",
  "properties": {
    "circuitBreaker": {
      "rules": [
        {
          "failureCondition": {
            "count": "int",
            "errorReasons": [ "string" ],
            "interval": "string",
            "percentage": "int",
            "statusCodeRanges": [
              {
                "max": "int",
                "min": "int"
              }
            ]
          },
          "name": "string",
          "tripDuration": "string"
        }
      ]
    },
    "credentials": {
      "authorization": {
        "parameter": "string",
        "scheme": "string"
      },
      "certificate": [ "string" ],
      "certificateIds": [ "string" ],
      "header": {
        "{customized property}": [ "string" ]
      },
      "query": {
        "{customized property}": [ "string" ]
      }
    },
    "description": "string",
    "pool": {
      "services": [
        {
          "id": "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"
    },
    "type": "string",
    "url": "string"
  }
}

Egenskapsvärden

tjänst/serverdelar

Name Beskrivning Värde
typ Resurstypen "Microsoft.ApiManagement/service/backends"
apiVersion Resurs-API-versionen "2023-05-01-preview"
name Resursnamnet

Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar.
sträng (krävs)

Teckengräns: 1–80

Giltiga tecken:
Alfanumeriska tecken och bindestreck.

Börja med bokstav och slut med alfanumeriskt.
properties Egenskaper för serverdelsentitetskontrakt. BackendContractProperties

BackendContractProperties

Name Beskrivning Värde
circuitBreaker Konfiguration av serverdelskretsbrytare BackendCircuitBreaker
autentiseringsuppgifter Egenskaper för kontrakt för serverdelsautentiseringsuppgifter BackendCredentialsContract
beskrivning Beskrivning av serverdelen. sträng
Pool BackendBaseParametersPool
properties Kontrakt för serverdelsegenskaper BackendProperties
Protokollet Protokoll för serverdelskommunikation. "http"
"soap" (krävs)
proxy Egenskaper för serverdelsgatewaykontrakt BackendProxyContract
resourceId Hanterings-URI för resursen i det externa systemet. Den här URL:en kan vara armresurs-ID för Logic Apps, Function Apps eller API Apps. sträng
title Serverdelsrubrik. sträng
Tls Egenskaper för serverdels-TLS BackendTlsEgenskaper
typ Typ av serverdel. En serverdel kan vara antingen Enskild eller Pool. "Pool"
"Enkel"
url Körnings-URL för serverdelen. sträng (krävs)

BackendCircuitBreaker

Name Beskrivning Värde
regler Reglerna för att snubbla serverdelen. CircuitBreakerRule[]

CircuitBreakerRule

Name Beskrivning Värde
failureCondition Villkoren för att snubbla kretsbrytaren. CircuitBreakerFailureCondition
name Regelnamnet. sträng
tripDuration Hur länge kretsen kommer att snubblas. sträng

CircuitBreakerFailureCondition

Name Beskrivning Värde
count Tröskelvärdet för att öppna kretsen. int
errorReasons De felorsaker som betraktas som fel. string[]
interval Det intervall under vilket felen räknas. sträng
percentage Tröskelvärdet för att öppna kretsen. int
statusCodeRanges Statuskodintervallen som betraktas som fel. FailureStatusCodeRange[]

FailureStatusCodeRange

Name Beskrivning Värde
max Maximal http-statuskod. int
min Minsta http-statuskod. int

BackendCredentialsContract

Name Beskrivning Värde
auktorisering Autentisering med auktoriseringshuvud BackendAuthorizationHeaderCredentials
certifikat Lista över tumavtryck för klientcertifikat. Ignoreras om certificatesIds tillhandahålls. string[]
certificateIds Lista över klientcertifikat-ID:t. string[]
sidhuvud Beskrivning av rubrikparameter. BackendCredentialsContractHeader
query Beskrivning av frågeparameter. BackendCredentialsContractQuery

BackendAuthorizationHeaderCredentials

Name Beskrivning Värde
parameter Autentiseringsparametervärde. sträng (krävs)
System Namn på autentiseringsschema. sträng (krävs)

BackendCredentialsContractHeader

Name Beskrivning Värde
{anpassad egenskap} string[]

BackendCredentialsContractQuery

Name Beskrivning Värde
{anpassad egenskap} string[]

BackendBaseParametersPool

Name Beskrivning Värde
services Listan över serverdelsentiteter som tillhör en pool. BackendPoolItem[]

BackendPoolItem

Name Beskrivning Värde
id Det unika ARM-ID:t för serverdelsentiteten. ARM-ID:t bör referera till en redan befintlig serverdelsentitet. sträng (krävs)

BackendProperties

Name Beskrivning Värde
serviceFabricCluster Egenskaper för Service Fabric-kluster i serverdelen BackendServiceFabricClusterProperties

BackendServiceFabricClusterProperties

Name Beskrivning Värde
clientCertificateId Klientcertifikat-ID för hanteringsslutpunkten. sträng
clientCertificatethumbprint Tumavtrycket för klientcertifikatet för hanteringsslutpunkten. Ignoreras om certificatesIds tillhandahålls sträng
managementEndpoints Slutpunkten för klusterhantering. string[] (krävs)
maxPartitionResolutionRetries Maximalt antal återförsök vid försök att lösa partitionen. int
serverCertificateThumbprints Tumavtryck för certifikat som klusterhanteringstjänsten använder för TLS-kommunikation string[]
serverX509Names Server X509-certifikatnamnsamling X509CertificateName[]

X509CertificateName

Name Beskrivning Värde
issuerCertificateThumbprint Tumavtryck för certifikatutfärdaren. sträng
name Eget namn på certifikatet. sträng

BackendProxyContract

Name Beskrivning Värde
password Lösenord för att ansluta till WebProxy-servern sträng
url Egenskapen WebProxy Server AbsoluteUri som innehåller hela URI:n som lagras i URI-instansen, inklusive alla fragment och frågesträngar. sträng (krävs)
användarnamn Användarnamn för att ansluta till WebProxy-servern sträng

BackendTlsProperties

Name Beskrivning Värde
validateCertificateChain Flagga som anger om SSL-certifikatkedjans validering ska utföras när du använder självsignerade certifikat för den här serverdelsvärden. boolesk
validateCertificateName Flagga som anger om SSL-certifikatets namnverifiering ska utföras när du använder självsignerade certifikat för den här serverdelsvärden. boolesk

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen tjänst/serverdel kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Resurs för Microsoft.ApiManagement/service/backends lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/backends@2023-05-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      circuitBreaker = {
        rules = [
          {
            failureCondition = {
              count = int
              errorReasons = [
                "string"
              ]
              interval = "string"
              percentage = int
              statusCodeRanges = [
                {
                  max = int
                  min = int
                }
              ]
            }
            name = "string"
            tripDuration = "string"
          }
        ]
      }
      credentials = {
        authorization = {
          parameter = "string"
          scheme = "string"
        }
        certificate = [
          "string"
        ]
        certificateIds = [
          "string"
        ]
        header = {
          {customized property} = [
            "string"
          ]
        }
        query = {
          {customized property} = [
            "string"
          ]
        }
      }
      description = "string"
      pool = {
        services = [
          {
            id = "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
      }
      type = "string"
      url = "string"
    }
  })
}

Egenskapsvärden

tjänst/serverdelar

Name Beskrivning Värde
typ Resurstypen "Microsoft.ApiManagement/service/backends@2023-05-01-preview"
name Resursnamnet sträng (krävs)

Teckengräns: 1–80

Giltiga tecken:
Alfanumeriska tecken och bindestreck.

Börja med bokstav och slut med alfanumeriskt.
parent_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: tjänst
properties Egenskaper för serverdelsentitetskontrakt. BackendContractProperties

BackendContractProperties

Name Beskrivning Värde
circuitBreaker Konfiguration av backend-kretsbrytare BackendCircuitBreaker
autentiseringsuppgifter Egenskaper för kontrakt för serverdelsautentiseringsuppgifter BackendCredentialsContract
beskrivning Beskrivning av serverdelen. sträng
Pool BackendBaseParametersPool
properties Kontrakt för serverdelsegenskaper BackendProperties
Protokollet Protokoll för serverdelskommunikation. "http"
"soap" (krävs)
proxy Egenskaper för serverdelsgatewaykontrakt BackendProxyContract
resourceId Hanterings-URI för resursen i det externa systemet. Den här URL:en kan vara armresurs-ID för Logic Apps, Funktionsappar eller API Apps. sträng
title Serverdelsrubrik. sträng
Tls Egenskaper för serverdels-TLS BackendTlsProperties
typ Typ av serverdel. En serverdel kan vara antingen Enskild eller Pool. "Pool"
"Enkel"
url Körnings-URL för serverdelen. sträng (krävs)

BackendCircuitBreaker

Name Beskrivning Värde
regler Reglerna för att snubbla serverdelen. CircuitBreakerRule[]

CircuitBreakerRule

Name Beskrivning Värde
failureCondition Villkoren för att snubbla strömbrytaren. CircuitBreakerFailureCondition
name Regelnamnet. sträng
tripDuration Hur länge kretsen kommer att snubblas. sträng

CircuitBreakerFailureCondition

Name Beskrivning Värde
count Tröskelvärdet för att öppna kretsen. int
errorReasons De felorsaker som betraktas som fel. string[]
interval Det intervall under vilket felen räknas. sträng
percentage Tröskelvärdet för att öppna kretsen. int
statusCodeRanges De statuskodintervall som betraktas som fel. FailureStatusCodeRange[]

FailureStatusCodeRange

Name Beskrivning Värde
max Maximal http-statuskod. int
min Minsta http-statuskod. int

BackendCredentialsContract

Name Beskrivning Värde
auktorisering Autentisering med auktoriseringshuvud BackendAuthorizationHeaderCredentials
certifikat Lista över tumavtryck för klientcertifikat. Ignoreras om certificatesIds tillhandahålls. string[]
certificateIds Lista över klientcertifikat-ID:t. string[]
sidhuvud Beskrivning av rubrikparameter. BackendCredentialsContractHeader
query Beskrivning av frågeparameter. BackendCredentialsContractQuery

BackendAuthorizationHeaderCredentials

Name Beskrivning Värde
parameter Autentiseringsparametervärde. sträng (krävs)
System Namn på autentiseringsschema. sträng (krävs)

BackendCredentialsContractHeader

Name Beskrivning Värde
{anpassad egenskap} string[]

BackendCredentialsContractQuery

Name Beskrivning Värde
{anpassad egenskap} string[]

BackendBaseParametersPool

Name Beskrivning Värde
services Listan över serverdelsentiteter som tillhör en pool. BackendPoolItem[]

BackendPoolItem

Name Beskrivning Värde
id Det unika ARM-ID:t för serverdelsentiteten. ARM-ID:t bör referera till en redan befintlig serverdelsentitet. sträng (krävs)

BackendProperties

Name Beskrivning Värde
serviceFabricCluster Egenskaper för Service Fabric-kluster i serverdelen BackendServiceFabricClusterEgenskaper

BackendServiceFabricClusterEgenskaper

Name Beskrivning Värde
clientCertificateId Klientcertifikat-ID för hanteringsslutpunkten. sträng
clientCertificatethumbprint Tumavtrycket för klientcertifikatet för hanteringsslutpunkten. Ignoreras om certificatesIds tillhandahålls sträng
managementEndpoints Slutpunkten för klusterhantering. string[] (krävs)
maxPartitionResolutionRetries Maximalt antal återförsök vid försök att lösa partitionen. int
serverCertificateThumbprints Tumavtryck för certifikat som klusterhanteringstjänsten använder för tls-kommunikation string[]
serverX509Names Server X509-certifikatnamnsamling X509CertificateName[]

X509CertificateName

Name Beskrivning Värde
issuerCertificateThumbprint Tumavtryck för certifikatutfärdaren. sträng
name Eget namn på certifikatet. sträng

BackendProxyContract

Name Beskrivning Värde
password Lösenord för att ansluta till WebProxy Server sträng
url Egenskapen WebProxy Server AbsoluteUri som innehåller hela URI:n som lagras i URI-instansen, inklusive alla fragment och frågesträngar. sträng (krävs)
användarnamn Användarnamn för att ansluta till WebProxy-servern sträng

BackendTlsEgenskaper

Name Beskrivning Värde
validateCertificateChain Flagga som anger om validering av SSL-certifikatkedja ska utföras när du använder självsignerade certifikat för den här serverdelsvärden. boolesk
validateCertificateName Flagga som anger om validering av SSL-certifikatnamn ska göras när du använder självsignerade certifikat för den här serverdelsvärden. boolesk