Deployments - What If

Referenz

Service:: Resource Management

API Version:: 2021-04-01

Gibt Änderungen zurück, die von der Bereitstellung vorgenommen werden, wenn sie im Bereich der Ressourcengruppe ausgeführt werden.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
deploymentName	path	True	string	Der Name der Bereitstellung Regex pattern: `^[-\w\._]+$`
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, in der die Vorlage bereitgestellt wird. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Die Microsoft Azure-Abonnement-ID.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties	True	DeploymentWhatIfProperties	Die Bereitstellungseigenschaften.
location		string	Der Speicherort für die Bereitstellungsdaten.

Antworten

Name	Typ	Beschreibung
200 OK	WhatIfOperationResult	OK : Gibt What-If Vorgang status zurück.
202 Accepted		Akzeptiert: Gibt die URL im Speicherortheader zurück, um status für lange Ausführungsvorgänge abzufragen. Headers Location: string Retry-After: string
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Name

Typ

Beschreibung

200 OK

WhatIfOperationResult

OK : Gibt What-If Vorgang status zurück.

202 Accepted

Akzeptiert: Gibt die URL im Speicherortheader zurück, um status für lange Ausführungsvorgänge abzufragen.

Headers

Location: string
Retry-After: string

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

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"
  }
}

package armresources_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4fd842fb73656039ec94ce367bcedee25a57bd18/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PostDeploymentWhatIfOnResourceGroup.json
func ExampleDeploymentsClient_BeginWhatIf() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armresources.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginWhatIf(ctx, "my-resource-group", "my-deployment", armresources.DeploymentWhatIf{
		Properties: &armresources.DeploymentWhatIfProperties{
			Mode:         to.Ptr(armresources.DeploymentModeIncremental),
			Parameters:   map[string]any{},
			TemplateLink: &armresources.TemplateLink{},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.WhatIfOperationResult = armresources.WhatIfOperationResult{
	// 	Properties: &armresources.WhatIfOperationProperties{
	// 		Changes: []*armresources.WhatIfChange{
	// 			{
	// 				After: map[string]any{
	// 					"name": "myExistingIdentity",
	// 					"type": "Microsoft.ManagedIdentity/userAssignedIdentities",
	// 					"apiVersion": "2018-11-30",
	// 					"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
	// 					"location": "westus2",
	// 					"tags":map[string]any{
	// 						"myNewTag": "my tag value",
	// 					},
	// 				},
	// 				Before: map[string]any{
	// 					"name": "myExistingIdentity",
	// 					"type": "Microsoft.ManagedIdentity/userAssignedIdentities",
	// 					"apiVersion": "2018-11-30",
	// 					"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
	// 					"location": "westus2",
	// 				},
	// 				ChangeType: to.Ptr(armresources.ChangeTypeModify),
	// 				Delta: []*armresources.WhatIfPropertyChange{
	// 					{
	// 						Path: to.Ptr("tags.myNewTag"),
	// 						After: "my tag value",
	// 						PropertyChangeType: to.Ptr(armresources.PropertyChangeTypeCreate),
	// 				}},
	// 				ResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity"),
	// 			},
	// 			{
	// 				After: map[string]any{
	// 					"name": "myNewIdentity",
	// 					"type": "Microsoft.ManagedIdentity/userAssignedIdentities",
	// 					"apiVersion": "2018-11-30",
	// 					"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myNewIdentity",
	// 					"location": "eastus",
	// 					"tags":map[string]any{
	// 						"myOtherNewTag": "another new tag value",
	// 					},
	// 				},
	// 				ChangeType: to.Ptr(armresources.ChangeTypeCreate),
	// 				ResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myNewIdentity"),
	// 		}},
	// 	},
	// 	Status: to.Ptr("succeeded"),
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ResourceManagementClient } = require("@azure/arm-resources");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Returns changes that will be made by the deployment if executed at the scope of the resource group.
 *
 * @summary Returns changes that will be made by the deployment if executed at the scope of the resource group.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PostDeploymentWhatIfOnResourceGroup.json
 */
async function predictTemplateChangesAtResourceGroupScope() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000001";
  const resourceGroupName = process.env["RESOURCES_RESOURCE_GROUP"] || "my-resource-group";
  const deploymentName = "my-deployment";
  const parameters = {
    properties: { mode: "Incremental", parameters: {}, templateLink: {} },
  };
  const credential = new DefaultAzureCredential();
  const client = new ResourceManagementClient(credential, subscriptionId);
  const result = await client.deployments.beginWhatIfAndWait(
    resourceGroupName,
    deploymentName,
    parameters
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Resources.Models;

// Generated from example definition: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PostDeploymentWhatIfOnResourceGroup.json
// this example is just showing the usage of "Deployments_WhatIf" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ArmDeploymentResource created on azure
// for more information of creating ArmDeploymentResource, please refer to the document of ArmDeploymentResource
string subscriptionId = "00000000-0000-0000-0000-000000000001";
string resourceGroupName = "my-resource-group";
string scope = $"/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}";
string deploymentName = "my-deployment";
ResourceIdentifier armDeploymentResourceId = ArmDeploymentResource.CreateResourceIdentifier(scope, deploymentName);
ArmDeploymentResource armDeployment = client.GetArmDeploymentResource(armDeploymentResourceId);

// invoke the operation
ArmDeploymentWhatIfContent content = new ArmDeploymentWhatIfContent(new ArmDeploymentWhatIfProperties(ArmDeploymentMode.Incremental)
{
    TemplateLink = null,
    Parameters = BinaryData.FromObjectAsJson(new Dictionary<string, object>()
    {
    }),
});
ArmOperation<WhatIfOperationResult> lro = await armDeployment.WhatIfAsync(WaitUntil.Completed, content);
WhatIfOperationResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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"
          }
        }
      }
    ]
  }
}

