Partager via

Service Microsoft.ApiManagement/backends 2019-12-01

  • Article

Définition de ressource Bicep

Le type de ressource de service/back-ends peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ApiManagement/service/backends, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ApiManagement/service/backends@2019-12-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    credentials: {
      authorization: {
        parameter: 'string'
        scheme: 'string'
      }
      certificate: [
        'string'
      ]
      header: {
        {customized property}: [
          'string'
        ]
      }
      query: {
        {customized property}: [
          'string'
        ]
      }
    }
    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'
  }
}

Valeurs de propriété

BackendAuthorizationHeaderCredentials

Nom Description Valeur
paramètre Valeur du paramètre d’authentification. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
schéma Nom du schéma d’authentification. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)

BackendContractProperties

Nom Description Valeur
Pouvoirs Propriétés du contrat d’informations d’identification du serveur principal BackendCredentialsContract
description Description du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
Propriétés Contrat propriétés du back-end BackendProperties
protocole Protocole de communication back-end. 'http'
'soap' (obligatoire)
procuration Propriétés du contrat de proxy principal backendProxyContract
resourceId URI de gestion de la ressource dans le système externe. Cette URL peut être l’ID de ressource Arm des applications logiques, des applications de fonction ou des applications API. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
titre Titre du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
tls Propriétés TLS du back-end BackendTlsProperties
URL URL du runtime du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)

BackendCredentialsContract

Nom Description Valeur
autorisation Authentification de l’en-tête d’autorisation BackendAuthorizationHeaderCredentials
certificat Liste de l’empreinte numérique du certificat client. string[]
en-tête Description du paramètre d’en-tête. BackendCredentialsContractHeader
requête Description du paramètre de requête. BackendCredentialsContractQuery

BackendCredentialsContractHeader

Nom Description Valeur

BackendCredentialsContractQuery

Nom Description Valeur

BackendProperties

Nom Description Valeur
serviceFabricCluster Propriétés du cluster Service Fabric principal BackendServiceFabricClusterProperties

BackendProxyContract

Nom Description Valeur
mot de passe Mot de passe pour se connecter au serveur WebProxy corde
URL Propriété WebProxy Server AbsoluteUri qui inclut l’URI entier stocké dans l’instance d’URI, y compris tous les fragments et chaînes de requête. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
nom d’utilisateur Nom d’utilisateur pour se connecter au serveur WebProxy corde

BackendServiceFabricClusterProperties

Nom Description Valeur
clientCertificatethumbprint Empreinte numérique du certificat client pour le point de terminaison de gestion. chaîne (obligatoire)
managementEndpoints Point de terminaison de gestion du cluster. string[] (obligatoire)
maxPartitionResolutionRetries Nombre maximal de nouvelles tentatives lors de la tentative de résolution de la partition. Int
serverCertificateThumbprints Empreintes du service de gestion de cluster de certificats utilisée pour la communication tls string[]
serverX509Names Collection de noms de certificats Server X509 X509CertificateName[]

BackendTlsProperties

Nom Description Valeur
validateCertificateChain Indicateur indiquant si la validation de la chaîne de certificats SSL doit être effectuée lors de l’utilisation de certificats auto-signés pour cet hôte principal. Bool
validateCertificateName Indicateur indiquant si la validation du nom de certificat SSL doit être effectuée lors de l’utilisation de certificats auto-signés pour cet hôte principal. Bool

Microsoft.ApiManagement/service/backends

Nom Description Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.		 Nom symbolique de la ressource de type : service
Propriétés Propriétés du contrat d’entité back-end. BackendContractProperties

X509CertificateName

Nom Description Valeur
issuerCertificateThumbprint Empreinte numérique de l’émetteur du certificat. corde
nom Nom commun du certificat. corde

Définition de ressource de modèle ARM

Le type de ressource de service/back-ends peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ApiManagement/service/backends, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ApiManagement/service/backends",
  "apiVersion": "2019-12-01",
  "name": "string",
  "properties": {
    "credentials": {
      "authorization": {
        "parameter": "string",
        "scheme": "string"
      },
      "certificate": [ "string" ],
      "header": {
        "{customized property}": [ "string" ]
      },
      "query": {
        "{customized property}": [ "string" ]
      }
    },
    "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"
  }
}

Valeurs de propriété

BackendAuthorizationHeaderCredentials

Nom Description Valeur
paramètre Valeur du paramètre d’authentification. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
schéma Nom du schéma d’authentification. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)

BackendContractProperties

Nom Description Valeur
Pouvoirs Propriétés du contrat d’informations d’identification du serveur principal BackendCredentialsContract
description Description du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
Propriétés Contrat propriétés du back-end BackendProperties
protocole Protocole de communication back-end. 'http'
'soap' (obligatoire)
procuration Propriétés du contrat de proxy principal backendProxyContract
resourceId URI de gestion de la ressource dans le système externe. Cette URL peut être l’ID de ressource Arm des applications logiques, des applications de fonction ou des applications API. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
titre Titre du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
tls Propriétés TLS du back-end BackendTlsProperties
URL URL du runtime du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)

BackendCredentialsContract

Nom Description Valeur
autorisation Authentification de l’en-tête d’autorisation BackendAuthorizationHeaderCredentials
certificat Liste de l’empreinte numérique du certificat client. string[]
en-tête Description du paramètre d’en-tête. BackendCredentialsContractHeader
requête Description du paramètre de requête. BackendCredentialsContractQuery

BackendCredentialsContractHeader

Nom Description Valeur

BackendCredentialsContractQuery

Nom Description Valeur

BackendProperties

