Transparent Data Encryptions - Get

Service:

SQL Database

API Version:

2021-11-01

取得邏輯資料庫的透明數據加密。

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

URI 參數

名稱	位於	必要	類型	Description
databaseName	path	True	string	定義透明數據加密的邏輯資料庫名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
tdeName	path	True	TransparentDataEncryptionName	透明數據加密組態的名稱。
api-version	query	True	string	要用於要求的 API 版本。

回應

名稱	類型	Description
200 OK	LogicalDatabaseTransparentDataEncryption	已成功擷取邏輯資料庫透明數據加密。
Other Status Codes		錯誤回應： ≦ 400 SecurityAdalPrincipalCertExpiredError - 作業無法完成，因為 Azure 金鑰保存庫 主體憑證已過期。 400 AkvHostNotResolvingFromNode - 伺服器 '' 上的{1} AKV 主機 '{0}' 無法從 SQL 解析。 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 提供的 金鑰保存庫 URI 無效。 400 KeyMaterialNotFoundOnRemoteServer - 遠端伺服器無法存取做為 TDE 保護裝置的金鑰數據。 400 AzureKeyVaultRsaKeyNotSupported - 提供的密鑰保存庫使用不支援的 RSA 金鑰大小或密鑰類型。 支援的 RSA 金鑰大小為 2048 或 3072，金鑰類型為 RSA 或 RSA-HSM。 400 AzureKeyVaultKeyDisabled - 無法在伺服器上完成作業，因為 Azure 金鑰保存庫 密鑰已停用。 400 AzureKeyVaultInvalidExpirationDate - 作業無法完成，因為 Azure 金鑰保存庫 密鑰到期日無效。 400 SameKeyUriNotFoundOnRemoteServer - 輔助伺服器沒有與主伺服器加密保護裝置相同的密鑰保存庫的密鑰數據，且已啟用密鑰自動輪替。 400 SecurityAzureKeyVaultUrlNullOrEmpty - 作業無法完成，因為 Azure 金鑰保存庫 Uri 為 Null 或空白。 400 SameKeyMaterialNotFoundOnRemoteServer - 輔助伺服器沒有主伺服器加密保護裝置的密鑰數據。 400 PerDatabaseCMKRestoreNotSupported - 在預覽中設定資料庫層級 CMK 時，不支持資料庫還原。 400 AzureKeyVaultNoServerIdentity - 未正確設定伺服器識別。 400 PerDatabaseCMKHSNotSupported - 超大規模資料庫版本不支援預覽版的資料庫層級 CMK。 400 AzureKeyVaultInvalidUri - 來自 Azure 金鑰保存庫 的無效回應。 請使用有效的 Azure 金鑰保存庫 URI。 400 AzureKeyVaultMissingPermissions - 伺服器缺少 Azure 金鑰保存庫 的必要許可權。 400 UmiMissingAkvPermissions - 使用者所提供的 PrimaryUserAssignedIdentityId 無法存取提供的 KeyId 400 AkvEndpointNotReachableFromNode - 無法在伺服器 '' 上從 SQL 連線到 AKV 端點 '{0}{1}'。 400 SecurityAzureKeyVaultInvalidKeyName - 作業無法完成，因為伺服器密鑰名稱無效。 400 AdalGenericError - 作業無法完成，因為發生 Azure Active Directory 錯誤。 400 AdalServicePrincipalNotFound - 作業無法完成，因為發生 Azure Active Directory 連結庫服務主體找不到錯誤。 400 AzureKeyVaultMalformedVaultUri - 提供的 金鑰保存庫 uri 無效。 400 SecurityAzureKeyVaultGeoChainError - 使用 Azure 金鑰保存庫 (BYOK) 啟用透明數據加密時，不支援建立次要 (的次要 (稱為鏈結) 。 400 PerDatabaseCMKDWNotSupported - Datawarehouse 版本不支援預覽中的資料庫層級 CMK。 400 ReadOnly - 無法在唯讀、具有唯讀檔案或未復原的資料庫上啟用或修改資料庫加密。 400 CanNotDropAlterOnMirror - 請修改主資料庫上的透明數據加密。 400 AttemptedEncryptionOnSystemDatabase - 無法加密系統資料庫。 系統無法對 'master'、'model'、'tempdb'、'msdb' 或 'resource' 資料庫進行資料庫加密作業。 401 CanNotChangeReadOnlyDuringTdeScan - 無法在加密轉換進行時修改檔案群組只讀/讀寫狀態。 409 ServerKeyNameAlreadyExists - 伺服器密鑰已存在於伺服器上。 409 ServerKeyUriAlreadyExists - 伺服器密鑰 URI 已存在於伺服器上。 「409 ServerKeyDoesNotExists - 伺服器金鑰不存在。」 409 AzureKeyVaultKeyNameNotFound - 無法完成作業，因為 Azure 金鑰保存庫 密鑰名稱不存在。 409 AzureKeyVaultKeyInUse - 伺服器目前正在使用密鑰。 409 NeedsLogBackup - 請等候數分鐘，記錄備份發生。 409 EncryptionInProgress - 無法在加密掃描進行時修改加密。 409 KeyChangeInProgress - 無法在加密、解密或密鑰變更掃描進行時變更資料庫加密密鑰。 409 NoBulkOperationLock - CREATE/ALTER/DROP DATABASE ENCRYPTION KEY 失敗，因為無法將鎖定放在資料庫上。 請稍後再試一次。 409 AltStateConflict - 作業無法在資料庫上執行，因為它涉及資料庫鏡像會話或可用性群組。 參與資料庫鏡像會話或可用性群組的資料庫上不允許某些作業。 503 AzureKeyVaultConnectionFailed - 無法在伺服器上完成作業，因為嘗試連線到 Azure 金鑰保存庫 失敗 503 AzureKeyVaultGenericConnectionError - 作業無法完成，因為嘗試擷取 金鑰保存庫 資訊時發生錯誤。 503 NoDekLock - CREATE/ALTER/DROP DATABASE ENCRYPTION KEY 失敗，因為無法將鎖定放在資料庫上。 請稍後再試一次。

範例

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"
  }
}

定義

名稱	Description
LogicalDatabaseTransparentDataEncryption	邏輯資料庫透明數據加密狀態。
TransparentDataEncryptionName	透明數據加密組態的名稱。
TransparentDataEncryptionState	指定透明數據加密的狀態。

LogicalDatabaseTransparentDataEncryption

邏輯資料庫透明數據加密狀態。

名稱	類型	Description
id	string	資源識別碼。
name	string	資源名稱。
properties.state	TransparentDataEncryptionState	指定透明數據加密的狀態。
type	string	資源類型。

TransparentDataEncryptionName

透明數據加密組態的名稱。

名稱	類型	Description
current	string

TransparentDataEncryptionState

指定透明數據加密的狀態。

名稱	類型	Description
Disabled	string
Enabled	string