Server Keys - Get

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém uma chave de servidor.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
keyName	path	True	string	O nome da chave de servidor a obter.
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.

Respostas

Name	Tipo	Description
200 OK	ServerKey	A chave de servidor especificada foi obtida com êxito.
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. 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.

Exemplos

Get the server key

Pedido de amostra

HTTP

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

Java

/**
 * Samples for ServerKeys Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerKeyGet.json
     */
    /**
     * Sample code: Get the server key.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getTheServerKey(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerKeys().getWithResponse("sqlcrudtest-7398",
            "sqlcrudtest-4645", "someVault_someKey_01234567890123456789012345678901", 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/keys/someVault_someKey_01234567890123456789012345678901",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers/keys",
  "location": "Japan East",
  "kind": "azurekeyvault",
  "properties": {
    "thumbprint": "00112233445566778899AABBCCDDEEFFAABBCCDD",
    "creationDate": "2020-11-15T00:00:00Z",
    "autoRotationEnabled": false
  }
}

Definições

Name	Description
ServerKey	Uma chave de servidor.
ServerKeyType	O tipo de chave de servidor, como "ServiceManaged", "AzureKeyVault".

ServerKey

Uma chave de 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.creationDate	string	A data de criação da chave de servidor.
properties.serverKeyType	ServerKeyType	O tipo de chave de servidor, como "ServiceManaged", "AzureKeyVault".
properties.subregion	string	Sub-região da chave do servidor.
properties.thumbprint	string	Thumbprint da chave do servidor.
properties.uri	string	O URI da chave do servidor. Se ServerKeyType for AzureKeyVault, o URI é necessário. O URI do AKV tem de estar neste formato: "https://YourVaultName.vault.azure.net/keys/YourKeyName/YourKeyVersion"
type	string	Tipo de recurso.

ServerKeyType

O tipo de chave de servidor, como "ServiceManaged", "AzureKeyVault".

Name	Tipo	Description
AzureKeyVault	string
ServiceManaged	string