Nom Description Valeur
serviceFabricCluster Propriétés du cluster Service Fabric principal BackendServiceFabricClusterProperties

BackendProxyContract

Nom Description Valeur
mot de passe Mot de passe pour se connecter au serveur WebProxy corde
URL Propriété WebProxy Server AbsoluteUri qui inclut l’URI entier stocké dans l’instance d’URI, y compris tous les fragments et chaînes de requête. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
nom d’utilisateur Nom d’utilisateur pour se connecter au serveur WebProxy corde

BackendServiceFabricClusterProperties

Nom Description Valeur
clientCertificatethumbprint Empreinte numérique du certificat client pour le point de terminaison de gestion. chaîne (obligatoire)
managementEndpoints Point de terminaison de gestion du cluster. string[] (obligatoire)
maxPartitionResolutionRetries Nombre maximal de nouvelles tentatives lors de la tentative de résolution de la partition. Int
serverCertificateThumbprints Empreintes du service de gestion de cluster de certificats utilisée pour la communication tls string[]
serverX509Names Collection de noms de certificats Server X509 X509CertificateName[]

BackendTlsProperties

Nom Description Valeur
validateCertificateChain Indicateur indiquant si la validation de la chaîne de certificats SSL doit être effectuée lors de l’utilisation de certificats auto-signés pour cet hôte principal. Bool
validateCertificateName Indicateur indiquant si la validation du nom de certificat SSL doit être effectuée lors de l’utilisation de certificats auto-signés pour cet hôte principal. Bool

Microsoft.ApiManagement/service/backends

Nom Description Valeur
apiVersion Version de l’API '2019-12-01'
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
Propriétés Propriétés du contrat d’entité back-end. BackendContractProperties
type Type de ressource 'Microsoft.ApiManagement/service/backends'

X509CertificateName

Nom Description Valeur
issuerCertificateThumbprint Empreinte numérique de l’émetteur du certificat. corde
nom Nom commun du certificat. corde

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource de service/back-ends peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ApiManagement/service/backends, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/backends@2019-12-01"
  name = "string"
  body = jsonencode({
    properties = {
      credentials = {
        authorization = {
          parameter = "string"
          scheme = "string"
        }
        certificate = [
          "string"
        ]
        header = {
          {customized property} = [
            "string"
          ]
        }
        query = {
          {customized property} = [
            "string"
          ]
        }
      }
      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"
    }
  })
}

Valeurs de propriété

BackendAuthorizationHeaderCredentials

Nom Description Valeur
paramètre Valeur du paramètre d’authentification. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
schéma Nom du schéma d’authentification. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)

BackendContractProperties

Nom Description Valeur
Pouvoirs Propriétés du contrat d’informations d’identification du serveur principal BackendCredentialsContract
description Description du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
Propriétés Contrat propriétés du back-end BackendProperties
protocole Protocole de communication back-end. 'http'
'soap' (obligatoire)
procuration Propriétés du contrat de proxy principal backendProxyContract
resourceId URI de gestion de la ressource dans le système externe. Cette URL peut être l’ID de ressource Arm des applications logiques, des applications de fonction ou des applications API. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
titre Titre du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1
tls Propriétés TLS du back-end BackendTlsProperties
URL URL du runtime du back-end. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)

BackendCredentialsContract

Nom Description Valeur
autorisation Authentification de l’en-tête d’autorisation BackendAuthorizationHeaderCredentials
certificat Liste de l’empreinte numérique du certificat client. string[]
en-tête Description du paramètre d’en-tête. BackendCredentialsContractHeader
requête Description du paramètre de requête. BackendCredentialsContractQuery

BackendCredentialsContractHeader

Nom Description Valeur

BackendCredentialsContractQuery

Nom Description Valeur

BackendProperties

Nom Description Valeur
serviceFabricCluster Propriétés du cluster Service Fabric principal BackendServiceFabricClusterProperties

BackendProxyContract

Nom Description Valeur
mot de passe Mot de passe pour se connecter au serveur WebProxy corde
URL Propriété WebProxy Server AbsoluteUri qui inclut l’URI entier stocké dans l’instance d’URI, y compris tous les fragments et chaînes de requête. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
nom d’utilisateur Nom d’utilisateur pour se connecter au serveur WebProxy corde

BackendServiceFabricClusterProperties

Nom Description Valeur
clientCertificatethumbprint Empreinte numérique du certificat client pour le point de terminaison de gestion. chaîne (obligatoire)
managementEndpoints Point de terminaison de gestion du cluster. string[] (obligatoire)
maxPartitionResolutionRetries Nombre maximal de nouvelles tentatives lors de la tentative de résolution de la partition. Int
serverCertificateThumbprints Empreintes du service de gestion de cluster de certificats utilisée pour la communication tls string[]
serverX509Names Collection de noms de certificats Server X509 X509CertificateName[]

BackendTlsProperties

Nom Description Valeur
validateCertificateChain Indicateur indiquant si la validation de la chaîne de certificats SSL doit être effectuée lors de l’utilisation de certificats auto-signés pour cet hôte principal. Bool
validateCertificateName Indicateur indiquant si la validation du nom de certificat SSL doit être effectuée lors de l’utilisation de certificats auto-signés pour cet hôte principal. Bool

Microsoft.ApiManagement/service/backends

Nom Description Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 1 (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : de service
Propriétés Propriétés du contrat d’entité back-end. BackendContractProperties
type Type de ressource « Microsoft.ApiManagement/service/backends@2019-12-01 »

X509CertificateName

Nom Description Valeur
issuerCertificateThumbprint Empreinte numérique de l’émetteur du certificat. corde
nom Nom commun du certificat. corde