Share via


Deployments - What If

Retourne les modifications qui seront apportées par le déploiement s’ils sont exécutés dans l’étendue du groupe de ressources.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}/whatIf?api-version=2021-04-01

Paramètres URI

Nom Dans Obligatoire Type Description
deploymentName
path True

string

Le nom du déploiement.

Regex pattern: ^[-\w\._\(\)]+$

resourceGroupName
path True

string

Nom du groupe de ressources dans lequel le modèle sera déployé. Le nom ne respecte pas la casse.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID d’abonnement Microsoft Azure.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
properties True

DeploymentWhatIfProperties

Propriétés de déploiement.

location

string

Emplacement où stocker les données de déploiement.

Réponses

Nom Type Description
200 OK

WhatIfOperationResult

OK : retourne What-If status d’opération

202 Accepted

Accepté : retourne l’URL dans l’en-tête Location pour interroger les status d’opération de longue durée.

Headers

  • Location: string
  • Retry-After: string
Other Status Codes

CloudError

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
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Exemples

Predict template changes at resource group scope

Sample Request

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment/whatIf?api-version=2021-04-01

{
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json"
    },
    "parameters": {},
    "mode": "Incremental"
  }
}

Sample Response

{
  "status": "Succeeded",
  "properties": {
    "changes": [
      {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
        "changeType": "Modify",
        "before": {
          "apiVersion": "2018-11-30",
          "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
          "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
          "name": "myExistingIdentity",
          "location": "westus2"
        },
        "after": {
          "apiVersion": "2018-11-30",
          "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
          "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
          "name": "myExistingIdentity",
          "location": "westus2",
          "tags": {
            "myNewTag": "my tag value"
          }
        },
        "delta": [
          {
            "path": "tags.myNewTag",
            "propertyChangeType": "Create",
            "after": "my tag value"
          }
        ]
      },
      {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myNewIdentity",
        "changeType": "Create",
        "after": {
          "apiVersion": "2018-11-30",
          "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myNewIdentity",
          "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
          "name": "myNewIdentity",
          "location": "eastus",
          "tags": {
            "myOtherNewTag": "another new tag value"
          }
        }
      }
    ]
  }
}
Location: /subscriptions/00000000-0000-0000-0000-000000000000/ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

Définitions

Nom Description
ChangeType

Type de modification qui sera apportée à la ressource lors de l’exécution du déploiement.

CloudError

Réponse d’erreur pour une demande de gestion des ressources.

DebugSetting

Paramètre de débogage.

DeploymentMode

Mode utilisé pour déployer des ressources. Cette valeur peut être Incrémentielle ou Terminée. En mode incrémentiel, les ressources sont déployées sans supprimer de ressources existantes non incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes du groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Soyez prudent lorsque vous utilisez le mode Complet, car vous pouvez supprimer involontairement des ressources.

DeploymentWhatIf

Paramètres de l’opération de simulation de déploiement.

DeploymentWhatIfProperties

Propriétés de scénario de déploiement.

DeploymentWhatIfSettings

Paramètres d’opération de déploiement What-If.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorResponse

Réponse d’erreur

ExpressionEvaluationOptions

Spécifie si les expressions de modèle sont évaluées dans l’étendue du modèle parent ou du modèle imbriqué.

ExpressionEvaluationOptionsScopeType

Étendue à utiliser pour l’évaluation des paramètres, des variables et des fonctions dans un modèle imbriqué.

OnErrorDeployment

Déploiement en cas d’erreur.

OnErrorDeploymentType

Type de comportement de déploiement en cas d’erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.

ParametersLink

Entité représentant la référence aux paramètres de déploiement.

PropertyChangeType

Type de modification de propriété.

TemplateLink

Entité représentant la référence au modèle.

WhatIfChange

Informations sur un changement de ressource unique prédit par What-If opération.

WhatIfOperationResult

Résultat de l’opération What-If. Contient une liste des modifications prédites et un lien URL pour accéder au jeu de résultats suivant.

WhatIfPropertyChange

Modification prédite de la propriété de ressource.

WhatIfResultFormat

Format des résultats What-If

ChangeType

Type de modification qui sera apportée à la ressource lors de l’exécution du déploiement.

Nom Type Description
Create

string

La ressource n’existe pas dans l’état actuel, mais elle est présente dans l’état souhaité. La ressource est créée lors de l’exécution du déploiement.

Delete

string

