Deployments - Create Or Update

Dienst:: Resource Management

API-Version:: 2025-04-01

Stellt Ressourcen in einer Ressourcengruppe bereit.
Sie können die Vorlage und Parameter direkt in der Anforderung bereitstellen oder mit JSON-Dateien verknüpfen.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
deploymentName	path	True	string minLength: 1 maxLength: 64 pattern: ^[-\w\._]+$	Der Name des Einsatzes.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties	True	DeploymentProperties	Die Bereitstellungseigenschaften.
identity		DeploymentIdentity	Die Konfiguration der verwalteten Identität für eine Bereitstellung.
location		string	Der Speicherort zum Speichern der Bereitstellungsdaten.
tags		object	Bereitstellungstags

Antworten

Name	Typ	Beschreibung
200 OK	DeploymentExtended	Die Aktualisierungsoperation der Ressource 'DeploymentExtended' war erfolgreich
201 Created	DeploymentExtended	Die Ressourcen-Erstellungsoperation 'DeploymentExtended' war erfolgreich Header Location: string Retry-After: integer
Other Status Codes	CloudError	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

DeploymentExtended

Die Aktualisierungsoperation der Ressource 'DeploymentExtended' war erfolgreich

201 Created

DeploymentExtended

Die Ressourcen-Erstellungsoperation 'DeploymentExtended' war erfolgreich

Header

Location: string
Retry-After: integer

Other Status Codes

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Create a deployment that will deploy a template with a uri and queryString

Create a deployment that will deploy a templateSpec with the given resourceId

Create a deployment that will redeploy another deployment on failure

Create a deployment that will redeploy the last successful deployment on failure

Create deployment using external inputs

Create a deployment that will deploy a template with a uri and queryString

Beispielanforderung

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

{
  "properties": {
    "mode": "Incremental",
    "parameters": {},
    "templateLink": {
      "queryString": "sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=xxxxxxxx0xxxxxxxxxxxxx%2bxxxxxxxxxxxxxxxxxxxx%3d",
      "uri": "https://example.com/exampleTemplate.json"
    }
  }
}


import com.azure.resourcemanager.resources.fluent.models.DeploymentInner;
import com.azure.resourcemanager.resources.models.DeploymentMode;
import com.azure.resourcemanager.resources.models.DeploymentProperties;
import com.azure.resourcemanager.resources.models.TemplateLink;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Deployments CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/
     * PutDeploymentResourceGroup.json
     */
    /**
     * Sample code: Create a deployment that will deploy a template with a uri and queryString.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createADeploymentThatWillDeployATemplateWithAUriAndQueryString(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.genericResources().manager().deploymentClient().getDeployments().createOrUpdate("my-resource-group",
            "my-deployment",
            new DeploymentInner().withProperties(new DeploymentProperties().withTemplateLink(
                new TemplateLink().withUri("https://example.com/exampleTemplate.json").withQueryString(
                    "sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=xxxxxxxx0xxxxxxxxxxxxx%2bxxxxxxxxxxxxxxxxxxxx%3d"))
                .withParameters(mapOf()).withMode(DeploymentMode.INCREMENTAL)),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.deployments import DeploymentsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-deployments
# USAGE
    python put_deployment_resource_group.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DeploymentsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000001",
    )

    response = client.deployments.begin_create_or_update(
        resource_group_name="my-resource-group",
        deployment_name="my-deployment",
        parameters={
            "properties": {
                "mode": "Incremental",
                "parameters": {},
                "templateLink": {
                    "queryString": "sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=xxxxxxxx0xxxxxxxxxxxxx%2bxxxxxxxxxxxxxxxxxxxx%3d",
                    "uri": "https://example.com/exampleTemplate.json",
                },
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentResourceGroup.json
if __name__ == "__main__":
    main()

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

package armdeployments_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/armdeployments"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/05809299e74fc16df7badbab3fb29e25da59f7d2/specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentResourceGroup.json
func ExampleDeploymentsClient_BeginCreateOrUpdate_createADeploymentThatWillDeployATemplateWithAUriAndQueryString() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdeployments.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginCreateOrUpdate(ctx, "my-resource-group", "my-deployment", armdeployments.Deployment{
		Properties: &armdeployments.DeploymentProperties{
			Mode:       to.Ptr(armdeployments.DeploymentModeIncremental),
			Parameters: map[string]*armdeployments.DeploymentParameter{},
			TemplateLink: &armdeployments.TemplateLink{
				QueryString: to.Ptr("sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=xxxxxxxx0xxxxxxxxxxxxx%2bxxxxxxxxxxxxxxxxxxxx%3d"),
				URI:         to.Ptr("https://example.com/exampleTemplate.json"),
			},
		},
	}, 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.DeploymentExtended = armdeployments.DeploymentExtended{
	// 	Name: to.Ptr("my-deployment"),
	// 	Type: to.Ptr("Microsoft.Resources/deployments"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment"),
	// 	Properties: &armdeployments.DeploymentPropertiesExtended{
	// 		CorrelationID: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 		Dependencies: []*armdeployments.Dependency{
	// 		},
	// 		Duration: to.Ptr("PT22.8356799S"),
	// 		Mode: to.Ptr(armdeployments.DeploymentModeIncremental),
	// 		OutputResources: []*armdeployments.ResourceReference{
	// 			{
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"),
	// 		}},
	// 		Parameters: map[string]any{
	// 		},
	// 		Providers: []*armdeployments.Provider{
	// 			{
	// 				Namespace: to.Ptr("Microsoft.Storage"),
	// 				ResourceTypes: []*armdeployments.ProviderResourceType{
	// 					{
	// 						Locations: []*string{
	// 							to.Ptr("eastus")},
	// 							ResourceType: to.Ptr("storageAccounts"),
	// 					}},
	// 			}},
	// 			ProvisioningState: to.Ptr(armdeployments.ProvisioningStateSucceeded),
	// 			TemplateHash: to.Ptr("0000000000000000000"),
	// 			TemplateLink: &armdeployments.TemplateLink{
	// 				ContentVersion: to.Ptr("1.0.0.0"),
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"),
	// 			},
	// 			Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-06-05T01:20:01.723Z"); return t}()),
	// 		},
	// 	}
}

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

const { DeploymentsClient } = require("@azure/arm-resourcesdeployments");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to You can provide the template and parameters directly in the request or link to JSON files.
 *
 * @summary You can provide the template and parameters directly in the request or link to JSON files.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentResourceGroup.json
 */
async function createADeploymentThatWillDeployATemplateWithAUriAndQueryString() {
  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: {
        queryString:
          "sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=xxxxxxxx0xxxxxxxxxxxxx%2bxxxxxxxxxxxxxxxxxxxx%3d",
        uri: "https://example.com/exampleTemplate.json",
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DeploymentsClient(credential, subscriptionId);
  const result = await client.deployments.beginCreateOrUpdateAndWait(
    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

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [],
    "duration": "PT22.8356799S",
    "mode": "Incremental",
    "outputResources": [
      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"
      }
    ],
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "locations": [
              "eastus"
            ],
            "resourceType": "storageAccounts"
          }
        ]
      }
    ],
    "provisioningState": "Succeeded",
    "templateHash": "0000000000000000000",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    },
    "timestamp": "2020-06-05T01:20:01.723776Z"
  }
}

Statuscode:: 201

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [],
    "duration": "PT22.8356799S",
    "mode": "Incremental",
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "locations": [
              "eastus"
            ],
            "resourceType": "storageAccounts"
          }
        ]
      }
    ],
    "provisioningState": "Accepted",
    "templateHash": "0000000000000000000",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    },
    "timestamp": "2020-06-05T01:20:01.723776Z"
  }
}

Create a deployment that will deploy a templateSpec with the given resourceId

Beispielanforderung

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

{
  "properties": {
    "mode": "Incremental",
    "parameters": {},
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    }
  }
}


