Condividi tramite


Databases - Update

Aggiorna un database esistente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2021-11-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database.

resourceGroupName
path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.

serverName
path True

string

Il nome del server.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True

string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome Tipo Descrizione
identity

DatabaseIdentity

Identità del database

properties.autoPauseDelay

integer (int32)

Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata

properties.catalogCollation

CatalogCollationType

Regole di confronto del catalogo di metadati.

properties.collation

string

Regole di confronto del database.

properties.createMode

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

properties.elasticPoolId

string (arm-id)

Identificatore della risorsa del pool elastico contenente il database.

properties.federatedClientId

string (uuid)

ID client usato per lo scenario cmk tra tenant per database

properties.highAvailabilityReplicaCount

integer (int32)

Numero di repliche secondarie associate al database utilizzato per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.

properties.isLedgerOn

boolean

Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.

properties.licenseType

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncluded se è necessaria una licenza o BasePrice se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.

properties.longTermRetentionBackupResourceId

string (arm-id)

Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.

properties.maintenanceConfigurationId

string

ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.

properties.maxSizeBytes

integer (int64)

Dimensione massima del database espressa in byte.

properties.minCapacity

number (double)

Capacità minima allocata dal database, se non sospesa

properties.readScale

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

properties.recoverableDatabaseId

string

Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.

properties.recoveryServicesRecoveryPointId

string (arm-id)

Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

properties.restorableDroppedDatabaseId

string (arm-id)

Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.

properties.restorePointInTime

string (date-time)

Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.

properties.sampleName

SampleName

Nome dello schema di esempio da applicare durante la creazione del database.

properties.secondaryType

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

properties.sourceDatabaseDeletionDate

string (date-time)

Specifica l'ora di eliminazione del database.

properties.sourceDatabaseId

string (arm-id)

Identificatore della risorsa del database di origine associato all'operazione di creazione del database.

properties.zoneRedundant

boolean

Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.

sku

Sku

Nome e livello dello SKU.

tags

object

Tag di risorsa.

Risposte

Nome Tipo Descrizione
200 OK

Database

Aggiornamento corretto del database.

202 Accepted

L'aggiornamento del database è in corso.

Other Status Codes

