Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Osservazioni:
Per Bicep, prendere in considerazione l'uso di moduli invece di questo tipo di risorsa.
Definizione di risorsa Bicep
Il tipo di risorsa delle distribuzioni può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Esempi di utilizzo
Esempi di Bicep
Esempio di base di distribuzione della distribuzione di modelli.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource deployment 'Microsoft.Resources/deployments@2020-06-01' = {
name: resourceName
properties: {
mode: 'Complete'
template: {
'$schema': 'https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#'
contentVersion: '1.0.0.0'
parameters: {
storageAccountType: {
allowedValues: [
'Standard_LRS'
'Standard_GRS'
'Standard_ZRS'
]
defaultValue: 'Standard_LRS'
metadata: {
description: 'Storage Account type'
}
type: 'string'
}
}
resources: [
{
apiVersion: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
name: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
properties: {
accountType: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
}
type: 'Microsoft.Storage/storageAccounts'
}
{
apiVersion: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
name: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
properties: {
dnsSettings: {
domainNameLabel: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
}
publicIPAllocationMethod: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
}
type: 'Microsoft.Network/publicIPAddresses'
}
]
variables: {
apiVersion: '2015-06-15'
dnsLabelPrefix: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
publicIPAddressName: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
publicIPAddressType: 'Dynamic'
storageAccountName: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
}
}
}
}
Formato risorsa
Per creare una risorsa Microsoft.Resources/deployments, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Resources/deployments@2017-05-10' = {
name: 'string'
properties: {
debugSetting: {
detailLevel: 'string'
}
mode: 'string'
parameters: any(...)
parametersLink: {
contentVersion: 'string'
uri: 'string'
}
template: any(...)
templateLink: {
contentVersion: 'string'
uri: 'string'
}
}
}
Valori delle proprietà
Microsoft.Resources/deployments
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 1 Lunghezza massima = 64 Pattern = ^[-\w\._\(\)]+$ (obbligatorio) |
| proprietà | Proprietà di distribuzione. | DeploymentPropertiesOrDeploymentPropertiesExtended (obbligatorio) |
Impostazione di debug
| Nome | Descrizione | Valore |
|---|---|---|
| dettaglioLivello | 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. | corda |
DeploymentPropertiesOrDeploymentPropertiesExtended
| Nome | Descrizione | Valore |
|---|---|---|
| debugSetting | Impostazione di debug della distribuzione. | Impostazione di debug |
| modalità | 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. | 'Completo' 'Incremental' (obbligatorio) |
| Parametri | 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. | qualunque |
| parametriCollegamento | 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. | ParametriLink |
| modello | 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. | qualunque |
| modelloCollegamento | URI del modello. Usare la proprietà templateLink o la proprietà del modello, ma non entrambe. | Collegamento al modello |
ParametriLink
| Nome | Descrizione | Valore |
|---|---|---|
| versione del contenuto | Se incluso, deve corrispondere a ContentVersion nel modello. | corda |
| URI | URI del file di parametri. | stringa (obbligatorio) |
Collegamento al modello
| Nome | Descrizione | Valore |
|---|---|---|
| versione del contenuto | Se incluso, deve corrispondere a ContentVersion nel modello. | corda |
| URI | URI del modello da distribuire. | stringa (obbligatorio) |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa delle distribuzioni può essere distribuito con operazioni destinate a:
- Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.
Esempi di utilizzo
Formato risorsa
Per creare una risorsa Microsoft.Resources/deployments, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.Resources/deployments",
"apiVersion": "2017-05-10",
"name": "string",
"properties": {
"debugSetting": {
"detailLevel": "string"
},
"mode": "string",
"parameters": {},
"parametersLink": {
"contentVersion": "string",
"uri": "string"
},
"template": {},
"templateLink": {
"contentVersion": "string",
"uri": "string"
}
}
}
Valori delle proprietà
Microsoft.Resources/deployments
| Nome | Descrizione | Valore |
|---|---|---|
| versione dell'API | Versione dell'API | '2017-05-10' |
| nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 1 Lunghezza massima = 64 Pattern = ^[-\w\._\(\)]+$ (obbligatorio) |
| proprietà | Proprietà di distribuzione. | DeploymentPropertiesOrDeploymentPropertiesExtended (obbligatorio) |
| tipo | Tipo di risorsa | 'Microsoft.Resources/deployments' |
Impostazione di debug
| Nome | Descrizione | Valore |
|---|---|---|
| dettaglioLivello | 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. | corda |
DeploymentPropertiesOrDeploymentPropertiesExtended
| Nome | Descrizione | Valore |
|---|---|---|
| debugSetting | Impostazione di debug della distribuzione. | Impostazione di debug |
| modalità | 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. | 'Completo' 'Incremental' (obbligatorio) |
| Parametri | 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. | qualunque |
| parametriCollegamento | 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. | ParametriLink |
| modello | 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. | qualunque |
| modelloCollegamento | URI del modello. Usare la proprietà templateLink o la proprietà del modello, ma non entrambe. | Collegamento al modello |
ParametriLink
| Nome | Descrizione | Valore |
|---|---|---|
| versione del contenuto | Se incluso, deve corrispondere a ContentVersion nel modello. | corda |
| URI | URI del file di parametri. | stringa (obbligatorio) |
Collegamento al modello
| Nome | Descrizione | Valore |
|---|---|---|
| versione del contenuto | Se incluso, deve corrispondere a ContentVersion nel modello. | corda |
| URI | URI del modello da distribuire. | stringa (obbligatorio) |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa delle distribuzioni può essere distribuito con operazioni destinate a:
- Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.
Esempi di utilizzo
Esempi di Terraform
Esempio di base di distribuzione della distribuzione di modelli.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "deployment" {
type = "Microsoft.Resources/deployments@2020-06-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
body = {
properties = {
mode = "Complete"
template = {
"$schema" = "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#"
contentVersion = "1.0.0.0"
parameters = {
storageAccountType = {
allowedValues = [
"Standard_LRS",
"Standard_GRS",
"Standard_ZRS",
]
defaultValue = "Standard_LRS"
metadata = {
description = "Storage Account type"
}
type = "string"
}
}
resources = [
{
apiVersion = "[variables('apiVersion')]"
location = "[variables('location')]"
name = "[variables('storageAccountName')]"
properties = {
accountType = "[parameters('storageAccountType')]"
}
type = "Microsoft.Storage/storageAccounts"
},
{
apiVersion = "[variables('apiVersion')]"
location = "[variables('location')]"
name = "[variables('publicIPAddressName')]"
properties = {
dnsSettings = {
domainNameLabel = "[variables('dnsLabelPrefix')]"
}
publicIPAllocationMethod = "[variables('publicIPAddressType')]"
}
type = "Microsoft.Network/publicIPAddresses"
},
]
variables = {
apiVersion = "2015-06-15"
dnsLabelPrefix = "[concat('terraform-tdacctest', uniquestring(resourceGroup().id))]"
location = "[resourceGroup().location]"
publicIPAddressName = "[concat('myPublicIp', uniquestring(resourceGroup().id))]"
publicIPAddressType = "Dynamic"
storageAccountName = "[concat(uniquestring(resourceGroup().id), 'storage')]"
}
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Formato risorsa
Per creare una risorsa Microsoft.Resources/deployments, aggiungere il codice Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Resources/deployments@2017-05-10"
name = "string"
parent_id = "string"
body = {
properties = {
debugSetting = {
detailLevel = "string"
}
mode = "string"
parameters = ?
parametersLink = {
contentVersion = "string"
uri = "string"
}
template = ?
templateLink = {
contentVersion = "string"
uri = "string"
}
}
}
}
Valori delle proprietà
Microsoft.Resources/deployments
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Nome della risorsa | corda Vincoli: Lunghezza minima = 1 Lunghezza massima = 64 Pattern = ^[-\w\._\(\)]+$ (obbligatorio) |
| proprietà | Proprietà di distribuzione. | DeploymentPropertiesOrDeploymentPropertiesExtended (obbligatorio) |
| tipo | Tipo di risorsa | "Microsoft.Resources/deployments@2017-05-10" |
Impostazione di debug
| Nome | Descrizione | Valore |
|---|---|---|
| dettaglioLivello | 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. | corda |
DeploymentPropertiesOrDeploymentPropertiesExtended
| Nome | Descrizione | Valore |
|---|---|---|
| debugSetting | Impostazione di debug della distribuzione. | Impostazione di debug |
| modalità | 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. | 'Completo' 'Incremental' (obbligatorio) |
| Parametri | 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. | qualunque |
| parametriCollegamento | 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. | ParametriLink |
| modello | 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. | qualunque |
| modelloCollegamento | URI del modello. Usare la proprietà templateLink o la proprietà del modello, ma non entrambe. | Collegamento al modello |
ParametriLink
| Nome | Descrizione | Valore |
|---|---|---|
| versione del contenuto | Se incluso, deve corrispondere a ContentVersion nel modello. | corda |
| URI | URI del file di parametri. | stringa (obbligatorio) |
Collegamento al modello
| Nome | Descrizione | Valore |
|---|---|---|
| versione del contenuto | Se incluso, deve corrispondere a ContentVersion nel modello. | corda |
| URI | URI del modello da distribuire. | stringa (obbligatorio) |