La ressource existe dans l’état actuel et est absente de l’état souhaité. La ressource est supprimée lors de l’exécution du déploiement.

Deploy

string

La ressource existe dans l’état actuel et l’état souhaité, et sera redéployée lors de l’exécution du déploiement. Il est possible que les propriétés de la ressource changent.

Ignore

string

La ressource existe dans l’état actuel et est absente de l’état souhaité. La ressource ne sera pas déployée ou modifiée lors de l’exécution du déploiement.

Modify

string

La ressource existe dans l’état actuel et l’état souhaité, et sera redéployée lors de l’exécution du déploiement. Les propriétés de la ressource changeront.

NoChange

string

La ressource existe dans l’état actuel et l’état souhaité, et sera redéployée lors de l’exécution du déploiement. Les propriétés de la ressource ne changeront pas.

Unsupported

string

La ressource n’est pas prise en charge par what-if.

CloudError

Réponse d’erreur pour une demande de gestion des ressources.

Nom Type Description
error

ErrorResponse

Réponse d’erreur
Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.)

DebugSetting

Paramètre de débogage.

Nom Type Description
detailLevel

string

Spécifie le type d’informations à consigner pour le débogage. Les valeurs autorisées sont none, requestContent, responseContent ou requestContent et responseContent séparées par une virgule. La valeur par défaut est aucune gestion. Lorsque vous définissez cette valeur, tenez compte du type d’informations que vous transmettez pendant le déploiement. En enregistrant des informations sur la requête ou la réponse, vous risquez d’exposer des données sensibles récupérées au cours des opérations de déploiement.

DeploymentMode

Mode utilisé pour déployer des ressources. Cette valeur peut être Incrémentielle ou Terminée. En mode incrémentiel, les ressources sont déployées sans supprimer de ressources existantes non incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes du groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Soyez prudent lorsque vous utilisez le mode Complet, car vous pouvez supprimer involontairement des ressources.

Nom Type Description
Complete

string

Incremental

string

DeploymentWhatIf

Paramètres de l’opération de simulation de déploiement.

Nom Type Description
location

string

Emplacement où stocker les données de déploiement.

properties

DeploymentWhatIfProperties

Propriétés de déploiement.

DeploymentWhatIfProperties

Propriétés de scénario de déploiement.

Nom Type Description
debugSetting

DebugSetting

Paramètre de débogage du déploiement.

expressionEvaluationOptions

ExpressionEvaluationOptions

Spécifie si les expressions de modèle sont évaluées dans l’étendue du modèle parent ou du modèle imbriqué. Applicable uniquement aux modèles imbriqués. Si elle n’est pas spécifiée, la valeur par défaut est externe.

mode

DeploymentMode

Mode utilisé pour déployer des ressources. Cette valeur peut être Incrémentielle ou Terminée. En mode incrémentiel, les ressources sont déployées sans supprimer de ressources existantes non incluses dans le modèle. En mode Complet, les ressources sont déployées et les ressources existantes du groupe de ressources qui ne sont pas incluses dans le modèle sont supprimées. Soyez prudent lorsque vous utilisez le mode Complet, car vous pouvez supprimer involontairement des ressources.

onErrorDeployment

OnErrorDeployment

Comportement du déploiement en cas d’erreur.

parameters

object

Paires nom-valeur qui définissent les paramètres de déploiement pour le modèle. Vous utilisez cet élément lorsque vous souhaitez fournir les valeurs de paramètre directement dans la demande au lieu de créer un lien vers un fichier de paramètres existant. Utilisez la propriété parametersLink ou la propriété parameters, mais pas les deux. Il peut s’agir d’un JObject ou d’une chaîne JSON bien formée.

parametersLink

ParametersLink

URI du fichier de paramètres. Vous utilisez cet élément pour lier à un fichier de paramètres existant. Utilisez la propriété parametersLink ou la propriété parameters, mais pas les deux.

template

object

Contenu du modèle. Vous utilisez cet élément lorsque vous souhaitez passer la syntaxe du modèle directement dans la requête au lieu d’un lien vers un modèle existant. Il peut s’agir d’une chaîne JObject ou JSON bien formée. Utilisez la propriété templateLink ou la propriété template, mais pas les deux.

templateLink

TemplateLink

URI du modèle. Utilisez la propriété templateLink ou la propriété template, mais pas les deux.

whatIfSettings

DeploymentWhatIfSettings

Paramètres d’opération de What-If facultatifs.

DeploymentWhatIfSettings

