Deployment Scripts - Create

Service:

Resource Management

API Version:

2020-10-01

Creates a deployment script.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deploymentScripts/{scriptName}?api-version=2020-10-01

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string	The name of the resource group. The name is case insensitive.
scriptName	path	True	string	Name of the deployment script.
subscriptionId	path	True	string	Subscription Id which forms part of the URI for every service call.
api-version	query	True	string	Client Api version.

Request Body

The request body can be one of the following:

Name	Description
AzureCliScript	Object model for the Azure CLI script.
AzurePowerShellScript	Object model for the Azure PowerShell script.

AzureCliScript

Object model for the Azure CLI script.

Name	Required	Type	Description
kind	True	string: AzureCLI	Type of the script.
location	True	string	The location of the ACI and the storage account for the deployment script.
properties.azCliVersion	True	string	Azure CLI module version to be used.
properties.retentionInterval	True	string	Interval for which the service retains the script resource after it reaches a terminal state. Resource will be deleted when this duration expires. Duration is based on ISO 8601 pattern (for example P1D means one day).
identity		ManagedServiceIdentity	Optional property. Managed identity to be used for this deployment script. Currently, only user-assigned MSI is supported.
properties.arguments		string	Command line arguments to pass to the script. Arguments are separated by spaces. ex: -Name blue* -Location 'West US 2'
properties.cleanupPreference		cleanupOptions	The clean up preference when the script execution gets in a terminal state. Default setting is 'Always'.
properties.containerSettings		ContainerConfiguration	Container settings.
properties.environmentVariables		EnvironmentVariable[]	The environment variables to pass over to the script.
properties.forceUpdateTag		string	Gets or sets how the deployment script should be forced to execute even if the script resource has not changed. Can be current time stamp or a GUID.
properties.primaryScriptUri		string	Uri for the script. This is the entry point for the external script.
properties.scriptContent		string	Script body.
properties.storageAccountSettings		StorageAccountConfiguration	Storage Account settings.
properties.supportingScriptUris		string[]	Supporting files for the external script.
properties.timeout		string	Maximum allowed script execution time specified in ISO 8601 format. Default value is P1D
tags		object	Resource tags.

AzurePowerShellScript

Object model for the Azure PowerShell script.

Name	Required	Type	Description
kind	True	string: AzurePowerShell	Type of the script.
location	True	string	The location of the ACI and the storage account for the deployment script.
properties.azPowerShellVersion	True	string	Azure PowerShell module version to be used.
properties.retentionInterval	True	string	Interval for which the service retains the script resource after it reaches a terminal state. Resource will be deleted when this duration expires. Duration is based on ISO 8601 pattern (for example P1D means one day).
identity		ManagedServiceIdentity	Optional property. Managed identity to be used for this deployment script. Currently, only user-assigned MSI is supported.
properties.arguments		string	Command line arguments to pass to the script. Arguments are separated by spaces. ex: -Name blue* -Location 'West US 2'
properties.cleanupPreference		cleanupOptions	The clean up preference when the script execution gets in a terminal state. Default setting is 'Always'.
properties.containerSettings		ContainerConfiguration	Container settings.
properties.environmentVariables		EnvironmentVariable[]	The environment variables to pass over to the script.
properties.forceUpdateTag		string	Gets or sets how the deployment script should be forced to execute even if the script resource has not changed. Can be current time stamp or a GUID.
properties.primaryScriptUri		string	Uri for the script. This is the entry point for the external script.
properties.scriptContent		string	Script body.
properties.storageAccountSettings		StorageAccountConfiguration	Storage Account settings.
properties.supportingScriptUris		string[]	Supporting files for the external script.
properties.timeout		string	Maximum allowed script execution time specified in ISO 8601 format. Default value is P1D
tags		object	Resource tags.

Responses

Name	Type	Description
200 OK	DeploymentScript: AzurePowerShellScript AzureCliScript	OK -- Deployment script is updated.
201 Created	DeploymentScript: AzurePowerShellScript AzureCliScript	Created -- Deployment script created.
Other Status Codes	DeploymentScriptsError	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

