Microsoft.Sql managedInstances 2023-05-01-preview
- Più recente
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
Definizione di risorsa Bicep
Il tipo di risorsa managedInstances può essere distribuito con operazioni destinate:
- Gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Sql/managedInstances, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Sql/managedInstances@2023-05-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
administrators: {
administratorType: 'ActiveDirectory'
azureADOnlyAuthentication: bool
login: 'string'
principalType: 'string'
sid: 'string'
tenantId: 'string'
}
authenticationMetadata: 'string'
collation: 'string'
databaseFormat: 'string'
dnsZonePartner: 'string'
hybridSecondaryUsage: 'string'
instancePoolId: 'string'
isGeneralPurposeV2: bool
keyId: 'string'
licenseType: 'string'
maintenanceConfigurationId: 'string'
managedInstanceCreateMode: 'string'
minimalTlsVersion: 'string'
pricingModel: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
restorePointInTime: 'string'
servicePrincipal: {
type: 'string'
}
sourceManagedInstanceId: 'string'
storageIOps: int
storageSizeInGB: int
storageThroughputMBps: int
subnetId: 'string'
timezoneId: 'string'
vCores: int
zoneRedundant: bool
}
}
Valori delle proprietà
managedInstances
Nome | Descrizione | valore |
---|---|---|
name | Nome della risorsa | stringa (obbligatoria) Limite di caratteri: 1-63 Caratteri validi: Lettere minuscole, numeri e trattini. Non può iniziare o terminare con un trattino. Il nome della risorsa deve essere univoco in Azure. |
posizione | Percorso della risorsa. | stringa (obbligatoria) |
tags | Tag di risorse. | Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli |
sku | SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
identity | Identità di Azure Active Directory dell'istanza gestita. | ResourceIdentity |
properties | Proprietà delle risorse. | ManagedInstanceProperties |
ResourceIdentity
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. | 'Nessuno' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | ID risorsa delle identità assegnate dall'utente da usare | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
Nome | Descrizione | Valore |
---|---|---|
{proprietà personalizzata} | UserIdentity |
UserIdentity
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
ManagedInstanceProperties
Nome | Descrizione | Valore |
---|---|---|
administratorLogin | Nome utente amministratore per l'istanza gestita. È possibile specificare solo quando l'istanza gestita viene creata (ed è necessaria per la creazione). | string |
administratorLoginPassword | Password di accesso amministratore (richiesta per la creazione di istanze gestite). | string Vincoli: Valore sensibile. Passare come parametro sicuro. |
amministratori | Amministratore di Azure Active Directory dell'istanza. Questa operazione può essere usata solo in fase di creazione dell'istanza. Se usato per l'aggiornamento dell'istanza, verrà ignorato o verrà generato un errore. Per gli aggiornamenti delle singole API sarà necessario usare. | ManagedInstanceExternalAdministrator |
authenticationMetadata | Modalità di ricerca dei metadati di autenticazione dell'istanza gestita. | 'AzureAD' 'Associato' 'Windows' |
collation | Regole di confronto dell'istanza gestita. | string |
databaseFormat | Specifica il formato interno dei database di istanza specifici della versione del motore SQL. | 'AlwaysUpToDate' 'SQLServer2022' |
dnsZonePartner | ID risorsa di un'altra istanza gestita la cui zona DNS verrà condivisa dopo la creazione. | string |
hybridSecondaryUsage | Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passivo" (il cliente usa il database secondario come ripristino di emergenza passivo). | 'Attivo' 'Passivo' |
instancePoolId | Id del pool di istanze a cui appartiene questo server gestito. | string |
isGeneralPurposeV2 | Indipendentemente dal fatto che si tratti di una variante GPv2 di per utilizzo generico edizione. | bool |
keyId | URI CMK della chiave da usare per la crittografia. | string |
licenseType | Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo normale incluso di una nuova licenza SQL) e 'BasePrice' (prezzo AHB scontato per portare le proprie licenze SQL). | 'BasePrice' 'LicenseIncluded' |
maintenanceConfigurationId | Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita. | string |
managedInstanceCreateMode | Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId. |
Impostazione predefinita 'PointInTimeRestore' |
minimalTlsVersion | Versione TLS minima. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2' | string |
pricingModel | Il tempo o meno Istanza gestita è freemium. | 'Freemium' 'Regolare' |
primaryUserAssignedIdentityId | ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita. | string |
proxyOverride | Tipo di connessione usato per la connessione all'istanza. | Impostazione predefinita 'Proxy' 'Reindirizzamento' |
publicDataEndpointEnabled | Se l'endpoint dati pubblico è abilitato o meno. | bool |
requestedBackupStorageRedundancy | Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorePointInTime | Specifica il tempo (ISO8601 formato) del database di origine che verrà ripristinato per creare il nuovo database. | string |
servicePrincipal | Entità servizio dell'istanza gestita. | ServicePrincipal |
sourceManagedInstanceId | Identificatore di risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza. | string |
storageIOps | Operazioni di IOps di archiviazione. Valore minimo: 120. Valore massimo: 120000. Incrementi di 1 operazioni di IOps consentite solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore. | INT |
storageSizeInGB | Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 16384. Incrementi di 32 GB consentiti solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore. | INT |
storageThroughputMBps | Velocità effettiva di archiviazione in MBps. Valore minimo: 25. Valore massimo: 4000. Incrementi di 1 MBps consentiti solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore. | INT |
subnetId | ID risorsa subnet per l'istanza gestita. | string |
timezoneId | ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows mantiene i dettagli sui fuso orario supportati, inclusi l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere tali valori del Registro di sistema tramite SQL Server eseguendo query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora standard dell'Europa". |
string |
vCore | Numero di vCore. Valori consentiti: 8, 16, 24, 32, 40, 64, 80. | INT |
zoneRedundant | Se il multi-az è abilitato o meno. | bool |
ManagedInstanceExternalAdministrator
Nome | Descrizione | Valore |
---|---|---|
administratorType | Tipo dell'amministratore di sever. | 'ActiveDirectory' |
azureADOnlyAuthentication | Solo autenticazione di Azure Active Directory abilitata. | bool |
login | Nome di accesso dell'amministratore del server. | string |
principalType | Tipo di entità dell'amministratore di sever. | 'Applicazione' 'Group' 'User' |
sid | SID (ID oggetto) dell'amministratore del server. | string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
TenantId | ID tenant dell'amministratore. | string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ServicePrincipal
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di entità servizio. | 'Nessuno' 'SystemAssigned' |
Sku
Nome | Descrizione | Valore |
---|---|---|
capacità | Capacità dello SKU specifico. | INT |
famiglia | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. | string |
name | Il nome dello SKU, in genere, una lettera + Codice Numero, ad esempio P3. | stringa (obbligatoria) |
size | Dimensioni dello SKU specifico | string |
Livello | Livello o edizione dello SKU specifico, ad esempio Basic, Premium. | string |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Modello | Descrizione |
---|---|
Distribuire Istanza gestita di SQL con rete |
Distribuire UDR e NSG per supportare Istanza gestita di SQL di Azure e distribuire l'Istanza gestita |
Creare un'interfaccia di rete virtuale di SQL all'interno della nuova rete virtuale |
Distribuire database SQL di Azure Istanza gestita (SQL MI) all'interno di nuove Rete virtuale. |
Creare l'interfaccia utente di SQL con l'invio di log e metriche configurate |
Questo modello consente di distribuire MI SQL e risorse aggiuntive usate per archiviare log e metriche (area di lavoro di diagnostica, account di archiviazione, hub eventi). |
Creare un'istanza di SQL MI con jumpbox all'interno di una nuova rete virtuale |
Distribuire database SQL di Azure Istanza gestita (SQL MI) e JumpBox con SSMS all'interno di nuove Rete virtuale. |
Creare un'istanza di SQL MI con connessione da punto a sito configurata |
Distribuire database SQL di Azure Istanza gestita (SQL MI) e gateway di rete virtuale configurato per la connessione da punto a sito all'interno della nuova rete virtuale. |
Definizione della risorsa modello di Resource Manager
Il tipo di risorsa managedInstances può essere distribuito con operazioni destinate:
- Gruppi di risorse - Vedere i comandi di distribuzione dei gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Sql/managedInstances, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2023-05-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"administratorLogin": "string",
"administratorLoginPassword": "string",
"administrators": {
"administratorType": "ActiveDirectory",
"azureADOnlyAuthentication": "bool",
"login": "string",
"principalType": "string",
"sid": "string",
"tenantId": "string"
},
"authenticationMetadata": "string",
"collation": "string",
"databaseFormat": "string",
"dnsZonePartner": "string",
"hybridSecondaryUsage": "string",
"instancePoolId": "string",
"isGeneralPurposeV2": "bool",
"keyId": "string",
"licenseType": "string",
"maintenanceConfigurationId": "string",
"managedInstanceCreateMode": "string",
"minimalTlsVersion": "string",
"pricingModel": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"restorePointInTime": "string",
"servicePrincipal": {
"type": "string"
},
"sourceManagedInstanceId": "string",
"storageIOps": "int",
"storageSizeInGB": "int",
"storageThroughputMBps": "int",
"subnetId": "string",
"timezoneId": "string",
"vCores": "int",
"zoneRedundant": "bool"
}
}
Valori delle proprietà
managedInstances
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di risorsa | 'Microsoft.Sql/managedInstances' |
apiVersion | Versione dell'API della risorsa | '2023-05-01-preview' |
name | Nome della risorsa | stringa (obbligatorio) Limite di caratteri: 1-63 Caratteri validi: Lettere minuscole, numeri e trattini. Non può iniziare o terminare con un trattino. Il nome della risorsa deve essere univoco in Azure. |
posizione | Percorso della risorsa. | stringa (obbligatorio) |
tags | Tag delle risorse. | Dizionario di nomi e valori di tag. Vedere Tag nei modelli |
sku | SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
identity | Identità di Azure Active Directory dell'istanza gestita. | ResourceIdentity |
properties | Proprietà delle risorse. | ManagedInstanceProperties |
ResourceIdentity
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. | 'Nessuno' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | ID risorsa delle identità assegnate dall'utente da usare | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
Nome | Descrizione | Valore |
---|---|---|
{proprietà personalizzata} | UserIdentity |
UserIdentity
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
ManagedInstanceProperties
Nome | Descrizione | Valore |
---|---|---|
administratorLogin | Nome utente amministratore per l'istanza gestita. Può essere specificato solo quando viene creata l'istanza gestita ed è necessaria per la creazione. | string |
administratorLoginPassword | Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita). | string Vincoli: Valore sensibile. Passare come parametro sicuro. |
amministratori | Amministratore di Azure Active Directory dell'istanza. Questa opzione può essere usata solo in fase di creazione dell'istanza. Se usato per l'aggiornamento dell'istanza, verrà ignorato o verrà generato un errore. Per gli aggiornamenti è necessario usare le singole API. | ManagedInstanceExternalAdministrator |
authenticationMetadata | Modalità di ricerca dei metadati di autenticazione dell'istanza gestita. | 'AzureAD' 'Abbinato' 'Windows' |
collation | Regole di confronto dell'istanza gestita. | string |
databaseFormat | Specifica il formato interno dei database di istanza specifici della versione del motore SQL. | 'AlwaysUpToDate' 'SQLServer2022' |
dnsZonePartner | ID risorsa di un'altra istanza gestita la cui zona DNS questa istanza gestita condividerà dopo la creazione. | string |
hybridSecondaryUsage | Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passive" (il cliente usa il database secondario come ripristino di emergenza passivo). | 'Attivo' 'Passivo' |
instancePoolId | ID del pool di istanze a cui appartiene il server gestito. | string |
isGeneralPurposeV2 | Indica se si tratta di una variante GPv2 di per utilizzo generico edizione. | bool |
keyId | URI cmk della chiave da usare per la crittografia. | string |
licenseType | Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL). | 'BasePrice' 'LicenseIncluded' |
maintenanceConfigurationId | Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita. | string |
managedInstanceCreateMode | Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId. |
Impostazione predefinita 'PointInTimeRestore' |
minimalTlsVersion | Versione minima di TLS. Valori consentiti: 'None', '1.0', '1.1', '1.2' | string |
pricingModel | Meteo o non Istanza gestita è freemium. | 'Freemium' 'Regular' |
primaryUserAssignedIdentityId | ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita. | string |
proxyOverride | Tipo di connessione utilizzato per la connessione all'istanza di . | Impostazione predefinita 'Proxy' 'Redirect' |
publicDataEndpointEnabled | Indica se l'endpoint dati pubblico è abilitato o meno. | bool |
requestedBackupStorageRedundancy | Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorePointInTime | Specifica il punto nel tempo (ISO8601 formato) del database di origine che verrà ripristinato per creare il nuovo database. | string |
servicePrincipal | Entità servizio dell'istanza gestita. | ServicePrincipal |
sourceManagedInstanceId | Identificatore della risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza. | string |
storageIOps | Operazioni di I/O al secondo di archiviazione. Valore minimo: 120. Valore massimo: 120000. Incrementi di 1 operazioni di I/O al secondo consentite solo. Il valore massimo dipende dalla famiglia di hardware selezionata e dal numero di vCore. | INT |
storageSizeInGB | Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 16384. Incrementi di 32 GB consentiti solo. Il valore massimo dipende dalla famiglia di hardware selezionata e dal numero di vCore. | INT |
storageThroughputMBps | Velocità effettiva di archiviazione in MBps. Valore minimo: 25. Valore massimo: 4000. Incrementi di 1 MBps consentiti solo. Il valore massimo dipende dalla famiglia di hardware selezionata e dal numero di vCore. | INT |
subnetId | ID risorsa subnet per l'istanza gestita. | string |
timezoneId | ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows mantiene i dettagli sui fusi orari supportati, incluso l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere tali valori del Registro di sistema tramite SQL Server eseguendo una query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora solare europa". |
string |
vCore | Numero di vCore. Valori consentiti: 8, 16, 24, 32, 40, 64, 80. | INT |
zoneRedundant | Indica se multi-az è abilitato o meno. | bool |
ManagedInstanceExternalAdministrator
Nome | Descrizione | Valore |
---|---|---|
administratorType | Tipo di amministratore del server. | 'ActiveDirectory' |
azureADOnlyAuthentication | Autenticazione di Azure Active Directory abilitata solo. | bool |
login | Nome di accesso dell'amministratore del server. | string |
principalType | Tipo di entità dell'amministratore del server. | 'Application' 'Group' 'User' |
sid | SID (ID oggetto) dell'amministratore del server. | string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
TenantId | ID tenant dell'amministratore. | string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ServicePrincipal
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di entità servizio. | 'Nessuno' 'SystemAssigned' |
Sku
Nome | Descrizione | Valore |
---|---|---|
capacità | Capacità dello SKU specifico. | INT |
famiglia | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, può essere acquisito qui. | string |
name | Nome dello SKU, in genere una lettera + codice numerico, ad esempio P3. | stringa (obbligatorio) |
size | Dimensioni dello SKU specifico | string |
Livello | Livello o edizione dello SKU specifico, ad esempio Basic, Premium. | string |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Modello | Descrizione |
---|---|
Distribuire Istanza gestita di SQL con rete |
Distribuire la route definita dall'utente e il gruppo di sicurezza di rete per supportare Istanza gestita di SQL di Azure e distribuire il Istanza gestita |
Creare un'istanza gestita di SQL all'interno della nuova rete virtuale |
Distribuire il database SQL di Azure Istanza gestita (SQL MI) all'interno di un nuovo Rete virtuale. |
Creare un'istanza gestita di SQL con l'invio configurato di log e metriche |
Questo modello consente di distribuire l'istanza gestita di SQL e risorse aggiuntive usate per archiviare log e metriche (area di lavoro di diagnostica, account di archiviazione, hub eventi). |
Creare un'istanza gestita di SQL con jumpbox all'interno di una nuova rete virtuale |
Distribuire database SQL di Azure Istanza gestita (SQL MI) e JumpBox con SSMS all'interno di nuove Rete virtuale. |
Creare un'istanza gestita di SQL con connessione da punto a sito configurata |
Distribuire il database SQL di Azure Istanza gestita (SQL MI) e il gateway di rete virtuale configurati per la connessione da punto a sito all'interno della nuova rete virtuale. |
Definizione della risorsa Terraform (provider AzAPI)
Il tipo di risorsa managedInstances può essere distribuito con operazioni destinate a:
- Gruppi di risorse
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.Sql/managedInstances, aggiungere il codice Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2023-05-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
administrators = {
administratorType = "ActiveDirectory"
azureADOnlyAuthentication = bool
login = "string"
principalType = "string"
sid = "string"
tenantId = "string"
}
authenticationMetadata = "string"
collation = "string"
databaseFormat = "string"
dnsZonePartner = "string"
hybridSecondaryUsage = "string"
instancePoolId = "string"
isGeneralPurposeV2 = bool
keyId = "string"
licenseType = "string"
maintenanceConfigurationId = "string"
managedInstanceCreateMode = "string"
minimalTlsVersion = "string"
pricingModel = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "string"
restorePointInTime = "string"
servicePrincipal = {
type = "string"
}
sourceManagedInstanceId = "string"
storageIOps = int
storageSizeInGB = int
storageThroughputMBps = int
subnetId = "string"
timezoneId = "string"
vCores = int
zoneRedundant = bool
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
})
}
Valori delle proprietà
managedInstances
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di risorsa | "Microsoft.Sql/managedInstances@2023-05-01-preview" |
name | Nome della risorsa | stringa (obbligatorio) Limite di caratteri: 1-63 Caratteri validi: Lettere minuscole, numeri e trattini. Non può iniziare o terminare con un trattino. Il nome della risorsa deve essere univoco in Azure. |
posizione | Percorso della risorsa. | stringa (obbligatorio) |
parent_id | Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse. | stringa (obbligatorio) |
tags | Tag delle risorse. | Dizionario di nomi e valori di tag. |
sku | SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
identity | Identità di Azure Active Directory dell'istanza gestita. | ResourceIdentity |
properties | Proprietà delle risorse. | ManagedInstanceProperties |
ResourceIdentity
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. | "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
identity_ids | ID risorsa delle identità assegnate dall'utente da usare | Matrice di ID identità utente. |
ResourceIdentityUserAssignedIdentities
Nome | Descrizione | Valore |
---|---|---|
{proprietà personalizzata} | UserIdentity |
UserIdentity
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
ManagedInstanceProperties
Nome | Descrizione | Valore |
---|---|---|
administratorLogin | Nome utente amministratore per l'istanza gestita. Può essere specificato solo quando viene creata l'istanza gestita ed è necessaria per la creazione. | string |
administratorLoginPassword | Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita). | string Vincoli: Valore sensibile. Passare come parametro sicuro. |
amministratori | Amministratore di Azure Active Directory dell'istanza. Questa opzione può essere usata solo in fase di creazione dell'istanza. Se usato per l'aggiornamento dell'istanza, verrà ignorato o verrà generato un errore. Per gli aggiornamenti è necessario usare le singole API. | ManagedInstanceExternalAdministrator |
authenticationMetadata | Modalità di ricerca dei metadati di autenticazione dell'istanza gestita. | "AzureAD" "Abbinato" "Windows" |
collation | Regole di confronto dell'istanza gestita. | string |
databaseFormat | Specifica il formato interno dei database di istanza specifici della versione del motore SQL. | "AlwaysUpToDate" "SQLServer2022" |
dnsZonePartner | ID risorsa di un'altra istanza gestita la cui zona DNS questa istanza gestita condividerà dopo la creazione. | string |
hybridSecondaryUsage | Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passive" (il cliente usa il database secondario come ripristino di emergenza passivo). | "Attivo" "Passivo" |
instancePoolId | ID del pool di istanze a cui appartiene il server gestito. | string |
isGeneralPurposeV2 | Indica se si tratta di una variante GPv2 di per utilizzo generico edizione. | bool |
keyId | URI cmk della chiave da usare per la crittografia. | string |
licenseType | Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL). | "BasePrice" "LicenseIncluded" |
maintenanceConfigurationId | Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita. | string |
managedInstanceCreateMode | Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId. |
"Default" "PointInTimeRestore" |
minimalTlsVersion | Versione minima di TLS. Valori consentiti: 'None', '1.0', '1.1', '1.2' | string |
pricingModel | Meteo o non Istanza gestita è freemium. | "Freemium" "Regolare" |
primaryUserAssignedIdentityId | ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita. | string |
proxyOverride | Tipo di connessione utilizzato per la connessione all'istanza di . | "Default" "Proxy" "Reindirizzamento" |
publicDataEndpointEnabled | Indica se l'endpoint dati pubblico è abilitato o meno. | bool |
requestedBackupStorageRedundancy | Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) | "Geo" "GeoZone" "Locale" "Zona" |
restorePointInTime | Specifica il punto nel tempo (ISO8601 formato) del database di origine che verrà ripristinato per creare il nuovo database. | string |
servicePrincipal | Entità servizio dell'istanza gestita. | ServicePrincipal |
sourceManagedInstanceId | Identificatore della risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza. | string |
storageIOps | Operazioni di I/O al secondo di archiviazione. Valore minimo: 120. Valore massimo: 120000. Incrementi di 1 operazioni di I/O al secondo consentite solo. Il valore massimo dipende dalla famiglia di hardware selezionata e dal numero di vCore. | INT |
storageSizeInGB | Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 16384. Incrementi di 32 GB consentiti solo. Il valore massimo dipende dalla famiglia di hardware selezionata e dal numero di vCore. | INT |
storageThroughputMBps | Velocità effettiva di archiviazione in MBps. Valore minimo: 25. Valore massimo: 4000. Incrementi di 1 MBps consentiti solo. Il valore massimo dipende dalla famiglia di hardware selezionata e dal numero di vCore. | INT |
subnetId | ID risorsa subnet per l'istanza gestita. | string |
timezoneId | ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows mantiene i dettagli sui fusi orari supportati, incluso l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere tali valori del Registro di sistema tramite SQL Server eseguendo una query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora solare europa". |
string |
vCore | Numero di vCore. Valori consentiti: 8, 16, 24, 32, 40, 64, 80. | INT |
zoneRedundant | Indica se multi-az è abilitato o meno. | bool |
ManagedInstanceExternalAdministrator
Nome | Descrizione | Valore |
---|---|---|
administratorType | Tipo di amministratore del server. | "ActiveDirectory" |
azureADOnlyAuthentication | Autenticazione di Azure Active Directory abilitata solo. | bool |
login | Nome di accesso dell'amministratore del server. | string |
principalType | Tipo di entità dell'amministratore del server. | "Applicazione" "Gruppo" "User" |
sid | SID (ID oggetto) dell'amministratore del server. | string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
TenantId | ID tenant dell'amministratore. | string Vincoli: Lunghezza minima = 36 Lunghezza massima = 36 Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ServicePrincipal
Nome | Descrizione | Valore |
---|---|---|
tipo | Tipo di entità servizio. | "None" "SystemAssigned" |
Sku
Nome | Descrizione | Valore |
---|---|---|
capacità | Capacità dello SKU specifico. | INT |
famiglia | Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, può essere acquisito qui. | string |
name | Nome dello SKU, in genere una lettera + codice numerico, ad esempio P3. | stringa (obbligatorio) |
size | Dimensioni dello SKU specifico | string |
Livello | Livello o edizione dello SKU specifico, ad esempio Basic, Premium. | string |