Service/api Microsoft.ApiManagement

Définition de ressource Bicep

Le type de ressource service/apis 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/apis, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ApiManagement/service/apis@2025-03-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    apiRevision: 'string'
    apiRevisionDescription: 'string'
    apiType: 'string'
    apiVersion: 'string'
    apiVersionDescription: 'string'
    apiVersionSet: {
      description: 'string'
      id: 'string'
      name: 'string'
      versionHeaderName: 'string'
      versioningScheme: 'string'
      versionQueryName: 'string'
    }
    apiVersionSetId: 'string'
    authenticationSettings: {
      oAuth2: {
        authorizationServerId: 'string'
        scope: 'string'
      }
      oAuth2AuthenticationSettings: [
        {
          authorizationServerId: 'string'
          scope: 'string'
        }
      ]
      openid: {
        bearerTokenSendingMethods: [
          'string'
        ]
        openidProviderId: 'string'
      }
      openidAuthenticationSettings: [
        {
          bearerTokenSendingMethods: [
            'string'
          ]
          openidProviderId: 'string'
        }
      ]
    }
    contact: {
      email: 'string'
      name: 'string'
      url: 'string'
    }
    description: 'string'
    displayName: 'string'
    format: 'string'
    isCurrent: bool
    license: {
      name: 'string'
      url: 'string'
    }
    path: 'string'
    protocols: [
      'string'
    ]
    serviceUrl: 'string'
    sourceApiId: 'string'
    subscriptionKeyParameterNames: {
      header: 'string'
      query: 'string'
    }
    subscriptionRequired: bool
    termsOfServiceUrl: 'string'
    translateRequiredQueryParameters: 'string'
    type: 'string'
    value: 'string'
    wsdlSelector: {
      wsdlEndpointName: 'string'
      wsdlServiceName: 'string'
    }
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apis