Status code:: 202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

Definitionen

Name	Beschreibung
ChangeType	Typ der Änderung, die an der Ressource vorgenommen wird, wenn die Bereitstellung ausgeführt wird.
CloudError	Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.
DebugSetting	Die Debugeinstellung.
DeploymentMode	Der Modus, der zum Bereitstellen von Ressourcen verwendet wird. Dieser Wert kann entweder Inkrementell oder Vollständig sein. Im inkrementellen Modus werden Ressourcen bereitgestellt, ohne vorhandene Ressourcen zu löschen, die nicht in der Vorlage enthalten sind. Im Vollständigen Modus werden Ressourcen bereitgestellt, und vorhandene Ressourcen in der Ressourcengruppe, die nicht in der Vorlage enthalten sind, werden gelöscht. Seien Sie vorsichtig, wenn Sie den Vollständigen Modus verwenden, da Sie versehentlich Ressourcen löschen können.
DeploymentWhatIf	Was-wäre-wenn-Vorgangsparameter für die Bereitstellung.
DeploymentWhatIfProperties	Was-wäre-wenn-Eigenschaften für die Bereitstellung.
DeploymentWhatIfSettings	Einstellungen für den Bereitstellungsvorgang What-If.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorResponse	Fehlerantwort
ExpressionEvaluationOptions	Gibt an, ob Vorlagenausdrücke innerhalb des Bereichs der übergeordneten oder geschachtelten Vorlage ausgewertet werden.
ExpressionEvaluationOptionsScopeType	Der Bereich, der für die Auswertung von Parametern, Variablen und Funktionen in einer geschachtelten Vorlage verwendet werden soll.
OnErrorDeployment	Bereitstellung bei Fehlerverhalten.
OnErrorDeploymentType	Die Bereitstellung nach Fehlerverhaltenstyp. Mögliche Werte sind LastSuccessful und SpecificDeployment.
ParametersLink	Entität, die den Verweis auf die Bereitstellungsparameter darstellt.
PropertyChangeType	Der Typ der Eigenschaftsänderung.
TemplateLink	Entität, die den Verweis auf die Vorlage darstellt.
WhatIfChange	Informationen zu einer einzelnen Ressourcenänderung, die von What-If Vorgang vorhergesagt wird.
WhatIfOperationResult	Ergebnis des What-If Vorgangs. Enthält eine Liste der vorhergesagten Änderungen und einen URL-Link, um zum nächsten Satz von Ergebnissen zu gelangen.
WhatIfPropertyChange	Die vorhergesagte Änderung der Ressourceneigenschaft.
WhatIfResultFormat	Das Format der What-If Ergebnisse

ChangeType

Typ der Änderung, die an der Ressource vorgenommen wird, wenn die Bereitstellung ausgeführt wird.

