Service/api Microsoft.ApiManagement

Article
07/24/2024

Définition de ressource Bicep

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

groupes de ressources - Consultez commandes de déploiement de 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/apis, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ApiManagement/service/apis@2023-09-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  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 propriété

service/apis

Nom	Description	Valeur
nom	Nom de la ressource Découvrez comment définir des noms et des types pour les ressources enfants dans Bicep.	chaîne (obligatoire) Limite de caractères : 1 à 80 Caractères valides : Alphanumériques et traits d’union. Commencez par la lettre et terminez par alphanumérique.
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

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nom	Description	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' 'soap' '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
authenticationSettings	Collection de paramètres d’authentification inclus dans cette API.	AuthenticationSettingsContract
contact	Informations de contact pour l’API.	ApiContactInformation
description	Description de l’API. Peut inclure des balises de mise en forme HTML.	corde
displayName	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	'graphql-link' 'grpc' 'grpc-link' 'odata' 'odata-link' 'openapi' 'openapi+json' 'openapi+json-link' 'openapi-link' 'swagger-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.	chaîne (obligatoire) Contraintes: Longueur maximale = 400
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
subscriptionRequired	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'	'query' 'template'
type	Type d’API.	'graphql' 'grpc' '`http`' 'odata' 'soap' '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

ApiVersionSetContractDetails

Nom	Description	Valeur
description	Description du jeu de versions d’API.	corde
id	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
versionHeaderName	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.	'Header' 'Query' '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	Description	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	Description	Valeur
authorizationServerId	Identificateur du serveur d’autorisation OAuth.	corde
portée	étendue des opérations.	corde

OpenIdAuthenticationSettingsContract

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

ApiContactInformation

Nom	Description	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

ApiLicenseInformation

Nom	Description	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

SubscriptionKeyParameterNamesContract

Nom	Description	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

ApiCreateOrUpdatePropertiesWsdlSelector

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

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
Créer une instance Gestion des API et toutes les sous-ressources à l’aide d’un modèle	Ce modèle montre comment créer un service Gestion des API et configurer des sous-entités
Créer Azure Front Door devant la Gestion des API Azure	Cet exemple montre comment utiliser Azure Front Door comme équilibreur de charge global devant Gestion des API Azure.

Définition de ressource de modèle ARM

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

groupes de ressources - Consultez commandes de déploiement de 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/apis, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ApiManagement/service/apis",
  "apiVersion": "2023-09-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 propriété

service/apis

Nom	Description	Valeur
type	Type de ressource	'Microsoft.ApiManagement/service/apis'
apiVersion	Version de l’API de ressource	'2023-09-01-preview'
nom	Nom de la ressource Découvrez comment définir des noms et des types pour les ressources enfants dans modèles ARM JSON.	chaîne (obligatoire) Limite de caractères : 1 à 80 Caractères valides : Alphanumériques et traits d’union. Commencez par la lettre et terminez par alphanumérique.
Propriétés	L’entité API crée des propriétés de mise à jour.	ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nom	Description	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' 'soap' '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
authenticationSettings	Collection de paramètres d’authentification inclus dans cette API.	AuthenticationSettingsContract
contact	Informations de contact pour l’API.	ApiContactInformation
description	Description de l’API. Peut inclure des balises de mise en forme HTML.	corde
displayName	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	'graphql-link' 'grpc' 'grpc-link' 'odata' 'odata-link' 'openapi' 'openapi+json' 'openapi+json-link' 'openapi-link' 'swagger-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.	chaîne (obligatoire) Contraintes: Longueur maximale = 400
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
subscriptionRequired	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'	'query' 'template'
type	Type d’API.	'graphql' 'grpc' '`http`' 'odata' 'soap' '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

ApiVersionSetContractDetails

Nom	Description	Valeur
description	Description du jeu de versions d’API.	corde
id	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
versionHeaderName	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.	'Header' 'Query' '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	Description	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	Description	Valeur
authorizationServerId	Identificateur du serveur d’autorisation OAuth.	corde
portée	étendue des opérations.	corde