import com.azure.resourcemanager.resources.fluent.models.DeploymentInner;
import com.azure.resourcemanager.resources.models.DeploymentMode;
import com.azure.resourcemanager.resources.models.DeploymentProperties;
import com.azure.resourcemanager.resources.models.TemplateLink;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Deployments CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/
     * PutDeploymentResourceGroupTemplateSpecsWithId.json
     */
    /**
     * Sample code: Create a deployment that will deploy a templateSpec with the given resourceId.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createADeploymentThatWillDeployATemplateSpecWithTheGivenResourceId(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.genericResources().manager().deploymentClient().getDeployments().createOrUpdate("my-resource-group",
            "my-deployment",
            new DeploymentInner().withProperties(new DeploymentProperties().withTemplateLink(new TemplateLink().withId(
                "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"))
                .withParameters(mapOf()).withMode(DeploymentMode.INCREMENTAL)),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.deployments import DeploymentsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-deployments
# USAGE
    python put_deployment_resource_group_template_specs_with_id.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DeploymentsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000001",
    )

    response = client.deployments.begin_create_or_update(
        resource_group_name="my-resource-group",
        deployment_name="my-deployment",
        parameters={
            "properties": {
                "mode": "Incremental",
                "parameters": {},
                "templateLink": {
                    "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
                },
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentResourceGroupTemplateSpecsWithId.json
if __name__ == "__main__":
    main()

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

package armdeployments_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/armdeployments"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/05809299e74fc16df7badbab3fb29e25da59f7d2/specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentResourceGroupTemplateSpecsWithId.json
func ExampleDeploymentsClient_BeginCreateOrUpdate_createADeploymentThatWillDeployATemplateSpecWithTheGivenResourceId() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdeployments.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginCreateOrUpdate(ctx, "my-resource-group", "my-deployment", armdeployments.Deployment{
		Properties: &armdeployments.DeploymentProperties{
			Mode:       to.Ptr(armdeployments.DeploymentModeIncremental),
			Parameters: map[string]*armdeployments.DeploymentParameter{},
			TemplateLink: &armdeployments.TemplateLink{
				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"),
			},
		},
	}, 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.DeploymentExtended = armdeployments.DeploymentExtended{
	// 	Name: to.Ptr("my-deployment"),
	// 	Type: to.Ptr("Microsoft.Resources/deployments"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment"),
	// 	Properties: &armdeployments.DeploymentPropertiesExtended{
	// 		CorrelationID: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 		Dependencies: []*armdeployments.Dependency{
	// 		},
	// 		Duration: to.Ptr("PT22.8356799S"),
	// 		Mode: to.Ptr(armdeployments.DeploymentModeIncremental),
	// 		OutputResources: []*armdeployments.ResourceReference{
	// 			{
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"),
	// 		}},
	// 		Parameters: map[string]any{
	// 		},
	// 		Providers: []*armdeployments.Provider{
	// 			{
	// 				Namespace: to.Ptr("Microsoft.Storage"),
	// 				ResourceTypes: []*armdeployments.ProviderResourceType{
	// 					{
	// 						Locations: []*string{
	// 							to.Ptr("eastus")},
	// 							ResourceType: to.Ptr("storageAccounts"),
	// 					}},
	// 			}},
	// 			ProvisioningState: to.Ptr(armdeployments.ProvisioningStateSucceeded),
	// 			TemplateHash: to.Ptr("0000000000000000000"),
	// 			TemplateLink: &armdeployments.TemplateLink{
	// 				ContentVersion: to.Ptr("1.0.0.0"),
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"),
	// 			},
	// 			Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-06-05T01:20:01.723Z"); return t}()),
	// 		},
	// 	}
}

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

const { DeploymentsClient } = require("@azure/arm-resourcesdeployments");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to You can provide the template and parameters directly in the request or link to JSON files.
 *
 * @summary You can provide the template and parameters directly in the request or link to JSON files.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentResourceGroupTemplateSpecsWithId.json
 */
async function createADeploymentThatWillDeployATemplateSpecWithTheGivenResourceId() {
  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: {
        id: "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DeploymentsClient(credential, subscriptionId);
  const result = await client.deployments.beginCreateOrUpdateAndWait(
    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

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [],
    "duration": "PT22.8356799S",
    "mode": "Incremental",
    "outputResources": [
      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"
      }
    ],
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "locations": [
              "eastus"
            ],
            "resourceType": "storageAccounts"
          }
        ]
      }
    ],
    "provisioningState": "Succeeded",
    "templateHash": "0000000000000000000",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    },
    "timestamp": "2020-06-05T01:20:01.723776Z"
  }
}

Statuscode:: 201

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [],
    "duration": "PT22.8356799S",
    "mode": "Incremental",
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "locations": [
              "eastus"
            ],
            "resourceType": "storageAccounts"
          }
        ]
      }
    ],
    "provisioningState": "Accepted",
    "templateHash": "0000000000000000000",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    },
    "timestamp": "2020-06-05T01:20:01.723776Z"
  }
}

Create a deployment that will redeploy another deployment on failure

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01

{
  "properties": {
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "name-of-deployment-to-use"
    },
    "parameters": {},
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json"
    }
  }
}


