Transparent Data Encryptions - List By Database

Dienst:

SQL Database

API-Version:

2021-11-01

Ruft eine Liste der transparenten Datenverschlüsselung der logischen Datenbank ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der logischen Datenbank, für die die transparente Datenverschlüsselung definiert ist.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	LogicalDatabaseTransparentDataEncryptionListResult	Die Liste der transparenten Datenverschlüsselung der logischen Datenbank wurde erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 400 SecurityAdalPrincipalCertExpiredError: Der Vorgang konnte nicht abgeschlossen werden, weil das Azure Key Vault-Prinzipalzertifikat abgelaufen ist. 400 AkvHostNotResolvingFromNode: DER AKV-Host "{0}" kann von SQL auf dem Server "{1}" nicht aufgelöst werden. 400 SecurityInvalidAzureKeyVaultRecoveryLevel: Der bereitgestellte Key Vault URI ist ungültig. 400 KeyMaterialNotFoundOnRemoteServer: Der Remoteserver hat keinen Zugriff auf Schlüsselmaterial, das als TDE-Schutzvorrichtung verwendet wird. 400 AzureKeyVaultRsaKeyNotSupported: Der bereitgestellte Schlüsseltresor verwendet nicht unterstützte RSA-Schlüsselgröße oder -Schlüsseltyp. Die unterstützte RSA-Schlüsselgröße ist 2048 oder 3072, und der Schlüsseltyp ist RSA oder RSA-HSM. 400 AzureKeyVaultKeyDisabled: Der Vorgang konnte auf dem Server nicht abgeschlossen werden, da der Azure Key Vault-Schlüssel deaktiviert ist. 400 AzureKeyVaultInvalidExpirationDate: Der Vorgang konnte nicht abgeschlossen werden, da das Ablaufdatum des Azure Key Vault Schlüssels ungültig ist. 400 SameKeyUriNotFoundOnRemoteServer: Auf dem sekundären Server wird nicht das Schlüsselmaterial aus demselben Schlüsseltresor wie die Verschlüsselungsschutzvorrichtung des primären Servers mit aktivierter automatischer Schlüsselrotation verwendet. 400 SecurityAzureKeyVaultUrlNullOrEmpty: Der Vorgang konnte nicht abgeschlossen werden, da der Azure Key Vault-URI NULL oder leer ist. 400 SameKeyMaterialNotFoundOnRemoteServer: Der sekundäre Server verfügt nicht über das Schlüsselmaterial der Verschlüsselungsschutzvorrichtung des primären Servers. 400 PerDatabaseCMKRestoreNotSupported: Die Datenbankwiederherstellung wird nicht unterstützt, wenn CMK auf Datenbankebene in der Vorschau konfiguriert ist. 400 AzureKeyVaultNoServerIdentity: Die Serveridentität ist nicht ordnungsgemäß konfiguriert. 400 PerDatabaseCMKHSNotSupported: CMK auf Datenbankebene in der Vorschau wird für die Hyperscale-Edition nicht unterstützt. 400 AzureKeyVaultInvalidUri: Eine ungültige Antwort von Azure Key Vault. Verwenden Sie einen gültigen Azure Key Vault-URI. 400 AzureKeyVaultMissingPermissions: Dem Server fehlen die erforderlichen Berechtigungen für die Azure Key Vault. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId, die vom Benutzer bereitgestellt wird, hat keinen Zugriff auf die bereitgestellte KeyId. 400 AkvEndpointNotReachableFromNode: DER AKV-Endpunkt "{0}" ist von SQL auf dem Server "{1}" nicht erreichbar. 400 SecurityAzureKeyVaultInvalidKeyName: Der Vorgang konnte aufgrund eines ungültigen Serverschlüsselnamens nicht abgeschlossen werden. 400 AdalGenericError: Der Vorgang konnte nicht abgeschlossen werden, weil ein Azure Active Directory-Fehler aufgetreten ist. 400 AdalServicePrincipalNotFound: Der Vorgang konnte nicht abgeschlossen werden, weil ein Fehler vom Dienstprinzipal der Azure Active Directory-Bibliothek nicht gefunden wurde. 400 AzureKeyVaultMalformedVaultUri: Der bereitgestellte Key Vault URI ist ungültig. 400 SecurityAzureKeyVaultGeoChainError: Das Erstellen einer sekundären sekundären Instanz (ein Prozess, der als Verkettung bezeichnet wird) wird beim Aktivieren von Transparent Data Encryption mit Azure Key Vault (BYOK) nicht unterstützt. 400 PerDatabaseCMKDWNotSupported: CMK auf Datenbankebene in der Vorschau wird für die Datawarehouse-Edition nicht unterstützt. 400 ReadOnly: Die Datenbankverschlüsselung kann für eine Datenbank, die schreibgeschützt ist, schreibgeschützte Dateien aufweist oder nicht wiederhergestellt wird, nicht aktiviert oder geändert werden kann. 400 CanNotDropAlterOnMirror: Ändern Sie die Transparente Datenverschlüsselung für die primären Datenbanken. 400 AttemptedEncryptionOnSystemDatabase: Eine Systemdatenbank kann nicht verschlüsselt werden. Datenbankverschlüsselungsvorgänge können nicht für die Datenbanken 'master', 'model', 'tempdb', 'msdb' oder 'resource' ausgeführt werden. 401 CanNotChangeReadOnlyDuringTdeScan: Der schreibgeschützte/schreibgeschützte Zustand der Dateigruppe kann nicht geändert werden, während ein Verschlüsselungsübergang ausgeführt wird. 409 ServerKeyNameAlreadyExists: Der Serverschlüssel ist bereits auf dem Server vorhanden. 409 ServerKeyUriAlreadyExists: Der Serverschlüssel-URI ist bereits auf dem Server vorhanden. 409 ServerKeyDoesNotExists: Der Serverschlüssel ist nicht vorhanden. 409 AzureKeyVaultKeyNameNotFound: Der Vorgang konnte nicht abgeschlossen werden, da der Azure Key Vault Schlüsselname nicht vorhanden ist. 409 AzureKeyVaultKeyInUse: Der Schlüssel wird derzeit vom Server verwendet. 409 NeedsLogBackup: Warten Sie einige Minuten, bis eine Protokollsicherung erfolgt. 409 EncryptionInProgress: Die Verschlüsselung kann nicht geändert werden, während eine Verschlüsselungsüberprüfung ausgeführt wird. 409 KeyChangeInProgress: Der Verschlüsselungsschlüssel der Datenbank kann nicht geändert werden, während eine Verschlüsselung, Entschlüsselung oder Schlüsseländerungsüberprüfung ausgeführt wird. 409 NoBulkOperationLock – CREATE/ALTER/DROP DATABASE ENCRYPTION KEY ist fehlgeschlagen, da keine Sperre für die Datenbank platziert werden konnte. Versuchen Sie es später noch einmal. 409 AltStateConflict: Der Vorgang kann nicht für die Datenbank ausgeführt werden, da er an einer Datenbankspiegelungssitzung oder einer Verfügbarkeitsgruppe beteiligt ist. Einige Vorgänge sind für eine Datenbank, die an einer Datenbankspiegelungssitzung oder einer Verfügbarkeitsgruppe teilnimmt, nicht zulässig. 503 AzureKeyVaultConnectionFailed: Der Vorgang konnte auf dem Server nicht abgeschlossen werden, da versuche, eine Verbindung mit Azure Key Vault herzustellen, fehlgeschlagen sind. 503 AzureKeyVaultGenericConnectionError: Der Vorgang konnte nicht abgeschlossen werden, da beim Versuch, Key Vault Informationen abzurufen, ein Fehler aufgetreten ist. 503 NoDekLock – CREATE/ALTER/DROP DATABASE ENCRYPTION KEY ist fehlgeschlagen, weil keine Sperre für die Datenbank platziert werden konnte. Versuchen Sie es später noch einmal.