Nom	Descriptif	Valeur
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 1 Longueur maximale = 256 Modèle = `^[^*#&+:<>?]+$` (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	L’entité API crée des propriétés de mise à jour.	ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiContactInformation

Nom	Descriptif	Valeur
Messagerie électronique	Adresse e-mail de la personne/de l’organisation de contact. DOIT être au format d’une adresse e-mail	corde
nom	Nom d’identification de la personne/de l’organisation de contact	corde
URL	URL pointant vers les informations de contact. DOIT être au format d’une URL	corde

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nom	Descriptif	Valeur
apiRevision	Décrit la révision de l’API. Si aucune valeur n’est fournie, la révision 1 par défaut est créée	corde Contraintes: Longueur minimale = 1 Longueur maximale = 100
apiRevisionDescription	Description de la révision de l’API.	corde Contraintes: Longueur maximale = 256
apiType	Type d’API à créer. * `http` crée une API REST * `soap` crée une API directe SOAP * `websocket` crée l’API websocket * `graphql` crée l’API GraphQL. De nouveaux types peuvent être ajoutés à l’avenir.	'graphql' 'GRPC' 'http' 'Odata' 'Savon' 'Websocket'
apiVersion	Indique l’identificateur de version de l’API si l’API est versionnée	corde Contraintes: Longueur maximale = 100
apiVersionDescription	Description de la version de l’API.	corde Contraintes: Longueur maximale = 256
apiVersionSet	Détails du jeu de versions	ApiVersionSetContractDetails
apiVersionSetId	Identificateur de ressource pour l’ApiVersionSet associé.	corde
authentificationParamètres	Collection de paramètres d’authentification inclus dans cette API.	AuthenticationSettingsContract
contacter	Informations de contact pour l’API.	ApiContactInformation
description	Description de l’API. Peut inclure des balises de mise en forme HTML.	corde
nom d’affichage	Nom de l’API. Doit être de 1 à 300 caractères.	corde Contraintes: Longueur minimale = 1 Longueur maximale = 300
format	Format du contenu dans lequel l’API est importée. De nouveaux formats peuvent être ajoutés à l’avenir	'Lien graphql' 'GRPC' 'Lien-grpc' 'Odata' 'odata-link' 'openapi' 'openapi+json' 'openapi+json-link' 'openapi-link' 'Fanfaron-json' 'swagger-link-json' 'wadl-link-json' 'WADL-XML' 'WSDL' 'wsdl-link'
isCurrent	Indique si la révision de l’API est la révision actuelle de l’API.	Bool
licence	Informations de licence pour l’API.	ApiLicenseInformation
chemin	URL relative identifiant de manière unique cette API et tous ses chemins de ressources dans l’instance du service Gestion des API. Elle est ajoutée à l’URL de base du point de terminaison d’API spécifiée pendant la création de l’instance de service pour former une URL publique pour cette API.	corde Contraintes: Longueur maximale = 400 (obligatoire)
protocole	Décrit les protocoles sur lesquels les opérations de cette API peuvent être appelées.	Tableau de chaînes contenant l’un des éléments suivants : 'http' 'https' 'WS' 'WSS'
serviceUrl	URL absolue du service principal implémentant cette API. Ne peut pas comporter plus de 2 000 caractères.	corde Contraintes: Longueur maximale = 2000
sourceApiId	Identificateur d’API de l’API source.	corde
subscriptionKeyParameterNames	Protocoles sur lesquels l’API est rendue disponible.	SubscriptionKeyParameterNamesContract
abonnementObligatoire	Spécifie si un abonnement API ou Produit est requis pour accéder à l’API.	Bool
termsOfServiceUrl	URL vers les conditions d’utilisation de l’API. DOIT être au format d’une URL.	corde
translateRequiredQueryParameters	Stratégie de traduction des paramètres de requête requis en paramètres de modèle. Par défaut, la valeur « template » est définie. Valeurs possibles : 'template', 'query'	'Requête' 'modèle'
type	Type d’API.	'graphql' 'GRPC' 'http' 'Odata' 'Savon' 'Websocket'
valeur	Valeur de contenu lors de l’importation d’une API.	corde
wsdlSelector	Critères pour limiter l’importation de WSDL à un sous-ensemble du document.	ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Nom	Descriptif	Valeur
wsdlEndpointName	Nom du point de terminaison(port) à importer à partir de WSDL	corde
wsdlServiceName	Nom du service à importer à partir de WSDL	corde

ApiLicenseInformation

Nom	Descriptif	Valeur
nom	Nom de licence utilisé pour l’API	corde
URL	URL de la licence utilisée pour l’API. DOIT être au format d’une URL	corde

ApiVersionSetContractDetails

Nom	Descriptif	Valeur
description	Description du jeu de versions d’API.	corde
pièce d'identité	Identificateur de l’ensemble de versions d’API existant. Omettez cette valeur pour créer un jeu de versions.	corde
nom	Nom complet du jeu de versions de l’API.	corde
versionNom de l’en-tête	Nom du paramètre d’en-tête HTTP qui indique la version de l’API si versioningScheme est défini sur `header`.	corde
versioningScheme	Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.	'En-tête' 'Requête' « Segment »
versionQueryName	Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur `query`.	corde

AuthenticationSettingsContract

Nom	Descriptif	Valeur
oAuth2	Paramètres d’authentification OAuth2	OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings	Collection de paramètres d’authentification OAuth2 inclus dans cette API.	OAuth2AuthenticationSettingsContract[]
openid	Paramètres d’authentification OpenID Connect	OpenIdAuthenticationSettingsContract
openidAuthenticationSettings	Collection de paramètres d’authentification Open ID Connect inclus dans cette API.	OpenIdAuthenticationSettingsContract[]

OAuth2AuthenticationSettingsContract

Nom	Descriptif	Valeur
autorisationServerId	Identificateur du serveur d’autorisation OAuth.	corde
portée	étendue des opérations.	corde

OpenIdAuthenticationSettingsContract

Nom	Descriptif	Valeur
bearerTokenSendingMethods	Comment envoyer un jeton au serveur.	Tableau de chaînes contenant l’un des éléments suivants : 'authorizationHeader' 'Requête'
openidProviderId	Identificateur du serveur d’autorisation OAuth.	corde

SubscriptionKeyParameterNamesContract

Nom	Descriptif	Valeur
en-tête	Nom de l’en-tête de clé d’abonnement.	corde
requête	Nom du paramètre de chaîne de requête de clé d’abonnement.	corde

Définition de ressource de modèle ARM

Le type de ressource service/apis 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/apis, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ApiManagement/service/apis",
  "apiVersion": "2025-03-01-preview",
  "name": "string",
  "properties": {
    "apiRevision": "string",
    "apiRevisionDescription": "string",
    "apiType": "string",
    "apiVersion": "string",
    "apiVersionDescription": "string",
    "apiVersionSet": {
      "description": "string",
      "id": "string",
      "name": "string",
      "versionHeaderName": "string",
      "versioningScheme": "string",
      "versionQueryName": "string"
    },
    "apiVersionSetId": "string",
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "string",
        "scope": "string"
      },
      "oAuth2AuthenticationSettings": [
        {
          "authorizationServerId": "string",
          "scope": "string"
        }
      ],
      "openid": {
        "bearerTokenSendingMethods": [ "string" ],
        "openidProviderId": "string"
      },
      "openidAuthenticationSettings": [
        {
          "bearerTokenSendingMethods": [ "string" ],
          "openidProviderId": "string"
        }
      ]
    },
    "contact": {
      "email": "string",
      "name": "string",
      "url": "string"
    },
    "description": "string",
    "displayName": "string",
    "format": "string",
    "isCurrent": "bool",
    "license": {
      "name": "string",
      "url": "string"
    },
    "path": "string",
    "protocols": [ "string" ],
    "serviceUrl": "string",
    "sourceApiId": "string",
    "subscriptionKeyParameterNames": {
      "header": "string",
      "query": "string"
    },
    "subscriptionRequired": "bool",
    "termsOfServiceUrl": "string",
    "translateRequiredQueryParameters": "string",
    "type": "string",
    "value": "string",
    "wsdlSelector": {
      "wsdlEndpointName": "string",
      "wsdlServiceName": "string"
    }
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apis