DeploymentScriptsCreate

DeploymentScriptsCreate_MinCreate

DeploymentScriptsCreate_UsingCustomACIName

DeploymentScriptsCreate_UsingExistingStorageAccount

DeploymentScriptsCreateNoUserManagedIdentity

DeploymentScriptsCreate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/script-rg/providers/Microsoft.Resources/deploymentScripts/MyDeploymentScript?api-version=2020-10-01

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "PT7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always"
  }
}

Go

package armdeploymentscripts_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/armdeploymentscripts"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/resources/resource-manager/Microsoft.Resources/stable/2020-10-01/examples/DeploymentScripts_Create.json
func ExampleClient_BeginCreate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armdeploymentscripts.NewClient("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := client.BeginCreate(ctx,
		"script-rg",
		"MyDeploymentScript",
		&armdeploymentscripts.AzurePowerShellScript{
			Identity: &armdeploymentscripts.ManagedServiceIdentity{
				Type: to.Ptr(armdeploymentscripts.ManagedServiceIdentityTypeUserAssigned),
				UserAssignedIdentities: map[string]*armdeploymentscripts.UserAssignedIdentity{
					"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {},
				},
			},
			Kind:     to.Ptr(armdeploymentscripts.ScriptTypeAzurePowerShell),
			Location: to.Ptr("westus"),
			Properties: &armdeploymentscripts.AzurePowerShellScriptProperties{
				CleanupPreference: to.Ptr(armdeploymentscripts.CleanupOptionsAlways),
				Arguments:         to.Ptr("-Location 'westus' -Name \"*rg2\""),
				RetentionInterval: to.Ptr("PT7D"),
				ScriptContent:     to.Ptr("Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name"),
				SupportingScriptUris: []*string{
					to.Ptr("https://uri1.to.supporting.script"),
					to.Ptr("https://uri2.to.supporting.script")},
				Timeout:             to.Ptr("PT1H"),
				AzPowerShellVersion: to.Ptr("1.7.0"),
			},
		},
		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)
	}
	// TODO: use response item
	_ = res
}

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

dotnet

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

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

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

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "script-rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ArmDeploymentScriptResource
ArmDeploymentScriptCollection collection = resourceGroupResource.GetArmDeploymentScripts();

// invoke the operation
string scriptName = "MyDeploymentScript";
ArmDeploymentScriptData data = new AzurePowerShellScript(new AzureLocation("westus"), XmlConvert.ToTimeSpan("PT7D"), "1.7.0")
{
    CleanupPreference = ScriptCleanupOptions.Always,
    SupportingScriptUris =
    {
    new Uri("https://uri1.to.supporting.script"),new Uri("https://uri2.to.supporting.script")
    },
    ScriptContent = "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    Arguments = "-Location 'westus' -Name \"*rg2\"",
    Timeout = XmlConvert.ToTimeSpan("PT1H"),
    Identity = new ArmDeploymentScriptManagedIdentity()
    {
        IdentityType = ArmDeploymentScriptManagedIdentityType.UserAssigned,
        UserAssignedIdentities =
        {
        ["/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai"] = new UserAssignedIdentity(),
        },
    },
};
ArmOperation<ArmDeploymentScriptResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, scriptName, data);
ArmDeploymentScriptResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ArmDeploymentScriptData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Sample Response

Status code:

201

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2020-02-01T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    }
  }
}

Status code:

200

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "provisioningState": "Succeeded",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    },
    "outputs": {
      "output1": "value1"
    }
  }
}

DeploymentScriptsCreate_MinCreate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/script-rg/providers/Microsoft.Resources/deploymentScripts/MyDeploymentScript?api-version=2020-10-01

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "retentionInterval": "P7D"
  }
}

Go

No code sample is available. To request a code sample, open a GitHub issue

