Partager via


Api Version Set - Update

Mises à jour les détails de l’Api VersionSet spécifié par son identificateur.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apiVersionSets/{versionSetId}?api-version=2021-08-01

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

Nom du groupe de ressources.

serviceName
path True

string

Nom du service Gestion des API.

Modèle d’expression régulière: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

versionSetId
path True

string

Identificateur de l’ensemble de versions de l’API. Doit être unique dans le instance de service Gestion des API actuel.

Modèle d’expression régulière: ^[^*#&+:<>?]+$

api-version
query True

string

Version de l’API à utiliser avec la demande du client.

En-tête de la demande

Nom Obligatoire Type Description
If-Match True

string

ETag de l’entité. ETag doit correspondre à l’état actuel de l’entité à partir de la réponse d’en-tête de la requête GET ou il doit être * pour la mise à jour inconditionnelle.

Corps de la demande

Nom Type Description
properties.description

string

Description de l’ensemble de versions d’API.

properties.displayName

string

Nom de l’ensemble de versions d’API

properties.versionHeaderName

string

Nom du paramètre d’en-tête HTTP qui indique la version de l’API si versioningScheme est défini sur header.

properties.versionQueryName

string

Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur query.

properties.versioningScheme

versioningScheme

Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.

Réponses

Nom Type Description
200 OK

ApiVersionSetContract

L’ensemble de versions de l’API a été correctement mis à jour.

En-têtes

ETag: string

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

ApiManagementUpdateApiVersionSet

Exemple de requête

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/vs1?api-version=2021-08-01


{
  "properties": {
    "displayName": "api set 1",
    "versioningScheme": "Segment",
    "description": "Version configuration"
  }
}

Exemple de réponse

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apiVersionSets/vs1",
  "type": "Microsoft.ApiManagement/service/api-version-sets",
  "name": "vs1",
  "properties": {
    "displayName": "api set 1",
    "versioningScheme": "Segment",
    "description": "Version configuration"
  }
}

Définitions

Nom Description
ApiVersionSetContract

Détails du contrat de l’ensemble de versions de l’API.

ApiVersionSetUpdateParameters

Paramètres pour mettre à jour ou créer un contrat d’ensemble de versions d’API.

ErrorFieldContract

Contrat de champ d’erreur.

ErrorResponse

Réponse d’erreur.

versioningScheme

Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.

ApiVersionSetContract

Détails du contrat de l’ensemble de versions de l’API.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

nom de la ressource.

properties.description

string

Description de l’ensemble de versions d’API.

properties.displayName

string

Nom de l’ensemble de versions d’API

properties.versionHeaderName

string

Nom du paramètre d’en-tête HTTP qui indique la version de l’API si versioningScheme est défini sur header.

properties.versionQueryName

string

Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur query.

properties.versioningScheme

versioningScheme

Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ApiVersionSetUpdateParameters

Paramètres pour mettre à jour ou créer un contrat d’ensemble de versions d’API.

Nom Type Description
properties.description

string

Description de l’ensemble de versions d’API.

properties.displayName

string

Nom de l’ensemble de versions d’API

properties.versionHeaderName

string

Nom du paramètre d’en-tête HTTP qui indique la version de l’API si versioningScheme est défini sur header.

properties.versionQueryName

string

Nom du paramètre de requête qui indique la version de l’API si versioningScheme a la valeur query.

properties.versioningScheme

versioningScheme

Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.

ErrorFieldContract

Contrat de champ d’erreur.

Nom Type Description
code

string

Code d'erreur de niveau propriété.

message

string

Représentation lisible par l’homme de l’erreur au niveau des propriétés.

target

string

Nom de propriété.

ErrorResponse

Réponse d’erreur.

Nom Type Description
error.code

string

Code d'erreur défini par le service. Ce code sert de sous-état pour le code d'erreur HTTP spécifié dans la réponse.

error.details

ErrorFieldContract[]

Liste des champs non valides envoyés dans la demande, en cas d’erreur de validation.

error.message

string

Représentation contrôlable de visu de l’erreur.

versioningScheme

Valeur qui détermine l’emplacement de l’identificateur de version de l’API dans une requête HTTP.

Nom Type Description
Header

string

La version de l’API est passée dans un en-tête HTTP.

Query

string

La version de l’API est passée dans un paramètre de requête.

Segment

string

La version de l’API est passée dans un segment de chemin d’accès.