Nom	Descriptif	Valeur
apiVersion	Version de l’API	'2025-03-01-preview'
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 1 Longueur maximale = 256 Modèle = `^[^*#&+:<>?]+$` (obligatoire)
Propriétés	L’entité API crée des propriétés de mise à jour.	ApiCreateOrUpdatePropertiesOrApiContractProperties
type	Type de ressource	'Microsoft.ApiManagement/service/apis'

ApiContactInformation

Nom	Descriptif	Valeur
Messagerie électronique	Adresse e-mail de la personne/de l’organisation de contact. DOIT être au format d’une adresse e-mail	corde
nom	Nom d’identification de la personne/de l’organisation de contact	corde
URL	URL pointant vers les informations de contact. DOIT être au format d’une URL	corde

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nom	Descriptif	Valeur
apiRevision	Décrit la révision de l’API. Si aucune valeur n’est fournie, la révision 1 par défaut est créée	corde Contraintes: Longueur minimale = 1 Longueur maximale = 100
apiRevisionDescription	Description de la révision de l’API.	corde Contraintes: Longueur maximale = 256
apiType	Type d’API à créer. * `http` crée une API REST * `soap` crée une API directe SOAP * `websocket` crée l’API websocket * `graphql` crée l’API GraphQL. De nouveaux types peuvent être ajoutés à l’avenir.	'graphql' 'GRPC' 'http' 'Odata' 'Savon' 'Websocket'
apiVersion	Indique l’identificateur de version de l’API si l’API est versionnée	corde Contraintes: Longueur maximale = 100
apiVersionDescription	Description de la version de l’API.	corde Contraintes: Longueur maximale = 256
apiVersionSet	Détails du jeu de versions	ApiVersionSetContractDetails
apiVersionSetId	Identificateur de ressource pour l’ApiVersionSet associé.	corde
authentificationParamètres	Collection de paramètres d’authentification inclus dans cette API.	AuthenticationSettingsContract
contacter	Informations de contact pour l’API.	ApiContactInformation
description	Description de l’API. Peut inclure des balises de mise en forme HTML.	corde
nom d’affichage	Nom de l’API. Doit être de 1 à 300 caractères.	corde Contraintes: Longueur minimale = 1 Longueur maximale = 300
format	Format du contenu dans lequel l’API est importée. De nouveaux formats peuvent être ajoutés à l’avenir	'Lien graphql' 'GRPC' 'Lien-grpc' 'Odata' 'odata-link' 'openapi' 'openapi+json' 'openapi+json-link' 'openapi-link' 'Fanfaron-json' 'swagger-link-json' 'wadl-link-json' 'WADL-XML' 'WSDL' 'wsdl-link'
isCurrent	Indique si la révision de l’API est la révision actuelle de l’API.	Bool
licence	Informations de licence pour l’API.	ApiLicenseInformation
chemin	URL relative identifiant de manière unique cette API et tous ses chemins de ressources dans l’instance du service Gestion des API. Elle est ajoutée à l’URL de base du point de terminaison d’API spécifiée pendant la création de l’instance de service pour former une URL publique pour cette API.	corde Contraintes: Longueur maximale = 400 (obligatoire)
protocole	Décrit les protocoles sur lesquels les opérations de cette API peuvent être appelées.	Tableau de chaînes contenant l’un des éléments suivants : 'http' 'https' 'WS' 'WSS'
serviceUrl	URL absolue du service principal implémentant cette API. Ne peut pas comporter plus de 2 000 caractères.	corde Contraintes: Longueur maximale = 2000
sourceApiId	Identificateur d’API de l’API source.	corde
subscriptionKeyParameterNames	Protocoles sur lesquels l’API est rendue disponible.	SubscriptionKeyParameterNamesContract
abonnementObligatoire	Spécifie si un abonnement API ou Produit est requis pour accéder à l’API.	Bool
termsOfServiceUrl	URL vers les conditions d’utilisation de l’API. DOIT être au format d’une URL.	corde
translateRequiredQueryParameters	Stratégie de traduction des paramètres de requête requis en paramètres de modèle. Par défaut, la valeur « template » est définie. Valeurs possibles : 'template', 'query'	'Requête' 'modèle'
type	Type d’API.	'graphql' 'GRPC' 'http' 'Odata' 'Savon' 'Websocket'
valeur	Valeur de contenu lors de l’importation d’une API.	corde
wsdlSelector	Critères pour limiter l’importation de WSDL à un sous-ensemble du document.	ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Nom	Descriptif	Valeur
wsdlEndpointName	Nom du point de terminaison(port) à importer à partir de WSDL	corde
wsdlServiceName	Nom du service à importer à partir de WSDL	corde