OpenIdAuthenticationSettingsContract

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

ApiContactInformation

Nom	Description	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

ApiLicenseInformation

Nom	Description	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

SubscriptionKeyParameterNamesContract

Nom	Description	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

ApiCreateOrUpdatePropertiesWsdlSelector

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

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
Créer une instance Gestion des API et toutes les sous-ressources à l’aide d’un modèle	Ce modèle montre comment créer un service Gestion des API et configurer des sous-entités
Créer Azure Front Door devant la Gestion des API Azure	Cet exemple montre comment utiliser Azure Front Door comme équilibreur de charge global devant Gestion des API Azure.

Définition de ressource Terraform (fournisseur AzAPI)

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis@2023-09-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    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 propriété

service/apis

Nom	Description	Valeur
type	Type de ressource	« Microsoft.ApiManagement/service/apis@2023-09-01-preview »
nom	Nom de la ressource	chaîne (obligatoire) Limite de caractères : 1 à 80 Caractères valides : Alphanumériques et traits d’union. Commencez par la lettre et terminez par alphanumérique.
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

ApiCreateOrUpdatePropertiesOrApiContractProperties

Nom	Description	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 » « soap » « 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
authenticationSettings	Collection de paramètres d’authentification inclus dans cette API.	AuthenticationSettingsContract
contact	Informations de contact pour l’API.	ApiContactInformation
description	Description de l’API. Peut inclure des balises de mise en forme HTML.	corde
displayName	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	« graphql-link » « grpc » « grpc-link » « odata » « odata-link » « openapi » « openapi+json » « openapi+json-link » « openapi-link » « swagger-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.	chaîne (obligatoire) Contraintes: Longueur maximale = 400
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
subscriptionRequired	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'	« query » « template »
type	Type d’API.	« graphql » « grpc » «`http`» « odata » « soap » « 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

ApiVersionSetContractDetails

Nom	Description	Valeur
description	Description du jeu de versions d’API.	corde
id	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
versionHeaderName	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	Description	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	Description	Valeur
authorizationServerId	Identificateur du serveur d’autorisation OAuth.	corde
portée	étendue des opérations.	corde

OpenIdAuthenticationSettingsContract

Nom	Description	Valeur
bearerTokenSendingMethods	Comment envoyer un jeton au serveur.	Tableau de chaînes contenant l’un des éléments suivants : « authorizationHeader » « query »
openidProviderId	Identificateur du serveur d’autorisation OAuth.	corde

ApiContactInformation

Nom	Description	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

ApiLicenseInformation

Nom	Description	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

SubscriptionKeyParameterNamesContract

Nom	Description	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

ApiCreateOrUpdatePropertiesWsdlSelector

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

Partager via

Service/api Microsoft.ApiManagement

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

service/apis

ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiVersionSetContractDetails

AuthenticationSettingsContract

OAuth2AuthenticationSettingsContract

OpenIdAuthenticationSettingsContract

ApiContactInformation

ApiLicenseInformation

SubscriptionKeyParameterNamesContract

ApiCreateOrUpdatePropertiesWsdlSelector

Modèles de démarrage rapide

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

service/apis

ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiVersionSetContractDetails

AuthenticationSettingsContract

OAuth2AuthenticationSettingsContract

OpenIdAuthenticationSettingsContract

ApiContactInformation

ApiLicenseInformation

SubscriptionKeyParameterNamesContract

ApiCreateOrUpdatePropertiesWsdlSelector

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

service/apis

ApiCreateOrUpdatePropertiesOrApiContractProperties

ApiVersionSetContractDetails

AuthenticationSettingsContract

OAuth2AuthenticationSettingsContract

OpenIdAuthenticationSettingsContract

ApiContactInformation

ApiLicenseInformation

SubscriptionKeyParameterNamesContract

ApiCreateOrUpdatePropertiesWsdlSelector

Commentaires

Ressources supplémentaires