dotnet

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

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

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

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "script-rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ArmDeploymentScriptResource
ArmDeploymentScriptCollection collection = resourceGroupResource.GetArmDeploymentScripts();

// invoke the operation
string scriptName = "MyDeploymentScript";
ArmDeploymentScriptData data = new AzurePowerShellScript(new AzureLocation("westus"), XmlConvert.ToTimeSpan("P7D"), "1.7.0")
{
    ScriptContent = "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    Arguments = "-Location 'westus' -Name \"*rg2\"",
    Identity = new ArmDeploymentScriptManagedIdentity()
    {
        IdentityType = ArmDeploymentScriptManagedIdentityType.UserAssigned,
        UserAssignedIdentities =
        {
        ["/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai"] = new UserAssignedIdentity(),
        },
    },
};
ArmOperation<ArmDeploymentScriptResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, scriptName, data);
ArmDeploymentScriptResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ArmDeploymentScriptData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Sample Response

Status code:

201

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2020-02-01T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    }
  }
}

Status code:

200

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "provisioningState": "Succeeded",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    },
    "outputs": {
      "output1": "value1"
    }
  }
}

DeploymentScriptsCreate_UsingCustomACIName

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/script-rg/providers/Microsoft.Resources/deploymentScripts/MyDeploymentScript?api-version=2020-10-01

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "containerSettings": {
      "containerGroupName": "contoso-aci"
    },
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "PT7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always"
  }
}

Go

No code sample is available. To request a code sample, open a GitHub issue

dotnet

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

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

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

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "script-rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ArmDeploymentScriptResource
ArmDeploymentScriptCollection collection = resourceGroupResource.GetArmDeploymentScripts();

// invoke the operation
string scriptName = "MyDeploymentScript";
ArmDeploymentScriptData data = new AzurePowerShellScript(new AzureLocation("westus"), XmlConvert.ToTimeSpan("PT7D"), "1.7.0")
{
    ContainerGroupName = "contoso-aci",
    CleanupPreference = ScriptCleanupOptions.Always,
    SupportingScriptUris =
    {
    new Uri("https://uri1.to.supporting.script"),new Uri("https://uri2.to.supporting.script")
    },
    ScriptContent = "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    Arguments = "-Location 'westus' -Name \"*rg2\"",
    Timeout = XmlConvert.ToTimeSpan("PT1H"),
    Identity = new ArmDeploymentScriptManagedIdentity()
    {
        IdentityType = ArmDeploymentScriptManagedIdentityType.UserAssigned,
        UserAssignedIdentities =
        {
        ["/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai"] = new UserAssignedIdentity(),
        },
    },
};
ArmOperation<ArmDeploymentScriptResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, scriptName, data);
ArmDeploymentScriptResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ArmDeploymentScriptData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Sample Response

Status code:

201

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2020-02-01T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "containerSettings": {
      "containerGroupName": "contoso-aci"
    },
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    }
  }
}

Status code:

200

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "provisioningState": "Succeeded",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "containerSettings": {
      "containerGroupName": "contoso-aci"
    },
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    },
    "outputs": {
      "output1": "value1"
    }
  }
}

DeploymentScriptsCreate_UsingExistingStorageAccount

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/script-rg/providers/Microsoft.Resources/deploymentScripts/MyDeploymentScript?api-version=2020-10-01

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "storageAccountSettings": {
      "storageAccountName": "contosostorage",
      "storageAccountKey": "contosostoragekey"
    },
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "PT7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always"
  }
}

Go

No code sample is available. To request a code sample, open a GitHub issue

dotnet

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

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

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

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "script-rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ArmDeploymentScriptResource
ArmDeploymentScriptCollection collection = resourceGroupResource.GetArmDeploymentScripts();

