Encryption Protectors - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Atualizações um protetor de encriptação existente.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
encryptionProtectorName	path	True	EncryptionProtectorName	O nome do protetor de encriptação a atualizar.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
properties.serverKeyType	True	ServerKeyType	O tipo de protetor de encriptação, como "ServiceManaged", "AzureKeyVault".
properties.autoRotationEnabled		boolean	Sinalizador de opção ativa de ativação ativa da rotação automática de chaves. Verdadeiro ou falso.
properties.serverKeyName		string	O nome da chave de servidor.

Respostas

Name	Tipo	Description
200 OK	EncryptionProtector	O protetor de encriptação foi atualizado com êxito.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 InvalidKeyName – foi atribuído um valor inválido para o nome da chave de servidor. 400 InvalidKeyType – o tipo de chave de servidor de criação não é suportado. 400 InvalidUpsertKeyType – as chaves TDE geridas pelo serviço são geridas pelo serviço. As chaves de Encriptação de Dados Transparente geridas pelo serviço não suportam Criar ou Atualizar pelo utilizador. 400 InvalidKeyUpsertRequest – o pedido de criação de chave de servidor não existe ou não tem nenhum objeto de propriedades. 400 InvalidEncryptionProtectorName – o nome da chave de proteção de encriptação não é suportado. 400 SecurityAdalPrincipalCertExpiredError – não foi possível concluir a operação porque o certificado principal do Azure Key Vault expirou. 400 AkvHostNotResolvingFromNode – o anfitrião AKV "{0}" não é resolvível a partir do SQL, no servidor "{1}". 400 SecurityInvalidAzureKeyVaultRecoveryLevel – o URI de Key Vault fornecido não é válido. 400 KeyMaterialNotFoundOnRemoteServer – o servidor remoto não tem acesso a material de chave utilizado como protetor de Encriptação de Dados Transparente. 400 AzureKeyVaultRsaKeyNotSupported – o cofre de chaves fornecido utiliza o Tamanho ou Tipo de Chave RSA não suportado. O tamanho da chave RSA suportado é 2048 ou 3072 e o Tipo de Chave é RSA ou RSA-HSM. 400 AzureKeyVaultKeyDisabled – não foi possível concluir a operação no servidor porque a chave de Key Vault do Azure está desativada. 400 AzureKeyVaultInvalidExpirationDate – não foi possível concluir a operação porque a data de expiração da chave de Key Vault do Azure é inválida. 400 SameKeyUriNotFoundOnRemoteServer – o servidor secundário não tem o material de chave do mesmo cofre de chaves que o protetor de encriptação do servidor primário com a rotação automática de chaves ativada. 400 SecurityAzureKeyVaultUrlNullOrEmpty – não foi possível concluir a operação porque o URI de Key Vault do Azure é nulo ou está vazio. 400 SameKeyMaterialNotFoundOnRemoteServer – o servidor secundário não tem o material de chave do protetor de encriptação do servidor primário. 400 PerDatabaseCMKRestoreNotSupported – o restauro da base de dados não é suportado quando a CMK ao nível da base de dados está configurada em pré-visualização. 400 AzureKeyVaultNoServerIdentity – a identidade do servidor não está configurada corretamente. 400 PerDatabaseCMKHSNotSupported – A CMK ao nível da base de dados em pré-visualização não é suportada para a edição Hyperscale. 400 AzureKeyVaultInvalidUri – uma resposta inválida do Azure Key Vault. Utilize um URI de Key Vault do Azure válido. 400 AzureKeyVaultMissingPermissions – o servidor tem as permissões necessárias em falta no Key Vault do Azure. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId fornecido pelo utilizador não tem acesso ao KeyId fornecido 400 AkvEndpointNotReachableFromNode – o ponto final AKV "{0}" não está acessível a partir do SQL, no servidor "{1}". 400 SecurityAzureKeyVaultInvalidKeyName – não foi possível concluir a operação devido a um nome de Chave de Servidor inválido. 400 AdalGenericError – não foi possível concluir a operação porque foi encontrado um erro do Azure Active Directory. 400 AdalServicePrincipalNotFound – não foi possível concluir a operação porque não foi encontrado um erro de Principal de Serviço da biblioteca do Azure Active Directory. 400 AzureKeyVaultMalformedVaultUri – o URI de Key Vault fornecido não é válido. 400 SecurityAzureKeyVaultGeoChainError – a criação de uma secundária secundária (um processo conhecido como encadeamento) não é suportada ao ativar a Encriptação de Dados Transparente com o Azure Key Vault (BYOK). 400 PerDatabaseCMKDWNotSupported - A CMK ao nível da base de dados em pré-visualização não é suportada para a edição Datawarehouse. 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados. 404 ResourceNotFound – o recurso pedido não foi encontrado. 404 ServerKeyNotFound – a chave de servidor pedida não foi encontrada na subscrição atual. 404 OperationIdNotFound – a operação com o ID não existe. 409 EncryptionProtectorChangeInProgress – não é possível atualizar o protetor da chave de encriptação da base de dados enquanto a alteração do protetor já estiver em curso 409 ServerKeyNameAlreadyExists – a chave de servidor já existe no servidor. 409 ServerKeyUriAlreadyExists – o URI da chave de servidor já existe no servidor. 409 ServerKeyDoesNotExists – a chave de servidor não existe. 409 AzureKeyVaultKeyNameNotFound – não foi possível concluir a operação porque o nome da Chave de Key Vault do Azure não existe. 409 AzureKeyVaultKeyInUse – a chave está atualmente a ser utilizada pelo servidor. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 AzureKeyVaultConnectionFailed – Não foi possível concluir a operação no servidor porque as tentativas de ligação ao Azure Key Vault falharam 503 AzureKeyVaultGenericConnectionError – não foi possível concluir a operação porque foi encontrado um erro ao tentar obter Key Vault informações . 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Name

