Deployments - Get At Tenant Scope

Service:

Resource Management

API Version:

2021-04-01

Ottiene una distribuzione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
deploymentName	path	True	string	Nome della distribuzione. Regex pattern: ^[-\w\._\(\)]+$
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	DeploymentExtended	OK: restituisce informazioni sulla distribuzione, incluso lo stato del provisioning.
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Definizioni

Nome	Descrizione
Alias	Tipo di alias.
AliasPath	Tipo dei percorsi per alias.
AliasPathAttributes	Attributi del token a cui fa riferimento il percorso alias.
AliasPathMetadata
AliasPathTokenType	Tipo di token a cui fa riferimento il percorso alias.
AliasPattern	Tipo del modello per un percorso alias.
AliasPatternType	Tipo di modello di alias
AliasType	Tipo dell'alias.
ApiProfile
BasicDependency	Informazioni sulle dipendenze della distribuzione.
CloudError	Risposta di errore per una richiesta di gestione delle risorse.
DebugSetting	Impostazione di debug.
Dependency	Informazioni sulle dipendenze della distribuzione.
DeploymentExtended	Informazioni sulla distribuzione.
DeploymentMode	Modalità usata per distribuire le risorse. Questo valore può essere Incremental o Complete. Nella modalità incrementale, le risorse vengono distribuite senza eliminare le risorse esistenti non incluse nel modello. In modalità completa le risorse vengono distribuite e le risorse esistenti nel gruppo di risorse non incluse nel modello vengono eliminate. Prestare attenzione quando si usa la modalità Completa perché è possibile eliminare involontariamente le risorse.
DeploymentPropertiesExtended	Proprietà di distribuzione con dettagli aggiuntivi.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorResponse	Risposta di errore
OnErrorDeploymentExtended	Distribuzione sul comportamento degli errori con dettagli aggiuntivi.
OnErrorDeploymentType	Distribuzione sul tipo di comportamento degli errori. I valori possibili sono LastSuccessful e SpecificDeployment.
ParametersLink	Entità che rappresenta il riferimento ai parametri di distribuzione.
Provider	Informazioni sul provider di risorse.
ProviderAuthorizationConsentState	Stato di consenso dell'autorizzazione del provider.
ProviderExtendedLocation	Posizione estesa del provider.
ProviderResourceType	Tipo di risorsa gestito dal provider di risorse.
ProvisioningState	Indica lo stato del provisioning.
ResourceReference	Modello ID risorsa.
TemplateLink	Entità che rappresenta il riferimento al modello.
ZoneMapping

Alias

Tipo di alias.

Nome	Tipo	Descrizione
defaultMetadata	AliasPathMetadata	Metadati del percorso alias predefiniti. Si applica al percorso predefinito e a qualsiasi percorso alias che non dispone di metadati
defaultPath	string	Percorso predefinito per un alias.
defaultPattern	AliasPattern	Modello predefinito per un alias.
name	string	Nome dell'alias.
paths	AliasPath[]	Percorsi di un alias.
type	AliasType	Tipo dell'alias.

AliasPath

Tipo dei percorsi per alias.

Nome	Tipo	Descrizione
apiVersions	string[]	Versioni dell'API.
metadata	AliasPathMetadata	Metadati del percorso alias. Se mancante, eseguire il fallback ai metadati predefiniti dell'alias.
path	string	Percorso di un alias.
pattern	AliasPattern	Modello per un percorso alias.

AliasPathAttributes

Attributi del token a cui fa riferimento il percorso alias.

Nome	Tipo	Descrizione
Modifiable	string	Il token a cui fa riferimento il percorso alias è modificabile dai criteri con effetto 'modify'.
None	string	Il token a cui fa riferimento il percorso alias non ha attributi.

AliasPathMetadata

Nome	Tipo	Descrizione
attributes	AliasPathAttributes	Attributi del token a cui fa riferimento il percorso alias.
type	AliasPathTokenType	Tipo di token a cui fa riferimento il percorso alias.

AliasPathTokenType

Tipo di token a cui fa riferimento il percorso alias.

