Megosztás a következőn keresztül:


Transparent Data Encryptions - Create Or Update

Frissíti a logikai adatbázisok transzparens adattitkosítási konfigurációját.

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

URI-paraméterek

Name In Kötelező Típus Description
databaseName
path True

string

Annak a logikai adatbázisnak a neve, amelyhez a biztonsági riasztási szabályzat definiálva van.

resourceGroupName
path True

string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True

string

A kiszolgáló neve.

subscriptionId
path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.

tdeName
path True

TransparentDataEncryptionName

A transzparens adattitkosítási konfiguráció neve.

api-version
query True

string

A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name Kötelező Típus Description
properties.state True

TransparentDataEncryptionState

A transzparens adattitkosítás állapotát adja meg.

Válaszok

Name Típus Description
200 OK

LogicalDatabaseTransparentDataEncryption

Sikeresen frissítette az adatbázis transzparens adattitkosítási állapotát.

201 Created

LogicalDatabaseTransparentDataEncryption

Sikeresen létrehozta az adatbázis transzparens adattitkosítási állapotát.

202 Accepted

Az adatbázis transzparens adattitkosítási konfigurációjának létrehozása vagy frissítése folyamatban van.

Fejlécek

Location: string

Other Status Codes

ErrorResponse

Hibaválaszok: ***

  • 400 SecurityAdalPrincipalCertExpiredError – A művelet nem hajtható végre, mert az Azure Key Vault főtanúsítványa lejárt.

  • 400 AkvHostNotResolvingFromNode – Az AKV-gazdagép{0}' nem oldható fel az SQL-ből,{1}kiszolgálón.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel – A megadott Key Vault URI érvénytelen.

  • 400 MissingKeyVaultUriForRestore – Az Azure Key Vault kulcsának URI -{0}' szükséges a{1}" kiszolgáló alatti{2}adatbázis sikeres visszaállításához.

  • 400 AzureKeyVaultKeyUsedOnGeoPrimary – A művelet nem hajtható végre, mert az Azure Key Vault kulcsnév {0} jelenleg titkosítási védőként van beállítva a geo-elsődlegesen.

  • 400 KeyMaterialNotFoundOnRemoteServer – A távoli kiszolgáló nem rendelkezik hozzáféréssel a TDE-védőként használt kulcsanyagokhoz.

  • 400 PerDatabaseCMKAKVKeyMaterialMissingOnGeoSecondary – A georeplikációban lévő összes adatbázisnak ugyanazt a kulcsanyagot kell tartalmaznia, mint a forrásadatbázis titkosítási védőjének. Adja hozzá a "{0}" kulcsot ugyanazzal a kulcsanyaggal a céladatbázishoz{1}".

  • 400 AzureKeyVaultRsaKeyNotSupported – A megadott kulcstartó nem támogatott RSA-kulcsméretet vagy kulcstípust használ. A támogatott RSA-kulcsméret 2048 vagy 3072, a kulcstípus pedig RSA vagy RSA-HSM.

  • 400 PerDatabaseCMKAKVKeyUriMissingOnGeoSecondary – Ha az adatbázisszintű TDE Protector automatikus elforgatása engedélyezve van, a forrás- és céladatbázisoknak is ugyanahhoz a kulcstartóhoz kell csatlakozniuk. Adja hozzá a "{0}" kulcsot (ugyanabból a kulcstartóból, amely a forrásadatbázishoz csatlakozik) a céladatbázishoz "{1}'.

  • 400 PerDatabaseCMKCopyOrReplicationAttemptedWithoutCurrentKeysWithDatabaseName – Az adatbázisszintű titkosítási védelemmel konfigurált adatbázis replikálása közben az elsődleges adatbázis által használt aktuális kulcsokat át kell adni a másodlagos adatbázisnak{0}'

  • 400 ManagedInstanceNoConditionToMakeDatabaseAccessible – A művelet nem hajtható végre, mert nincs elegendő engedély az akadálymentes munkafolyamat elindításához a felügyelt példányon {0}.

  • 400 UmiMissingAkvPermissions – A felhasználó által megadott PrimaryUserAssignedIdentityId nem rendelkezik hozzáféréssel a megadott KeyId-hez

  • 400 SameKeyUriNotFoundOnRemoteServer – A másodlagos kiszolgáló nem rendelkezik a kulcs anyagával ugyanabból a kulcstartóból, mint az elsődleges kiszolgáló titkosítási védője, és a kulcs automatikus elforgatása engedélyezve van.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – A másodlagos kiszolgáló nem rendelkezik az elsődleges kiszolgáló titkosítási védőjének kulcsanyagával.

  • 400 SecurityAzureKeyVaultGeoChainError – A másodlagos (láncolásnak nevezett) folyamat másodlagos létrehozása nem támogatott az Transzparens adattitkosítás Azure Key Vault (BYOK) használatával történő engedélyezésekor.

  • 400 PerDatabaseCMKDWNotSupported – Az adatbázisszintű CMK előzetes verzióban nem támogatott a Datawarehouse kiadásban.

  • 400 BlockSystemAssignedIdentityForCrossTenantCMK – A bérlők közötti CMK csak akkor konfigurálható, ha a kiszolgáló felhasználó által hozzárendelt felügyelt identitással van konfigurálva. A felhasználó által hozzárendelt felügyelt identitás konfigurálásához tekintse meg https://aka.ms/sqltdebyokumi.

  • 400 PerDatabaseCMKCopyOrReplicationAttemptedWithoutCurrentKeys – Az adatbázisszintű titkosítási védővel konfigurált adatbázis replikálása közben az elsődleges által használt aktuális kulcsokat át kell adni a másodlagos adatbázisnak.

  • 400 CannotDropDatabaseAKVError – A kiszolgálón {0} adatbázis {1} nem lehet biztonságosan elvetni, mert olyan ügyfél által felügyelt kulccsal van titkosítva, amely már nem érhető el az utolsó biztonsági mentés levétele előtt. Állítsa vissza az Azure Key Vault Accesst a kiszolgálón, és állítsa újra újra a kulcsokat, hogy az adatbázis akadálymentes legyen, majd folytassa a ledobással. További részletekért lásd: https://aka.ms/tdecmkrestorability

  • 400 CreateDatabaseAttemptedWithRotationInProgress – Az adatbázis létrehozása művelet jelenleg nem hajtható végre, mert folyamatban van a transzparens adattitkosítás (TDE) kulcsváltása a kiszolgálón. Próbálkozzon újra később.

  • 400 AzureKeyVaultKeyDisabled – A művelet nem hajtható végre a kiszolgálón, mert az Azure Key Vault-kulcs le van tiltva.

  • 400 PerDatabaseCMKRestoreNotSupported – Az adatbázis-visszaállítás nem támogatott, ha az adatbázisszintű CMK előzetes verzióban van konfigurálva.

  • 400 AzureKeyVaultInvalidExpirationDate – A művelet nem hajtható végre, mert az Azure Key Vault kulcs lejárati dátuma érvénytelen.

  • 400 PerDatabaseCMKHSNotSupported – Az előzetes verziójú adatbázisszintű CMK nem támogatott a rugalmas skálázású kiadások esetében.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – A művelet nem hajtható végre, mert az Azure Key Vault Uri értéke null értékű vagy üres.

  • 400 CMKOperationNotAllowed – A felhasználó megpróbált végrehajtani egy műveletet a kiszolgálón, amikor a kiszolgáló nem rendelkezik Azure Key Vault-hozzáféréssel.

  • 400 AkvEndpointNotReachableFromNode – Az AKV-végpont "{0}' nem érhető el az SQL-ből, a kiszolgáló "{1}" kiszolgálón.

  • 400 AzureKeyVaultNoServerIdentity – A kiszolgálóidentitás nincs megfelelően konfigurálva.

  • 400 AzureKeyVaultInvalidUri – Érvénytelen válasz az Azure Key Vaulttól. Használjon érvényes Azure Key Vault URI-t.

  • 400 AzureKeyVaultMissingPermissions – A kiszolgáló nem rendelkezik szükséges engedélyekkel az Azure Key Vaultban.

  • 400 AzureKeyVaultKeyNameCurrentlyInUse – A művelet nem hajtható végre, mert az Azure Key Vault-kulcs neve {0} jelenleg használatban van.

  • 400 AzureKeyVaultKeyThumbprintIsDifferent – A művelet nem hajtható végre, mert az Azure Key Vault-kulcs anyaga eltér az aktuális titkosítási védőkulcstól.

  • 400 SecurityAzureKeyVaultInvalidKeyName – Érvénytelen kiszolgálókulcsnév miatt nem sikerült végrehajtani a műveletet.

  • 400 OldGenerationOfAKVKeyBeingUsedError – Az AKV-kulcs régi verziójának használata TDE-védőként nem engedélyezett. Használja az AKV-kulcs legújabb verzióját titkosítási védőként

  • 400 PerDatabaseCMKMissingIdentityOnGeoSecondaryDatabase – Adatbázisonkénti CMK-identitás nincs beállítva a céladatbázison.

  • 400 AdalGenericError – A művelet nem hajtható végre, mert hiba történt az Azure Active Directoryban.

  • 400 AdalServicePrincipalNotFound – A művelet nem hajtható végre, mert egy Azure Active Directory-kódtár szolgáltatásnév nem talált hibát.

  • 400 AzureKeyVaultMalformedVaultUri – A megadott Key Vault uri érvénytelen.

  • 400 AttemptedEncryptionOnSystemDatabase – Rendszeradatbázis nem titkosítható. Az adatbázistitkosítási műveletek nem végezhetők el a "master", a "model", a "tempdb", az "msdb" vagy az "resource" adatbázisok esetében.

  • 400 ReadOnly – Nem lehet engedélyezni vagy módosítani az adatbázis titkosítását olyan adatbázison, amely írásvédett, írásvédett fájlokat tartalmaz, vagy nem állítható helyre.

  • 400 CanNotChangeReadOnlyDuringTdeScan – Nem módosítható a fájlcsoport írásvédett/írási állapota, miközben a titkosítási átmenet folyamatban van.

  • 400 CanNotDropAlterOnMirror – Módosítsa a transzparens adattitkosítást az elsődleges adatbázisokon.

  • 400 ManagedInstanceStoppingOrStopped – Ütköző művelet van elküldve, miközben a példány leáll/leállított állapotban van

  • 400 ManagedInstanceStarting – Ütköző művelet küldve, miközben a példány kezdő állapotban van

  • 400 InvalidTransparentDataEncryptionUpdateRequest – Adjon meg érvényes állapotot. Használja az "Engedélyezve" vagy a "Letiltva" lehetőséget.

  • 400 InvalidTransparentDataEncryptionName – A transzparens adattitkosítási kulcs neve nem támogatott.

  • 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik.

  • 409 ServerKeyNameAlreadyExists – A kiszolgálókulcs már létezik a kiszolgálón.

  • 409 ServerKeyUriAlreadyExists – A kiszolgálókulcs URI-ja már létezik a kiszolgálón.

  • 409 ServerKeyDoesNotExists – A kiszolgálókulcs nem létezik.

  • 409 AzureKeyVaultKeyNameNotFound – A művelet nem hajtható végre, mert az Azure Key Vault kulcsneve nem létezik.

  • 409 AzureKeyVaultKeyInUse – A kulcsot jelenleg a kiszolgáló használja.

  • 409 EncryptionInProgress – A titkosítás nem módosítható, amíg a titkosítási vizsgálat folyamatban van.

  • 409 KeyChangeInProgress – Nem módosítható az adatbázis titkosítási kulcsa, amíg a titkosítás, a visszafejtés vagy a kulcsmódosítás vizsgálata folyamatban van.

  • 409 NoBulkOperationLock – A CREATE/ALTER/DROP ADATBÁZIS TITKOSÍTÁSI KULCSA nem sikerült, mert a zárolás nem helyezhető el az adatbázison. Próbálkozzon újra később.

  • 409 NeedsLogBackup – Várjon néhány percet a napló biztonsági mentésének végrehajtására.

  • 409 AltStateConflict – A művelet nem hajtható végre az adatbázisban, mert adatbázis-tükrözési munkamenetben vagy rendelkezésre állási csoportban vesz részt. Egyes műveletek nem engedélyezettek olyan adatbázisokon, amelyek adatbázis-tükrözési munkamenetben vagy rendelkezésre állási csoportban vesznek részt.

  • 409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető.

  • 409 OperationCancelled – A felhasználó megszakította a műveletet.

  • 409 OperationInterrupted – Az erőforráson lévő művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése.

  • 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel.

  • 503 AzureKeyVaultConnectionFailed – A művelet nem hajtható végre a kiszolgálón, mert sikertelen volt az Azure Key Vaulthoz való kapcsolódási kísérlet

  • 503 AzureKeyVaultGenericConnectionError – A művelet nem hajtható végre, mert hiba történt a Key Vault adatainak lekérésekor.

  • 503 NoDekLock – A CREATE/ALTER/DROP ADATBÁZIS TITKOSÍTÁSI KULCSA nem sikerült, mert nem sikerült zárolni az adatbázist. Próbálkozzon újra később.

  • 503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Update a database's Transparent Data Encryption state with minimal parameters