Risposte di errore:

  • 400 InvalidDatabaseCreateOrUpdateRequest: il corpo della richiesta per l'operazione di creazione o aggiornamento del database non è valido.

  • 400 InvalidResourceId - Identificatore di risorsa non valido.

  • 400 InvalidSourceDatabaseId - Identificatore di database di origine non valido.

  • 400 Mancata corrispondenzaResourceGroupNameWithUrl- Il nome del gruppo di risorse specificato non corrisponde al nome nell'URL.

  • 400 MismatchingServerNameWithUrl: il nome del server specificato non corrisponde al nome nell'URL.

  • 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrisponde alla sottoscrizione nell'URL.

  • 400 MissingCollation: sono necessarie regole di confronto.

  • 400 MissingMaxSizeBytes - MaxSizeBytes è obbligatorio.

  • 400 MissingSkuName : è necessario il nome sku.

  • 400 MissingSourceDatabaseId - Identificatore del database di origine mancante.

  • 400 InvalidLicenseType - Il tipo di licenza specificato non è valido.

  • 400 InvalidSkuName - Nome SKU non valido.

  • 400 Mancata corrispondenzaSkuNameAndCapacity - Mancata corrispondenza tra nome SKU e capacità.

  • 400 Mancata corrispondenzaSkuNameAndTier - Mancata corrispondenza tra il nome dello SKU e il livello.

  • 400 Mancata corrispondenzaSkuNameAndFamily - Mancata corrispondenza tra nome SKU e famiglia.

  • 400 LedgerNotAllowedWithSpecifiedCreateMode - IsLedgerOn non è consentito con la modalità di creazione specificata.

  • 400 LedgerNotAllowedOnSampleDatabase- La creazione del database non è consentita con IsLedgerOn per un database di esempio.

  • 400 DatabaseNameDoesNotMatchSourceDatabaseId: il nome del database specificato non corrisponde al nome del database in sourceDatabaseId.

  • 400 ElasticPoolNotSupportedForExternalBackupRestore - Il pool elastico non è supportato per il ripristino di backup esterno

  • 400 InvalidRecoverableDatabaseId - Identificatore di database ripristinabile non valido.

  • 400 InvalidRecoveryServicesRecoveryPointId - Identificatore del punto di ripristino dei servizi di ripristino non valido.

  • 400 InvalidRestorableDroppedDatabaseDeletionDate - La data di eliminazione del database eliminata ripristinabile specificata non è valida

  • 400 InvalidRestorableDroppedDatabaseId - Identificatore del database eliminato ripristinabile non valido

  • 400 MissingRecoverableDatabaseId - Identificatore di database ripristinabile mancante.

  • 400 MissingRecoveryServicesRecoveryPointId - ID punto di ripristino dei servizi di ripristino mancante.

  • 400 MissingRestorableDroppedDatabaseId - RestorableDroppedDatabaseId mancante

  • 400 MissingRestorePointInTime - Punto di ripristino mancante nel tempo

  • 400 MissingSourceDatabaseDeletionDate - Data di eliminazione del database di origine mancante

  • 400 MissingStorageContainerSasToken - Token di firma di accesso condiviso del contenitore di archiviazione mancante

  • 400 MissingStorageContainerUri - URI contenitore di archiviazione mancante

  • 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Impossibile specificare restorableDroppedDatabaseId quando sourceDatabaseId è già specificato in modalità di ripristino

  • 400 MultipleIdentitiesOnDatabase: a livello di database è supportata solo un'identità gestita assegnata dall'utente.

  • 400 MultipleIdentityDelegationsOnDatabase: a livello di database è supportata una sola delega di identità.

  • 400 MissingPrimaryDelegatedIdentityClientId: per usare le identità delegate, specificare un ID client di identità delegato primario.

  • 400 LongTermRetentionMigrationRequestNotSupported: la sottoscrizione non è consentita la funzionalità di migrazione del backup con conservazione a lungo termine.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Le sottoscrizioni di origine e di destinazione non possono comunicare per la funzionalità di copia di backup con conservazione a lungo termine.

  • 400 LongTermRetentionMigrationParameterMissing - Parametro obbligatorio mancante per l'operazione.

  • 400 LongTermRetentionMigrationSameServerNotSupported - La funzionalità copia con conservazione a lungo termine non è supportata per copiare i backup con conservazione a lungo termine all'interno dello stesso server.

  • 400 LongTermRetentionMigrationTargetServerNotFound- Il server di destinazione non esiste o non è pronto per l'operazione di copia di backup con conservazione a lungo termine.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound- Il database di destinazione non esiste nel server.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - La ridondanza dell'archiviazione di backup specificata non è supportata nell'area di destinazione.

  • 400 LongTermRetentionMigrationStorageMismatch - La ridondanza del backup attiva del database non corrisponde alla ridondanza del backup richiesta dal cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported: la migrazione con conservazione a lungo termine è supportata solo per i backup con conservazione a lungo termine dell'istanza gestita e del database SQL di Azure.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed- La modifica della ridondanza dell'archiviazione di backup non è consentita per le operazioni di copia con conservazione a lungo termine.

  • 400 LongTermRetentionMigrationSubscriptionNotFound - Impossibile trovare la sottoscrizione.

  • 400 InvalidStandbyGeoReadScale: l'utente ha tentato di abilitare la scalabilità in lettura in un database geografico di standby che non lo supporta.

  • 400 PerDatabaseCMKKeyRotationAttemptedWhileOldThumbprintInUse- La rotazione delle chiavi per la protezione TDE a livello di database viene bloccata quando le transazioni attive mantengono il log crittografato con le chiavi precedenti. Per le possibili strategie per risolvere questo problema, vedere aka.ms/azuresqldbkeyrotation.

  • 400 TierChangeUnsupportedDueToMemoryOptimizedObject: il database non può aggiornare lo SKU perché dispone di oggetti ottimizzati per la memoria.

  • 400 PerDBCMKNotSupportedWithLTR - La chiave gestita a livello di database non è supportata quando la conservazione dei backup a lungo termine è abilitata nel database.

  • 400 SourceServerNotFound: la parte server di un ID di database di origine fornito in una chiamata API CreateDatabaseAsCopy non esegue il mapping a un server esistente.

  • 400 ElasticPoolOverStorageUsage - Tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico.

  • 400 InvalidDatabaseCreateMode - Richiesta non valida per creare un database.

  • 400 MissingAsymmetricKeyOnTargetServer - Il server di destinazione non ha accesso a una chiave asimmetrica.

  • 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrisponde alla sottoscrizione nell'URL.

  • 400 MultipleDroppedDatabasesWithTheSameName - Trovato più database eliminati con lo stesso nome nel server.

  • 400 InvalidAddSecondaryPermission: l'utente non dispone di autorizzazioni sufficienti per aggiungere secondario nel server specificato.

  • 400 AzureKeyVaultClientError - Si è verificato un errore nel client di Azure Key Vault.

  • 400 UnsupportedServiceName: il nome specificato non è valido perché contiene uno o più caratteri Unicode non supportati.

  • 400 AzureKeyVaultClientInfoError- Si è verificato un errore durante l'acquisizione di informazioni per il client di Azure Key Vault.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize- L'utente ha tentato di modificare il database in uno SKU con dimensioni massime massime inferiori rispetto all'utilizzo corrente.

  • 400 IsLedgerDatabaseIsNotSupportedOnResourceType - La modifica della proprietà libro mastro non è supportata per questo tipo di risorsa.

  • 400 InvalidBackupStorageAccountType - L'utente ha passato zrs/lrs durante la creazione/aggiornamento di un database, ma non è riuscito perché il cliente non è incluso nell'elenco elementi consentiti o perché zrs non è disponibile nell'area specificata.

  • 400 CannotUpdateToFreeDatabase: l'aggiornamento di un database allo SKU gratuito non è supportato.

  • 400 DatabaseInvalidSkuPropertyCombination: le proprietà dello SKU richiesto non sono coerenti. Verificare che sia specificata una combinazione valida. Per altri dettagli, vedere https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.

  • 400 DatabaseNamedReplicaPerDatabaseLimitExceeded - L'utente ha provato a creare una replica denominata che supererebbe il numero consentito per ogni database primario

  • 400 UnsupportedBackupStorageRedundancyForEdition - La ridondanza dell'archiviazione di backup richiesta non è supportata per l'edizione

  • 400 DatabaseIsCurrentlyPinned- Microsoft ha aggiunto la versione del motore di SQL Server del database. Per assicurarsi che il database non riscontri problemi di produzione, eventuali operazioni di scalabilità future sul database verranno bloccate fino a quando non è stato aggiunto. Contattare il supporto tecnico Microsoft per assistenza per il ridimensionamento.

  • 400 RestoreTargetEditionSizeInsufficient - L'utente ha tentato di ripristinare un database in un'edizione di dimensioni inferiori rispetto alle dimensioni allocate correnti dell'origine.

  • 400 InvalidSku: l'utente ha specificato uno SKU non valido.

  • 400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato.

  • 400 ServerNotFound - Il server richiesto non è stato trovato.

  • 400 UnsupportedBackupStorageRedundancy - La ridondanza dell'archiviazione di backup specificata non è supportata nell'area di destinazione.

  • 400 InvalidIdentityId: uno o più ID identità specificati non sono ID risorsa ARM validi. Immettere gli ID validi e riprovare.

  • 400 LTRSterlingToVldbMigrationNotSupported- Impossibile modificare l'obiettivo del servizio per il database in Hyperscale perché la conservazione a lungo termine non è ancora supportata in Hyperscale. Disabilitare la conservazione a lungo termine nel database e riprovare.

  • 400 TokenTooLong: il token fornito è troppo lungo.

  • 400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione del database corrente.

  • 400 OfferDisabledOnSubscription : il tipo di offerta sottoscrizione è limitato dal provisioning della risorsa richiesta.

  • 400 UnableToCreateGeoChain - L'utente ha tentato di creare un database secondario (concatenamento) anche se è stato configurato il caricamento automatico dei digest libro mastro

  • 400 InvalidNumberOfIdentities: a livello di database è supportata solo un'identità gestita assegnata dall'utente.

  • 400 DatabaseNamedReplicaChainingNotAllowed - L'utente ha tentato di creare una replica denominata di una replica denominata che non è consentita.

  • 400 DatabaseNamedReplicaInvalidOperation- L'utente ha tentato un'operazione non supportata in una replica denominata.

  • 400 DatabaseNamedReplicaInvalidSourceDatabase- L'utente ha tentato di creare una replica denominata in una sottoscrizione o un'area diversa rispetto al database di origine.

  • 400 InvalidTargetSubregion: il server di destinazione di un database secondario non leggibile non si trova in un'area di Azure associata al ripristino di emergenza.

  • 400 CannotAssignIdentityToMaster- Impossibile assegnare un'identità a un database di sistema. Impossibile assegnare l'identità del database ai database 'master', 'model', 'tempdb', 'msdb' o 'resource'.

  • 400 PerDatabaseCMKDWNotSupported - CmK a livello di database in anteprima non è supportato per l'edizione Datawarehouse.

  • 400 DatabaseCreationBlockedForNonActivatedCMKServer: le creazioni del pool SQL vengono bloccate per le aree di lavoro abilitate per la chiave gestita dal cliente fino all'attivazione dell'area di lavoro. Abilitare prima di tutto la protezione dall'eliminazione e concedere all'identità gestita dell'area di lavoro le autorizzazioni necessarie (Get, Wrap Key, Unwrap Key Key) nell'insieme di credenziali delle chiavi di Azure della chiave dell'area di lavoro. Attivare quindi l'area di lavoro dopo aver concesso l'accesso.

  • 400 PartnerServerNotCompatible - L'utente sta tentando di copiare un database da un server SAWA V1 a un server Sterling o viceversa.

  • 400 IncorrectReplicationLinkState: l'operazione prevede che il database sia in uno stato previsto nel collegamento di replica.

  • 400 TargetElasticPoolDoesNotExist: il pool elastico non esiste in un server.

  • 400 ElasticPoolSkuCombinationInvalid- Il pool elastico e lo SKU possono essere specificati insieme solo se lo SKU è specificato come 'ElasticPool'.

  • 400 ElasticPoolTierCombinationInvalid: il livello di database è diverso dal livello di servizio del pool elastico.

  • 400 ElasticPoolNameRequired - L'utente ha tentato di creare o aggiornare il database in base all'obiettivo di servizio del pool elastico senza specificare il nome del pool elastico.

  • 400 MissingThumbprintCrm: operazione di ripristino di un database CRM non riuscita perché manca un certificato TDE richiesto. Ripetere l'operazione di ripristino in un pool elastico esistente.

  • 400 ElasticPoolOverStorage: tentativo di scrivere dati in un database quando è stato raggiunto il limite di archiviazione del pool elastico.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings: tentativo di fornire il numero minimo di DTU per i database nel pool elastico che supera le DTU richieste del pool elastico.

  • 400 RestoreTargetEditionSizeInsufficientV2- L'utente ha tentato di ripristinare un database in un'edizione di dimensioni inferiori rispetto alle dimensioni allocate del database ripristinato.

  • 400 TierChangeUnsupportedDueToCDCEnabledDatabase: il database non può aggiornare lo SKU perché è abilitato per CDC.

  • 400 ElasticPoolDatabaseCountOverLimit- Tentativo di creare o aggiungere database al pool elastico quando è stato raggiunto il limite di conteggio del database del pool elastico.

  • 400 ResourcePoolStorageLimitHitDuringRestore: il database ripristinato non può essere ripristinato nel pool di risorse a causa della capacità di archiviazione rimanente nel pool.

  • 400 CannotChangeToOrFromDataWarehouseTier - L'utente ha tentato di modificare lo SKU di un database dal livello DataWarehouse a livelli non DataWarehouse o viceversa.

  • 400 CurrentDatabaseSizeExceedsMaxSize- L'utente ha tentato di ridurre le dimensioni massime per un database a una dimensione inferiore all'utilizzo corrente.

  • 400 PerDatabaseCMKRestoreNotSupported - Il ripristino del database non è supportato quando la chiave gestita a livello di database è configurata in anteprima.

  • 400 PerDatabaseCMKHSNotSupported - La chiave cmk a livello di database in anteprima non è supportata per l'edizione Hyperscale.

  • 400 AzureKeyVaultKeyDisabled- Impossibile completare l'operazione nel server perché la chiave di Azure Key Vault è disabilitata.

  • 400 PerDatabaseCMKGeoReplicationNotSupported - La replica geografica e la copia del database non sono supportate quando la chiave gestita a livello di database è configurata in anteprima.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - Tentativo di ridurre il limite di archiviazione del pool elastico al di sotto del relativo utilizzo di archiviazione.

  • 400 AzureKeyVaultInvalidExpirationDate- Impossibile completare l'operazione perché la data di scadenza della chiave di Azure Key Vault non è valida.

  • 400 InvalidStandbyGeoEdition - L'utente ha tentato di creare un'area geografica di standby basata su DTU.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty- Impossibile completare l'operazione perché l'URI di Azure Key Vault è null o vuoto.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings: il numero di database e il numero minimo di VCore per database non possono superare i VCore richiesti del pool elastico.

  • 400 UpdateNotAllowedOnPausedDatabase - L'utente ha tentato di eseguire un aggiornamento in un database sospeso.

  • 400 GeoRestoreBackupStorageTypeNotSupported- Le richieste di ripristino del database non sono valide quando vengono eseguite su un database non configurato per l'uso dell'archiviazione di backup con ridondanza geografica.

  • 400 RestoreHyperscaleToNonHyperscale - Il ripristino di un backup di un database Hyperscale in un livello di servizio non Hyperscale o viceversa non è supportato.

  • 400 SubscriptionDoesNotHaveAccessToServer - La sottoscrizione non ha accesso ai server specificati

  • 400 RecoveryPointDoesNotExist: il punto di ripristino specificato non esiste o non è valido.

  • 400 AzureKeyVaultNoServerIdentity - L'identità del server non è configurata correttamente.

  • 400 InvalidMaxSizeTierCombination: il livello specificato non supporta le dimensioni massime del database specificate.

  • 400 LtrBackupNotFound - Il backup di conservazione a lungo termine specificato non esiste.

  • 400 AzureKeyVaultInvalidUri: risposta non valida da Azure Key Vault. Usare un URI di Azure Key Vault valido.

  • 400 InvalidPointInTime: il punto nel tempo specificato non è valido per il database.

  • 400 AzureKeyVaultMissingPermissions: il server non dispone delle autorizzazioni necessarie per Azure Key Vault.

  • 400 GeoRestoreCannotResolveTargetCluster - Impossibile risolvere il cluster di destinazione per il server

  • 400 InvalidReadScaleEdition : l'utente ha tentato di abilitare la scalabilità in lettura su un tipo di database che non lo supporta.

  • 400 CannotSpecifyEditionOrSloWhenRestoringToPool: specificare l'obiettivo o l'edizione del livello di servizio di destinazione non è supportato durante il ripristino in un pool elastico.

  • 400 InvalidReadScaleUnits : l'utente ha tentato di fornire un valore di scala in lettura non supportato.

  • 400 RestoreNotSupportedForGeoDrSecondary: le operazioni di ripristino temporizzato e ripristino del database non sono supportate nei database attualmente configurati come repliche secondarie geografiche.

  • 400 SecurityAzureKeyVaultInvalidKeyName- Impossibile completare l'operazione a causa di un nome di chiave server non valido.

  • 400 RegionDoesNotSupportVersion: un utente ha tentato di creare un server di una versione specificata in un percorso in cui tale versione del server non è supportata.

  • 400 GeoSecondaryMaxSizeUpdateFailed: il database geo-secondario è di un SLO che non supporta il valore maxsize richiesto o il database geo-secondario si trova in un'area non supportata o un'operazione di aggiornamento è già in corso nel database geo-secondario.

  • 400 AdalGenericError- Impossibile completare l'operazione perché è stato rilevato un errore di Azure Active Directory.

  • 400 AdalServicePrincipalNotFound- Impossibile completare l'operazione perché non è stato rilevato un errore dell'entità servizio della libreria di Azure Active Directory.

  • 400 InvalidTier: l'utente ha specificato un livello non valido.

  • 400 AzureKeyVaultMalformedVaultUri: l'URI dell'insieme di credenziali delle chiavi specificato non è valido.

  • 400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione.

  • 400 RequestedDatabaseSizeRequiresShrink : l'utente ha tentato di modificare MAXSIZE ALTER DATABASE MODIFY PER modificare MAXSIZE per un database in una dimensione inferiore, quindi le dimensioni correnti.

  • 400 CurrentDatabaseSizeExceedsDbMaxSize- L'utente ha tentato di ridurre le dimensioni massime per un database a dimensioni inferiori all'utilizzo corrente.

  • 400 InvalidServerName - Nome server non valido specificato.

  • 400 CannotUseTrailingWhitespacesInDatabaseName- La convalida del nome del database non è riuscita.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded: il database di origine non può avere un'edizione superiore rispetto al database di destinazione.

  • 400 SecurityAdalPrincipalCertExpiredError- Impossibile completare l'operazione perché il certificato dell'entità di insieme di credenziali delle chiavi di Azure è scaduto.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded: il database di destinazione non può avere un'edizione inferiore rispetto al database di origine.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - L'operazione non è consentita perché l'operazione di copia o failover per il database '{0}' nel server '{1}' è attualmente in corso.

  • 400 InvalidCollation : le regole di confronto non sono riconosciute dal server.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel: l'URI dell'insieme di credenziali delle chiavi specificato non è valido.

  • 400 KeyMaterialNotFoundOnRemoteServer - Il server remoto non ha accesso al materiale della chiave usato come protezione TDE.

  • 400 AzureKeyVaultRsaKeyNotSupported: l'insieme di credenziali delle chiavi fornito usa le dimensioni o il tipo di chiave RSA non supportato. Le dimensioni della chiave RSA supportate sono 2048 o 3072 e il tipo di chiave è RSA o RSA-HSM.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - Il server secondario non dispone del materiale della chiave della protezione di crittografia del server primario.

  • 400 ElasticPoolOverFileSpace - Spazio file insufficiente nel pool elastico.

  • 400 PartnerDBNotCompatibleForSGXEnclave- Il tentativo di impostare il collegamento GeoDR o aggiornare SLO per il database abilitato per l'enclave è supportato solo quando entrambi i database sono in esecuzione nell'hardware della serie DC.

  • 400 UpdateNotAllowedInCurrentReplicationState: l'operazione non è consentita nel database nello stato di replica corrente.

  • 400 InvalidLicenseType: l'utente ha tentato di creare o aggiornare un database o un pool elastico con tipo di licenza non supportato.

  • 400 GeoReplicaLimitReached: è stato raggiunto il limite di replica per replica.

  • 400 UnsupportedCapacity : l'utente ha tentato di creare o aggiornare il database con capacità non supportata.

  • 400 ReplicationSourceAndTargetMustHaveSameName: i database di origine e di destinazione della replica devono avere lo stesso nome.

  • 400 ProvisioningDisabled - Visualizza il messaggio di errore dell'autorizzatore dell'operazione delle risorse così come è, senza modifiche

  • 400 ReplicationSourceAndTargetMustBeInDifferentServers: i database di origine e di destinazione della replica devono trovarsi in server logici diversi.

  • 400 CannotUpdateIsLedgerDatabase- Impossibile aggiornare la proprietà libro mastro di un database esistente.

  • 400 UnableToResolveRemoteServer- Impossibile risolvere il nome del server partner remoto a causa di problemi di connettività DNS o nome server non validi.

  • 400 RemoteDatabaseCopyPermission: l'utente non dispone di autorizzazioni sufficienti per creare una copia del database nel server specificato.

  • 400 CannotMoveOrDropSyncMetadataDatabase- Impossibile eliminare il database usato come database di metadati di sincronizzazione.

  • 400 SecurityAzureKeyVaultGeoChainError- La creazione di un database secondario (un processo noto come concatenamento) non è supportata quando si abilita Transparent Data Encryption con Azure Key Vault (BYOK).

  • 400 RestoreToFreeEditionNotSupported: il ripristino e la destinazione GeoRestore non possono essere database gratuiti.

  • 400 CannotMoveOrDropJobAccountDatabase - Impossibile eliminare il database associato all'account del processo.

  • 400 RestoreNotSupportedForFreeEdition: il ripristino e il georestore non sono supportati per il database gratuito.

  • 400 JobAgentDatabaseEditionUnsupported: l'obiettivo del livello di servizio del database specificato non è supportato per l'uso come database dell'agente processo.

  • 400 InvalidDroppedDatabase- Il database di origine eliminato non esiste nel server entro il periodo di recupero supportato.

  • 400 InvalidLiveDatabase- Il database di origine non esiste nel server entro il periodo di recupero supportato. Se si ripristina un database eliminato, specificare la data di eliminazione.

  • 400 InvalidVldbRecoverySlo: il ripristino dell'edizione Hyperscale richiede sia i database di origine che di destinazione per usare l'obiettivo del livello di servizio Hyperscale.

  • 400 SourceDatabaseNotFound - Il database di origine non esiste.

  • 400 InvalidVldbRestoreSlo - Il ripristino point-In-Time dell'edizione Hyperscale richiede sia i database di origine che di destinazione per usare l'obiettivo del livello di servizio Hyperscale.

  • 400 CannotSpecifyPoolOrSlo: specificare un pool elastico e/o modificare l'obiettivo o l'edizione del livello di servizio non è supportato per l'edizione.

  • 400 InvalidPublicMaintenanceConfiguration - L'utente ha tentato di specificare la configurazione di manutenzione pubblica che non può essere convertita in ID interno (in formato non valido o in un'area errata).

  • 400 MaintenanceWindowNotSupportedForNamedReplica - L'utente ha tentato di creare o aggiornare la replica denominata con finestra di manutenzione non predefinita non supportata.

  • 400 ChangeUnsupportedOnEntity - L'utente ha tentato un'operazione di creazione/aggiornamento/eliminazione non supportata in una determinata entità.

  • 404 OperationIdNotFound - L'operazione con ID non esiste.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 LongTermRetentionMigrationBackupNotFound- Il backup di conservazione a lungo termine specificato non esiste.

  • 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server.

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 SubscriptionNotFound - La sottoscrizione richiesta non è stata trovata.

  • 404 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata.

  • 404 CannotFindObject - Impossibile trovare l'oggetto perché non esiste o non si dispone delle autorizzazioni

  • 405 UnsupportedReplicationOperation- È stata avviata un'operazione di replica non supportata nel database.

  • 409 OperationCancelled - L'operazione è stata annullata dall'utente.

  • 409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.

  • 409 LongTermRetentionMigrationRequestConflict- È ancora in corso un'operazione di conflitto su questo backup con conservazione a lungo termine.

  • 409 LongTermRetentionMigrationBackupConflict - Esiste un altro backup LTR con lo stesso tempo di backup per il database di destinazione.

  • 409 FreeDbAlreadyExists: è possibile che esista un solo database gratuito per una sottoscrizione per area.

  • 409 ConflictingServerOperation: un'operazione è attualmente in corso per il server.

  • 409 SubscriptionDisabled : la sottoscrizione è disabilitata.

  • 409 ConflictingSystemOperationInProgress - È in corso un'operazione di manutenzione del sistema nel database e altre operazioni devono attendere il completamento.

  • 409 ConflictRequestToUpdateBackupRedundancy- È ancora in corso una richiesta di conflitto per modificare la ridondanza dell'archiviazione di backup.

  • 409 SkuAssignmentInProgress- Impossibile elaborare la richiesta di assegnazione corrente perché una richiesta precedente non è stata completata.

  • 409 DatabaseElasticPoolMaintenanceConflict - L'utente ha tentato di creare o aggiornare un database con una configurazione di manutenzione specificata in conflitto con quella del pool elastico del database.

  • 409 ServerDtuQuotaExceeded- Impossibile eseguire l'operazione perché il server supera la quota consentita di unità elaborate del database.

  • 409 UnableToAlterDatabaseInReplication - Edizione modificata dall'utente in un database in una relazione di replica.

  • 409 SubscriptionVcoreQuotaExceeded: non è stato possibile eseguire l'operazione perché la sottoscrizione supera la quota vCore consentita.

  • 409 CurrentMemoryUsageExceedsSkuQuota - L'utente ha tentato di eseguire un'operazione di aggiornamento sku che non può essere completata a causa del consumo di risorse più elevato.

  • 409 ServerKeyNameAlreadyExists - La chiave del server esiste già nel server.

  • 409 ServerKeyUriAlreadyExists: l'URI della chiave del server esiste già nel server.

  • 409 ServerKeyDoesNotExists - La chiave del server non esiste.

  • 409 UpdateSloInProgress - L'utente ha tentato di avviare un'operazione incompatibile mentre era in corso un aggiornamento SLO.

  • 409 UpdateSloFailedDatabaseTooBusy - Impossibile completare l'operazione SLO di aggiornamento perché il database era troppo occupato.

  • 409 ElasticPoolBusy- È stata tentata un'operazione di gestione in un pool elastico occupato.

  • 409 AzureKeyVaultKeyNameNotFound- Impossibile completare l'operazione perché il nome della chiave di Azure Key Vault non esiste.

  • 409 AzureKeyVaultKeyInUse: la chiave è attualmente usata dal server.

  • 409 ServerDisabled - Il server è disabilitato.

  • 409 ConflictingDatabaseOperation: nel database è già presente un'operazione e l'operazione corrente deve attendere fino a quando non viene eseguita.

  • 409 SimultaneousSkuChangeNotAllowed: le operazioni di modifica dell'obiettivo del servizio non possono essere eseguite in entrambi i database di una relazione di replica contemporaneamente.

  • 409 TargetElasticPoolBeingUpdated - Impossibile avviare l'aggiornamento del pool elastico perché è in corso un'operazione di copia per uno dei database in questo pool elastico

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship- È stata eseguita un'operazione di seeding della replica in un database già in una relazione di replica.

  • 409 InvalidOperationForDatabaseInReplicationRelationship- È stata eseguita un'operazione di seeding della replica in un database già in una relazione di replica.

  • 409 DuplicateGeoDrRelation: i database sono già in una relazione di replica. Si tratta di una richiesta duplicata.

  • 409 DatabaseCopyLimitPerReplicaReached- L'utente ha raggiunto il limite di copie simultanee del database.

  • 409 RemoteDatabaseExists: il nome del database di destinazione esiste già nel server di destinazione.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Impossibile avviare la richiesta di copia di backup con conservazione a lungo termine nell'area di destinazione.

  • 500 LongTermRetentionMigrationRequestCopyFailed - Operazione di copia non riuscita per i BLOB di backup con conservazione a lungo termine.

  • 500 LongTermRetentionMigrationRestoreVerExceeded - La verifica del ripristino non è riuscita dopo il raggiungimento del numero massimo di tentativi.

  • 500 LongTermRetentionMigrationRestoreVerFailed - La verifica del ripristino non è riuscita.

  • 500 ActivateOrDeactivateWorkflowThrottling - L'attivazione o la disattivazione del flusso di lavoro non è riuscita perché sono presenti troppi flussi di lavoro simultanei

  • 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 503 AzureKeyVaultConnectionFailed - Impossibile completare l'operazione nel server perché i tentativi di connessione ad Azure Key Vault non sono riusciti

  • 503 AzureKeyVaultGenericConnectionError - Impossibile completare l'operazione perché si è verificato un errore durante il tentativo di recuperare le informazioni di Key Vault.

  • 503 DatabaseUnavailable: operazione non riuscita perché il database non è disponibile.

  • 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Esempio