Nome	Tipo	Descrizione
Any	string	Il tipo di token può essere qualsiasi elemento.
Array	string	Il tipo di token è matrice.
Boolean	string	Il tipo di token è booleano.
Integer	string	Il tipo di token è integer.
NotSpecified	string	Il tipo di token non è specificato.
Number	string	Il tipo di token è number.
Object	string	Il tipo di token è object.
String	string	Il tipo di token è string.

AliasPattern

Tipo del modello per un percorso alias.

Nome	Tipo	Descrizione
phrase	string	Frase del modello alias.
type	AliasPatternType	Tipo di modello di alias
variable	string	Variabile del pattern alias.

AliasPatternType

Tipo di modello di alias

Nome	Tipo	Descrizione
Extract	string	Extract è l'unico valore consentito.
NotSpecified	string	NotSpecified non è consentito.

AliasType

Tipo dell'alias.

Nome	Tipo	Descrizione
Mask	string	Il valore alias è secret.
NotSpecified	string	Il tipo di alias è sconosciuto (come non fornire il tipo di alias).
PlainText	string	Il valore alias non è segreto.

ApiProfile

Nome	Tipo	Descrizione
apiVersion	string	La versione delle API.
profileVersion	string	Versione del profilo.

BasicDependency

Informazioni sulle dipendenze della distribuzione.

Nome	Tipo	Descrizione
id	string	ID della dipendenza.
resourceName	string	Nome della risorsa di dipendenza.
resourceType	string	Tipo di risorsa di dipendenza.

CloudError

Risposta di errore per una richiesta di gestione delle risorse.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta di errore Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

DebugSetting

Impostazione di debug.

Nome	Tipo	Descrizione
detailLevel	string	Specifica il tipo di informazioni da registrare per il debug. I valori consentiti sono none, requestContent, responseContent o requestContent e responseContent separati da una virgola. Il valore predefinito è none. Quando si imposta questo valore, considerare attentamente il tipo di informazioni passate durante la distribuzione. La registrazione di informazioni sulla richiesta o sulla risposta può esporre dati riservati, che vengono recuperati tramite le operazioni di distribuzione.

Dependency

Informazioni sulle dipendenze della distribuzione.

Nome	Tipo	Descrizione
dependsOn	BasicDependency[]	Elenco di dipendenze.
id	string	ID della dipendenza.
resourceName	string	Nome della risorsa di dipendenza.
resourceType	string	Tipo di risorsa di dipendenza.

DeploymentExtended

Informazioni sulla distribuzione.

Nome	Tipo	Descrizione
id	string	ID della distribuzione.
location	string	percorso della distribuzione.
name	string	Nome della distribuzione.
properties	DeploymentPropertiesExtended	Proprietà della distribuzione.
tags	object	Tag di distribuzione
type	string	Tipo della distribuzione.

DeploymentMode

Modalità usata per distribuire le risorse. Questo valore può essere Incremental o Complete. Nella modalità incrementale, le risorse vengono distribuite senza eliminare le risorse esistenti non incluse nel modello. In modalità completa le risorse vengono distribuite e le risorse esistenti nel gruppo di risorse non incluse nel modello vengono eliminate. Prestare attenzione quando si usa la modalità Completa perché è possibile eliminare involontariamente le risorse.

Nome	Tipo	Descrizione
Complete	string
Incremental	string

DeploymentPropertiesExtended

Proprietà di distribuzione con dettagli aggiuntivi.