ApiLicenseInformation

Nom	Descriptif	Valeur
nom	Nom de licence utilisé pour l’API	corde
URL	URL de la licence utilisée pour l’API. DOIT être au format d’une URL	corde

ApiVersionSetContractDetails

Nom	Descriptif	Valeur
description	Description du jeu de versions d’API.	corde
pièce d'identité	Identificateur de l’ensemble de versions d’API existant. Omettez cette valeur pour créer un jeu de versions.	corde
nom	Nom complet du jeu de versions de l’API.	corde
versionNom de l’en-tête	Nom du paramètre d’en-tête HTTP qui indique la version de l’API si versioningScheme est défini sur `header`.	corde
versioningScheme	Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.	'En-tête' 'Requête' « Segment »
versionQueryName	Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur `query`.	corde

AuthenticationSettingsContract

Nom	Descriptif	Valeur
oAuth2	Paramètres d’authentification OAuth2	OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings	Collection de paramètres d’authentification OAuth2 inclus dans cette API.	OAuth2AuthenticationSettingsContract[]
openid	Paramètres d’authentification OpenID Connect	OpenIdAuthenticationSettingsContract
openidAuthenticationSettings	Collection de paramètres d’authentification Open ID Connect inclus dans cette API.	OpenIdAuthenticationSettingsContract[]