import com.azure.resourcemanager.resources.fluent.models.DeploymentInner;
import com.azure.resourcemanager.resources.models.DeploymentMode;
import com.azure.resourcemanager.resources.models.DeploymentProperties;
import com.azure.resourcemanager.resources.models.OnErrorDeployment;
import com.azure.resourcemanager.resources.models.OnErrorDeploymentType;
import com.azure.resourcemanager.resources.models.TemplateLink;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Deployments CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/
     * PutDeploymentWithOnErrorDeploymentSpecificDeployment.json
     */
    /**
     * Sample code: Create a deployment that will redeploy another deployment on failure.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createADeploymentThatWillRedeployAnotherDeploymentOnFailure(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.genericResources().manager().deploymentClient().getDeployments().createOrUpdate("my-resource-group",
            "my-deployment",
            new DeploymentInner().withProperties(new DeploymentProperties()
                .withTemplateLink(new TemplateLink().withUri("https://example.com/exampleTemplate.json"))
                .withParameters(mapOf()).withMode(DeploymentMode.COMPLETE)
                .withOnErrorDeployment(new OnErrorDeployment().withType(OnErrorDeploymentType.SPECIFIC_DEPLOYMENT)
                    .withDeploymentName("name-of-deployment-to-use"))),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.deployments import DeploymentsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-deployments
# USAGE
    python put_deployment_with_on_error_deployment_specific_deployment.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DeploymentsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.deployments.begin_create_or_update(
        resource_group_name="my-resource-group",
        deployment_name="my-deployment",
        parameters={
            "properties": {
                "mode": "Complete",
                "onErrorDeployment": {"deploymentName": "name-of-deployment-to-use", "type": "SpecificDeployment"},
                "parameters": {},
                "templateLink": {"uri": "https://example.com/exampleTemplate.json"},
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithOnErrorDeploymentSpecificDeployment.json
if __name__ == "__main__":
    main()

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

package armdeployments_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/armdeployments"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/05809299e74fc16df7badbab3fb29e25da59f7d2/specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithOnErrorDeploymentSpecificDeployment.json
func ExampleDeploymentsClient_BeginCreateOrUpdate_createADeploymentThatWillRedeployAnotherDeploymentOnFailure() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdeployments.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginCreateOrUpdate(ctx, "my-resource-group", "my-deployment", armdeployments.Deployment{
		Properties: &armdeployments.DeploymentProperties{
			Mode: to.Ptr(armdeployments.DeploymentModeComplete),
			OnErrorDeployment: &armdeployments.OnErrorDeployment{
				Type:           to.Ptr(armdeployments.OnErrorDeploymentTypeSpecificDeployment),
				DeploymentName: to.Ptr("name-of-deployment-to-use"),
			},
			Parameters: map[string]*armdeployments.DeploymentParameter{},
			TemplateLink: &armdeployments.TemplateLink{
				URI: to.Ptr("https://example.com/exampleTemplate.json"),
			},
		},
	}, 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.DeploymentExtended = armdeployments.DeploymentExtended{
	// 	Name: to.Ptr("my-deployment"),
	// 	Type: to.Ptr("Microsoft.Resources/deployments"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment"),
	// 	Properties: &armdeployments.DeploymentPropertiesExtended{
	// 		CorrelationID: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 		Dependencies: []*armdeployments.Dependency{
	// 			{
	// 				DependsOn: []*armdeployments.BasicDependency{
	// 					{
	// 						ID: to.Ptr("{resourceid}"),
	// 						ResourceName: to.Ptr("VNet1"),
	// 						ResourceType: to.Ptr("Microsoft.Network/virtualNetworks"),
	// 				}},
	// 				ID: to.Ptr("{resourceid}"),
	// 				ResourceName: to.Ptr("VNet1/Subnet1"),
	// 				ResourceType: to.Ptr("Microsoft.Network/virtualNetworks/subnets"),
	// 			},
	// 			{
	// 				DependsOn: []*armdeployments.BasicDependency{
	// 					{
	// 						ID: to.Ptr("{resourceid}"),
	// 						ResourceName: to.Ptr("VNet1"),
	// 						ResourceType: to.Ptr("Microsoft.Network/virtualNetworks"),
	// 					},
	// 					{
	// 						ID: to.Ptr("{resourceid}"),
	// 						ResourceName: to.Ptr("VNet1/Subnet1"),
	// 						ResourceType: to.Ptr("Microsoft.Network/virtualNetworks/subnets"),
	// 				}},
	// 				ID: to.Ptr("{resourceid}"),
	// 				ResourceName: to.Ptr("VNet1/Subnet2"),
	// 				ResourceType: to.Ptr("Microsoft.Network/virtualNetworks/subnets"),
	// 		}},
	// 		Duration: to.Ptr("PT0.8204881S"),
	// 		Mode: to.Ptr(armdeployments.DeploymentModeComplete),
	// 		OnErrorDeployment: &armdeployments.OnErrorDeploymentExtended{
	// 			Type: to.Ptr(armdeployments.OnErrorDeploymentTypeSpecificDeployment),
	// 			DeploymentName: to.Ptr("name-of-deployment-to-use"),
	// 		},
	// 		Parameters: map[string]any{
	// 		},
	// 		Providers: []*armdeployments.Provider{
	// 			{
	// 				Namespace: to.Ptr("Microsoft.Network"),
	// 				ResourceTypes: []*armdeployments.ProviderResourceType{
	// 					{
	// 						Locations: []*string{
	// 							to.Ptr("centralus")},
	// 							ResourceType: to.Ptr("virtualNetworks"),
	// 						},
	// 						{
	// 							Locations: []*string{
	// 								to.Ptr("centralus")},
	// 								ResourceType: to.Ptr("virtualNetworks/subnets"),
	// 						}},
	// 				}},
	// 				ProvisioningState: to.Ptr(armdeployments.ProvisioningStateSucceeded),
	// 				TemplateLink: &armdeployments.TemplateLink{
	// 					ContentVersion: to.Ptr("1.0.0.0"),
	// 					URI: to.Ptr("https://example.com/exampleTemplate.json"),
	// 				},
	// 				Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-03-01T00:00:00.000Z"); return t}()),
	// 			},
	// 		}
}

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

const { DeploymentsClient } = require("@azure/arm-resourcesdeployments");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to You can provide the template and parameters directly in the request or link to JSON files.
 *
 * @summary You can provide the template and parameters directly in the request or link to JSON files.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithOnErrorDeploymentSpecificDeployment.json
 */
async function createADeploymentThatWillRedeployAnotherDeploymentOnFailure() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["RESOURCES_RESOURCE_GROUP"] || "my-resource-group";
  const deploymentName = "my-deployment";
  const parameters = {
    properties: {
      mode: "Complete",
      onErrorDeployment: {
        type: "SpecificDeployment",
        deploymentName: "name-of-deployment-to-use",
      },
      parameters: {},
      templateLink: { uri: "https://example.com/exampleTemplate.json" },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DeploymentsClient(credential, subscriptionId);
  const result = await client.deployments.beginCreateOrUpdateAndWait(
    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

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet1",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          },
          {
            "id": "{resourceid}",
            "resourceName": "VNet1/Subnet1",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet2",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      }
    ],
    "duration": "PT0.8204881S",
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "name-of-deployment-to-use"
    },
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks"
          },
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks/subnets"
          }
        ]
      }
    ],
    "provisioningState": "Accepted",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "uri": "https://example.com/exampleTemplate.json"
    },
    "timestamp": "2019-03-01T00:00:00.0000000Z"
  }
}

Statuscode:: 201

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet1",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          },
          {
            "id": "{resourceid}",
            "resourceName": "VNet1/Subnet1",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet2",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      }
    ],
    "duration": "PT0.8204881S",
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "name-of-deployment-to-use"
    },
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks"
          },
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks/subnets"
          }
        ]
      }
    ],
    "provisioningState": "Accepted",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "uri": "https://example.com/exampleTemplate.json"
    },
    "timestamp": "2019-03-01T00:00:00.0000000Z"
  }
}

Create a deployment that will redeploy the last successful deployment on failure

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01

{
  "properties": {
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "LastSuccessful"
    },
    "parameters": {},
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json"
    }
  }
}