Nome	Tipo	Descrizione
correlationId	string	ID di correlazione della distribuzione.
debugSetting	DebugSetting	Impostazione di debug della distribuzione.
dependencies	Dependency[]	Elenco delle dipendenze della distribuzione.
duration	string	Durata della distribuzione del modello.
error	ErrorResponse	Risposta di errore Errore di distribuzione.
mode	DeploymentMode	Modalità di distribuzione. I valori possibili sono Incremental e Complete.
onErrorDeployment	OnErrorDeploymentExtended	Distribuzione in caso di comportamento degli errori.
outputResources	ResourceReference[]	Matrice di risorse di cui è stato effettuato il provisioning.
outputs	object	Coppie chiave/valore che rappresentano l'output della distribuzione.
parameters	object	Parametri di distribuzione.
parametersLink	ParametersLink	URI che fa riferimento ai parametri.
providers	Provider[]	Elenco dei provider di risorse necessari per la distribuzione.
provisioningState	ProvisioningState	Indica lo stato del provisioning.
templateHash	string	Hash prodotto per il modello.
templateLink	TemplateLink	URI che fa riferimento al modello.
timestamp	string	Timestamp della distribuzione del modello.
validatedResources	ResourceReference[]	Matrice di risorse convalidate.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorResponse[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

OnErrorDeploymentExtended

Distribuzione sul comportamento degli errori con dettagli aggiuntivi.

Nome	Tipo	Descrizione
deploymentName	string	Distribuzione da usare in caso di errore.
provisioningState	string	Stato del provisioning per la distribuzione degli errori.
type	OnErrorDeploymentType	Distribuzione sul tipo di comportamento degli errori. I valori possibili sono LastSuccessful e SpecificDeployment.

OnErrorDeploymentType

Distribuzione sul tipo di comportamento degli errori. I valori possibili sono LastSuccessful e SpecificDeployment.

Nome	Tipo	Descrizione
LastSuccessful	string
SpecificDeployment	string

ParametersLink

Entità che rappresenta il riferimento ai parametri di distribuzione.

Nome	Tipo	Descrizione
contentVersion	string	Se incluso, deve corrispondere a ContentVersion nel modello.
uri	string	URI del file di parametri.

Provider

Informazioni sul provider di risorse.

Nome	Tipo	Descrizione
id	string	ID del provider.
namespace	string	Spazio dei nomi del provider di risorse.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Stato di consenso dell'autorizzazione del provider.
registrationPolicy	string	Criteri di registrazione del provider di risorse.
registrationState	string	Stato di registrazione del provider di risorse.
resourceTypes	ProviderResourceType[]	Raccolta di tipi di risorse del provider.

ProviderAuthorizationConsentState

Stato di consenso dell'autorizzazione del provider.

Nome	Tipo	Descrizione
Consented	string
NotRequired	string
NotSpecified	string
Required	string

ProviderExtendedLocation

Posizione estesa del provider.

Nome	Tipo	Descrizione
extendedLocations	string[]	Località estese per la località di Azure.
location	string	Località di Azure.
type	string	Tipo di posizione estesa.

ProviderResourceType

Tipo di risorsa gestito dal provider di risorse.

Nome	Tipo	Descrizione
aliases	Alias[]	Alias supportati da questo tipo di risorsa.
apiProfiles	ApiProfile[]	Profili API per il provider di risorse.
apiVersions	string[]	La versione delle API.
capabilities	string	Funzionalità aggiuntive offerte da questo tipo di risorsa.
defaultApiVersion	string	Versione API predefinita.
locationMappings	ProviderExtendedLocation[]	Mapping dei percorsi supportati da questo tipo di risorsa.
locations	string[]	Raccolta di percorsi in cui è possibile creare questo tipo di risorsa.
properties	object	Proprietà.
resourceType	string	Tipo di risorsa.
zoneMappings	ZoneMapping[]

ProvisioningState

Indica lo stato del provisioning.

Nome	Tipo	Descrizione
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

Modello ID risorsa.

Nome	Tipo	Descrizione
id	string	ID risorsa completo.

TemplateLink

Entità che rappresenta il riferimento al modello.

Nome	Tipo	Descrizione
contentVersion	string	Se incluso, deve corrispondere a ContentVersion nel modello.
id	string	ID risorsa di una specifica di modello. Utilizzare la proprietà id o URI, ma non entrambi.
queryString	string	Stringa di query (ad esempio, un token di firma di accesso condiviso) da usare con l'URI templateLink.
relativePath	string	La proprietà relativePath può essere utilizzata per distribuire un modello collegato in una posizione relativa all'elemento padre. Se il modello padre è stato collegato a un oggetto TemplateSpec, questo farà riferimento a un artefatto in TemplateSpec. Se l'elemento padre è stato collegato a un URI, la distribuzione figlio sarà una combinazione degli URI padre e relativePath
uri	string	URI del modello da distribuire. Usare l'URI o la proprietà ID, ma non entrambi.

ZoneMapping

Nome	Tipo	Descrizione
location	string	Posizione del mapping della zona.
zones	string[]