Managed Instances - Start
Avvia l'istanza gestita.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/start?api-version=2023-08-01-preview
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
managed
|
path | True |
string |
Nome dell'istanza gestita. |
resource
|
path | True |
string |
Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale. |
subscription
|
path | True |
string |
ID sottoscrizione che identifica una sottoscrizione di Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare per la richiesta. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Avviato correttamente l'istanza gestita. |
|
202 Accepted |
L'avvio dell'istanza gestita è in corso. |
|
Other Status Codes |
Risposte agli errori: **
|
Esempio
Starts the managed instance.
Sample Request
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart/start?api-version=2023-08-01-preview
Sample Response
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen5"
},
"properties": {
"fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Succeeded",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"minimalTlsVersion": "1.2",
"dnsZone": "1234567891234",
"instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/instancePools/instancePool1",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"servicePrincipal": {
"principalId": "00000011-1111-2222-2222-123456789111",
"clientId": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"type": "SystemAssigned"
},
"externalGovernanceStatus": "Enabled",
"hybridSecondaryUsage": "Passive",
"authenticationMetadata": "Windows",
"databaseFormat": "SQLServer2022"
},
"location": "japaneast",
"tags": {
"key": "value"
},
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
"name": "mitostart",
"type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
Definizioni
Nome | Descrizione |
---|---|
Administrator |
Tipo dell'amministratore di sever. |
Auth |
Modalità di ricerca dei metadati di autenticazione dell'istanza gestita. |
Backup |
Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
External |
Stato della governance esterna. |
Freemium |
Il tempo o meno Istanza gestita è freemium. |
Hybrid |
Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passivo" (il cliente usa il database secondario come ripristino di emergenza passivo). |
Hybrid |
Utilizzo secondario ibrido rilevato. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per l'uso secondario come ripristino di emergenza passivo). |
Identity |
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. |
Managed |
Istanza gestita Azure SQL. |
Managed |
Specifica il formato interno dei database di istanza specifici della versione del motore SQL. |
Managed |
Proprietà di un amministratore di Active Directory. |
Managed |
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). |
Managed |
Connessione endpoint privato in un'istanza gestita |
Managed |
Proprietà di una connessione endpoint privato. |
Managed |
|
Managed |
|
Managed |
Tipo di connessione usato per la connessione all'istanza. |
Managed |
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. |
Principal |
Tipo di entità dell'amministratore di sever. |
Provisioning |
Stato di provisioning dell'istanza gestita. |
Resource |
Configurazione delle identità di Azure Active Directory per una risorsa. |
Service |
Configurazione dell'entità servizio dell'istanza gestita per una risorsa. |
Service |
Tipo di entità servizio. |
Sku |
SKU di risorsa arm. |
User |
Configurazione delle identità di Azure Active Directory per una risorsa. |
AdministratorType
Tipo dell'amministratore di sever.
Nome | Tipo | Descrizione |
---|---|---|
ActiveDirectory |
string |
AuthMetadataLookupModes
Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.
Nome | Tipo | Descrizione |
---|---|---|
AzureAD |
string |
|
Paired |
string |
|
Windows |
string |
BackupStorageRedundancy
Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
Nome | Tipo | Descrizione |
---|---|---|
Geo |
string |
|
GeoZone |
string |
|
Local |
string |
|
Zone |
string |
ErrorAdditionalInfo
Informazioni aggiuntive sulla gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'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. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
ExternalGovernanceStatus
Stato della governance esterna.
Nome | Tipo | Descrizione |
---|---|---|
Disabled |
string |
|
Enabled |
string |
FreemiumType
Il tempo o meno Istanza gestita è freemium.
Nome | Tipo | Descrizione |
---|---|---|
Freemium |
string |
|
Regular |
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).
Nome | Tipo | Descrizione |
---|---|---|
Active |
string |
|
Passive |
string |
HybridSecondaryUsageDetected
Utilizzo secondario ibrido rilevato. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per l'uso secondario come ripristino di emergenza passivo).
Nome | Tipo | Descrizione |
---|---|---|
Active |
string |
|
Passive |
string |
IdentityType
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
ManagedInstance
Istanza gestita Azure SQL.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
identity |
Identità di Azure Active Directory dell'istanza gestita. |
|
location |
string |
Percorso della risorsa. |
name |
string |
Nome risorsa. |
properties.administratorLogin |
string |
Nome utente amministratore per l'istanza gestita. È possibile specificare solo quando l'istanza gestita viene creata (ed è necessaria per la creazione). |
properties.administratorLoginPassword |
string |
Password di accesso amministratore (richiesta per la creazione di istanze gestite). |
properties.administrators |
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. |
|
properties.authenticationMetadata |
Modalità di ricerca dei metadati di autenticazione dell'istanza gestita. |
|
properties.collation |
string |
Regole di confronto dell'istanza gestita. |
properties.createTime |
string |
Specifica il periodo di tempo (ISO8601 formato) della creazione di Istanza gestita. |
properties.currentBackupStorageRedundancy |
Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
properties.databaseFormat |
Specifica il formato interno dei database di istanza specifici della versione del motore SQL. |
|
properties.dnsZone |
string |
Zona DNS in cui si trova l'istanza gestita. |
properties.dnsZonePartner |
string |
ID risorsa di un'altra istanza gestita la cui zona DNS verrà condivisa dopo la creazione. |
properties.externalGovernanceStatus |
Stato della governance esterna. |
|
properties.fullyQualifiedDomainName |
string |
Nome di dominio completo dell'istanza gestita. |
properties.hybridSecondaryUsage |
Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passivo" (il cliente usa il database secondario come ripristino di emergenza passivo). |
|
properties.hybridSecondaryUsageDetected |
Utilizzo secondario ibrido rilevato. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per l'uso secondario come ripristino di emergenza passivo). |
|
properties.instancePoolId |
string |
Id del pool di istanze a cui appartiene questo server gestito. |
properties.isGeneralPurposeV2 |
boolean |
Indipendentemente dal fatto che si tratti di una variante GPv2 di per utilizzo generico edizione. |
properties.keyId |
string |
URI CMK della chiave da usare per la crittografia. |
properties.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). |
|
properties.maintenanceConfigurationId |
string |
Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita. |
properties.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. |
|
properties.minimalTlsVersion |
string |
Versione TLS minima. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2' |
properties.pricingModel |
Il tempo o meno Istanza gestita è freemium. |
|
properties.primaryUserAssignedIdentityId |
string |
ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita. |
properties.privateEndpointConnections |
Elenco delle connessioni endpoint private in un'istanza gestita. |
|
properties.provisioningState |
Stato di provisioning dell'istanza gestita. |
|
properties.proxyOverride |
Tipo di connessione usato per la connessione all'istanza. |
|
properties.publicDataEndpointEnabled |
boolean |
Se l'endpoint dati pubblico è abilitato o meno. |
properties.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) |
|
properties.restorePointInTime |
string |
Specifica il tempo (ISO8601 formato) del database di origine che verrà ripristinato per creare il nuovo database. |
properties.servicePrincipal |
Entità servizio dell'istanza gestita. |
|
properties.sourceManagedInstanceId |
string |
Identificatore di risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza. |
properties.state |
string |
Stato dell'istanza gestita. |
properties.storageIOps |
integer |
Operazioni di IOps di archiviazione. Valore minimo: 300. Valore massimo: 80000. Incrementi di 1 operazioni di IOps consentite solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore. |
properties.storageSizeInGB |
integer |
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. |
properties.storageThroughputMBps |
integer |
Il parametro MBps della velocità effettiva di archiviazione non è supportato nell'operazione di creazione/aggiornamento dell'istanza. |
properties.subnetId |
string |
ID risorsa subnet per l'istanza gestita. |
properties.timezoneId |
string |
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". |
properties.totalMemoryMB |
integer |
Memoria totale in MB. Valore minimo: 7168. Valore massimo: 891328. Incrementi di 1 MB consentiti solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore. |
properties.vCores |
integer |
Numero di vCore. Valori consentiti: 8, 16, 24, 32, 40, 64, 80. |
properties.virtualClusterId |
string |
ID risorsa cluster virtuale per il Istanza gestita. |
properties.zoneRedundant |
boolean |
Se il multi-az è abilitato o meno. |
sku |
SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH |
|
tags |
object |
Tag di risorse. |
type |
string |
Tipo di risorsa. |
ManagedInstanceDatabaseFormat
Specifica il formato interno dei database di istanza specifici della versione del motore SQL.
Nome | Tipo | Descrizione |
---|---|---|
AlwaysUpToDate |
string |
|
SQLServer2022 |
string |
ManagedInstanceExternalAdministrator
Proprietà di un amministratore di Active Directory.
Nome | Tipo | Descrizione |
---|---|---|
administratorType |
Tipo dell'amministratore di sever. |
|
azureADOnlyAuthentication |
boolean |
Solo autenticazione di Azure Active Directory abilitata. |
login |
string |
Nome di accesso dell'amministratore del server. |
principalType |
Tipo di entità dell'amministratore di sever. |
|
sid |
string |
SID (ID oggetto) dell'amministratore del server. |
tenantId |
string |
ID tenant dell'amministratore. |
ManagedInstanceLicenseType
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).
Nome | Tipo | Descrizione |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ManagedInstancePecProperty
Connessione endpoint privato in un'istanza gestita
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
properties |
Proprietà di connessione dell'endpoint privato |
ManagedInstancePrivateEndpointConnectionProperties
Proprietà di una connessione endpoint privato.
Nome | Tipo | Descrizione |
---|---|---|
privateEndpoint |
Endpoint privato a cui appartiene la connessione. |
|
privateLinkServiceConnectionState |
Stato della connessione dell'endpoint privato. |
|
provisioningState |
string |
Stato della connessione endpoint privato. |
ManagedInstancePrivateEndpointProperty
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa dell'endpoint privato. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
Nome | Tipo | Descrizione |
---|---|---|
actionsRequired |
string |
Descrizione della connessione al servizio collegamento privato. |
description |
string |
Descrizione della connessione al servizio collegamento privato. |
status |
string |
Stato di connessione del servizio di collegamento privato. |
ManagedInstanceProxyOverride
Tipo di connessione usato per la connessione all'istanza.
Nome | Tipo | Descrizione |
---|---|---|
Default |
string |
|
Proxy |
string |
|
Redirect |
string |
ManagedServerCreateMode
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.
Nome | Tipo | Descrizione |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
PrincipalType
Tipo di entità dell'amministratore di sever.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
ProvisioningState
Stato di provisioning dell'istanza gestita.
Nome | Tipo | Descrizione |
---|---|---|
Canceled |
string |
|
Created |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
ResourceIdentity
Configurazione delle identità di Azure Active Directory per una risorsa.
Nome | Tipo | Descrizione |
---|---|---|
principalId |
string |
ID entità di Azure Active Directory. |
tenantId |
string |
ID tenant di Azure Active Directory. |
type |
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. |
|
userAssignedIdentities |
<string,
User |
ID risorsa delle identità assegnate dall'utente da usare |
ServicePrincipal
Configurazione dell'entità servizio dell'istanza gestita per una risorsa.
Nome | Tipo | Descrizione |
---|---|---|
clientId |
string |
ID client dell'applicazione Azure Active Directory. |
principalId |
string |
ID oggetto dell'applicazione Azure Active Directory. |
tenantId |
string |
ID tenant di Azure Active Directory. |
type |
Tipo di entità servizio. |
ServicePrincipalType
Tipo di entità servizio.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
SystemAssigned |
string |
Sku
SKU di risorsa arm.
Nome | Tipo | Descrizione |
---|---|---|
capacity |
integer |
Capacità dello SKU specifico. |
family |
string |
Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui. |
name |
string |
Il nome dello SKU, in genere, una lettera + Codice Numero, ad esempio P3. |
size |
string |
Dimensioni dello SKU specifico |
tier |
string |
Livello o edizione dello SKU specifico, ad esempio Basic, Premium. |
UserIdentity
Configurazione delle identità di Azure Active Directory per una risorsa.
Nome | Tipo | Descrizione |
---|---|---|
clientId |
string |
ID client di Azure Active Directory. |
principalId |
string |
ID entità di Azure Active Directory. |