Delen via

Encryption Protectors - Create Or Update

Service:
SQL Database
API-versie:
2025-01-01

Werkt een bestaande versleutelingsbeveiliging bij.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/encryptionProtector/current?api-version=2025-01-01

URI-parameters

Name In Vereist Type Description
encryptionProtectorName
 path True

EncryptionProtectorName

De naam van de versleutelingsbeveiliging die moet worden opgehaald.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.
serverName
 path True

string

De naam van de server.
subscriptionId
 path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
properties.serverKeyType True

ServerKeyType

Het type versleutelingsbeveiliging, zoals 'ServiceManaged', 'AzureKeyVault'.
properties.autoRotationEnabled

boolean

Aanmeldingsvlag voor automatische rotatie van sleutels. Waar of onwaar.
properties.serverKeyName

string

De naam van de serversleutel.

Antwoorden

Name Type Description
200 OK

EncryptionProtector

De update-operatie van de resource 'EncryptionProtector' is geslaagd
202 Accepted

Resourcebewerking geaccepteerd.

Kopteksten

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Update the encryption protector to key vault
Update the encryption protector to key vault with versionless key
Update the encryption protector to service managed

Update the encryption protector to key vault

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/encryptionProtector/current?api-version=2025-01-01

{
  "properties": {
    "autoRotationEnabled": false,
    "serverKeyName": "someVault_someKey_01234567890123456789012345678901",
    "serverKeyType": "AzureKeyVault"
  }
}

Voorbeeldrespons

Statuscode:
200 
{
  "name": "current",
  "type": "Microsoft.Sql/servers/encryptionProtector",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/encryptionProtector/current",
  "kind": "azurekeyvault",
  "location": "West US",
  "properties": {
    "autoRotationEnabled": false,
    "serverKeyName": "someVault_someKey_01234567890123456789012345678901",
    "serverKeyType": "AzureKeyVault"
  }
}
Statuscode:
202

Update the encryption protector to key vault with versionless key

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/encryptionProtector/current?api-version=2025-01-01

{
  "properties": {
    "autoRotationEnabled": false,
    "serverKeyName": "someVault_someKey",
    "serverKeyType": "AzureKeyVault"
  }
}

Voorbeeldrespons

Statuscode:
200 
{
  "name": "current",
  "type": "Microsoft.Sql/servers/encryptionProtector",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/encryptionProtector/current",
  "kind": "azurekeyvault",
  "location": "West US",
  "properties": {
    "autoRotationEnabled": false,
    "keyVersion": "01234567890123456789012345678901",
    "serverKeyName": "someVault_someKey",
    "serverKeyType": "AzureKeyVault"
  }
}
Statuscode:
202

Update the encryption protector to service managed

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/encryptionProtector/current?api-version=2025-01-01

{
  "properties": {
    "serverKeyName": "ServiceManaged",
    "serverKeyType": "ServiceManaged"
  }
}

Voorbeeldrespons

Statuscode:
200 
{
  "name": "current",
  "type": "Microsoft.Sql/servers/encryptionProtector",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/encryptionProtector/current",
  "kind": "servicemanaged",
  "location": "West US",
  "properties": {
    "serverKeyName": "ServiceManaged",
    "serverKeyType": "ServiceManaged"
  }
}
Statuscode:
202

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.
EncryptionProtector

De versleutelingsbeveiliging van de server.
EncryptionProtectorName
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
ServerKeyType

Het type versleutelingsbeveiliging, zoals 'ServiceManaged', 'AzureKeyVault'.
systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

EncryptionProtector

Object

De versleutelingsbeveiliging van de server.

Name Type Description
id

string (arm-id)

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
kind

string

Soort versleutelingsbeveiliging. Dit is metadata die wordt gebruikt voor de Azure-portaalervaring.
location

string

Resourcelocatie.
name

string

De naam van de resource
properties.autoRotationEnabled

boolean

Aanmeldingsvlag voor automatische rotatie van sleutels. Waar of onwaar.
properties.keyVersion

string

De versie van de serversleutel die wordt gebruikt als versleutelingsbeveiliging
properties.serverKeyName

string

De naam van de serversleutel.
properties.serverKeyType

ServerKeyType

Het type versleutelingsbeveiliging, zoals 'ServiceManaged', 'AzureKeyVault'.
properties.subregion

string

Subregio van de versleutelingsbeveiliging.
properties.thumbprint

string

Vingerafdruk van de serversleutel.
properties.uri

string

De URI van de serversleutel.
systemData

systemData

Azure Resource Manager metadata met creationBy en modifiedBy informatie.
type

string

Het type bron. Bijvoorbeeld: "Microsoft. Compute/virtualMachines" of "Microsoft. Opslag/opslagAccounts"

EncryptionProtectorName

Opsomming
Waarde Description
current

huidig

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ServerKeyType

Opsomming

Het type versleutelingsbeveiliging, zoals 'ServiceManaged', 'AzureKeyVault'.

Waarde Description
ServiceManaged

ServiceManaged
AzureKeyVault

AzureKeyVault

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).
createdBy

string

De identiteit waarmee de resource is gemaakt.
createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt

string (date-time)

Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.