Tipo

Description

200 OK

EncryptionProtector

O protetor de encriptação foi atualizado com êxito.

202 Accepted

Aceite

Other Status Codes

Respostas de Erro: ***

400 InvalidKeyName – foi atribuído um valor inválido para o nome da chave de servidor.
400 InvalidKeyType – o tipo de chave de servidor de criação não é suportado.
400 InvalidUpsertKeyType – as chaves TDE geridas pelo serviço são geridas pelo serviço. As chaves de Encriptação de Dados Transparente geridas pelo serviço não suportam Criar ou Atualizar pelo utilizador.
400 InvalidKeyUpsertRequest – o pedido de criação de chave de servidor não existe ou não tem nenhum objeto de propriedades.
400 InvalidEncryptionProtectorName – o nome da chave de proteção de encriptação não é suportado.
400 SecurityAdalPrincipalCertExpiredError – não foi possível concluir a operação porque o certificado principal do Azure Key Vault expirou.
400 AkvHostNotResolvingFromNode – o anfitrião AKV "{0}" não é resolvível a partir do SQL, no servidor "{1}".
400 SecurityInvalidAzureKeyVaultRecoveryLevel – o URI de Key Vault fornecido não é válido.
400 KeyMaterialNotFoundOnRemoteServer – o servidor remoto não tem acesso a material de chave utilizado como protetor de Encriptação de Dados Transparente.
400 AzureKeyVaultRsaKeyNotSupported – o cofre de chaves fornecido utiliza o Tamanho ou Tipo de Chave RSA não suportado. O tamanho da chave RSA suportado é 2048 ou 3072 e o Tipo de Chave é RSA ou RSA-HSM.
400 AzureKeyVaultKeyDisabled – não foi possível concluir a operação no servidor porque a chave de Key Vault do Azure está desativada.
400 AzureKeyVaultInvalidExpirationDate – não foi possível concluir a operação porque a data de expiração da chave de Key Vault do Azure é inválida.
400 SameKeyUriNotFoundOnRemoteServer – o servidor secundário não tem o material de chave do mesmo cofre de chaves que o protetor de encriptação do servidor primário com a rotação automática de chaves ativada.
400 SecurityAzureKeyVaultUrlNullOrEmpty – não foi possível concluir a operação porque o URI de Key Vault do Azure é nulo ou está vazio.
400 SameKeyMaterialNotFoundOnRemoteServer – o servidor secundário não tem o material de chave do protetor de encriptação do servidor primário.
400 PerDatabaseCMKRestoreNotSupported – o restauro da base de dados não é suportado quando a CMK ao nível da base de dados está configurada em pré-visualização.
400 AzureKeyVaultNoServerIdentity – a identidade do servidor não está configurada corretamente.
400 PerDatabaseCMKHSNotSupported – A CMK ao nível da base de dados em pré-visualização não é suportada para a edição Hyperscale.
400 AzureKeyVaultInvalidUri – uma resposta inválida do Azure Key Vault. Utilize um URI de Key Vault do Azure válido.
400 AzureKeyVaultMissingPermissions – o servidor tem as permissões necessárias em falta no Key Vault do Azure.
400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId fornecido pelo utilizador não tem acesso ao KeyId fornecido
400 AkvEndpointNotReachableFromNode – o ponto final AKV "{0}" não está acessível a partir do SQL, no servidor "{1}".
400 SecurityAzureKeyVaultInvalidKeyName – não foi possível concluir a operação devido a um nome de Chave de Servidor inválido.
400 AdalGenericError – não foi possível concluir a operação porque foi encontrado um erro do Azure Active Directory.
400 AdalServicePrincipalNotFound – não foi possível concluir a operação porque não foi encontrado um erro de Principal de Serviço da biblioteca do Azure Active Directory.
400 AzureKeyVaultMalformedVaultUri – o URI de Key Vault fornecido não é válido.
400 SecurityAzureKeyVaultGeoChainError – a criação de uma secundária secundária (um processo conhecido como encadeamento) não é suportada ao ativar a Encriptação de Dados Transparente com o Azure Key Vault (BYOK).
400 PerDatabaseCMKDWNotSupported - A CMK ao nível da base de dados em pré-visualização não é suportada para a edição Datawarehouse.
404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.
404 ResourceNotFound – o recurso pedido não foi encontrado.
404 ServerKeyNotFound – a chave de servidor pedida não foi encontrada na subscrição atual.
404 OperationIdNotFound – a operação com o ID não existe.
409 EncryptionProtectorChangeInProgress – não é possível atualizar o protetor da chave de encriptação da base de dados enquanto a alteração do protetor já estiver em curso
409 ServerKeyNameAlreadyExists – a chave de servidor já existe no servidor.
409 ServerKeyUriAlreadyExists – o URI da chave de servidor já existe no servidor.
409 ServerKeyDoesNotExists – a chave de servidor não existe.
409 AzureKeyVaultKeyNameNotFound – não foi possível concluir a operação porque o nome da Chave de Key Vault do Azure não existe.
409 AzureKeyVaultKeyInUse – a chave está atualmente a ser utilizada pelo servidor.
409 OperationCancelled - A operação foi cancelada pelo utilizador.
409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.
429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.
429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.
500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.
503 AzureKeyVaultConnectionFailed – Não foi possível concluir a operação no servidor porque as tentativas de ligação ao Azure Key Vault falharam
503 AzureKeyVaultGenericConnectionError – não foi possível concluir a operação porque foi encontrado um erro ao tentar obter Key Vault informações .
503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Update the encryption protector to key vault