Paramètres d’opération de déploiement What-If.

Nom Type Description
resultFormat

WhatIfResultFormat

Format des résultats What-If

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorResponse

Réponse d’erreur

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorResponse[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ExpressionEvaluationOptions

Spécifie si les expressions de modèle sont évaluées dans l’étendue du modèle parent ou du modèle imbriqué.

Nom Type Description
scope

ExpressionEvaluationOptionsScopeType

Étendue à utiliser pour l’évaluation des paramètres, des variables et des fonctions dans un modèle imbriqué.

ExpressionEvaluationOptionsScopeType

Étendue à utiliser pour l’évaluation des paramètres, des variables et des fonctions dans un modèle imbriqué.

Nom Type Description
Inner

string

NotSpecified

string

Outer

string

OnErrorDeployment

Déploiement en cas d’erreur.

Nom Type Description
deploymentName

string

Déploiement à utiliser en cas d’erreur.

type

OnErrorDeploymentType

Type de comportement de déploiement en cas d’erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.

OnErrorDeploymentType

Type de comportement de déploiement en cas d’erreur. Les valeurs possibles sont LastSuccessful et SpecificDeployment.

Nom Type Description
LastSuccessful

string

SpecificDeployment

string

Entité représentant la référence aux paramètres de déploiement.

Nom Type Description
contentVersion

string

S’il est inclus, doit correspondre à ContentVersion dans le modèle.

uri

string

URI du fichier de paramètres.

PropertyChangeType

Type de modification de propriété.

Nom Type Description
Array

string

La propriété est un tableau et contient les modifications imbriquées.

Create

string

La propriété n’existe pas dans l’état actuel, mais est présente dans l’état souhaité. La propriété est créée lors de l’exécution du déploiement.

Delete

string

La propriété existe dans l’état actuel et est absente de l’état souhaité. Il sera supprimé lors de l’exécution du déploiement.

Modify

string

La propriété existe à la fois dans l’état actuel et souhaité et est différente. La valeur de la propriété change lorsque le déploiement est exécuté.

NoEffect

string

La propriété ne sera pas définie ou mise à jour.

Entité représentant la référence au modèle.

Nom Type Description
contentVersion

string

S’il est inclus, doit correspondre à ContentVersion dans le modèle.

id

string

ID de ressource d’une spécification de modèle. Utilisez la propriété id ou uri, mais pas les deux.

queryString

string

Chaîne de requête (par exemple, un jeton SAS) à utiliser avec l’URI templateLink.

relativePath

string

La propriété relativePath peut être utilisée pour déployer un modèle lié à un emplacement relatif au parent. Si le modèle parent a été lié à un TemplateSpec, cela fait référence à un artefact dans templateSpec. Si le parent a été lié avec un URI, le déploiement enfant est une combinaison des URI parent et relativePath

uri

string

URI du modèle à déployer. Utilisez la propriété URI ou id, mais pas les deux.

WhatIfChange

Informations sur un changement de ressource unique prédit par What-If opération.

Nom Type Description
after

object

La instantané prédite de la ressource après l’exécution du déploiement.

before

object

Le instantané de la ressource avant l’exécution du déploiement.

changeType

ChangeType

Type de modification qui sera apportée à la ressource lors de l’exécution du déploiement.

delta

WhatIfPropertyChange[]

Modifications prédites des propriétés de ressource.

resourceId

string

ID de ressource

unsupportedReason

string

Explication de la raison pour laquelle la ressource n’est pas prise en charge par what-if.

WhatIfOperationResult

Résultat de l’opération What-If. Contient une liste des modifications prédites et un lien URL pour accéder au jeu de résultats suivant.

Nom Type Description
error

ErrorResponse

Réponse d’erreur
Erreur lorsque What-If opération échoue.

properties.changes

WhatIfChange[]

Liste des modifications de ressources prédites par What-If opération.

status

string

État de l’opération What-If.

WhatIfPropertyChange

Modification prédite de la propriété de ressource.

Nom Type Description
after

object

Valeur de la propriété après l’exécution du déploiement.

before

object

Valeur de la propriété avant l’exécution du déploiement.

children

WhatIfPropertyChange[]

Modifications des propriétés imbriquées.

path

string

Chemin d'accès à la propriété.

propertyChangeType

PropertyChangeType

Type de modification de propriété.

WhatIfResultFormat

Format des résultats What-If

Nom Type Description
FullResourcePayloads

string

ResourceIdOnly

string