Name	Typ	Beschreibung
Create	string	Die Ressource ist nicht im aktuellen Zustand vorhanden, sondern im gewünschten Zustand vorhanden. Die Ressource wird erstellt, wenn die Bereitstellung ausgeführt wird.
Delete	string	Die Ressource befindet sich im aktuellen Zustand und fehlt im gewünschten Zustand. Die Ressource wird gelöscht, wenn die Bereitstellung ausgeführt wird.
Deploy	string	Die Ressource befindet sich im aktuellen Zustand und im gewünschten Zustand und wird erneut bereitgestellt, wenn die Bereitstellung ausgeführt wird. Die Eigenschaften der Ressource können sich ändern oder auch nicht.
Ignore	string	Die Ressource befindet sich im aktuellen Zustand und fehlt im gewünschten Zustand. Die Ressource wird nicht bereitgestellt oder geändert, wenn die Bereitstellung ausgeführt wird.
Modify	string	Die Ressource ist im aktuellen Zustand und im gewünschten Zustand vorhanden und wird bei Ausführung der Bereitstellung erneut bereitgestellt. Die Eigenschaften der Ressource ändern sich.
NoChange	string	Die Ressource befindet sich im aktuellen Zustand und im gewünschten Zustand und wird erneut bereitgestellt, wenn die Bereitstellung ausgeführt wird. Die Eigenschaften der Ressource werden nicht geändert.
Unsupported	string	Die Ressource wird von What-If nicht unterstützt.

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name	Typ	Beschreibung
error	ErrorResponse	Fehlerantwort Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

DebugSetting

Die Debugeinstellung.

Name	Typ	Beschreibung
detailLevel	string	Gibt den Typ der Informationen an, die für das Debuggen protokolliert werden sollen. Die zulässigen Werte sind none, requestContent, responseContent oder requestContent und responseContent getrennt durch ein Komma. Der Standardwert ist „none“. Berücksichtigen Sie beim Festlegen dieses Werts sorgfältig den Typ der Informationen, die Sie während der Bereitstellung übergeben. Indem Sie Informationen über die Anforderung oder die Antwort protokollieren, machen Sie möglicherweise vertrauliche Daten verfügbar, die durch die Bereitstellungsvorgänge abgerufen werden.

DeploymentMode

Der Modus, der zum Bereitstellen von Ressourcen verwendet wird. Dieser Wert kann entweder Inkrementell oder Vollständig sein. Im inkrementellen Modus werden Ressourcen bereitgestellt, ohne vorhandene Ressourcen zu löschen, die nicht in der Vorlage enthalten sind. Im Vollständigen Modus werden Ressourcen bereitgestellt, und vorhandene Ressourcen in der Ressourcengruppe, die nicht in der Vorlage enthalten sind, werden gelöscht. Seien Sie vorsichtig, wenn Sie den Vollständigen Modus verwenden, da Sie versehentlich Ressourcen löschen können.

Name	Typ	Beschreibung
Complete	string
Incremental	string

DeploymentWhatIf

Was-wäre-wenn-Vorgangsparameter für die Bereitstellung.

Name	Typ	Beschreibung
location	string	Der Speicherort für die Bereitstellungsdaten.
properties	DeploymentWhatIfProperties	Die Bereitstellungseigenschaften.

DeploymentWhatIfProperties

Was-wäre-wenn-Eigenschaften für die Bereitstellung.