OAuth2AuthenticationSettingsContract

Nom	Descriptif	Valeur
autorisationServerId	Identificateur du serveur d’autorisation OAuth.	corde
portée	étendue des opérations.	corde

OpenIdAuthenticationSettingsContract

Nom	Descriptif	Valeur
bearerTokenSendingMethods	Comment envoyer un jeton au serveur.	Tableau de chaînes contenant l’un des éléments suivants : 'authorizationHeader' 'Requête'
openidProviderId	Identificateur du serveur d’autorisation OAuth.	corde

SubscriptionKeyParameterNamesContract

Nom	Descriptif	Valeur
en-tête	Nom de l’en-tête de clé d’abonnement.	corde
requête	Nom du paramètre de chaîne de requête de clé d’abonnement.	corde

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource service/apis 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/apis, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis@2025-03-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      apiRevision = "string"
      apiRevisionDescription = "string"
      apiType = "string"
      apiVersion = "string"
      apiVersionDescription = "string"
      apiVersionSet = {
        description = "string"
        id = "string"
        name = "string"
        versionHeaderName = "string"
        versioningScheme = "string"
        versionQueryName = "string"
      }
      apiVersionSetId = "string"
      authenticationSettings = {
        oAuth2 = {
          authorizationServerId = "string"
          scope = "string"
        }
        oAuth2AuthenticationSettings = [
          {
            authorizationServerId = "string"
            scope = "string"
          }
        ]
        openid = {
          bearerTokenSendingMethods = [
            "string"
          ]
          openidProviderId = "string"
        }
        openidAuthenticationSettings = [
          {
            bearerTokenSendingMethods = [
              "string"
            ]
            openidProviderId = "string"
          }
        ]
      }
      contact = {
        email = "string"
        name = "string"
        url = "string"
      }
      description = "string"
      displayName = "string"
      format = "string"
      isCurrent = bool
      license = {
        name = "string"
        url = "string"
      }
      path = "string"
      protocols = [
        "string"
      ]
      serviceUrl = "string"
      sourceApiId = "string"
      subscriptionKeyParameterNames = {
        header = "string"
        query = "string"
      }
      subscriptionRequired = bool
      termsOfServiceUrl = "string"
      translateRequiredQueryParameters = "string"
      type = "string"
      value = "string"
      wsdlSelector = {
        wsdlEndpointName = "string"
        wsdlServiceName = "string"
      }
    }
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apis

Nom	Descriptif	Valeur
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 1 Longueur maximale = 256 Modèle = `^[^*#&+:<>?]+$` (obligatoire)
parent_id	ID de la ressource qui est le parent de cette ressource.	ID de ressource de type : de service
Propriétés	L’entité API crée des propriétés de mise à jour.	ApiCreateOrUpdatePropertiesOrApiContractProperties
type	Type de ressource	« Microsoft.ApiManagement/service/apis@2025-03-01-preview »

ApiContactInformation