Assigns maintenance window to a database.
Resets maintenance window of a database to default.
Updates a database.

Assigns maintenance window to a database.

Esempio di richiesta

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "sku": {
    "name": "BC_Gen5_4"
  },
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1"
  }
}

Risposta di esempio

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 4
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 4
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Resets maintenance window of a database to default.

Esempio di richiesta

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "sku": {
    "name": "BC_Gen5_4"
  },
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
  }
}

Risposta di esempio

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 4
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_4",
    "requestedServiceObjectiveName": "BC_Gen5_4",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 4
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Updates a database.

Esempio di richiesta

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "sku": {
    "name": "BC_Gen4_4"
  },
  "properties": {
    "maxSizeBytes": 1073741824,
    "licenseType": "LicenseIncluded"
  }
}

Risposta di esempio

{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 4
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "requestedServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 4
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Local",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Definizioni

Nome Descrizione
BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

CatalogCollationType

Regole di confronto del catalogo di metadati.

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

Database

Una risorsa di database.

DatabaseIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

DatabaseIdentityType

Tipo di identità

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncluded se è necessaria una licenza o BasePrice se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

DatabaseStatus

Stato del database.

DatabaseUpdate

Risorsa di aggiornamento del database.

DatabaseUserIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

SampleName

Nome dello schema di esempio da applicare durante la creazione del database.

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

Sku

SKU della risorsa ARM.

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

Valore Descrizione
Geo
GeoZone
Local
Zone

CatalogCollationType

Regole di confronto del catalogo di metadati.

Valore Descrizione
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

Valore Descrizione
Copy
Default
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
Secondary

Database

Una risorsa di database.

Nome Tipo Descrizione
id

string

ID risorsa.

identity

DatabaseIdentity

Identità di Azure Active Directory del database.

kind

string

Tipo di database. Si tratta di metadati usati per l'esperienza del portale di Azure.

location

string

Percorso della risorsa.

managedBy

string

Risorsa che gestisce il database.

name

string

Nome risorsa.

properties.autoPauseDelay

integer (int32)

Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata

properties.catalogCollation

CatalogCollationType

Regole di confronto del catalogo di metadati.

properties.collation

string

Regole di confronto del database.

properties.createMode

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

properties.creationDate

string (date-time)

Data di creazione del database (formato ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

properties.currentServiceObjectiveName

string

Nome dell'obiettivo del livello di servizio corrente del database.

properties.currentSku

Sku

Nome e livello dello SKU.

properties.databaseId

string (uuid)

ID del database.

properties.defaultSecondaryLocation

string

Area secondaria predefinita per questo database.

properties.earliestRestoreDate

string (date-time)

Registra la data e l'ora di inizio meno recente disponibili per il database (ISO8601 formato).

properties.elasticPoolId

string (arm-id)

Identificatore della risorsa del pool elastico contenente il database.

properties.failoverGroupId

string

Identificatore di risorsa del gruppo di failover a cui appartiene il database.

properties.federatedClientId

string (uuid)

ID client usato per lo scenario cmk tra tenant per database

properties.highAvailabilityReplicaCount

integer (int32)

Numero di repliche secondarie associate al database utilizzato per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.

properties.isInfraEncryptionEnabled

boolean

La crittografia a infrastruttura è abilitata per questo database.

properties.isLedgerOn

boolean

Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.

properties.licenseType

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncluded se è necessaria una licenza o BasePrice se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.

properties.longTermRetentionBackupResourceId

string (arm-id)

Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.

properties.maintenanceConfigurationId

string

ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.

properties.maxLogSizeBytes

integer (int64)

Dimensioni massime del log per questo database.

properties.maxSizeBytes

integer (int64)

Dimensione massima del database espressa in byte.

properties.minCapacity

number (double)

Capacità minima allocata dal database, se non sospesa

properties.pausedDate

string (date-time)

Data in cui il database è stato sospeso dalla configurazione utente o dall'azione (formato ISO8601). Null se il database è pronto.

properties.readScale

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

properties.recoverableDatabaseId

string (arm-id)

Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.

properties.recoveryServicesRecoveryPointId

string (arm-id)

Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

properties.requestedServiceObjectiveName

string

Nome dell'obiettivo del livello di servizio richiesto del database.

properties.restorableDroppedDatabaseId

string (arm-id)

Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.

properties.restorePointInTime

string (date-time)

Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.

properties.resumedDate

string (date-time)

Data in cui il database è stato ripreso dall'azione dell'utente o dall'account di accesso al database (ISO8601 formato). Null se il database è sospeso.

properties.sampleName

SampleName

Nome dello schema di esempio da applicare durante la creazione del database.

properties.secondaryType

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

properties.sourceDatabaseDeletionDate

string (date-time)

Specifica l'ora di eliminazione del database.

properties.sourceDatabaseId

string (arm-id)

Identificatore della risorsa del database di origine associato all'operazione di creazione del database.

properties.sourceResourceId

string (arm-id)

Identificatore della risorsa dell'origine associata all'operazione di creazione del database.

Questa proprietà è supportata solo per l'edizione DataWarehouse e consente di eseguire il ripristino tra sottoscrizioni.

Quando si specifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId e sourceDatabaseDeletionDate non devono essere specificati e CreateMode deve essere PointInTimeRestore, Restore o Recover.

Quando createMode è PointInTimeRestore, sourceResourceId deve essere l'ID risorsa del database esistente o del pool SQL esistente e deve essere specificato restorePointInTime.

Quando createMode è Restore, sourceResourceId deve essere l'ID risorsa del database eliminato ripristinabile o ripristinare il pool SQL eliminato.

Quando createMode è Recover, sourceResourceId deve essere l'ID risorsa del database recuperabile o del pool SQL ripristinabile.

Quando la sottoscrizione di origine appartiene a un tenant diverso rispetto alla sottoscrizione di destinazione, l'intestazione "x-ms-authorization-auxiliary" deve contenere il token di autenticazione per il tenant di origine. Per altri dettagli sull'intestazione "x-ms-authorization-auxiliary", vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

properties.status

DatabaseStatus

Stato del database.

properties.zoneRedundant

boolean

Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.

sku

Sku

SKU del database.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags

object

Tag di risorsa.

type

string

Tipo di risorsa.

DatabaseIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
tenantId

string (uuid)

ID tenant di Azure Active Directory.

type

DatabaseIdentityType

Tipo di identità

userAssignedIdentities

<string,  DatabaseUserIdentity>

ID risorsa delle identità assegnate dall'utente da usare

DatabaseIdentityType

Tipo di identità

Valore Descrizione
None
UserAssigned

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncluded se è necessaria una licenza o BasePrice se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.

Valore Descrizione
BasePrice
LicenseIncluded

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

Valore Descrizione
Disabled
Enabled

DatabaseStatus

Stato del database.

Valore Descrizione
AutoClosed
Copying
Creating
Disabled
EmergencyMode
Inaccessible
Offline
OfflineChangingDwPerformanceTiers
OfflineSecondary
Online
OnlineChangingDwPerformanceTiers
Paused
Pausing
Recovering
RecoveryPending
Restoring
Resuming
Scaling
Shutdown
Standby
Starting
Stopped
Stopping
Suspect

DatabaseUpdate

Risorsa di aggiornamento del database.

Nome Tipo Descrizione
identity

DatabaseIdentity

Identità del database

properties.autoPauseDelay

integer (int32)

Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata

properties.catalogCollation

CatalogCollationType

Regole di confronto del catalogo di metadati.

properties.collation

string

Regole di confronto del database.

properties.createMode

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

properties.creationDate

string (date-time)

Data di creazione del database (formato ISO8601).

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

properties.currentServiceObjectiveName

string

Nome dell'obiettivo del livello di servizio corrente del database.

properties.currentSku

Sku

Nome e livello dello SKU.

properties.databaseId

string (uuid)

ID del database.

properties.defaultSecondaryLocation

string

Area secondaria predefinita per questo database.

properties.earliestRestoreDate

string (date-time)

Registra la data e l'ora di inizio meno recente disponibili per il database (ISO8601 formato).

properties.elasticPoolId

string (arm-id)

Identificatore della risorsa del pool elastico contenente il database.

properties.failoverGroupId

string

Identificatore di risorsa del gruppo di failover a cui appartiene il database.

properties.federatedClientId

string (uuid)

ID client usato per lo scenario cmk tra tenant per database

properties.highAvailabilityReplicaCount

integer (int32)

Numero di repliche secondarie associate al database utilizzato per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.

properties.isInfraEncryptionEnabled

boolean

La crittografia a infrastruttura è abilitata per questo database.

properties.isLedgerOn

boolean

Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.

properties.licenseType

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncluded se è necessaria una licenza o BasePrice se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.

properties.longTermRetentionBackupResourceId

string (arm-id)

Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.

properties.maintenanceConfigurationId

string

ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.

properties.maxLogSizeBytes

integer (int64)

Dimensioni massime del log per questo database.

properties.maxSizeBytes

integer (int64)

Dimensione massima del database espressa in byte.

properties.minCapacity

number (double)

Capacità minima allocata dal database, se non sospesa

properties.pausedDate

string (date-time)

Data in cui il database è stato sospeso dalla configurazione utente o dall'azione (formato ISO8601). Null se il database è pronto.

properties.readScale

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

properties.recoverableDatabaseId

string

Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.

properties.recoveryServicesRecoveryPointId

string (arm-id)

Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

properties.requestedServiceObjectiveName

string

Nome dell'obiettivo del livello di servizio richiesto del database.

properties.restorableDroppedDatabaseId

string (arm-id)

Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.

properties.restorePointInTime

string (date-time)

Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.

properties.resumedDate

string (date-time)

Data in cui il database è stato ripreso dall'azione dell'utente o dall'account di accesso al database (ISO8601 formato). Null se il database è sospeso.

properties.sampleName

SampleName

Nome dello schema di esempio da applicare durante la creazione del database.

properties.secondaryType

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

properties.sourceDatabaseDeletionDate

string (date-time)

Specifica l'ora di eliminazione del database.

properties.sourceDatabaseId

string (arm-id)

Identificatore della risorsa del database di origine associato all'operazione di creazione del database.

properties.status

DatabaseStatus

Stato del database.

properties.zoneRedundant

boolean

Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.

sku

Sku

Nome e livello dello SKU.

tags

object

Tag di risorsa.

DatabaseUserIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
clientId

string (uuid)

ID client di Azure Active Directory.

principalId

string (uuid)

ID dell'entità di sicurezza di Azure Active Directory.

SampleName

Nome dello schema di esempio da applicare durante la creazione del database.

Valore Descrizione
AdventureWorksLT
WideWorldImportersFull
WideWorldImportersStd

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

Valore Descrizione
Geo
Named

Sku

SKU della risorsa ARM.

Nome Tipo Descrizione
capacity

integer (int32)

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 numerico, ad esempio P3.

size

string

Dimensioni dello SKU specifico

tier

string

Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.