Dela via

Transparent Data Encryptions - Create Or Update

  • Referens
Tjänst:
SQL Database
API-version:
2023-08-01

Uppdaterar en logisk databass konfiguration av transparent datakryptering.

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

URI-parametrar

Name I Obligatorisk Typ Description
databaseName
 path True

string

Namnet på den logiska databas som säkerhetsaviseringsprincipen har definierats för.
resourceGroupName
 path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName
 path True

string

Namnet på servern.
subscriptionId
 path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.
tdeName
 path True

TransparentDataEncryptionName

Namnet på konfigurationen för transparent datakryptering.
api-version
 query True

string

DEN API-version som ska användas för begäran.

Begärandetext

Name Obligatorisk Typ Description
properties.state True

TransparentDataEncryptionState

Anger tillståndet för transparent datakryptering.

Svar

Name Typ Description
200 OK

LogicalDatabaseTransparentDataEncryption

Databasens transparenta datakrypteringstillstånd har uppdaterats.
201 Created

LogicalDatabaseTransparentDataEncryption

Databasens transparenta datakrypteringstillstånd har skapats.
202 Accepted

Det pågår att skapa eller uppdatera databasens transparenta datakrypteringskonfiguration.

Sidhuvuden

Location: string
Other Status Codes

ErrorResponse