Update the encryption protector to service managed

Update the encryption protector to key vault

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

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


import com.azure.resourcemanager.sql.fluent.models.EncryptionProtectorInner;
import com.azure.resourcemanager.sql.models.EncryptionProtectorName;
import com.azure.resourcemanager.sql.models.ServerKeyType;

/**
 * Samples for EncryptionProtectors CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * EncryptionProtectorCreateOrUpdateKeyVault.json
     */
    /**
     * Sample code: Update the encryption protector to key vault.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheEncryptionProtectorToKeyVault(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getEncryptionProtectors().createOrUpdate("sqlcrudtest-7398",
            "sqlcrudtest-4645", EncryptionProtectorName.CURRENT,
            new EncryptionProtectorInner().withServerKeyName("fakeTokenPlaceholder")
                .withServerKeyType(ServerKeyType.AZURE_KEY_VAULT).withAutoRotationEnabled(false),
            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

Resposta da amostra

Código de estado:: 200

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

Código de estado:: 202

Update the encryption protector to service managed

Pedido de amostra

HTTP
Java

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

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


import com.azure.resourcemanager.sql.fluent.models.EncryptionProtectorInner;
import com.azure.resourcemanager.sql.models.EncryptionProtectorName;
import com.azure.resourcemanager.sql.models.ServerKeyType;

/**
 * Samples for EncryptionProtectors CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * EncryptionProtectorCreateOrUpdateServiceManaged.json
     */
    /**
     * Sample code: Update the encryption protector to service managed.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updateTheEncryptionProtectorToServiceManaged(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getEncryptionProtectors().createOrUpdate("sqlcrudtest-7398",
            "sqlcrudtest-4645", EncryptionProtectorName.CURRENT, new EncryptionProtectorInner()
                .withServerKeyName("fakeTokenPlaceholder").withServerKeyType(ServerKeyType.SERVICE_MANAGED),
            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

Resposta da amostra

Código de estado:: 200

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

Código de estado:: 202

Definições

Name	Description
EncryptionProtector	O protetor de encriptação do servidor.
EncryptionProtectorName	O nome do protetor de encriptação a atualizar.
ServerKeyType	O tipo de protetor de encriptação, como "ServiceManaged", "AzureKeyVault".

EncryptionProtector

O protetor de encriptação do servidor.

Name	Tipo	Description
id	string	ID do Recurso.
kind	string	Tipo de protetor de encriptação. Estes são os metadados utilizados para a experiência de portal do Azure.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.autoRotationEnabled	boolean	Sinalizador de opção ativa de ativação ativa da rotação automática de chaves. Verdadeiro ou falso.
properties.serverKeyName	string	O nome da chave de servidor.
properties.serverKeyType	ServerKeyType	O tipo de protetor de encriptação, como "ServiceManaged", "AzureKeyVault".
properties.subregion	string	Sub-região do protetor de encriptação.
properties.thumbprint	string	Thumbprint da chave do servidor.
properties.uri	string	O URI da chave do servidor.
type	string	Tipo de recurso.

EncryptionProtectorName

O nome do protetor de encriptação a atualizar.

Name	Tipo	Description
current	string

ServerKeyType

O tipo de protetor de encriptação, como "ServiceManaged", "AzureKeyVault".

Name	Tipo	Description
AzureKeyVault	string
ServiceManaged	string

Partilhar via

Encryption Protectors - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Update the encryption protector to key vault

Pedido de amostra

Resposta da amostra

Update the encryption protector to service managed

Pedido de amostra

Resposta da amostra

Definições

EncryptionProtector

EncryptionProtectorName

ServerKeyType

Recursos adicionais