import com.azure.resourcemanager.resources.fluent.models.DeploymentInner;
import com.azure.resourcemanager.resources.models.DeploymentMode;
import com.azure.resourcemanager.resources.models.DeploymentProperties;
import com.azure.resourcemanager.resources.models.OnErrorDeployment;
import com.azure.resourcemanager.resources.models.OnErrorDeploymentType;
import com.azure.resourcemanager.resources.models.TemplateLink;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Deployments CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/
     * PutDeploymentWithOnErrorDeploymentLastSuccessful.json
     */
    /**
     * Sample code: Create a deployment that will redeploy the last successful deployment on failure.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createADeploymentThatWillRedeployTheLastSuccessfulDeploymentOnFailure(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.genericResources().manager().deploymentClient().getDeployments().createOrUpdate("my-resource-group",
            "my-deployment",
            new DeploymentInner().withProperties(new DeploymentProperties()
                .withTemplateLink(new TemplateLink().withUri("https://example.com/exampleTemplate.json"))
                .withParameters(mapOf()).withMode(DeploymentMode.COMPLETE)
                .withOnErrorDeployment(new OnErrorDeployment().withType(OnErrorDeploymentType.LAST_SUCCESSFUL))),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.deployments import DeploymentsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-deployments
# USAGE
    python put_deployment_with_on_error_deployment_last_successful.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DeploymentsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.deployments.begin_create_or_update(
        resource_group_name="my-resource-group",
        deployment_name="my-deployment",
        parameters={
            "properties": {
                "mode": "Complete",
                "onErrorDeployment": {"type": "LastSuccessful"},
                "parameters": {},
                "templateLink": {"uri": "https://example.com/exampleTemplate.json"},
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithOnErrorDeploymentLastSuccessful.json
if __name__ == "__main__":
    main()

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

package armdeployments_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/armdeployments"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/05809299e74fc16df7badbab3fb29e25da59f7d2/specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithOnErrorDeploymentLastSuccessful.json
func ExampleDeploymentsClient_BeginCreateOrUpdate_createADeploymentThatWillRedeployTheLastSuccessfulDeploymentOnFailure() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdeployments.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginCreateOrUpdate(ctx, "my-resource-group", "my-deployment", armdeployments.Deployment{
		Properties: &armdeployments.DeploymentProperties{
			Mode: to.Ptr(armdeployments.DeploymentModeComplete),
			OnErrorDeployment: &armdeployments.OnErrorDeployment{
				Type: to.Ptr(armdeployments.OnErrorDeploymentTypeLastSuccessful),
			},
			Parameters: map[string]*armdeployments.DeploymentParameter{},
			TemplateLink: &armdeployments.TemplateLink{
				URI: to.Ptr("https://example.com/exampleTemplate.json"),
			},
		},
	}, 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.DeploymentExtended = armdeployments.DeploymentExtended{
	// 	Name: to.Ptr("my-deployment"),
	// 	Type: to.Ptr("Microsoft.Resources/deployments"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment"),
	// 	Properties: &armdeployments.DeploymentPropertiesExtended{
	// 		CorrelationID: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 		Dependencies: []*armdeployments.Dependency{
	// 			{
	// 				DependsOn: []*armdeployments.BasicDependency{
	// 					{
	// 						ID: to.Ptr("{resourceid}"),
	// 						ResourceName: to.Ptr("VNet1"),
	// 						ResourceType: to.Ptr("Microsoft.Network/virtualNetworks"),
	// 				}},
	// 				ID: to.Ptr("{resourceid}"),
	// 				ResourceName: to.Ptr("VNet1/Subnet1"),
	// 				ResourceType: to.Ptr("Microsoft.Network/virtualNetworks/subnets"),
	// 			},
	// 			{
	// 				DependsOn: []*armdeployments.BasicDependency{
	// 					{
	// 						ID: to.Ptr("{resourceid}"),
	// 						ResourceName: to.Ptr("VNet1"),
	// 						ResourceType: to.Ptr("Microsoft.Network/virtualNetworks"),
	// 					},
	// 					{
	// 						ID: to.Ptr("{resourceid}"),
	// 						ResourceName: to.Ptr("VNet1/Subnet1"),
	// 						ResourceType: to.Ptr("Microsoft.Network/virtualNetworks/subnets"),
	// 				}},
	// 				ID: to.Ptr("{resourceid}"),
	// 				ResourceName: to.Ptr("VNet1/Subnet2"),
	// 				ResourceType: to.Ptr("Microsoft.Network/virtualNetworks/subnets"),
	// 		}},
	// 		Duration: to.Ptr("PT0.8204881S"),
	// 		Mode: to.Ptr(armdeployments.DeploymentModeComplete),
	// 		OnErrorDeployment: &armdeployments.OnErrorDeploymentExtended{
	// 			Type: to.Ptr(armdeployments.OnErrorDeploymentTypeLastSuccessful),
	// 			DeploymentName: to.Ptr("{nameOfLastSuccesfulDeployment}"),
	// 		},
	// 		Parameters: map[string]any{
	// 		},
	// 		Providers: []*armdeployments.Provider{
	// 			{
	// 				Namespace: to.Ptr("Microsoft.Network"),
	// 				ResourceTypes: []*armdeployments.ProviderResourceType{
	// 					{
	// 						Locations: []*string{
	// 							to.Ptr("centralus")},
	// 							ResourceType: to.Ptr("virtualNetworks"),
	// 						},
	// 						{
	// 							Locations: []*string{
	// 								to.Ptr("centralus")},
	// 								ResourceType: to.Ptr("virtualNetworks/subnets"),
	// 						}},
	// 				}},
	// 				ProvisioningState: to.Ptr(armdeployments.ProvisioningStateSucceeded),
	// 				TemplateLink: &armdeployments.TemplateLink{
	// 					ContentVersion: to.Ptr("1.0.0.0"),
	// 					URI: to.Ptr("https://example.com/exampleTemplate.json"),
	// 				},
	// 				Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-03-01T00:00:00.000Z"); return t}()),
	// 			},
	// 		}
}

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

const { DeploymentsClient } = require("@azure/arm-resourcesdeployments");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to You can provide the template and parameters directly in the request or link to JSON files.
 *
 * @summary You can provide the template and parameters directly in the request or link to JSON files.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithOnErrorDeploymentLastSuccessful.json
 */
async function createADeploymentThatWillRedeployTheLastSuccessfulDeploymentOnFailure() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["RESOURCES_RESOURCE_GROUP"] || "my-resource-group";
  const deploymentName = "my-deployment";
  const parameters = {
    properties: {
      mode: "Complete",
      onErrorDeployment: { type: "LastSuccessful" },
      parameters: {},
      templateLink: { uri: "https://example.com/exampleTemplate.json" },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DeploymentsClient(credential, subscriptionId);
  const result = await client.deployments.beginCreateOrUpdateAndWait(
    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

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet1",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          },
          {
            "id": "{resourceid}",
            "resourceName": "VNet1/Subnet1",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet2",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      }
    ],
    "duration": "PT0.8204881S",
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "LastSuccessful",
      "deploymentName": "{nameOfLastSuccesfulDeployment}"
    },
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks"
          },
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks/subnets"
          }
        ]
      }
    ],
    "provisioningState": "Accepted",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "uri": "https://example.com/exampleTemplate.json"
    },
    "timestamp": "2019-03-01T00:00:00.0000000Z"
  }
}

Statuscode:: 201

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet1",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceName": "VNet1",
            "resourceType": "Microsoft.Network/virtualNetworks"
          },
          {
            "id": "{resourceid}",
            "resourceName": "VNet1/Subnet1",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets"
          }
        ],
        "id": "{resourceid}",
        "resourceName": "VNet1/Subnet2",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets"
      }
    ],
    "duration": "PT0.8204881S",
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "LastSuccessful",
      "deploymentName": "{nameOfLastSuccesfulDeployment}"
    },
    "parameters": {},
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks"
          },
          {
            "locations": [
              "centralus"
            ],
            "resourceType": "virtualNetworks/subnets"
          }
        ]
      }
    ],
    "provisioningState": "Accepted",
    "templateLink": {
      "contentVersion": "1.0.0.0",
      "uri": "https://example.com/exampleTemplate.json"
    },
    "timestamp": "2019-03-01T00:00:00.0000000Z"
  }
}

Create deployment using external inputs

Beispielanforderung

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

{
  "properties": {
    "externalInputDefinitions": {
      "fooValue": {
        "config": "FOO_VALUE",
        "kind": "sys.envVar"
      }
    },
    "externalInputs": {
      "fooValue": {
        "value": "baz"
      }
    },
    "mode": "Incremental",
    "parameters": {
      "inputObj": {
        "expression": "[createObject('foo', externalInputs('fooValue'))]"
      }
    },
    "template": {
      "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
      "contentVersion": "1.0.0.0",
      "outputs": {
        "inputObj": {
          "type": "object",
          "value": "[parameters('inputObj')]"
        }
      },
      "parameters": {
        "inputObj": {
          "type": "object"
        }
      },
      "resources": []
    }
  }
}