Nom	Descriptif	Valeur
Messagerie électronique	Adresse e-mail de la personne/de l’organisation de contact. DOIT être au format d’une adresse e-mail	corde
nom	Nom d’identification de la personne/de l’organisation de contact	corde
URL	URL pointant vers les informations de contact. DOIT être au format d’une URL	corde

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nom	Descriptif	Valeur
apiRevision	Décrit la révision de l’API. Si aucune valeur n’est fournie, la révision 1 par défaut est créée	corde Contraintes: Longueur minimale = 1 Longueur maximale = 100
apiRevisionDescription	Description de la révision de l’API.	corde Contraintes: Longueur maximale = 256
apiType	Type d’API à créer. * `http` crée une API REST * `soap` crée une API directe SOAP * `websocket` crée l’API websocket * `graphql` crée l’API GraphQL. De nouveaux types peuvent être ajoutés à l’avenir.	'graphql' 'GRPC' 'http' 'Odata' 'Savon' 'Websocket'
apiVersion	Indique l’identificateur de version de l’API si l’API est versionnée	corde Contraintes: Longueur maximale = 100
apiVersionDescription	Description de la version de l’API.	corde Contraintes: Longueur maximale = 256
apiVersionSet	Détails du jeu de versions	ApiVersionSetContractDetails
apiVersionSetId	Identificateur de ressource pour l’ApiVersionSet associé.	corde
authentificationParamètres	Collection de paramètres d’authentification inclus dans cette API.	AuthenticationSettingsContract
contacter	Informations de contact pour l’API.	ApiContactInformation
description	Description de l’API. Peut inclure des balises de mise en forme HTML.	corde
nom d’affichage	Nom de l’API. Doit être de 1 à 300 caractères.	corde Contraintes: Longueur minimale = 1 Longueur maximale = 300
format	Format du contenu dans lequel l’API est importée. De nouveaux formats peuvent être ajoutés à l’avenir	'Lien graphql' 'GRPC' 'Lien-grpc' 'Odata' 'odata-link' 'openapi' 'openapi+json' 'openapi+json-link' 'openapi-link' 'Fanfaron-json' 'swagger-link-json' 'wadl-link-json' 'WADL-XML' 'WSDL' 'wsdl-link'
isCurrent	Indique si la révision de l’API est la révision actuelle de l’API.	Bool
licence	Informations de licence pour l’API.	ApiLicenseInformation
chemin	URL relative identifiant de manière unique cette API et tous ses chemins de ressources dans l’instance du service Gestion des API. Elle est ajoutée à l’URL de base du point de terminaison d’API spécifiée pendant la création de l’instance de service pour former une URL publique pour cette API.	corde Contraintes: Longueur maximale = 400 (obligatoire)
protocole	Décrit les protocoles sur lesquels les opérations de cette API peuvent être appelées.	Tableau de chaînes contenant l’un des éléments suivants : 'http' 'https' 'WS' 'WSS'
serviceUrl	URL absolue du service principal implémentant cette API. Ne peut pas comporter plus de 2 000 caractères.	corde Contraintes: Longueur maximale = 2000
sourceApiId	Identificateur d’API de l’API source.	corde
subscriptionKeyParameterNames	Protocoles sur lesquels l’API est rendue disponible.	SubscriptionKeyParameterNamesContract
abonnementObligatoire	Spécifie si un abonnement API ou Produit est requis pour accéder à l’API.	Bool
termsOfServiceUrl	URL vers les conditions d’utilisation de l’API. DOIT être au format d’une URL.	corde
translateRequiredQueryParameters	Stratégie de traduction des paramètres de requête requis en paramètres de modèle. Par défaut, la valeur « template » est définie. Valeurs possibles : 'template', 'query'	'Requête' 'modèle'
type	Type d’API.	'graphql' 'GRPC' 'http' 'Odata' 'Savon' 'Websocket'
valeur	Valeur de contenu lors de l’importation d’une API.	corde
wsdlSelector	Critères pour limiter l’importation de WSDL à un sous-ensemble du document.	ApiCreateOrUpdatePropertiesWsdlSelector

ApiCreateOrUpdatePropertiesWsdlSelector

Nom	Descriptif	Valeur
wsdlEndpointName	Nom du point de terminaison(port) à importer à partir de WSDL	corde
wsdlServiceName	Nom du service à importer à partir de WSDL	corde

ApiLicenseInformation

Nom	Descriptif	Valeur
nom	Nom de licence utilisé pour l’API	corde
URL	URL de la licence utilisée pour l’API. DOIT être au format d’une URL	corde

ApiVersionSetContractDetails

Nom	Descriptif	Valeur
description	Description du jeu de versions d’API.	corde
pièce d'identité	Identificateur de l’ensemble de versions d’API existant. Omettez cette valeur pour créer un jeu de versions.	corde
nom	Nom complet du jeu de versions de l’API.	corde
versionNom de l’en-tête	Nom du paramètre d’en-tête HTTP qui indique la version de l’API si versioningScheme est défini sur `header`.	corde
versioningScheme	Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.	'En-tête' 'Requête' « Segment »
versionQueryName	Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur `query`.	corde