Felsvar: ***

  • 400 SecurityAdalPrincipalCertExpiredError – Åtgärden kunde inte slutföras eftersom Azure Key Vault-huvudcertifikatet har upphört att gälla.

  • 400 AkvHostNotResolvingFromNode – AKV-värden{0}kan inte matchas från SQL, på serverns{1}.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel – Den angivna Key Vault-URI:n är inte giltig.

  • 400 MissingKeyVaultUriForRestore – Azure Key Vault-nyckel-URI{0}krävs för att återställa databasen{1}under servern{2}.

  • 400 AzureKeyVaultKeyUsedOnGeoPrimary – Åtgärden kunde inte slutföras eftersom Azure Key Vault-nyckelnamnet {0} för närvarande har angetts som krypteringsskydd på geo-primärt.

  • 400 KeyMaterialNotFoundOnRemoteServer – Fjärrservern har inte åtkomst till nyckelmaterial som används som TDE-skydd.

  • 400 PerDatabaseCMKAKVKeyMaterialMissingOnGeoSecondary – Alla databaser i geo-replikering måste innehålla samma nyckelmaterial som källdatabasens krypteringsskydd. Lägg till nyckeln{0}med samma nyckelmaterial i måldatabasen{1}.

  • 400 AzureKeyVaultRsaKeyNotSupported – Det angivna nyckelvalvet använder RSA-nyckelstorlek eller nyckeltyp som inte stöds. RSA-nyckelstorleken som stöds är 2048 eller 3072 och nyckeltypen är RSA eller RSA-HSM.

  • 400 PerDatabaseCMKAKVKeyUriMissingOnGeoSecondary – När den automatiska rotationen av TDE-skydd på databasnivå är aktiverad måste både käll- och måldatabaser vara anslutna till samma nyckelvalv. Lägg till nyckeln{0}(från samma nyckelvalv som är anslutet till källdatabasen) till måldatabasen{1}.

  • 400 PerDatabaseCMKCopyOrReplicationAttemptedWithoutCurrentKeysWithDatabaseName – När du försöker replikera en databas som konfigurerats med krypteringsskydd på databasnivå måste de aktuella nycklarna som används av den primära databasen skickas till den sekundära databasen{0}

  • 400 ManagedInstanceNoConditionToMakeDatabaseAccessible – Åtgärden kunde inte slutföras eftersom det inte finns tillräckliga behörigheter för att starta ett tillgängligt arbetsflöde på den hanterade instansen {0}.

  • 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId som tillhandahålls av användaren har inte åtkomst till KeyId som tillhandahålls

  • 400 SameKeyUriNotFoundOnRemoteServer – Sekundär server har inte nyckelmaterialet från samma nyckelvalv som den primära serverns krypteringsskydd med automatisk rotation aktiverad.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – sekundär server har inte nyckelmaterialet för den primära serverns krypteringsskydd.

  • 400 SecurityAzureKeyVaultGeoChainError – Det går inte att skapa sekundär sekundär (en process som kallas länkning) när transparent datakryptering aktiveras med hjälp av Azure Key Vault (BYOK).

  • 400 PerDatabaseCMKDWNotSupported – CMK på databasnivå i förhandsversionen stöds inte för Datawarehouse Edition.

  • 400 BlockSystemAssignedIdentityForCrossTenantCMK – CMK för flera klientorganisationer kan bara konfigureras när servern har konfigurerats med en användartilldelad hanterad identitet. Se https://aka.ms/sqltdebyokumi för att konfigurera användartilldelad hanterad identitet.

  • 400 PerDatabaseCMKCopyOrReplicationAttemptedWithoutCurrentKeys – När du försöker replikera en databas som konfigurerats med krypteringsskydd på databasnivå måste de aktuella nycklar som används av den primära skickas till den sekundära databasen.

  • 400 CannotDropDatabaseAKVError – Databasen {0} på servern {1} inte kan tas bort på ett säkert sätt eftersom den är krypterad med en kundhanterad nyckel som inte längre är tillgänglig för att ta den sista säkerhetskopian innan den släpps. Återställ Azure Key Vault-åtkomst på servern och återställ nycklarna för att göra databasen tillgänglig och fortsätt sedan med släppet. Mer information finns i https://aka.ms/tdecmkrestorability

  • 400 CreateDatabaseAttemptedWithRotationInProgress – Åtgärden skapa databas kan inte utföras just nu på grund av pågående transparent datakryptering (TDE) nyckelrotation på servern. Försök igen senare.

  • 400 AzureKeyVaultKeyDisabled – Det gick inte att slutföra åtgärden på servern eftersom Azure Key Vault-nyckeln är inaktiverad.

  • 400 PerDatabaseCMKRestoreNotSupported – Databasåterställning stöds inte när CMK på databasnivå konfigureras i förhandsversionen.

  • 400 AzureKeyVaultInvalidExpirationDate – Det gick inte att slutföra åtgärden eftersom förfallodatumet för Azure Key Vault-nyckeln är ogiltigt.

  • 400 PerDatabaseCMKHSNotSupported – CMK på databasnivå i förhandsversionen stöds inte för Hyperskala-utgåvan.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-URI:n är null eller tom.

  • 400 CMKOperationNotAllowed – Användaren försökte utföra en åtgärd på servern när servern inte hade Åtkomst till Azure Key Vault.

  • 400 AkvEndpointNotReachableFromNode – AKV-slutpunkten{0}kan inte nås från SQL, på serverns{1}.

  • 400 AzureKeyVaultNoServerIdentity – serveridentiteten är inte korrekt konfigurerad.

  • 400 AzureKeyVaultInvalidUri – ett ogiltigt svar från Azure Key Vault. Använd en giltig Azure Key Vault-URI.

  • 400 AzureKeyVaultMissingPermissions – Servern saknar nödvändiga behörigheter i Azure Key Vault.

  • 400 AzureKeyVaultKeyNameCurrentlyInUse – Åtgärden kunde inte slutföras eftersom Azure Key Vault-nyckelnamnet {0} används för närvarande.

  • 400 AzureKeyVaultKeyThumbprintIsDifferent – Åtgärden kunde inte slutföras eftersom Nyckelmaterialet för Azure Key Vault skiljer sig från den aktuella krypteringsskyddsnyckeln.

  • 400 SecurityAzureKeyVaultInvalidKeyName – Åtgärden kunde inte slutföras på grund av ett ogiltigt servernyckelnamn.

  • 400 OldGenerationOfAKVKeyBeingUsedError – Det är inte tillåtet att använda en gammal version av AKV-nyckeln som TDE-skydd. Använd den senaste versionen av AKV-nyckeln som krypteringsskydd

  • 400 PerDatabaseCMKMissingIdentityOnGeoSecondaryDatabase – CMK-identitet per databas som inte har konfigurerats på måldatabasen.

  • 400 AdalGenericError – Det gick inte att slutföra åtgärden eftersom ett Azure Active Directory-fel påträffades.

  • 400 AdalServicePrincipalNotFound – Det gick inte att slutföra åtgärden eftersom ett azure Active Directory-bibliotekstjänsthuvudnamn inte hittades.

  • 400 AzureKeyVaultMalformedVaultUri – Den angivna Key Vault-URI:n är inte giltig.

  • 400 AttemptedEncryptionOnSystemDatabase – Det går inte att kryptera en systemdatabas. Databaskrypteringsåtgärder kan inte utföras för databasdatabaser som master, modell, tempdb, msdb eller resursdatabaser.

  • 400 ReadOnly – Det går inte att aktivera eller ändra databaskryptering på en databas som är skrivskyddad, har skrivskyddade filer eller inte återställs.

  • 400 CanNotChangeReadOnlyDuringTdeScan – Det går inte att ändra filgruppens skrivskyddade/skrivskyddade tillstånd medan en krypteringsövergång pågår.

  • 400 CanNotDropAlterOnMirror – Ändra transparent datakryptering på de primära databaserna.

  • 400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd

  • 400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd

  • 400 InvalidTransparentDataEncryptionUpdateRequest – Ange ett giltigt tillstånd. Använd "Aktiverad" eller "Inaktiverad".

  • 400 InvalidTransparentDataEncryptionName – nyckelnamnet för transparent datakryptering stöds inte.

  • 404 OperationIdNotFound – Åtgärden med ID finns inte.

  • 409 ServerKeyNameAlreadyExists – servernyckeln finns redan på servern.

  • 409 ServerKeyUriAlreadyExists – Servernyckelns URI finns redan på servern.

  • 409 ServerKeyDoesNotExists – servernyckeln finns inte.

  • 409 AzureKeyVaultKeyNameNotFound – Det gick inte att slutföra åtgärden eftersom Azure Key Vault-nyckelnamnet inte finns.

  • 409 AzureKeyVaultKeyInUse – Nyckeln används för närvarande av servern.

  • 409 EncryptionInProgress – Det går inte att ändra kryptering när en krypteringsgenomsökning pågår.

  • 409 KeyChangeInProgress – Det går inte att ändra databaskrypteringsnyckeln medan en krypterings-, dekrypterings- eller nyckeländringsgenomsökning pågår.

  • 409 NoBulkOperationLock – KRYPTERINGsnyckeln CREATE/ALTER/DROP DATABASE misslyckades eftersom det inte gick att placera ett lås på databasen. Försök igen senare.

  • 409 NeedsLogBackup – Vänta några minuter tills en loggsäkerhetskopia har inträffat.

  • 409 AltStateConflict – Åtgärden kan inte utföras på databasen eftersom den ingår i en databasspeglingssession eller en tillgänglighetsgrupp. Vissa åtgärder tillåts inte i en databas som deltar i en databasspeglingssession eller i en tillgänglighetsgrupp.

  • 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas.

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.

  • 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.

  • 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen.

  • 503 AzureKeyVaultConnectionFailed – Det gick inte att slutföra åtgärden på servern eftersom det inte gick att ansluta till Azure Key Vault

  • 503 AzureKeyVaultGenericConnectionError – Det gick inte att slutföra åtgärden eftersom ett fel uppstod vid försök att hämta Key Vault-information .

  • 503 NoDekLock – KRYPTERINGsnyckeln CREATE/ALTER/DROP DATABASE misslyckades eftersom det inte gick att placera ett lås på databasen. Försök igen senare.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

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