Name	Typ	Beschreibung
debugSetting	DebugSetting	Die Debugeinstellung der Bereitstellung.
expressionEvaluationOptions	ExpressionEvaluationOptions	Gibt an, ob Vorlagenausdrücke innerhalb des Bereichs der übergeordneten oder geschachtelten Vorlage ausgewertet werden. Gilt nur für geschachtelte Vorlagen. Wenn nicht angegeben, ist der Standardwert äußerer Wert.
mode	DeploymentMode	Der Modus, der zum Bereitstellen von Ressourcen verwendet wird. Dieser Wert kann entweder Inkrementell oder Vollständig sein. Im inkrementellen Modus werden Ressourcen bereitgestellt, ohne vorhandene Ressourcen zu löschen, die nicht in der Vorlage enthalten sind. Im Vollständigen Modus werden Ressourcen bereitgestellt, und vorhandene Ressourcen in der Ressourcengruppe, die nicht in der Vorlage enthalten sind, werden gelöscht. Seien Sie vorsichtig, wenn Sie den Vollständigen Modus verwenden, da Sie versehentlich Ressourcen löschen können.
onErrorDeployment	OnErrorDeployment	Die Bereitstellung bei Fehlerverhalten.
parameters	object	Name- und Wertpaare, die die Bereitstellungsparameter für die Vorlage definieren. Sie verwenden dieses Element, wenn Sie die Parameterwerte direkt in der Anforderung angeben möchten, anstatt eine Verknüpfung mit einer vorhandenen Parameterdatei herzustellen. Verwenden Sie entweder die parametersLink-Eigenschaft oder die parameters-Eigenschaft, aber nicht beide. Dabei kann es sich um ein JObject oder eine wohlgeformte JSON-Zeichenfolge handeln.
parametersLink	ParametersLink	Der URI der Parameterdatei. Sie verwenden dieses Element, um eine Verknüpfung mit einer vorhandenen Parameterdatei zu erstellen. Verwenden Sie entweder die parametersLink-Eigenschaft oder die parameters-Eigenschaft, aber nicht beide.
template	object	Der Vorlageninhalt. Sie verwenden dieses Element, wenn Sie die Vorlagensyntax direkt in der Anforderung übergeben möchten, anstatt eine Verknüpfung mit einer vorhandenen Vorlage herzustellen. Es kann sich um ein JObject oder eine wohlgeformte JSON-Zeichenfolge handeln. Verwenden Sie entweder die templateLink-Eigenschaft oder die Template-Eigenschaft, aber nicht beides.
templateLink	TemplateLink	Der URI der Vorlage. Verwenden Sie entweder die templateLink-Eigenschaft oder die Template-Eigenschaft, aber nicht beides.
whatIfSettings	DeploymentWhatIfSettings	Optionale What-If Vorgangseinstellungen.

DeploymentWhatIfSettings

Einstellungen für den Bereitstellungsvorgang What-If.