// invoke the operation
string scriptName = "MyDeploymentScript";
ArmDeploymentScriptData data = new AzurePowerShellScript(new AzureLocation("westus"), XmlConvert.ToTimeSpan("PT7D"), "1.7.0")
{
    StorageAccountSettings = new ScriptStorageConfiguration()
    {
        StorageAccountName = "contosostorage",
        StorageAccountKey = "contosostoragekey",
    },
    CleanupPreference = ScriptCleanupOptions.Always,
    SupportingScriptUris =
    {
    new Uri("https://uri1.to.supporting.script"),new Uri("https://uri2.to.supporting.script")
    },
    ScriptContent = "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    Arguments = "-Location 'westus' -Name \"*rg2\"",
    Timeout = XmlConvert.ToTimeSpan("PT1H"),
    Identity = new ArmDeploymentScriptManagedIdentity()
    {
        IdentityType = ArmDeploymentScriptManagedIdentityType.UserAssigned,
        UserAssignedIdentities =
        {
        ["/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai"] = new UserAssignedIdentity(),
        },
    },
};
ArmOperation<ArmDeploymentScriptResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, scriptName, data);
ArmDeploymentScriptResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ArmDeploymentScriptData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Sample Response

Status code:

201

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2020-02-01T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "storageAccountSettings": {
      "storageAccountName": "contosostorage"
    },
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    }
  }
}

Status code:

200

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/uai": {}
    }
  },
  "properties": {
    "provisioningState": "Succeeded",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "storageAccountSettings": {
      "storageAccountName": "contosostorage"
    },
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    },
    "outputs": {
      "output1": "value1"
    }
  }
}

DeploymentScriptsCreateNoUserManagedIdentity

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/script-rg/providers/Microsoft.Resources/deploymentScripts/MyDeploymentScript?api-version=2020-10-01

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "properties": {
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "PT7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always"
  }
}

Go

No code sample is available. To request a code sample, open a GitHub issue

dotnet

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

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

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

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "script-rg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this ArmDeploymentScriptResource
ArmDeploymentScriptCollection collection = resourceGroupResource.GetArmDeploymentScripts();

// invoke the operation
string scriptName = "MyDeploymentScript";
ArmDeploymentScriptData data = new AzurePowerShellScript(new AzureLocation("westus"), XmlConvert.ToTimeSpan("PT7D"), "1.7.0")
{
    CleanupPreference = ScriptCleanupOptions.Always,
    SupportingScriptUris =
    {
    new Uri("https://uri1.to.supporting.script"),new Uri("https://uri2.to.supporting.script")
    },
    ScriptContent = "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    Arguments = "-Location 'westus' -Name \"*rg2\"",
    Timeout = XmlConvert.ToTimeSpan("PT1H"),
};
ArmOperation<ArmDeploymentScriptResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, scriptName, data);
ArmDeploymentScriptResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ArmDeploymentScriptData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Sample Response

Status code:

201

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "systemData": {
    "createdBy": "string",
    "createdByType": "Application",
    "createdAt": "2020-02-01T01:01:01.1075056Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
  },
  "properties": {
    "provisioningState": "Creating",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    }
  }
}

Status code:

200

{
  "kind": "AzurePowerShell",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "azPowerShellVersion": "1.7.0",
    "scriptContent": "Param([string]$Location,[string]$Name) $deploymentScriptOutputs['test'] = 'value' Get-AzResourceGroup -Location $Location -Name $Name",
    "arguments": "-Location 'westus' -Name \"*rg2\"",
    "supportingScriptUris": [
      "https://uri1.to.supporting.script",
      "https://uri2.to.supporting.script"
    ],
    "retentionInterval": "P7D",
    "timeout": "PT1H",
    "cleanupPreference": "Always",
    "status": {
      "containerInstanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.ContainerInstance/containerGroups/scriptContainer",
      "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scriptRG/providers/Microsoft.Storage/storageAccounts/scriptStorage",
      "startTime": "2018-11-13T15:19:45-08:00",
      "endTime": "2018-11-13T15:19:45-08:00",
      "expirationTime": "2018-11-13T15:19:45-08:00"
    },
    "outputs": {
      "output1": "value1"
    }
  }
}