Exempelbegäran

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

Exempelsvar

Statuskod:
200 
{
  "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"
  }
}
Statuskod:
201 
{
  "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"
  }
}
Statuskod:
202 
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/securitytde-42-rg/providers/Microsoft.Sql/locations/southeastasia/transparentDataEncryptionOperationResults/11111111-1111-1111-1111-111111111111

Definitioner

Name Description
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.
ErrorDetail

Felinformationen.
ErrorResponse

Felsvar
LogicalDatabaseTransparentDataEncryption

Ett transparent datakrypteringstillstånd för logisk databas.
TransparentDataEncryptionName

Namnet på konfigurationen för transparent datakryptering.
TransparentDataEncryptionState

Anger tillståndet för transparent datakryptering.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.
type

string

Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

ErrorDetail[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

ErrorResponse

Objekt

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

LogicalDatabaseTransparentDataEncryption

Objekt

Ett transparent datakrypteringstillstånd för logisk databas.

Name Typ Description
id

string

Resurs-ID.
name

string

Resursnamn.
properties.state

TransparentDataEncryptionState

Anger tillståndet för transparent datakryptering.
type

string

Resurstyp.

TransparentDataEncryptionName

Uppräkning

Namnet på konfigurationen för transparent datakryptering.

Värde Description
current

TransparentDataEncryptionState

Uppräkning

Anger tillståndet för transparent datakryptering.

Värde Description
Disabled
Enabled