Deployment
Deployment stack object. Uses Azure REST API version 2024-03-01. In version 2.x of the Azure Native provider, it used API version 2022-08-01-preview. Other available API versions: 2022-08-01-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native resources [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.
Example Usage
DeploymentStacksSubscriptionCreateOrUpdate
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var deploymentStackAtSubscription = new AzureNative.Resources.DeploymentStackAtSubscription("deploymentStackAtSubscription", new()
{
ActionOnUnmanage = new AzureNative.Resources.Inputs.ActionOnUnmanageArgs
{
ManagementGroups = AzureNative.Resources.DeploymentStacksDeleteDetachEnum.Detach,
ResourceGroups = AzureNative.Resources.DeploymentStacksDeleteDetachEnum.Delete,
Resources = AzureNative.Resources.DeploymentStacksDeleteDetachEnum.Delete,
},
DenySettings = new AzureNative.Resources.Inputs.DenySettingsArgs
{
ApplyToChildScopes = false,
ExcludedActions = new[]
{
"action",
},
ExcludedPrincipals = new[]
{
"principal",
},
Mode = AzureNative.Resources.DenySettingsMode.DenyDelete,
},
DeploymentStackName = "simpleDeploymentStack",
Location = "eastus",
Parameters =
{
{ "parameter1", new AzureNative.Resources.Inputs.DeploymentParameterArgs
{
Value = "a string",
} },
},
Tags =
{
{ "tagkey", "tagVal" },
},
});
});package main
import (
resources "github.com/pulumi/pulumi-azure-native-sdk/resources/v3"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := resources.NewDeploymentStackAtSubscription(ctx, "deploymentStackAtSubscription", &resources.DeploymentStackAtSubscriptionArgs{
ActionOnUnmanage: &resources.ActionOnUnmanageArgs{
ManagementGroups: pulumi.String(resources.DeploymentStacksDeleteDetachEnumDetach),
ResourceGroups: pulumi.String(resources.DeploymentStacksDeleteDetachEnumDelete),
Resources: pulumi.String(resources.DeploymentStacksDeleteDetachEnumDelete),
},
DenySettings: &resources.DenySettingsArgs{
ApplyToChildScopes: pulumi.Bool(false),
ExcludedActions: pulumi.StringArray{
pulumi.String("action"),
},
ExcludedPrincipals: pulumi.StringArray{
pulumi.String("principal"),
},
Mode: pulumi.String(resources.DenySettingsModeDenyDelete),
},
DeploymentStackName: pulumi.String("simpleDeploymentStack"),
Location: pulumi.String("eastus"),
Parameters: resources.DeploymentParameterMap{
"parameter1": &resources.DeploymentParameterArgs{
Value: pulumi.Any("a string"),
},
},
Tags: pulumi.StringMap{
"tagkey": pulumi.String("tagVal"),
},
})
if err != nil {
return err
}
return nil
})
}package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.resources.DeploymentStackAtSubscription;
import com.pulumi.azurenative.resources.DeploymentStackAtSubscriptionArgs;
import com.pulumi.azurenative.resources.inputs.ActionOnUnmanageArgs;
import com.pulumi.azurenative.resources.inputs.DenySettingsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var deploymentStackAtSubscription = new DeploymentStackAtSubscription("deploymentStackAtSubscription", DeploymentStackAtSubscriptionArgs.builder()
.actionOnUnmanage(ActionOnUnmanageArgs.builder()
.managementGroups("detach")
.resourceGroups("delete")
.resources("delete")
.build())
.denySettings(DenySettingsArgs.builder()
.applyToChildScopes(false)
.excludedActions("action")
.excludedPrincipals("principal")
.mode("denyDelete")
.build())
.deploymentStackName("simpleDeploymentStack")
.location("eastus")
.parameters(Map.of("parameter1", DeploymentParameterArgs.builder()
.value("a string")
.build()))
.tags(Map.of("tagkey", "tagVal"))
.build());
}
}Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:resources:DeploymentStackAtSubscription simpleDeploymentStack /subscriptions/{subscriptionId}/providers/Microsoft.Resources/deploymentStacks/{deploymentStackName}Properties
Defines the behavior of resources that are no longer managed after the Deployment stack is updated or deleted.
The Azure API version of the resource.
The correlation id of the last Deployment stack upsert or delete operation. It is in GUID format and is used for tracing.
The debug setting of the deployment.
An array of resources that were deleted during the most recent Deployment stack update. Deleted means that the resource was removed from the template and relevant deletion operations were specified.
Defines how resources deployed by the stack are locked.
The resourceId of the deployment resource created by the deployment stack.
The scope at which the initial deployment should be created. If a scope is not specified, it will default to the scope of the deployment stack. Valid scopes are: management group (format: '/providers/Microsoft.Management/managementGroups/{managementGroupId}'), subscription (format: '/subscriptions/{subscriptionId}'), resource group (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}').
Deployment stack description. Max length of 4096 characters.
An array of resources that were detached during the most recent Deployment stack update. Detached means that the resource was removed from the template, but no relevant deletion operations were specified. So, the resource still exists while no longer being associated with the stack.
The error detail.
An array of resources that failed to reach goal state during the most recent update. Each resourceId is accompanied by an error message.
Name and value pairs that define the deployment parameters for the template. Use this element when providing the parameter values directly in the request, rather than linking to an existing parameter file. Use either the parametersLink property or the parameters property, but not both.
The URI of parameters file. Use this element to link to an existing parameters file. Use either the parametersLink property or the parameters property, but not both.
State of the deployment stack.
An array of resources currently managed by the deployment stack.
Azure Resource Manager metadata containing createdBy and modifiedBy information.