AuthenticationSettingsContract

Nom	Descriptif	Valeur
oAuth2	Paramètres d’authentification OAuth2	OAuth2AuthenticationSettingsContract
oAuth2AuthenticationSettings	Collection de paramètres d’authentification OAuth2 inclus dans cette API.	OAuth2AuthenticationSettingsContract[]
openid	Paramètres d’authentification OpenID Connect	OpenIdAuthenticationSettingsContract
openidAuthenticationSettings	Collection de paramètres d’authentification Open ID Connect inclus dans cette API.	OpenIdAuthenticationSettingsContract[]

OAuth2AuthenticationSettingsContract

Nom	Descriptif	Valeur
autorisationServerId	Identificateur du serveur d’autorisation OAuth.	corde
portée	étendue des opérations.	corde

OpenIdAuthenticationSettingsContract

Nom	Descriptif	Valeur
bearerTokenSendingMethods	Comment envoyer un jeton au serveur.	Tableau de chaînes contenant l’un des éléments suivants : 'authorizationHeader' 'Requête'
openidProviderId	Identificateur du serveur d’autorisation OAuth.	corde

SubscriptionKeyParameterNamesContract

Nom	Descriptif	Valeur
en-tête	Nom de l’en-tête de clé d’abonnement.	corde
requête	Nom du paramètre de chaîne de requête de clé d’abonnement.	corde

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement d’API au sein d’un service de gestion des API.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "service" {
  type      = "Microsoft.ApiManagement/service@2021-08-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      certificates = [
      ]
      customProperties = {
        "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30" = "false"
        "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10" = "false"
        "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11" = "false"
        "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10"         = "false"
        "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11"         = "false"
      }
      disableGateway      = false
      publicNetworkAccess = "Enabled"
      publisherEmail      = "pub1@email.com"
      publisherName       = "pub1"
      virtualNetworkType  = "None"
    }
    sku = {
      capacity = 0
      name     = "Consumption"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "api" {
  type      = "Microsoft.ApiManagement/service/apis@2021-08-01"
  parent_id = azapi_resource.service.id
  name      = "${var.resource_name};rev=1"
  body = {
    properties = {
      apiRevisionDescription = ""
      apiType                = "http"
      apiVersion             = ""
      apiVersionDescription  = ""
      authenticationSettings = {
      }
      description = ""
      displayName = "api1"
      path        = "api1"
      protocols = [
        "https",
      ]
      serviceUrl           = ""
      subscriptionRequired = true
      type                 = "http"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Rétroaction

Cette page vous a-t-elle été utile ?

Last updated on 2025-09-16

Partager via

Service/api Microsoft.ApiManagement

Définition de ressource Bicep

Format de ressource

Valeurs de la propriété

Microsoft.ApiManagement/service/apis

ApiContactInformation

ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiCreateOrUpdatePropertiesWsdlSelector

ApiLicenseInformation

ApiVersionSetContractDetails

AuthenticationSettingsContract

OAuth2AuthenticationSettingsContract

OpenIdAuthenticationSettingsContract

SubscriptionKeyParameterNamesContract

Définition de ressource de modèle ARM

Format de ressource

Valeurs de la propriété

Microsoft.ApiManagement/service/apis

ApiContactInformation

ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiCreateOrUpdatePropertiesWsdlSelector

ApiLicenseInformation

ApiVersionSetContractDetails

AuthenticationSettingsContract

OAuth2AuthenticationSettingsContract

OpenIdAuthenticationSettingsContract

SubscriptionKeyParameterNamesContract

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de la propriété

Microsoft.ApiManagement/service/apis

ApiContactInformation

ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiCreateOrUpdatePropertiesWsdlSelector

ApiLicenseInformation

ApiVersionSetContractDetails

AuthenticationSettingsContract

OAuth2AuthenticationSettingsContract

OpenIdAuthenticationSettingsContract

SubscriptionKeyParameterNamesContract

Exemples d’utilisation

Échantillons Terraform

Rétroaction

Ressources additionnelles