import com.azure.core.management.serializer.SerializerFactory;
import com.azure.core.util.serializer.SerializerEncoding;
import com.azure.resourcemanager.resources.fluent.models.DeploymentInner;
import com.azure.resourcemanager.resources.models.DeploymentExternalInput;
import com.azure.resourcemanager.resources.models.DeploymentExternalInputDefinition;
import com.azure.resourcemanager.resources.models.DeploymentMode;
import com.azure.resourcemanager.resources.models.DeploymentParameter;
import com.azure.resourcemanager.resources.models.DeploymentProperties;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Deployments CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/
     * PutDeploymentWithExternalInputs.json
     */
    /**
     * Sample code: Create deployment using external inputs.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createDeploymentUsingExternalInputs(com.azure.resourcemanager.AzureResourceManager azure)
        throws IOException {
        azure.genericResources().manager().deploymentClient().getDeployments().createOrUpdate("my-resource-group",
            "my-deployment",
            new DeploymentInner().withProperties(new DeploymentProperties()
                .withTemplate(SerializerFactory.createDefaultManagementSerializerAdapter().deserialize(
                    "{\"$schema\":\"https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#\",\"contentVersion\":\"1.0.0.0\",\"outputs\":{\"inputObj\":{\"type\":\"object\",\"value\":\"[parameters('inputObj')]\"}},\"parameters\":{\"inputObj\":{\"type\":\"object\"}},\"resources\":[]}",
                    Object.class, SerializerEncoding.JSON))
                .withParameters(mapOf("inputObj",
                    new DeploymentParameter().withExpression("[createObject('foo', externalInputs('fooValue'))]")))
                .withExternalInputs(mapOf("fooValue", new DeploymentExternalInput().withValue("baz")))
                .withExternalInputDefinitions(mapOf("fooValue",
                    new DeploymentExternalInputDefinition().withKind("sys.envVar").withConfig("FOO_VALUE")))
                .withMode(DeploymentMode.INCREMENTAL)),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.deployments import DeploymentsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-deployments
# USAGE
    python put_deployment_with_external_inputs.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DeploymentsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000001",
    )

    response = client.deployments.begin_create_or_update(
        resource_group_name="my-resource-group",
        deployment_name="my-deployment",
        parameters={
            "properties": {
                "externalInputDefinitions": {"fooValue": {"config": "FOO_VALUE", "kind": "sys.envVar"}},
                "externalInputs": {"fooValue": {"value": "baz"}},
                "mode": "Incremental",
                "parameters": {"inputObj": {"expression": "[createObject('foo', externalInputs('fooValue'))]"}},
                "template": {
                    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
                    "contentVersion": "1.0.0.0",
                    "outputs": {"inputObj": {"type": "object", "value": "[parameters('inputObj')]"}},
                    "parameters": {"inputObj": {"type": "object"}},
                    "resources": [],
                },
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithExternalInputs.json
if __name__ == "__main__":
    main()

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

package armdeployments_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/armdeployments"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/05809299e74fc16df7badbab3fb29e25da59f7d2/specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithExternalInputs.json
func ExampleDeploymentsClient_BeginCreateOrUpdate_createDeploymentUsingExternalInputs() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdeployments.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginCreateOrUpdate(ctx, "my-resource-group", "my-deployment", armdeployments.Deployment{
		Properties: &armdeployments.DeploymentProperties{
			ExternalInputDefinitions: map[string]*armdeployments.DeploymentExternalInputDefinition{
				"fooValue": {
					Config: "FOO_VALUE",
					Kind:   to.Ptr("sys.envVar"),
				},
			},
			ExternalInputs: map[string]*armdeployments.DeploymentExternalInput{
				"fooValue": {
					Value: "baz",
				},
			},
			Mode: to.Ptr(armdeployments.DeploymentModeIncremental),
			Parameters: map[string]*armdeployments.DeploymentParameter{
				"inputObj": {
					Expression: to.Ptr("[createObject('foo', externalInputs('fooValue'))]"),
				},
			},
			Template: map[string]any{
				"$schema":        "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
				"contentVersion": "1.0.0.0",
				"outputs": map[string]any{
					"inputObj": map[string]any{
						"type":  "object",
						"value": "[parameters('inputObj')]",
					},
				},
				"parameters": map[string]any{
					"inputObj": map[string]any{
						"type": "object",
					},
				},
				"resources": []any{},
			},
		},
	}, 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.DeploymentExtended = armdeployments.DeploymentExtended{
	// 	Name: to.Ptr("my-deployment"),
	// 	Type: to.Ptr("Microsoft.Resources/deployments"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment"),
	// 	Properties: &armdeployments.DeploymentPropertiesExtended{
	// 		CorrelationID: to.Ptr("ef613b6c-f76e-48fd-9da7-28884243c5e5"),
	// 		Dependencies: []*armdeployments.Dependency{
	// 		},
	// 		Mode: to.Ptr(armdeployments.DeploymentModeIncremental),
	// 		OutputResources: []*armdeployments.ResourceReference{
	// 		},
	// 		Outputs: map[string]any{
	// 			"inputObj":map[string]any{
	// 				"type": "Object",
	// 				"value":map[string]any{
	// 					"foo": "baz",
	// 				},
	// 			},
	// 		},
	// 		Parameters: map[string]any{
	// 			"inputObj":map[string]any{
	// 				"type": "Object",
	// 				"value":map[string]any{
	// 					"foo": "baz",
	// 				},
	// 			},
	// 		},
	// 		Providers: []*armdeployments.Provider{
	// 		},
	// 		ProvisioningState: to.Ptr(armdeployments.ProvisioningStateSucceeded),
	// 		TemplateHash: to.Ptr("17686481789412793580"),
	// 		Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-09T14:36:48.204Z"); return t}()),
	// 	},
	// }
}

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

const { DeploymentsClient } = require("@azure/arm-resourcesdeployments");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to You can provide the template and parameters directly in the request or link to JSON files.
 *
 * @summary You can provide the template and parameters directly in the request or link to JSON files.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/deployments/stable/2025-04-01/examples/PutDeploymentWithExternalInputs.json
 */
