Deployments - Get

Obtém uma implementação.

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

Parâmetros do URI

Name Em Necessário Tipo Description
deploymentName
path True

string

O nome da implementação.

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

resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

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

subscriptionId
path True

string

O ID da subscrição do Microsoft Azure.

api-version
query True

string

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Description
200 OK

DeploymentExtended

OK - Devolve informações sobre a implementação, incluindo o estado de aprovisionamento.

Other Status Codes

CloudError

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation representar a sua conta de utilizador

Definições

Name Description
Alias

O tipo de alias.

AliasPath

O tipo de caminhos para alias.

AliasPathAttributes

Os atributos do token a que o caminho do alias se refere.

AliasPathMetadata
AliasPathTokenType

O tipo de token a que o caminho do alias se refere.

AliasPattern

O tipo do padrão para um caminho de alias.

AliasPatternType

O tipo de padrão de alias

AliasType

O tipo de alias.

ApiProfile
BasicDependency

Informações de dependência de implementação.

CloudError

Uma resposta de erro para um pedido de gestão de recursos.

DebugSetting

A definição de depuração.

Dependency

Informações de dependência de implementação.

DeploymentExtended

Informações de implementação.

DeploymentMode

O modo utilizado para implementar recursos. Este valor pode ser Incremental ou Complete. No modo Incremental, os recursos são implementados sem eliminar recursos existentes que não estão incluídos no modelo. No modo Completo, os recursos são implementados e os recursos existentes no grupo de recursos que não estão incluídos no modelo são eliminados. Tenha cuidado ao utilizar o Modo completo, uma vez que pode eliminar recursos involuntariamente.

DeploymentPropertiesExtended

Propriedades de implementação com detalhes adicionais.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorResponse

Resposta a Erros

OnErrorDeploymentExtended

Implementação no comportamento do erro com detalhes adicionais.

OnErrorDeploymentType

A implementação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment.

ParametersLink

Entidade que representa a referência aos parâmetros de implementação.

Provider

Informações do fornecedor de recursos.

ProviderAuthorizationConsentState

O estado de consentimento da autorização do fornecedor.

ProviderExtendedLocation

A localização expandida do fornecedor.

ProviderResourceType

Tipo de recurso gerido pelo fornecedor de recursos.

ProvisioningState

Indica o estado do aprovisionamento.

ResourceReference

O modelo de ID do recurso.

TemplateLink

Entidade que representa a referência ao modelo.

ZoneMapping

Alias

O tipo de alias.

Name Tipo Description
defaultMetadata

AliasPathMetadata

Os metadados do caminho do alias predefinido. Aplica-se ao caminho predefinido e a qualquer caminho de alias que não tenha metadados

defaultPath

string

O caminho predefinido para um alias.

defaultPattern

AliasPattern

O padrão predefinido para um alias.

name

string

O nome do alias.

paths

AliasPath[]

Os caminhos para um alias.

type

AliasType

O tipo de alias.

AliasPath

O tipo de caminhos para alias.

Name Tipo Description
apiVersions

string[]

As versões da API.

metadata

AliasPathMetadata

Os metadados do caminho do alias. Se estiver em falta, recue para os metadados predefinidos do alias.

path

string

O caminho de um alias.

pattern

AliasPattern

O padrão para um caminho de alias.

AliasPathAttributes

Os atributos do token a que o caminho do alias se refere.

Name Tipo Description
Modifiable

string

O token a que o caminho do alias se refere é modificável por políticas com efeito "modificar".

None

string

O token a que o caminho do alias se refere não tem atributos.

AliasPathMetadata

Name Tipo Description
attributes

AliasPathAttributes

Os atributos do token a que o caminho do alias se refere.

type

AliasPathTokenType

O tipo de token a que o caminho do alias se refere.

AliasPathTokenType

O tipo de token a que o caminho do alias se refere.

Name Tipo Description
Any

string

O tipo de token pode ser qualquer coisa.

Array

string

O tipo de token é matriz.

Boolean

string

O tipo de token é booleano.

Integer

string

O tipo de token é número inteiro.

