Tenant Configuration - Validate
Cette opération valide les modifications apportées à la branche Git spécifiée. Il s’agit d’une opération de longue durée qui peut prendre plusieurs minutes.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/configuration/validate?api-version=2021-08-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
configuration
|
path | True |
Identificateur de l’opération de configuration Git. |
|
resource
|
path | True |
string |
Nom du groupe de ressources. |
service
|
path | True |
string |
Nom du service Gestion des API. Modèle d’expression régulière: |
subscription
|
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. |
api-version
|
query | True |
string |
Version de l’API à utiliser avec la demande cliente. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
properties.branch | True |
string |
Nom de la branche Git à partir de laquelle la configuration doit être déployée dans la base de données de configuration. |
properties.force |
boolean |
Valeur qui applique la suppression d’abonnements aux produits qui sont supprimés dans cette mise à jour. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Résultat de la validation des modifications dans la branche Git spécifiée. |
|
202 Accepted |
Accepté : l’en-tête Emplacement contient l’URL dans laquelle les status de l’opération de longue durée peuvent être vérifiées. |
|
Other Status Codes |
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
ApiManagementTenantConfigurationValidate
Exemple de requête
Exemple de réponse
location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5a1af64e2a6d2e0b688d751e?api-version=2021-08-01
{
"id": "6074ec02093a9d0dac3d7345",
"type": "Microsoft.ApiManagement/service/tenant/operationResults",
"name": "6074ec02093a9d0dac3d7345",
"properties": {
"status": "Succeeded",
"started": "2021-04-13T00:55:30.62Z",
"updated": "2021-04-13T00:55:39.857Z",
"resultInfo": "Validation is successfull",
"actionLog": []
}
}
Définitions
Nom | Description |
---|---|
Async |
État d’une opération asynchrone. |
configuration |
Identificateur de l’opération de configuration Git. |
Deploy |
Déployer le contrat de configuration du locataire. |
Error |
Contrat champ d’erreur. |
Error |
Réponse d’erreur. |
Error |
Contrat de corps d’erreur. |
Operation |
Résultats de l’opération Git de longue durée. |
Operation |
Journal de l’entité en cours de création, de mise à jour ou de suppression. |
AsyncOperationStatus
État d’une opération asynchrone.
Nom | Type | Description |
---|---|---|
Failed |
string |
|
InProgress |
string |
|
Started |
string |
|
Succeeded |
string |
configurationIdName
Identificateur de l’opération de configuration Git.
Nom | Type | Description |
---|---|---|
configuration |
string |
DeployConfigurationParameters
Déployer le contrat de configuration du locataire.
Nom | Type | Description |
---|---|---|
properties.branch |
string |
Nom de la branche Git à partir de laquelle la configuration doit être déployée dans la base de données de configuration. |
properties.force |
boolean |
Valeur qui applique la suppression d’abonnements aux produits qui sont supprimés dans cette mise à jour. |
ErrorFieldContract
Contrat 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 de la propriété. |
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 |
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. |
ErrorResponseBody
Contrat de corps d’erreur.
Nom | Type | Description |
---|---|---|
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. |
details |
Liste des champs non valides envoyés dans la demande, en cas d’erreur de validation. |
|
message |
string |
Représentation contrôlable de visu de l’erreur. |
OperationResultContract
Résultats de l’opération Git de longue durée.
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.actionLog |
Cette propriété est fournie uniquement dans le cadre de l’opération de TenantConfiguration_Validate. Il contient le journal des entités qui seront mises à jour/créées/supprimées dans le cadre de l’opération de TenantConfiguration_Deploy. |
|
properties.error |
Contrat de corps d’erreur |
|
properties.id |
string |
Identificateur du résultat de l’opération. |
properties.resultInfo |
string |
Informations de résultat facultatives. |
properties.started |
string |
Heure de début d’une opération asynchrone. La date est conforme au format suivant : |
properties.status |
État d’une opération asynchrone. |
|
properties.updated |
string |
Heure de la dernière mise à jour d’une opération asynchrone. La date est conforme au format suivant : |
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
OperationResultLogItemContract
Journal de l’entité en cours de création, de mise à jour ou de suppression.
Nom | Type | Description |
---|---|---|
action |
string |
Action telle que créer/mettre à jour/supprimer. |
objectKey |
string |
Identificateur de l’entité en cours de création/mise à jour/suppression. |
objectType |
string |
Type de contrat d’entité. |