async function createDeploymentUsingExternalInputs() {
  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: {
      externalInputDefinitions: {
        fooValue: { config: "FOO_VALUE", kind: "sys.envVar" },
      },
      externalInputs: { fooValue: { value: "baz" } },
      mode: "Incremental",
      parameters: {
        inputObj: {
          expression: "[createObject('foo', externalInputs('fooValue'))]",
        },
      },
      template: {
        $schema: "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
        contentVersion: "1.0.0.0",
        outputs: {
          inputObj: { type: "object", value: "[parameters('inputObj')]" },
        },
        parameters: { inputObj: { type: "object" } },
        resources: [],
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DeploymentsClient(credential, subscriptionId);
  const result = await client.deployments.beginCreateOrUpdateAndWait(
    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

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "ef613b6c-f76e-48fd-9da7-28884243c5e5",
    "dependencies": [],
    "mode": "Incremental",
    "outputResources": [],
    "outputs": {
      "inputObj": {
        "type": "Object",
        "value": {
          "foo": "baz"
        }
      }
    },
    "parameters": {
      "inputObj": {
        "type": "Object",
        "value": {
          "foo": "baz"
        }
      }
    },
    "providers": [],
    "provisioningState": "Succeeded",
    "templateHash": "17686481789412793580",
    "timestamp": "2025-04-09T14:36:48.2047169Z"
  }
}

Statuscode:: 201

{
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "properties": {
    "correlationId": "ef613b6c-f76e-48fd-9da7-28884243c5e5",
    "dependencies": [],
    "duration": "PT0.0009164S",
    "mode": "Incremental",
    "parameters": {
      "inputObj": {
        "type": "Object",
        "value": {
          "foo": "baz"
        }
      }
    },
    "providers": [],
    "provisioningState": "Accepted",
    "templateHash": "17686481789412793580",
    "timestamp": "2025-04-09T14:36:47.6637583Z"
  }
}

Definitionen

Name	Beschreibung
Alias	Der Aliastyp.
AliasPath	Der Typ der Pfade für Alias.
AliasPathAttributes	Die Attribute des Tokens, auf das der Aliaspfad verweist.
AliasPathMetadata
AliasPathTokenType	Der Typ des Tokens, auf das der Aliaspfad verweist.
AliasPattern	Der Typ des Musters für einen Aliaspfad.
AliasPatternType	Der Typ des Aliasmusters
AliasType	Der Typ des Alias.
ApiProfile
BasicDependency	Informationen zur Bereitstellungsabhängigkeit.
CloudError	Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DebugSetting	Die Debugeinstellung.
Dependency	Informationen zur Bereitstellungsabhängigkeit.
Deployment	Parameter für den Bereitstellungsvorgang.
DeploymentDiagnosticsDefinition
DeploymentExtended	Bereitstellungsinformationen.
DeploymentExtensionConfigItem
DeploymentExtensionDefinition
DeploymentExternalInput	Deployment externer Eingang für die Parametrisierung.
DeploymentExternalInputDefinition	Deployment Externe Eingabedefinition für die Parametrisierung.
DeploymentIdentity	Die Konfiguration der verwalteten Identität für eine Bereitstellung.
DeploymentIdentityType	Der Identitätstyp.
DeploymentMode	Der Modus, der zum Bereitstellen von Ressourcen verwendet wird. Dieser Wert kann entweder inkrementell oder abgeschlossen 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, gelöscht. Achten Sie darauf, wenn Sie den Vollständigen Modus verwenden, da Sie möglicherweise unbeabsichtigt Ressourcen löschen.
DeploymentParameter	Bereitstellungsparameter für die Vorlage.
DeploymentProperties	Bereitstellungseigenschaften.
DeploymentPropertiesExtended	Bereitstellungseigenschaften mit zusätzlichen Details.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorResponse	Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
ExpressionEvaluationOptions	Gibt an, ob Vorlagenausdrücke im Bereich der übergeordneten Vorlage 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.
ExtensionConfigPropertyType
KeyVaultParameterReference	Azure Key Vault parameter reference.
KeyVaultReference	Azure Key Vault Reference.
Level	Gibt die zusätzliche Antwortebene an.
OnErrorDeployment	Bereitstellung beim Fehlerverhalten.
OnErrorDeploymentExtended	Bereitstellung bei Fehlerverhalten mit zusätzlichen Details.
OnErrorDeploymentType	Die Bereitstellung beim Fehlerverhaltenstyp. Mögliche Werte sind LastSuccessful und SpecificDeployment.
ParametersLink	Entität, die den Verweis auf die Bereitstellungsparameter darstellt.
Provider	Informationen zum Ressourcenanbieter.
ProviderAuthorizationConsentState	Der Autorisierungsstatus des Anbieters.
ProviderExtendedLocation	Der erweiterte Anbieterspeicherort.
ProviderResourceType	Vom Ressourcenanbieter verwalteter Ressourcentyp.
ProvisioningState	Gibt den Bereitstellungsstatus an.
ResourceReference	Das Ressourcen-ID-Modell.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TemplateLink	Entität, die den Verweis auf die Vorlage darstellt.
UserAssignedIdentity	Benutzer zugewiesene Identitätseigenschaften
ValidationLevel	Die Validierungsebene, die für die Bereitstellung ausgeführt wurde.
ZoneMapping

Alias

Objekt

Der Aliastyp.

Name	Typ	Beschreibung
defaultMetadata	AliasPathMetadata	Die Standardaliaspfadmetadaten. Gilt für den Standardpfad und für alle Aliaspfade, für die keine Metadaten vorhanden sind
defaultPath	string	Der Standardpfad für einen Alias.
defaultPattern	AliasPattern	Das Standardmuster für einen Alias.
name	string	Der Aliasname.
paths	AliasPath[]	Die Pfade für einen Alias.
type	AliasType	Der Typ des Alias.

AliasPath

Objekt

Der Typ der Pfade für Alias.

Name	Typ	Beschreibung
apiVersions	string[]	Die API-Versionen.
metadata	AliasPathMetadata	Die Metadaten des Aliaspfads. Falls nicht, greifen Sie auf die Standardmetadaten des Alias zurück.
path	string	Der Pfad eines Alias.
pattern	AliasPattern	Das Muster für einen Aliaspfad.

AliasPathAttributes

Enumeration

Die Attribute des Tokens, auf das der Aliaspfad verweist.

Wert	Beschreibung
None	Das Token, auf das der Aliaspfad verweist, weist keine Attribute auf.
Modifiable	Das Token, auf das der Aliaspfad verweist, kann durch Richtlinien mit "Modify"-Effekt geändert werden.

AliasPathMetadata

Objekt

Name	Typ	Beschreibung
attributes	AliasPathAttributes	Die Attribute des Tokens, auf das der Aliaspfad verweist.
type	AliasPathTokenType	Der Typ des Tokens, auf das der Aliaspfad verweist.

AliasPathTokenType

Enumeration

Der Typ des Tokens, auf das der Aliaspfad verweist.

Wert	Beschreibung
NotSpecified	Der Tokentyp ist nicht angegeben.
Any	Der Tokentyp kann alles sein.
String	Der Tokentyp ist eine Zeichenfolge.
Object	Der Tokentyp ist Objekt.
Array	Der Tokentyp ist array.
Integer	Der Tokentyp ist eine ganze Zahl.
Number	Der Tokentyp ist Zahl.
Boolean	Der Tokentyp ist boolescher Wert.

AliasPattern

Objekt

Der Typ des Musters für einen Aliaspfad.

Name	Typ	Beschreibung
phrase	string	Der Aliasmusterausdruck.
type	AliasPatternType	Der Typ des Aliasmusters
variable	string	Die Aliasmustervariable.

AliasPatternType

Enumeration

Der Typ des Aliasmusters

Wert	Beschreibung
NotSpecified	NotSpecified ist nicht zulässig.
Extract	Extrahieren ist der einzige zulässige Wert.

AliasType

Enumeration

Der Typ des Alias.

Wert	Beschreibung
NotSpecified	Der Aliastyp ist unbekannt (identisch mit der Angabe des Aliastyps).
PlainText	Der Aliaswert ist nicht geheim.
Mask	Der Aliaswert ist geheim.

ApiProfile

Objekt

Name	Typ	Beschreibung
apiVersion	string	Die API-Version.
profileVersion	string	Die Profilversion.

BasicDependency

Objekt

Informationen zur Bereitstellungsabhängigkeit.

Name	Typ	Beschreibung
id	string	Die ID der Abhängigkeit.
resourceName	string	Der Name der Abhängigkeitsressource.
resourceType	string	Der Abhängigkeitsressourcentyp.

CloudError

Objekt

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name	Typ	Beschreibung
error	ErrorResponse	Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DebugSetting

Objekt

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", die durch ein Komma getrennt sind. Der Standardwert ist keine. Berücksichtigen Sie beim Festlegen dieses Werts sorgfältig die Art der Informationen, die Sie während der Bereitstellung übergeben. Durch die Protokollierung von Informationen über die Anforderung oder Antwort könnten Sie potenziell vertrauliche Daten verfügbar machen, die über die Bereitstellungsvorgänge abgerufen werden.

Dependency

Objekt

Informationen zur Bereitstellungsabhängigkeit.

Name	Typ	Beschreibung
dependsOn	BasicDependency[]	Die Liste der Abhängigkeiten.
id	string	Die ID der Abhängigkeit.
resourceName	string	Der Name der Abhängigkeitsressource.
resourceType	string	Der Abhängigkeitsressourcentyp.

Deployment

Objekt

Parameter für den Bereitstellungsvorgang.

Name	Typ	Beschreibung
identity	DeploymentIdentity	Die Konfiguration der verwalteten Identität für eine Bereitstellung.
location	string	Der Speicherort zum Speichern der Bereitstellungsdaten.
properties	DeploymentProperties	Die Bereitstellungseigenschaften.
tags	object	Bereitstellungstags

DeploymentDiagnosticsDefinition

Objekt

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
level	Level	Gibt die zusätzliche Antwortebene an.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

DeploymentExtended

Objekt

Bereitstellungsinformationen.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	der Speicherort der Bereitstellung.
name	string	Der Name der Ressource
properties	DeploymentPropertiesExtended	Bereitstellungseigenschaften.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten.
tags	object	Bereitstellungstags
type	string	Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten"

DeploymentExtensionConfigItem

Objekt

Name	Typ	Beschreibung
keyVaultReference	KeyVaultParameterReference	Die Azure Key Vault-Referenz, die verwendet wird, um den geheimen Wert der Erweiterungskonfigurationseigenschaft abzurufen.
type	ExtensionConfigPropertyType	Der Werttyp der config-Eigenschaft der Erweiterung.
value		Der Wert der config-Eigenschaft der Erweiterung.

DeploymentExtensionDefinition

Objekt

Name	Typ	Beschreibung
alias	string	Der Alias der Erweiterung, wie er in der Bereitstellungsvorlage definiert ist.
config	<string, DeploymentExtensionConfigItem>	Die Konfiguration der Erweiterung.
configId	string	Die Konfigurations-ID der Erweiterung. Sie identifiziert eindeutig eine Bereitstellungssteuerungsebene innerhalb einer Erweiterung.
name	string	Der Erweiterungsname.
version	string	Die Version der Erweiterung.

DeploymentExternalInput

Objekt

Deployment externer Eingang für die Parametrisierung.

Name	Typ	Beschreibung
value		Externer Eingabewert.

DeploymentExternalInputDefinition

Objekt

Deployment Externe Eingabedefinition für die Parametrisierung.

Name	Typ	Beschreibung
config		Konfiguration für den externen Eingang.
kind	string	Die Art des externen Inputs.

DeploymentIdentity

Objekt

Die Konfiguration der verwalteten Identität für eine Bereitstellung.

Name	Typ	Beschreibung
type	DeploymentIdentityType	Der Identitätstyp.
userAssignedIdentities	<string, UserAssignedIdentity>	Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind.

DeploymentIdentityType

Enumeration

Der Identitätstyp.

Wert	Beschreibung
None	Nichts
UserAssigned	UserAssigned

DeploymentMode

Enumeration

Der Modus, der zum Bereitstellen von Ressourcen verwendet wird. Dieser Wert kann entweder inkrementell oder abgeschlossen 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, gelöscht. Achten Sie darauf, wenn Sie den Vollständigen Modus verwenden, da Sie möglicherweise unbeabsichtigt Ressourcen löschen.

Wert	Beschreibung
Incremental	Inkrementell
Complete	Abgeschlossen

DeploymentParameter

Objekt

Bereitstellungsparameter für die Vorlage.

Name	Typ	Beschreibung
expression	string	Eingabeausdruck für den Parameter.
reference	KeyVaultParameterReference	Azure Key Vault parameter reference.
value		Eingabewert für den Parameter .

DeploymentProperties

Objekt

Bereitstellungseigenschaften.

Name	Typ	Beschreibung
debugSetting	DebugSetting	Die Debugeinstellung der Bereitstellung.
expressionEvaluationOptions	ExpressionEvaluationOptions	Gibt an, ob Vorlagenausdrücke im Bereich der übergeordneten Vorlage oder geschachtelten Vorlage ausgewertet werden. Gilt nur für geschachtelte Vorlagen. Wenn nicht angegeben, ist der Standardwert außen.
extensionConfigs	object	Die Konfigurationen, die für Bereitstellungserweiterungen verwendet werden sollen. Bei den Schlüsseln dieses Objekts handelt es sich um Aliase für Bereitstellungserweiterungen, die in der Bereitstellungsvorlage definiert sind.
externalInputDefinitions	<string, DeploymentExternalInputDefinition>	Externe Eingabedefinitionen, die von externen Tools verwendet werden, um erwartete externe Eingabewerte zu definieren.
externalInputs	<string, DeploymentExternalInput>	Externe Eingabewerte, die von externen Tools zur Parameterauswertung verwendet werden.
mode	DeploymentMode	Der Modus, der zum Bereitstellen von Ressourcen verwendet wird. Dieser Wert kann entweder inkrementell oder abgeschlossen 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, gelöscht. Achten Sie darauf, wenn Sie den Vollständigen Modus verwenden, da Sie möglicherweise unbeabsichtigt Ressourcen löschen.
onErrorDeployment	OnErrorDeployment	Die Bereitstellung beim Fehlerverhalten.
parameters	<string, DeploymentParameter>	Name- und Wertpaare, die die Bereitstellungsparameter für die Vorlage definieren. Sie verwenden dieses Element, wenn Sie die Parameterwerte direkt in der Anforderung bereitstellen möchten, anstatt eine Verknüpfung mit einer vorhandenen Parameterdatei zu erstellen. Verwenden Sie entweder die ParametersLink-Eigenschaft oder die Parametereigenschaft, aber nicht beide. Es kann sich um ein JObject oder eine wohlgeformte JSON-Zeichenfolge sein.
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 Parametereigenschaft, aber nicht beide.
template		Der Vorlageninhalt. Sie verwenden dieses Element, wenn Sie die Vorlagensyntax direkt in der Anforderung übergeben möchten, anstatt mit einer vorhandenen Vorlage zu verknüpfen. Es kann sich um eine JObject- oder wohlgeformte JSON-Zeichenfolge sein. Verwenden Sie entweder die templateLink-Eigenschaft oder die Vorlageneigenschaft, aber nicht beide.
templateLink	TemplateLink	Der URI der Vorlage. Verwenden Sie entweder die templateLink-Eigenschaft oder die Vorlageneigenschaft, aber nicht beide.
validationLevel	ValidationLevel	Die Validierungsebene der Bereitstellung

DeploymentPropertiesExtended

Objekt

Bereitstellungseigenschaften mit zusätzlichen Details.

Name	Typ	Beschreibung
correlationId	string	Die Korrelations-ID der Bereitstellung.
debugSetting	DebugSetting	Die Debugeinstellung der Bereitstellung.
dependencies	Dependency[]	Die Liste der Bereitstellungsabhängigkeiten.
diagnostics	DeploymentDiagnosticsDefinition[]	Enthält Diagnoseinformationen, die während des Validierungsprozesses gesammelt wurden.
duration	string	Die Dauer der Vorlagenbereitstellung.
error	ErrorResponse	Der Bereitstellungsfehler.
extensions	DeploymentExtensionDefinition[]	Die Erweiterungen, die in dieser Bereitstellung verwendet werden.
mode	DeploymentMode	Der Bereitstellungsmodus. Mögliche Werte sind inkrementell und abgeschlossen.
onErrorDeployment	OnErrorDeploymentExtended	Die Bereitstellung beim Fehlerverhalten.
outputResources	ResourceReference[]	Array der bereitgestellten Ressourcen.
outputs		Schlüssel-Wert-Paare, die die Bereitstellungsausgabe darstellen.
parameters		Bereitstellungsparameter.
parametersLink	ParametersLink	Der URI, der auf die Parameter verweist.
providers	Provider[]	Die Liste der Ressourcenanbieter, die für die Bereitstellung erforderlich sind.
provisioningState	ProvisioningState	Gibt den Bereitstellungsstatus an.
templateHash	string	Der für die Vorlage erstellte Hash.
templateLink	TemplateLink	Der URI, der auf die Vorlage verweist.
timestamp	string (date-time)	Der Zeitstempel der Vorlagenbereitstellung.
validatedResources	ResourceReference[]	Array von überprüften Ressourcen.
validationLevel	ValidationLevel	Die Validierungsebene der Bereitstellung

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorResponse

Objekt

Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

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

ExpressionEvaluationOptions

Objekt

Gibt an, ob Vorlagenausdrücke im Bereich der übergeordneten Vorlage 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

Enumeration

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

Wert	Beschreibung
NotSpecified	Nicht angegeben
Outer	Äußeres
Inner	Innerhalb

ExtensionConfigPropertyType

Enumeration

Wert	Beschreibung
String	Eigenschaftstyp, der einen Zeichenfolgenwert darstellt.
Int	Eigenschaftstyp, der einen ganzzahligen Wert darstellt.
Bool	Eigenschaftstyp, der einen booleschen Wert darstellt.
Array	Eigenschaftstyp, der einen Arraywert darstellt.
Object	Eigenschaftstyp, der einen Objektwert darstellt.
SecureString	Eigenschaftstyp, der einen sicheren Zeichenfolgenwert darstellt.
SecureObject	Eigenschaftstyp, der einen Wert für ein sicheres Objekt darstellt.

KeyVaultParameterReference

Objekt

Azure Key Vault parameter reference.

Name	Typ	Beschreibung
keyVault	KeyVaultReference	Azure Key Vault Reference.
secretName	string	Azure Key Vault Geheimname.
secretVersion	string	Azure Key Vault geheime Version.

KeyVaultReference

Objekt

Azure Key Vault Reference.

Name	Typ	Beschreibung
id	string	Azure Key Vault resource id.

Level

Enumeration

Gibt die zusätzliche Antwortebene an.

Wert	Beschreibung
Warning	Warnung
Info	Info
Error	Fehler

OnErrorDeployment

Objekt

Bereitstellung beim Fehlerverhalten.

Name	Typ	Beschreibung
deploymentName	string	Die Bereitstellung, die für den Fehlerfall verwendet werden soll.
type	OnErrorDeploymentType	Die Bereitstellung beim Fehlerverhaltenstyp. Mögliche Werte sind LastSuccessful und SpecificDeployment.

OnErrorDeploymentExtended

Objekt

Bereitstellung bei Fehlerverhalten mit zusätzlichen Details.

Name	Typ	Beschreibung
deploymentName	string	Die Bereitstellung, die für den Fehlerfall verwendet werden soll.
provisioningState	string	Der Status der Bereitstellung für die On Error Deployment.
type	OnErrorDeploymentType	Die Bereitstellung beim Fehlerverhaltenstyp. Mögliche Werte sind LastSuccessful und SpecificDeployment.

OnErrorDeploymentType

Enumeration

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

Wert	Beschreibung
LastSuccessful	LetztErfolgreich
SpecificDeployment	SpecificDeployment

ParametersLink

Objekt

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

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

Provider

Objekt

Informationen zum Ressourcenanbieter.

Name	Typ	Beschreibung
id	string	Die Anbieter-ID.
namespace	string	Der Namespace des Ressourcenanbieters.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Der Autorisierungsstatus des Anbieters.
registrationPolicy	string	Die Registrierungsrichtlinie des Ressourcenanbieters.
registrationState	string	Der Registrierungsstatus des Ressourcenanbieters.
resourceTypes	ProviderResourceType[]	Die Sammlung von Anbieterressourcentypen.

ProviderAuthorizationConsentState

Enumeration

Der Autorisierungsstatus des Anbieters.

Wert	Beschreibung
NotSpecified	Nicht angegeben
Required	Erforderlich
NotRequired	NotRequired
Consented	Einverstanden

ProviderExtendedLocation

Objekt

Der erweiterte Anbieterspeicherort.

Name	Typ	Beschreibung
extendedLocations	string[]	Die erweiterten Speicherorte für den Azure-Speicherort.
location	string	Der Azure-Speicherort.
type	string	Der erweiterte Standorttyp.

ProviderResourceType

Objekt

Vom Ressourcenanbieter verwalteter Ressourcentyp.

Name	Typ	Beschreibung
aliases	Alias[]	Die Aliase, die von diesem Ressourcentyp unterstützt werden.
apiProfiles	ApiProfile[]	Die API-Profile für den Ressourcenanbieter.
apiVersions	string[]	Die API-Version.
capabilities	string	Die zusätzlichen Funktionen, die von diesem Ressourcentyp angeboten werden.
defaultApiVersion	string	Die Standard-API-Version.
locationMappings	ProviderExtendedLocation[]	Die Standortzuordnungen, die von diesem Ressourcentyp unterstützt werden.
locations	string[]	Die Sammlung der Speicherorte, an denen dieser Ressourcentyp erstellt werden kann.
properties	object	Die Eigenschaften.
resourceType	string	Der Ressourcentyp.
zoneMappings	ZoneMapping[]

ProvisioningState

Enumeration

Gibt den Bereitstellungsstatus an.

Wert	Beschreibung
NotSpecified	Nicht angegeben
Accepted	Akzeptiert
Running	Laufen
Ready	Bereit
Creating	Erstellen
Created	Erstellt
Deleting	Löschen
Deleted	Gelöscht
Canceled	Abgesagt
Failed	gescheitert
Succeeded	Erfolgreich
Updating	Aktualisieren

ResourceReference

Objekt

Das Ressourcen-ID-Modell.

Name	Typ	Beschreibung
apiVersion	string	Die API-Version, mit der die Ressource bereitgestellt wurde.
extension	DeploymentExtensionDefinition	Die Erweiterung, mit der die Ressource bereitgestellt wurde.
id	string	Die vollständig qualifizierte Azure Resource ID.
identifiers		Die erweiterbaren Ressourcenbezeichner.
resourceType	string	Der Ressourcentyp.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

TemplateLink

Objekt

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

Name	Typ	Beschreibung
contentVersion	string	Falls enthalten, muss der ContentVersion in der Vorlage entsprechen.
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, wird auf ein Artefakt in der TemplateSpec verwiesen. Wenn das übergeordnete Element mit einem URI verknüpft wurde, ist die untergeordnete Bereitstellung eine Kombination aus den übergeordneten und relativenPath-URIs.
uri	string	Der URI der bereitzustellenden Vorlage. Verwenden Sie entweder die URI- oder ID-Eigenschaft, aber nicht beide.

UserAssignedIdentity

Objekt

Benutzer zugewiesene Identitätseigenschaften

Name	Typ	Beschreibung
clientId	string (uuid)	Die Client-ID der zugewiesenen Identität.
principalId	string (uuid)	Die Prinzipal-ID der zugewiesenen Identität.

ValidationLevel

Enumeration

Die Validierungsebene, die für die Bereitstellung ausgeführt wurde.

Wert	Beschreibung
Template	Es wird eine statische Analyse des Templates durchgeführt.
Provider	Die Vorlage wird statisch analysiert, und Ressourcendeklarationen werden zur semantischen Validierung an Ressourcenanbieter gesendet. Überprüft, ob der Aufrufer über RBAC-Schreibberechtigungen für jede Ressource verfügt.
ProviderNoRbac	Die Vorlage wird statisch analysiert, und Ressourcendeklarationen werden zur semantischen Validierung an Ressourcenanbieter gesendet. Überspringt die Überprüfung, ob der Aufrufer über RBAC-Schreibberechtigungen für jede Ressource verfügt.

ZoneMapping

Objekt

Name	Typ	Beschreibung
location	string	Die Position der Zonenzuordnung.
zones	string[]

Freigeben über

Deployments - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Create a deployment that will deploy a template with a uri and queryString

Beispielanforderung

Beispiel für eine Antwort

Create a deployment that will deploy a templateSpec with the given resourceId

Beispielanforderung

Beispiel für eine Antwort

Create a deployment that will redeploy another deployment on failure

Beispielanforderung

Beispiel für eine Antwort

Create a deployment that will redeploy the last successful deployment on failure

Beispielanforderung

Beispiel für eine Antwort

Create deployment using external inputs

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Alias

AliasPath

AliasPathAttributes

AliasPathMetadata

AliasPathTokenType

AliasPattern

AliasPatternType

AliasType

ApiProfile

BasicDependency

CloudError

createdByType

DebugSetting

Dependency

Deployment

DeploymentDiagnosticsDefinition

DeploymentExtended

DeploymentExtensionConfigItem

DeploymentExtensionDefinition

DeploymentExternalInput

DeploymentExternalInputDefinition

DeploymentIdentity

DeploymentIdentityType

DeploymentMode

DeploymentParameter

DeploymentProperties

DeploymentPropertiesExtended

ErrorAdditionalInfo

ErrorResponse

ExpressionEvaluationOptions

ExpressionEvaluationOptionsScopeType

ExtensionConfigPropertyType

KeyVaultParameterReference

KeyVaultReference

Level

OnErrorDeployment

OnErrorDeploymentExtended

OnErrorDeploymentType

ParametersLink

Provider

ProviderAuthorizationConsentState

ProviderExtendedLocation

ProviderResourceType

ProvisioningState

ResourceReference

systemData

TemplateLink

UserAssignedIdentity

ValidationLevel

ZoneMapping