NotSpecified

string

O tipo de token não é especificado.

Number

string

O tipo de token é número.

Object

string

O tipo de token é objeto.

String

string

O tipo de token é cadeia.

AliasPattern

O tipo do padrão para um caminho de alias.

Name Tipo Description
phrase

string

A expressão de padrão de alias.

type

AliasPatternType

O tipo de padrão de alias

variable

string

A variável de padrão de alias.

AliasPatternType

O tipo de padrão de alias

Name Tipo Description
Extract

string

Extrair é o único valor permitido.

NotSpecified

string

Não é permitido notSpecified.

AliasType

O tipo de alias.

Name Tipo Description
Mask

string

O valor do alias é secreto.

NotSpecified

string

O tipo de alias é desconhecido (o mesmo que não fornecer o tipo de alias).

PlainText

string

O valor do alias não é secreto.

ApiProfile

Name Tipo Description
apiVersion

string

A versão da API.

profileVersion

string

A versão do perfil.

BasicDependency

Informações de dependência de implementação.

Name Tipo Description
id

string

O ID da dependência.

resourceName

string

O nome do recurso de dependência.

resourceType

string

O tipo de recurso de dependência.

CloudError

Uma resposta de erro para um pedido de gestão de recursos.

Name Tipo Description
error

ErrorResponse

Resposta a Erros
Resposta de erro comum para todas as APIs Resource Manager do Azure para devolver detalhes de erro para operações falhadas. (Isto também segue o formato de resposta a erros OData.)

DebugSetting

A definição de depuração.

Name Tipo Description
detailLevel

string

Especifica o tipo de informações a registar para depuração. Os valores permitidos não são nenhum, requestContent, responseContent ou requestContent e responseContent separados por uma vírgula. A predefinição é Nenhum. Ao definir este valor, considere cuidadosamente o tipo de informação que está a transmitir durante a implementação. Ao registar informações sobre o pedido ou a resposta, pode potencialmente expor dados confidenciais obtidos através das operações de implementação.

Dependency

Informações de dependência de implementação.

Name Tipo Description
dependsOn

BasicDependency[]

A lista de dependências.

id

string

O ID da dependência.

resourceName

string

O nome do recurso de dependência.

resourceType

string

O tipo de recurso de dependência.

DeploymentExtended

Informações de implementação.

Name Tipo Description
id

string

O ID da implementação.

location

string

a localização da implementação.

name

string

O nome da implementação.

properties

DeploymentPropertiesExtended

Propriedades de implementação.

tags

object

Etiquetas de implementação

type

string

O tipo de implementação.

DeploymentMode

O modo utilizado para implementar recursos. Este valor pode ser Incremental ou Complete. No modo Incremental, os recursos são implementados sem eliminar recursos existentes que não estão incluídos no modelo. No modo Completo, os recursos são implementados e os recursos existentes no grupo de recursos que não estão incluídos no modelo são eliminados. Tenha cuidado ao utilizar o Modo completo, uma vez que pode eliminar recursos involuntariamente.

Name Tipo Description
Complete

string

Incremental

string

DeploymentPropertiesExtended

Propriedades de implementação com detalhes adicionais.

Name Tipo Description
correlationId

string

O ID de correlação da implementação.

debugSetting

DebugSetting

A definição de depuração da implementação.

dependencies

Dependency[]

A lista de dependências de implementação.

duration

string

A duração da implementação do modelo.

error

ErrorResponse

Resposta a Erros
O erro de implementação.

mode

DeploymentMode

O modo de implementação. Os valores possíveis são Incremental e Complete.

onErrorDeployment

OnErrorDeploymentExtended

A implementação no comportamento do erro.

outputResources

ResourceReference[]

Matriz de recursos aprovisionados.

outputs

object

Pares chave/valor que representam a saída da implementação.

parameters

object

Parâmetros de implementação.

parametersLink

ParametersLink

O URI que referencia os parâmetros.

providers

Provider[]

A lista de fornecedores de recursos necessários para a implementação.

provisioningState

ProvisioningState

