Deployments - Create Or Update At Management Group Scope
Distribuisce le risorse nell'ambito del gruppo di gestione.
È possibile specificare il modello e i parametri direttamente nella richiesta o nel collegamento ai file JSON.
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
deployment
|
path | True |
string minLength: 1maxLength: 64 pattern: ^[-\w\._\(\)]+$ |
Nome della distribuzione. |
group
|
path | True |
string minLength: 1maxLength: 90 |
ID del gruppo di gestione. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
location | True |
string |
Percorso in cui archiviare i dati di distribuzione. |
properties | True |
Proprietà di distribuzione. |
|
tags |
object |
Tag di distribuzione |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK: restituisce informazioni sulla distribuzione, incluso lo stato del provisioning. |
|
201 Created |
Creato: restituisce informazioni sulla distribuzione, incluso lo stato del provisioning. |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
Create deployment at management group scope.
Esempio di richiesta
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Resources/deployments/my-deployment?api-version=2021-04-01
{
"location": "eastus",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json"
},
"parameters": {},
"mode": "Incremental"
}
}
Risposta di esempio
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"location": "eastus",
"properties": {
"parameters": {},
"mode": "Incremental",
"provisioningState": "Accepted",
"timestamp": "2019-04-24T22:52:38.7895563Z",
"duration": "PT1.2970875S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Authorization",
"resourceTypes": [
{
"resourceType": "policyDefinitions",
"locations": [
null
]
},
{
"resourceType": "policyAssignments",
"locations": [
null
]
}
]
},
{
"namespace": "Microsoft.Resources",
"resourceTypes": [
{
"resourceType": "deployments",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyDefinitions/policy-definition-name",
"resourceType": "Microsoft.Authorization/policyDefinitions",
"resourceName": "policy-definition-name"
}
],
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyAssignments/location-lock",
"resourceType": "Microsoft.Authorization/policyAssignments",
"resourceName": "location-lock"
}
]
}
}
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"location": "eastus",
"properties": {
"parameters": {},
"mode": "Incremental",
"provisioningState": "Accepted",
"timestamp": "2019-04-24T22:52:38.7895563Z",
"duration": "PT1.2970875S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Authorization",
"resourceTypes": [
{
"resourceType": "policyDefinitions",
"locations": [
null
]
},
{
"resourceType": "policyAssignments",
"locations": [
null
]
}
]
},
{
"namespace": "Microsoft.Resources",
"resourceTypes": [
{
"resourceType": "deployments",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyDefinitions/policy-definition-name",
"resourceType": "Microsoft.Authorization/policyDefinitions",
"resourceName": "policy-definition-name"
}
],
"id": "/providers/Microsoft.Management/managementGroups/my-management-group-id/providers/Microsoft.Authorization/policyAssignments/location-lock",
"resourceType": "Microsoft.Authorization/policyAssignments",
"resourceName": "location-lock"
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Alias |
Tipo di alias. |
Alias |
Tipo dei percorsi per alias. |
Alias |
Attributi del token a cui fa riferimento il percorso alias. |
Alias |
|
Alias |
Tipo del token a cui fa riferimento il percorso alias. |
Alias |
Tipo del modello per un percorso alias. |
Alias |
Tipo di pattern alias |
Alias |
Tipo dell'alias. |
Api |
|
Basic |
Informazioni sulle dipendenze della distribuzione. |
Cloud |
Risposta di errore per una richiesta di gestione delle risorse. |
Debug |
Impostazione di debug. |
Dependency |
Informazioni sulle dipendenze della distribuzione. |
Deployment |
Informazioni sulla distribuzione. |
Deployment |
Modalità utilizzata per distribuire le risorse. Questo valore può essere Incremental o Complete. In 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. |
Deployment |
Proprietà di distribuzione. |
Deployment |
Proprietà di distribuzione con dettagli aggiuntivi. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Risposta errore |
Expression |
Specifica se le espressioni modello vengono valutate nell'ambito del modello padre o del modello annidato. |
Expression |
Ambito da usare per la valutazione di parametri, variabili e funzioni in un modello annidato. |
On |
Distribuzione in caso di comportamento degli errori. |
On |
Distribuzione sul comportamento degli errori con dettagli aggiuntivi. |
On |
Distribuzione sul tipo di comportamento degli errori. I valori possibili sono LastSuccessful e SpecificDeployment. |
Parameters |
Entità che rappresenta il riferimento ai parametri di distribuzione. |
Provider |
Informazioni sul provider di risorse. |
Provider |
Stato di consenso dell'autorizzazione del provider. |
Provider |
Posizione estesa del provider. |
Provider |
Tipo di risorsa gestito dal provider di risorse. |
Provisioning |
Indica lo stato del provisioning. |
Resource |
Modello id risorsa. |
Scoped |
Parametri dell'operazione di distribuzione. |
Template |
Entità che rappresenta il riferimento al modello. |
Zone |
Alias
Tipo di alias.
Nome | Tipo | Descrizione |
---|---|---|
defaultMetadata |
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 |
Modello predefinito per un alias. |
|
name |
string |
Nome alias. |
paths |
Percorsi di un alias. |
|
type |
Tipo dell'alias. |
AliasPath
Tipo dei percorsi per alias.
Nome | Tipo | Descrizione |
---|---|---|
apiVersions |
string[] |
Versioni dell'API. |
metadata |
Metadati del percorso alias. Se mancante, eseguire il fallback ai metadati predefiniti dell'alias. |
|
path |
string |
Percorso di un alias. |
pattern |
Modello per un percorso alias. |
AliasPathAttributes
Attributi del token a cui fa riferimento il percorso alias.
Valore | Descrizione |
---|---|
Modifiable |
Il token a cui fa riferimento il percorso alias è modificabile dai criteri con effetto 'modify'. |
None |
Il token a cui fa riferimento il percorso alias non ha attributi. |
AliasPathMetadata
Nome | Tipo | Descrizione |
---|---|---|
attributes |
Attributi del token a cui fa riferimento il percorso alias. |
|
type |
Tipo del token a cui fa riferimento il percorso alias. |
AliasPathTokenType
Tipo del token a cui fa riferimento il percorso alias.
Valore | Descrizione |
---|---|
Any |
Il tipo di token può essere qualsiasi elemento. |
Array |
Il tipo di token è array. |
Boolean |
Il tipo di token è booleano. |
Integer |
Il tipo di token è integer. |
NotSpecified |
Il tipo di token non è specificato. |
Number |
Il tipo di token è number. |
Object |
Il tipo di token è object. |
String |
Il tipo di token è string. |
AliasPattern
Tipo del modello per un percorso alias.
Nome | Tipo | Descrizione |
---|---|---|
phrase |
string |
Frase del criterio alias. |
type |
Tipo di pattern alias |
|
variable |
string |
Variabile del pattern alias. |
AliasPatternType
Tipo di pattern alias
Valore | Descrizione |
---|---|
Extract |
Extract è l'unico valore consentito. |
NotSpecified |
NotSpecified non è consentito. |
AliasType
Tipo dell'alias.
Valore | Descrizione |
---|---|
Mask |
Il valore alias è segreto. |
NotSpecified |
Il tipo di alias è sconosciuto (uguale a non fornire il tipo di alias). |
PlainText |
Il valore alias non è segreto. |
ApiProfile
Nome | Tipo | Descrizione |
---|---|---|
apiVersion |
string |
Versione dell'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 |
Risposta errore |
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 è nessuno. Quando si imposta questo valore, considerare attentamente il tipo di informazioni passate durante la distribuzione. Registrando informazioni sulla richiesta o sulla risposta, è possibile esporre dati sensibili recuperati tramite le operazioni di distribuzione. |
Dependency
Informazioni sulle dipendenze della distribuzione.
Nome | Tipo | Descrizione |
---|---|---|
dependsOn |
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 |
Proprietà di distribuzione. |
|
tags |
object |
Tag di distribuzione |
type |
string |
Tipo di distribuzione. |
DeploymentMode
Modalità utilizzata per distribuire le risorse. Questo valore può essere Incremental o Complete. In 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.
Valore | Descrizione |
---|---|
Complete | |
Incremental |
DeploymentProperties
Proprietà di distribuzione.
Nome | Tipo | Descrizione |
---|---|---|
debugSetting |
Impostazione di debug della distribuzione. |
|
expressionEvaluationOptions |
Specifica se le espressioni modello vengono valutate nell'ambito del modello padre o del modello annidato. Applicabile solo ai modelli annidati. Se non specificato, il valore predefinito è esterno. |
|
mode |
Modalità utilizzata per distribuire le risorse. Questo valore può essere Incremental o Complete. In 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. |
|
onErrorDeployment |
Distribuzione in caso di comportamento dell'errore. |
|
parameters |
object |
Coppie nome e valore che definiscono i parametri di distribuzione per il modello. Questo elemento viene usato quando si desidera specificare i valori dei parametri direttamente nella richiesta anziché collegarsi a un file di parametri esistente. Utilizzare la proprietà parametersLink o la proprietà parameters, ma non entrambe. Può essere un JObject o una stringa JSON ben formata. |
parametersLink |
URI del file di parametri. Questo elemento viene usato per collegarsi a un file di parametri esistente. Utilizzare la proprietà parametersLink o la proprietà parameters, ma non entrambe. |
|
template |
object |
Contenuto del modello. Questo elemento viene usato quando si vuole passare la sintassi del modello direttamente nella richiesta anziché collegarsi a un modello esistente. Può trattarsi di una stringa JSON JObject o di formato corretto. Usare la proprietà templateLink o la proprietà del modello, ma non entrambe. |
templateLink |
URI del modello. Usare la proprietà templateLink o la proprietà del modello, ma non entrambe. |
DeploymentPropertiesExtended
Proprietà di distribuzione con dettagli aggiuntivi.
Nome | Tipo | Descrizione |
---|---|---|
correlationId |
string |
ID di correlazione della distribuzione. |
debugSetting |
Impostazione di debug della distribuzione. |
|
dependencies |
Elenco delle dipendenze di distribuzione. |
|
duration |
string |
Durata della distribuzione del modello. |
error |
Risposta errore |
|
mode |
Modalità di distribuzione. I valori possibili sono Incremental e Complete. |
|
onErrorDeployment |
Distribuzione in caso di comportamento dell'errore. |
|
outputResources |
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 |
URI che fa riferimento ai parametri. |
|
providers |
Provider[] |
Elenco dei provider di risorse necessari per la distribuzione. |
provisioningState |
Indica lo stato del provisioning. |
|
templateHash |
string |
Hash prodotto per il modello. |
templateLink |
URI che fa riferimento al modello. |
|
timestamp |
string (date-time) |
Timestamp della distribuzione del modello. |
validatedResources |
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 errore
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ExpressionEvaluationOptions
Specifica se le espressioni modello vengono valutate nell'ambito del modello padre o del modello annidato.
Nome | Tipo | Descrizione |
---|---|---|
scope |
Ambito da usare per la valutazione di parametri, variabili e funzioni in un modello annidato. |
ExpressionEvaluationOptionsScopeType
Ambito da usare per la valutazione di parametri, variabili e funzioni in un modello annidato.
Valore | Descrizione |
---|---|
Inner | |
NotSpecified | |
Outer |
OnErrorDeployment
Distribuzione in caso di comportamento degli errori.
Nome | Tipo | Descrizione |
---|---|---|
deploymentName |
string |
Distribuzione da usare in caso di errore. |
type |
Distribuzione sul tipo di comportamento degli errori. I valori possibili sono LastSuccessful e SpecificDeployment. |
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 |
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.
Valore | Descrizione |
---|---|
LastSuccessful | |
SpecificDeployment |
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 provider. |
namespace |
string |
Spazio dei nomi del provider di risorse. |
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 |
Raccolta di tipi di risorse del provider. |
ProviderAuthorizationConsentState
Stato di consenso dell'autorizzazione del provider.
Valore | Descrizione |
---|---|
Consented | |
NotRequired | |
NotSpecified | |
Required |
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 |
Profili API per il provider di risorse. |
|
apiVersions |
string[] |
Versione dell'API. |
capabilities |
string |
Funzionalità aggiuntive offerte da questo tipo di risorsa. |
defaultApiVersion |
string |
Versione dell'API predefinita. |
locationMappings |
Mapping dei percorsi supportati da questo tipo di risorsa. |
|
locations |
string[] |
Raccolta di posizioni in cui è possibile creare questo tipo di risorsa. |
properties |
object |
Proprietà. |
resourceType |
string |
Tipo di risorsa. |
zoneMappings |
ProvisioningState
Indica lo stato del provisioning.
Valore | Descrizione |
---|---|
Accepted | |
Canceled | |
Created | |
Creating | |
Deleted | |
Deleting | |
Failed | |
NotSpecified | |
Ready | |
Running | |
Succeeded | |
Updating |
ResourceReference
Modello id risorsa.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa completo. |
ScopedDeployment
Parametri dell'operazione di distribuzione.
Nome | Tipo | Descrizione |
---|---|---|
location |
string |
Percorso in cui archiviare i dati di distribuzione. |
properties |
Proprietà di distribuzione. |
|
tags |
object |
Tag di distribuzione |
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, verrà fatto riferimento a un artefatto in TemplateSpec. Se l'elemento padre è stato collegato con 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[] |