Name	Typ	Beschreibung
resultFormat	WhatIfResultFormat	Das Format der What-If Ergebnisse

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorResponse[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ExpressionEvaluationOptions

Gibt an, ob Vorlagenausdrücke innerhalb des Bereichs der übergeordneten oder geschachtelten Vorlage ausgewertet werden.

Name	Typ	Beschreibung
scope	ExpressionEvaluationOptionsScopeType	Der Bereich, der für die Auswertung von Parametern, Variablen und Funktionen in einer geschachtelten Vorlage verwendet werden soll.

ExpressionEvaluationOptionsScopeType

Der Bereich, der für die Auswertung von Parametern, Variablen und Funktionen in einer geschachtelten Vorlage verwendet werden soll.

Name	Typ	Beschreibung
Inner	string
NotSpecified	string
Outer	string

OnErrorDeployment

Bereitstellung bei Fehlerverhalten.

Name	Typ	Beschreibung
deploymentName	string	Die Bereitstellung, die bei Einem Fehlerfall verwendet werden soll.
type	OnErrorDeploymentType	Die Bereitstellung nach Fehlerverhaltenstyp. Mögliche Werte sind LastSuccessful und SpecificDeployment.

OnErrorDeploymentType

Die Bereitstellung nach Fehlerverhaltenstyp. Mögliche Werte sind LastSuccessful und SpecificDeployment.

Name	Typ	Beschreibung
LastSuccessful	string
SpecificDeployment	string

ParametersLink

Entität, die den Verweis auf die Bereitstellungsparameter darstellt.

Name	Typ	Beschreibung
contentVersion	string	Falls enthalten, muss mit der ContentVersion in der Vorlage übereinstimmen.
uri	string	Der URI der Parameterdatei.

PropertyChangeType

Der Typ der Eigenschaftsänderung.

Name	Typ	Beschreibung
Array	string	Die Eigenschaft ist ein Array und enthält geschachtelte Änderungen.
Create	string	Die Eigenschaft ist nicht im aktuellen Zustand vorhanden, sondern im gewünschten Zustand vorhanden. Die -Eigenschaft wird erstellt, wenn die Bereitstellung ausgeführt wird.
Delete	string	Die Eigenschaft befindet sich im aktuellen Zustand und fehlt im gewünschten Zustand. Sie wird gelöscht, wenn die Bereitstellung ausgeführt wird.
Modify	string	Die Eigenschaft ist sowohl im aktuellen als auch im gewünschten Zustand vorhanden und unterscheidet sich. Der Wert der -Eigenschaft ändert sich, wenn die Bereitstellung ausgeführt wird.
NoEffect	string	Die Eigenschaft wird nicht festgelegt oder aktualisiert.

TemplateLink

Entität, die den Verweis auf die Vorlage darstellt.

Name	Typ	Beschreibung
contentVersion	string	Falls enthalten, muss mit der ContentVersion in der Vorlage übereinstimmen.
id	string	Die Ressourcen-ID einer Vorlagenspezifikation. Verwenden Sie entweder die Id- oder URI-Eigenschaft, aber nicht beide.
queryString	string	Die Abfragezeichenfolge (z. B. ein SAS-Token), die mit dem templateLink-URI verwendet werden soll.
relativePath	string	Die relativePath-Eigenschaft kann verwendet werden, um eine verknüpfte Vorlage an einem Speicherort relativ zum übergeordneten Element bereitzustellen. Wenn die übergeordnete Vorlage mit einer TemplateSpec verknüpft wurde, verweist dies auf ein Artefakt in der TemplateSpec. Wenn das übergeordnete Element mit einem URI verknüpft wurde, ist die untergeordnete Bereitstellung eine Kombination aus den übergeordneten uris und relativePath-URIs.
uri	string	Der URI der bereitzustellenden Vorlage. Verwenden Sie entweder die URI- oder id-Eigenschaft, aber nicht beide.

WhatIfChange

Informationen zu einer einzelnen Ressourcenänderung, die von What-If Vorgang vorhergesagt wird.

Name	Typ	Beschreibung
after	object	Der vorhergesagte Momentaufnahme der Ressource, nachdem die Bereitstellung ausgeführt wurde.
before	object	Der Momentaufnahme der Ressource, bevor die Bereitstellung ausgeführt wird.
changeType	ChangeType	Typ der Änderung, die an der Ressource vorgenommen wird, wenn die Bereitstellung ausgeführt wird.
delta	WhatIfPropertyChange[]	Die vorhergesagten Änderungen an Den Ressourceneigenschaften.
resourceId	string	Ressourcen-ID
unsupportedReason	string	Die Erläuterung, warum die Ressource von Was-wäre-wäre-wenn nicht unterstützt wird.

WhatIfOperationResult

Ergebnis des What-If Vorgangs. Enthält eine Liste der vorhergesagten Änderungen und einen URL-Link, um zum nächsten Satz von Ergebnissen zu gelangen.

Name	Typ	Beschreibung
error	ErrorResponse	Fehlerantwort Fehler, wenn What-If Vorgang fehlschlägt.
properties.changes	WhatIfChange[]	Liste der Ressourcenänderungen, die von What-If Vorgang vorhergesagt werden.
status	string	Status des What-If Vorgangs.

WhatIfPropertyChange

Die vorhergesagte Änderung der Ressourceneigenschaft.

Name	Typ	Beschreibung
after	object	Der Wert der Eigenschaft, nachdem die Bereitstellung ausgeführt wurde.
before	object	Der Wert der Eigenschaft, bevor die Bereitstellung ausgeführt wird.
children	WhatIfPropertyChange[]	Geschachtelte Eigenschaftenänderungen.
path	string	Der Pfad der Eigenschaft.
propertyChangeType	PropertyChangeType	Der Typ der Eigenschaftsänderung.

WhatIfResultFormat

Das Format der What-If Ergebnisse

Name	Typ	Beschreibung
FullResourcePayloads	string
ResourceIdOnly	string

Freigeben über

Deployments - What If

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Scopes

Beispiele

Predict template changes at resource group scope

Sample Request

Sample Response

Definitionen

ChangeType

CloudError

DebugSetting

DeploymentMode

DeploymentWhatIf

DeploymentWhatIfProperties

DeploymentWhatIfSettings

ErrorAdditionalInfo

ErrorResponse

ExpressionEvaluationOptions

ExpressionEvaluationOptionsScopeType

OnErrorDeployment

OnErrorDeploymentType

ParametersLink

PropertyChangeType

TemplateLink

WhatIfChange

WhatIfOperationResult

WhatIfPropertyChange

WhatIfResultFormat

Zusätzliche Ressourcen