Definitions

Name	Description
AzureCliScript	Object model for the Azure CLI script.
AzurePowerShellScript	Object model for the Azure PowerShell script.
cleanupOptions	The clean up preference when the script execution gets in a terminal state. Default setting is 'Always'.
ContainerConfiguration	Settings to customize ACI container instance.
createdByType	The type of identity that created the resource.
DeploymentScriptsError	Deployment scripts error response.
EnvironmentVariable	The environment variable to pass to the script in the container instance.
ErrorAdditionalInfo	The resource management error additional info.
ErrorResponse	Error Response
ManagedServiceIdentity	Managed identity generic object.
ManagedServiceIdentityType	Type of the managed identity.
ScriptProvisioningState	State of the script execution. This only appears in the response.
ScriptStatus	Generic object modeling results of script execution.
StorageAccountConfiguration	Settings to use an existing storage account. Valid storage account kinds are: Storage, StorageV2 and FileStorage
systemData	Metadata pertaining to creation and last modification of the resource.
UserAssignedIdentity	User-assigned managed identity.

AzureCliScript

Object model for the Azure CLI script.

Name	Type	Default Value	Description
id	string		String Id used to locate any resource on Azure.
identity	ManagedServiceIdentity		Optional property. Managed identity to be used for this deployment script. Currently, only user-assigned MSI is supported.
kind	string: AzureCLI		Type of the script.
location	string		The location of the ACI and the storage account for the deployment script.
name	string		Name of this resource.
properties.arguments	string		Command line arguments to pass to the script. Arguments are separated by spaces. ex: -Name blue* -Location 'West US 2'
properties.azCliVersion	string		Azure CLI module version to be used.
properties.cleanupPreference	cleanupOptions	Always	The clean up preference when the script execution gets in a terminal state. Default setting is 'Always'.
properties.containerSettings	ContainerConfiguration		Container settings.
properties.environmentVariables	EnvironmentVariable[]		The environment variables to pass over to the script.
properties.forceUpdateTag	string		Gets or sets how the deployment script should be forced to execute even if the script resource has not changed. Can be current time stamp or a GUID.
properties.outputs	object		List of script outputs.
properties.primaryScriptUri	string		Uri for the script. This is the entry point for the external script.
properties.provisioningState	ScriptProvisioningState		State of the script execution. This only appears in the response.
properties.retentionInterval	string		Interval for which the service retains the script resource after it reaches a terminal state. Resource will be deleted when this duration expires. Duration is based on ISO 8601 pattern (for example P1D means one day).
properties.scriptContent	string		Script body.
properties.status	ScriptStatus		Contains the results of script execution.
properties.storageAccountSettings	StorageAccountConfiguration		Storage Account settings.
properties.supportingScriptUris	string[]		Supporting files for the external script.
properties.timeout	string	P1D	Maximum allowed script execution time specified in ISO 8601 format. Default value is P1D
systemData	systemData		The system metadata related to this resource.
tags	object		Resource tags.
type	string		Type of this resource.

AzurePowerShellScript

Object model for the Azure PowerShell script.

