Deployments - Get

Gets a deployment.

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

URI Parameters

Name In Required Type Description
subscriptionId
path True
  • string

The ID of the target subscription.

resourceGroupName
path True
  • string

The name of the resource group. The name is case insensitive.

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

deploymentName
path True
  • string

The name of the deployment to get.

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

api-version
query True
  • string

The API version to use for this operation.

Responses

Name Type Description
200 OK

OK - Returns information about the deployment, including provisioning status.

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

Definitions

AliasPathType

The type of the paths for alias.

AliasType

The alias type.

BasicDependency

Deployment dependency information.

DebugSetting
Dependency

Deployment dependency information.

DeploymentExtended

Deployment information.

DeploymentMode

The mode that is used to deploy resources. This value can be either Incremental or Complete. In Incremental mode, resources are deployed without deleting existing resources that are not included in the template. In Complete mode, resources are deployed and existing resources in the resource group that are not included in the template are deleted. Be careful when using Complete mode as you may unintentionally delete resources.

DeploymentPropertiesExtended

Deployment properties with additional details.

OnErrorDeploymentExtended

Deployment on error behavior with additional details.

OnErrorDeploymentType

The deployment on error behavior type. Possible values are LastSuccessful and SpecificDeployment.

ParametersLink

Entity representing the reference to the deployment parameters.

Provider

Resource provider information.

ProviderResourceType

Resource type managed by the resource provider.

TemplateLink

Entity representing the reference to the template.

AliasPathType

The type of the paths for alias.

Name Type Description
apiVersions
  • string[]

The API versions.

path
  • string

The path of an alias.

AliasType

The alias type.

Name Type Description
name
  • string

The alias name.

paths

The paths for an alias.

BasicDependency

Deployment dependency information.

Name Type Description
id
  • string

The ID of the dependency.

resourceName
  • string

The dependency resource name.

resourceType
  • string

The dependency resource type.

DebugSetting

Name Type Description
detailLevel
  • string

Specifies the type of information to log for debugging. The permitted values are none, requestContent, responseContent, or both requestContent and responseContent separated by a comma. The default is none. When setting this value, carefully consider the type of information you are passing in during deployment. By logging information about the request or response, you could potentially expose sensitive data that is retrieved through the deployment operations.

Dependency

Deployment dependency information.

Name Type Description
dependsOn

The list of dependencies.

id
  • string

The ID of the dependency.

resourceName
  • string

The dependency resource name.

resourceType
  • string

The dependency resource type.

DeploymentExtended

Deployment information.

Name Type Description
id
  • string

The ID of the deployment.

location
  • string

the location of the deployment.

name
  • string

The name of the deployment.

properties

Deployment properties.

type
  • string

The type of the deployment.

DeploymentMode

The mode that is used to deploy resources. This value can be either Incremental or Complete. In Incremental mode, resources are deployed without deleting existing resources that are not included in the template. In Complete mode, resources are deployed and existing resources in the resource group that are not included in the template are deleted. Be careful when using Complete mode as you may unintentionally delete resources.

Name Type Description
Complete
  • string
Incremental
  • string

DeploymentPropertiesExtended

Deployment properties with additional details.

Name Type Description
correlationId
  • string

The correlation ID of the deployment.

debugSetting

The debug setting of the deployment.

dependencies

The list of deployment dependencies.

mode

The deployment mode. Possible values are Incremental and Complete.

onErrorDeployment

The deployment on error behavior.

outputs
  • object

Key/value pairs that represent deployment output.

parameters
  • object

Deployment parameters. Use only one of Parameters or ParametersLink.

parametersLink

The URI referencing the parameters. Use only one of Parameters or ParametersLink.

providers

The list of resource providers needed for the deployment.

provisioningState
  • string

The state of the provisioning.

template
  • object

The template content. Use only one of Template or TemplateLink.

templateLink

The URI referencing the template. Use only one of Template or TemplateLink.

timestamp
  • string

The timestamp of the template deployment.

OnErrorDeploymentExtended

Deployment on error behavior with additional details.

Name Type Description
deploymentName
  • string

The deployment to be used on error case.

provisioningState
  • string

The state of the provisioning for the on error deployment.

type

The deployment on error behavior type. Possible values are LastSuccessful and SpecificDeployment.

OnErrorDeploymentType

The deployment on error behavior type. Possible values are LastSuccessful and SpecificDeployment.

Name Type Description
LastSuccessful
  • string
SpecificDeployment
  • string

Entity representing the reference to the deployment parameters.

Name Type Description
contentVersion
  • string

If included, must match the ContentVersion in the template.

uri
  • string

The URI of the parameters file.

Provider

Resource provider information.

Name Type Description
id
  • string

The provider ID.

namespace
  • string

The namespace of the resource provider.

registrationPolicy
  • string

The registration policy of the resource provider.

registrationState
  • string

The registration state of the resource provider.

resourceTypes

The collection of provider resource types.

ProviderResourceType

Resource type managed by the resource provider.

Name Type Description
aliases

The aliases that are supported by this resource type.

apiVersions
  • string[]

The API version.

capabilities
  • string

The additional capabilities offered by this resource type.

locations
  • string[]

The collection of locations where this resource type can be created.

properties
  • object

The properties.

resourceType
  • string

The resource type.

Entity representing the reference to the template.

Name Type Description
contentVersion
  • string

If included, must match the ContentVersion in the template.

uri
  • string

The URI of the template to deploy.