Mintakérelem

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/servers/securitytde-42/databases/testdb/transparentDataEncryption/current?api-version=2023-08-01

{
  "properties": {
    "state": "Enabled"
  }
}

Mintaválasz

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/servers/securitytde-42/databases/testdb/transparentDataEncryption",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/transparentDataEncryption",
  "properties": {
    "state": "Enabled"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/servers/securitytde-42/databases/testdb/transparentDataEncryption",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/transparentDataEncryption",
  "properties": {
    "state": "Enabled"
  }
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/locations/southeastasia/transparentDataEncryptionOperationResults/11111111-1111-1111-1111-111111111111

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

LogicalDatabaseTransparentDataEncryption

Logikai adatbázis transzparens adattitkosítási állapota.

TransparentDataEncryptionName

A transzparens adattitkosítási konfiguráció neve.

TransparentDataEncryptionState

A transzparens adattitkosítás állapotát adja meg.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

LogicalDatabaseTransparentDataEncryption

Logikai adatbázis transzparens adattitkosítási állapota.

Name Típus Description
id

string

Erőforrás-azonosító.

name

string

Erőforrás neve.

properties.state

TransparentDataEncryptionState

A transzparens adattitkosítás állapotát adja meg.

type

string

Erőforrás típusa.

TransparentDataEncryptionName

A transzparens adattitkosítási konfiguráció neve.

Érték Description
current

TransparentDataEncryptionState

A transzparens adattitkosítás állapotát adja meg.

Érték Description
Enabled
Disabled