Name	Type	Default Value	Description
id	string		String Id used to locate any resource on Azure.
identity	ManagedServiceIdentity		Optional property. Managed identity to be used for this deployment script. Currently, only user-assigned MSI is supported.
kind	string: AzurePowerShell		Type of the script.
location	string		The location of the ACI and the storage account for the deployment script.
name	string		Name of this resource.
properties.arguments	string		Command line arguments to pass to the script. Arguments are separated by spaces. ex: -Name blue* -Location 'West US 2'
properties.azPowerShellVersion	string		Azure PowerShell module version to be used.
properties.cleanupPreference	cleanupOptions	Always	The clean up preference when the script execution gets in a terminal state. Default setting is 'Always'.
properties.containerSettings	ContainerConfiguration		Container settings.
properties.environmentVariables	EnvironmentVariable[]		The environment variables to pass over to the script.
properties.forceUpdateTag	string		Gets or sets how the deployment script should be forced to execute even if the script resource has not changed. Can be current time stamp or a GUID.
properties.outputs	object		List of script outputs.
properties.primaryScriptUri	string		Uri for the script. This is the entry point for the external script.
properties.provisioningState	ScriptProvisioningState		State of the script execution. This only appears in the response.
properties.retentionInterval	string		Interval for which the service retains the script resource after it reaches a terminal state. Resource will be deleted when this duration expires. Duration is based on ISO 8601 pattern (for example P1D means one day).
properties.scriptContent	string		Script body.
properties.status	ScriptStatus		Contains the results of script execution.
properties.storageAccountSettings	StorageAccountConfiguration		Storage Account settings.
properties.supportingScriptUris	string[]		Supporting files for the external script.
properties.timeout	string	P1D	Maximum allowed script execution time specified in ISO 8601 format. Default value is P1D
systemData	systemData		The system metadata related to this resource.
tags	object		Resource tags.
type	string		Type of this resource.

cleanupOptions

The clean up preference when the script execution gets in a terminal state. Default setting is 'Always'.

Name	Type	Description
Always	string
OnExpiration	string
OnSuccess	string

ContainerConfiguration

Settings to customize ACI container instance.

Name	Type	Description
containerGroupName	string	Container group name, if not specified then the name will get auto-generated. Not specifying a 'containerGroupName' indicates the system to generate a unique name which might end up flagging an Azure Policy as non-compliant. Use 'containerGroupName' when you have an Azure Policy that expects a specific naming convention or when you want to fully control the name. 'containerGroupName' property must be between 1 and 63 characters long, must contain only lowercase letters, numbers, and dashes and it cannot start or end with a dash and consecutive dashes are not allowed. To specify a 'containerGroupName', add the following object to properties: { "containerSettings": { "containerGroupName": "contoso-container" } }. If you do not want to specify a 'containerGroupName' then do not add 'containerSettings' property.

createdByType

The type of identity that created the resource.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DeploymentScriptsError

Deployment scripts error response.

Name	Type	Description
error	ErrorResponse	Error Response Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.)

EnvironmentVariable

The environment variable to pass to the script in the container instance.

Name	Type	Description
name	string	The name of the environment variable.
secureValue	string	The value of the secure environment variable.
value	string	The value of the environment variable.

ErrorAdditionalInfo

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorResponse

Error Response

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorResponse[]	The error details.
message	string	The error message.
target	string	The error target.

ManagedServiceIdentity

Managed identity generic object.

Name	Type	Description
tenantId	string	ID of the Azure Active Directory.
type	ManagedServiceIdentityType	Type of the managed identity.
userAssignedIdentities	<string,  UserAssignedIdentity>	The list of user-assigned managed identities associated with the resource. Key is the Azure resource Id of the managed identity.

ManagedServiceIdentityType

Type of the managed identity.

Name	Type	Description
UserAssigned	string

ScriptProvisioningState

State of the script execution. This only appears in the response.

Name	Type	Description
Canceled	string
Creating	string
Failed	string
ProvisioningResources	string
Running	string
Succeeded	string

ScriptStatus

Generic object modeling results of script execution.

Name	Type	Description
containerInstanceId	string	ACI resource Id.
endTime	string	End time of the script execution.
error	ErrorResponse	Error Response Error that is relayed from the script execution.
expirationTime	string	Time the deployment script resource will expire.
startTime	string	Start time of the script execution.
storageAccountId	string	Storage account resource Id.

StorageAccountConfiguration

Settings to use an existing storage account. Valid storage account kinds are: Storage, StorageV2 and FileStorage

Name	Type	Description
storageAccountKey	string	The storage account access key.
storageAccountName	string	The storage account name.

systemData

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

UserAssignedIdentity

User-assigned managed identity.

Name	Type	Description
clientId	string	Client App Id associated with this identity.
principalId	string	Azure Active Directory principal ID associated with this identity.