Partager via

Service/api Microsoft.ApiManagement

  • Article

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@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

Déployer sur Azure 		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

Déployer sur 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 :

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

Déployer sur Azure 		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

Déployer sur 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