Transparent Data Encryptions - Get

Service:

SQL Database

API Version:

2021-11-01

Ottiene la crittografia dei dati trasparente di un database logico.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database logico per il quale è definita la crittografia dei dati trasparente.
resourceGroupName	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.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
tdeName	path	True	TransparentDataEncryptionName	Nome della configurazione di crittografia dati trasparente.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	LogicalDatabaseTransparentDataEncryption	È stato recuperato correttamente la crittografia dei dati trasparente del database logico.
Other Status Codes		Risposte agli errori: ** 400 SecurityAdalPrincipalCertExpiredError - Impossibile completare l'operazione perché il certificato dell'entità di azure Key Vault è scaduto. 400 AkvHostNotResolvingFromNode - host AKV '{0}' non è risolvibile da SQL, nel server '{1}'. 400 SecurityInvalidAzureKeyVaultRecoveryLevel - L'URI fornito Key Vault non è valido. 400 KeyMaterialNotFoundOnRemoteServer - Il server remoto non ha accesso al materiale chiave usato come protezione TDE. 400 AzureKeyVaultRsaKeyNotSupported: l'insieme di credenziali delle chiavi fornito usa dimensioni chiave RSA o tipo di chiave non supportato. Le dimensioni della chiave RSA supportate sono 2048 o 3072 e il tipo di chiave è RSA o RSA-HSM. 400 AzureKeyVaultKeyDisabled: impossibile completare l'operazione nel server perché la chiave di Key Vault di Azure è disabilitata. 400 AzureKeyVaultInvalidExpirationDate - Impossibile completare l'operazione perché la data di scadenza della chiave di Azure Key Vault non è valida. 400 SameKeyUriNotFoundOnRemoteServer - Il server secondario non dispone del materiale della chiave dello stesso insieme di credenziali delle chiavi della protezione della crittografia del server primario con rotazione automatica della chiave abilitata. 400 SecurityAzureKeyVaultUrlNullOrEmpty - Impossibile completare l'operazione perché l'URI di Azure Key Vault è null o vuoto. 400 SameKeyMaterialNotFoundOnRemoteServer - Il server secondario non ha il materiale chiave della protezione di crittografia del server primario. 400 PerDatabaseCMKRestoreNotSupported - Il ripristino del database non è supportato quando il cmK a livello di database è configurato in anteprima. 400 AzureKeyVaultNoServerIdentity : l'identità del server non è configurata correttamente. 400 PerDatabaseCMKHSNotSupported - CmK a livello di database in anteprima non è supportato per Hyperscale Edition. 400 AzureKeyVaultInvalidUri - Risposta non valida da Azure Key Vault. Usare un URI di Azure Key Vault valido. 400 AzureKeyVaultMissingPermissions: il server manca delle autorizzazioni necessarie per l'Key Vault di Azure. 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fornito dall'utente non ha accesso a KeyId fornito 400 AkvEndpointNotReachableFromNode - endpoint AKV '{0}' non è raggiungibile da SQL, nel server '{1}'. 400 SecurityAzureKeyVaultInvalidKeyName- Impossibile completare l'operazione a causa di un nome chiave server non valido. 400 AdalGenericError: impossibile completare l'operazione perché è stato rilevato un errore di Azure Active Directory. 400 AdalServicePrincipalNotFound - Impossibile completare l'operazione perché è stato rilevato un errore dell'entità servizio libreria di Azure Active Directory. 400 AzureKeyVaultMalformedVaultUri: l'uri Key Vault fornito non è valido. 400 SecurityAzureKeyVaultGeoChainError - Creazione di un processo secondario (un processo noto come concatenamento) non è supportato quando si abilita Transparent Data Encryption usando Azure Key Vault (BYOK). 400 PerDatabaseCMKDWNotSupported - CmK a livello di database in anteprima non è supportato per l'edizione Datawarehouse. 400 ReadOnly- Impossibile abilitare o modificare la crittografia del database in un database di sola lettura, con file di sola lettura o non ripristinati. 400 CanNotDropAlterOnMirror - Modificare Transparent Data Encryption nei database primari. 400 TentativoedEncryptionOnSystemDatabase - Impossibile crittografare un database di sistema. Impossibile eseguire operazioni di crittografia per i database 'master', 'model', 'tempdb', 'msdb' o 'resource'. 401 CanNotChangeReadOnlyDuringTdeScan - Impossibile modificare lo stato di sola lettura/lettura/scrittura mentre è in corso una transizione di crittografia. 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 server non esiste. 409 AzureKeyVaultKeyKeyNameNotFound- Impossibile completare l'operazione perché il nome della chiave di Azure Key Vault non esiste. 409 AzureKeyVaultKeyInUse: la chiave è attualmente usata dal server. 409 NeedsLogBackup: attendere alcuni minuti per l'esecuzione di un backup del log. 409 EncryptionInProgress - Impossibile modificare la crittografia durante un'analisi della crittografia in corso. 409 KeyChangeInProgress - Impossibile modificare la chiave di crittografia del database mentre è in corso un'analisi di crittografia, decrittografia o modifica della chiave. 409 NoBulkOperationLock - CREATE/ALTER/DROP DATABASE ENCRYPTION KEY non riuscito perché non è stato possibile inserire un blocco nel database. Riprovare più tardi. 409 AltStateConflict: l'operazione non può essere eseguita nel database perché è coinvolta in una sessione di mirroring del database o in un gruppo di disponibilità. Alcune operazioni non sono consentite in un database che partecipa a una sessione di mirroring del database o in un gruppo di disponibilità. 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 informazioni Key Vault . 503 NoDekLock - CREATE/ALTER/DROP DATABASE ENCRYPTION KEY non riuscito perché non è stato possibile inserire un blocco nel database. Riprovare più tardi.

Esempio

Get a database's transparent data encryption

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/security-tde-resourcegroup/providers/Microsoft.Sql/servers/securitytde/databases/testdb/transparentDataEncryption/current?api-version=2021-11-01

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.TransparentDataEncryptionName;

/** Samples for TransparentDataEncryptions Get. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/TransparentDataEncryptionGet.json
     */
    /**
     * Sample code: Get a database's transparent data encryption.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getADatabaseSTransparentDataEncryption(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getTransparentDataEncryptions().getWithResponse(
            "security-tde-resourcegroup", "securitytde", "testdb", TransparentDataEncryptionName.CURRENT, Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/security-tde-resourcegroup/providers/Microsoft.Sql/servers/securitytde/databases/testdb",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/transparentDataEncryption",
  "properties": {
    "state": "Enabled"
  }
}

Definizioni

Nome	Descrizione
LogicalDatabaseTransparentDataEncryption	Uno stato di crittografia dei dati trasparente per il database logico.
TransparentDataEncryptionName	Nome della configurazione di crittografia dati trasparente.
TransparentDataEncryptionState	Specifica lo stato della crittografia dei dati trasparente.

LogicalDatabaseTransparentDataEncryption

Uno stato di crittografia dei dati trasparente per il database logico.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.state	TransparentDataEncryptionState	Specifica lo stato della crittografia dei dati trasparente.
type	string	Tipo di risorsa.

TransparentDataEncryptionName

Nome della configurazione di crittografia dati trasparente.

Nome	Tipo	Descrizione
current	string

TransparentDataEncryptionState

Specifica lo stato della crittografia dei dati trasparente.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string