Partager via


Service Microsoft.ApiManagement/apiVersionSets 2021-08-01

Définition de ressource Bicep

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

resource symbolicname 'Microsoft.ApiManagement/service/apiVersionSets@2021-08-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    versionHeaderName: 'string'
    versioningScheme: 'string'
    versionQueryName: 'string'
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apiVersionSets

Nom Descriptif Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 80
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 Propriétés du contrat API VersionSet. ApiVersionSetContractProperties

ApiVersionSetContractProperties

Nom Descriptif Valeur
descriptif Description du jeu de versions d’API. corde
nom d’affichage Nom du jeu de versions d’API corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 100 (obligatoire)
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

Contraintes:
Longueur minimale = 1
Longueur maximale = 100
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' (obligatoire)
versionQueryName Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur query. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 100

Définition de ressource de modèle ARM

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

{
  "type": "Microsoft.ApiManagement/service/apiVersionSets",
  "apiVersion": "2021-08-01",
  "name": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "versionHeaderName": "string",
    "versioningScheme": "string",
    "versionQueryName": "string"
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apiVersionSets

Nom Descriptif Valeur
apiVersion Version de l’API '2021-08-01'
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 80
Modèle = ^[^*#&+:<>?]+$ (obligatoire)
Propriétés Propriétés du contrat API VersionSet. ApiVersionSetContractProperties
type Type de ressource 'Microsoft.ApiManagement/service/apiVersionSets'

ApiVersionSetContractProperties

Nom Descriptif Valeur
descriptif Description du jeu de versions d’API. corde
nom d’affichage Nom du jeu de versions d’API corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 100 (obligatoire)
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

Contraintes:
Longueur minimale = 1
Longueur maximale = 100
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' (obligatoire)
versionQueryName Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur query. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 100

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apiVersionSets@2021-08-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      description = "string"
      displayName = "string"
      versionHeaderName = "string"
      versioningScheme = "string"
      versionQueryName = "string"
    }
  }
}

Valeurs de la propriété

Microsoft.ApiManagement/service/apiVersionSets

Nom Descriptif Valeur
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 80
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 Propriétés du contrat API VersionSet. ApiVersionSetContractProperties
type Type de ressource « Microsoft.ApiManagement/service/apiVersionSets@2021-08-01 »

ApiVersionSetContractProperties

Nom Descriptif Valeur
descriptif Description du jeu de versions d’API. corde
nom d’affichage Nom du jeu de versions d’API corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 100 (obligatoire)
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

Contraintes:
Longueur minimale = 1
Longueur maximale = 100
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' (obligatoire)
versionQueryName Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur query. corde

Contraintes:
Longueur minimale = 1
Longueur maximale = 100