Indica o estado do aprovisionamento.

templateHash

string

O hash produzido para o modelo.

templateLink

TemplateLink

O URI que referencia o modelo.

timestamp

string

O carimbo de data/hora da implementação do modelo.

validatedResources

ResourceReference[]

Matriz de recursos validados.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorResponse

Resposta a Erros

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorResponse[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

OnErrorDeploymentExtended

Implementação no comportamento do erro com detalhes adicionais.

Name Tipo Description
deploymentName

string

A implementação a ser utilizada em caso de erro.

provisioningState

string

O estado do aprovisionamento para a implementação de erros.

type

OnErrorDeploymentType

A implementação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment.

OnErrorDeploymentType

A implementação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment.

Name Tipo Description
LastSuccessful

string

SpecificDeployment

string

Entidade que representa a referência aos parâmetros de implementação.

Name Tipo Description
contentVersion

string

Se estiver incluído, tem de corresponder ao ContentVersion no modelo.

uri

string

O URI do ficheiro de parâmetros.

Provider

Informações do fornecedor de recursos.

Name Tipo Description
id

string

O ID do fornecedor.

namespace

string

O espaço de nomes do fornecedor de recursos.

providerAuthorizationConsentState

ProviderAuthorizationConsentState

O estado de consentimento da autorização do fornecedor.

registrationPolicy

string

A política de registo do fornecedor de recursos.

registrationState

string

O estado de registo do fornecedor de recursos.

resourceTypes

ProviderResourceType[]

A coleção de tipos de recursos do fornecedor.

ProviderAuthorizationConsentState

O estado de consentimento da autorização do fornecedor.

Name Tipo Description
Consented

string

NotRequired

string

NotSpecified

string

Required

string

ProviderExtendedLocation

A localização expandida do fornecedor.

Name Tipo Description
extendedLocations

string[]

As localizações expandidas para a localização do azure.

location

string

A localização do azure.

type

string

O tipo de localização expandida.

ProviderResourceType

Tipo de recurso gerido pelo fornecedor de recursos.

Name Tipo Description
aliases

Alias[]

Os aliases suportados por este tipo de recurso.

apiProfiles

ApiProfile[]

Os perfis de API para o fornecedor de recursos.

apiVersions

string[]

A versão da API.

capabilities

string

As capacidades adicionais oferecidas por este tipo de recurso.

defaultApiVersion

string

A versão predefinida da API.

locationMappings

ProviderExtendedLocation[]

Os mapeamentos de localização suportados por este tipo de recurso.

locations

string[]

A coleção de localizações onde este tipo de recurso pode ser criado.

properties

object

As propriedades.

resourceType

string

O tipo de recurso.

zoneMappings

ZoneMapping[]

ProvisioningState

Indica o estado do aprovisionamento.

Name Tipo Description
Accepted

string

Canceled

string

Created

string

Creating

string

Deleted

string

Deleting

string

Failed

string

NotSpecified

string

Ready

string

Running

string

Succeeded

string

Updating

string

ResourceReference

O modelo de ID do recurso.

Name Tipo Description
id

string

O ID de recurso completamente qualificado.

Entidade que representa a referência ao modelo.

Name Tipo Description
contentVersion

string

Se estiver incluído, tem de corresponder ao ContentVersion no modelo.

id

string

O ID de recurso de uma Especificação de Modelo. Utilize a propriedade ID ou URI, mas não ambas.

queryString

string

A cadeia de consulta (por exemplo, um token de SAS) a ser utilizada com o URI de templateLink.

relativePath

string

A propriedade relativePath pode ser utilizada para implementar um modelo ligado numa localização relativa ao principal. Se o modelo principal estiver ligado a um TemplateSpec, isto fará referência a um artefacto no TemplateSpec. Se o elemento principal tiver sido associado a um URI, a implementação subordinada será uma combinação dos URIs principal e relativePath

uri

string

O URI do modelo a implementar. Utilize a propriedade uri ou id, mas não ambas.

ZoneMapping

Name Tipo Description
location

string

A localização do mapeamento da zona.

zones

string[]