Beispiele

Get a list of the database's transparent data encryption

Beispielanforderung

HTTP

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

Java

/**
 * Samples for TransparentDataEncryptions ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/TransparentDataEncryptionList.json
     */
    /**
     * Sample code: Get a list of the database's transparent data encryption.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAListOfTheDatabaseSTransparentDataEncryption(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getTransparentDataEncryptions()
            .listByDatabase("security-tde-resourcegroup", "securitytde", "testdb", com.azure.core.util.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

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "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"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
LogicalDatabaseTransparentDataEncryption	Ein transparenter Datenverschlüsselungsstatus einer logischen Datenbank.
LogicalDatabaseTransparentDataEncryptionListResult	Eine Liste transparenter Datenverschlüsselungen
TransparentDataEncryptionState	Gibt den Status der transparenten Datenverschlüsselung an.

LogicalDatabaseTransparentDataEncryption

Ein transparenter Datenverschlüsselungsstatus einer logischen Datenbank.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.state	TransparentDataEncryptionState	Gibt den Status der transparenten Datenverschlüsselung an.
type	string	Der Ressourcentyp.

LogicalDatabaseTransparentDataEncryptionListResult

Eine Liste transparenter Datenverschlüsselungen

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	LogicalDatabaseTransparentDataEncryption[]	Array von Ergebnissen.

TransparentDataEncryptionState

Gibt den Status der transparenten Datenverschlüsselung an.

Name	Typ	Beschreibung
Disabled	string
Enabled	string