Managed Instance Encryption Protectors - List By Instance

Service:

SQL Database

API Version:

2021-11-01

Obtiene una lista de protectores de cifrado de instancia administrada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/encryptionProtector?api-version=2021-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
managedInstanceName	path	True	string	El nombre de la instancia administrada.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	ManagedInstanceEncryptionProtectorListResult	Se recuperó correctamente la lista del protector de cifrado de instancia administrada.
Other Status Codes		Respuestas de error: *** 400 InvalidKeyName: se ha proporcionado un valor no válido para el nombre de clave del servidor. 400 InvalidKeyType: no se admite el tipo de clave create server. 400 InvalidUpsertKeyType: el servicio administra las claves TDE administradas por el servicio. Las claves de TDE administradas por el servicio no admiten la creación o actualización por parte del usuario. 400 InvalidKeyUpsertRequest: la solicitud de creación de clave de servidor no existe o no tiene ningún objeto de propiedades. 400 InvalidEncryptionProtectorName: no se admite el nombre de la clave del protector de cifrado. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado. 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

Ejemplos

List encryption protectors by managed instance

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for ManagedInstanceEncryptionProtectors ListByInstance. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceEncryptionProtectorList.json
     */
    /**
     * Sample code: List encryption protectors by managed instance.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listEncryptionProtectorsByManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceEncryptionProtectors()
            .listByInstance("sqlcrudtest-7398", "sqlcrudtest-4645", 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

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/encryptionProtector/current",
      "name": "current",
      "type": "Microsoft.Sql/managedInstances/encryptionProtector",
      "kind": "azurekeyvault",
      "properties": {
        "serverKeyName": "someVault_someKey_01234567890123456789012345678901",
        "serverKeyType": "AzureKeyVault",
        "uri": "https://someVault.vault.azure.net/keys/someKey/01234567890123456789012345678901"
      }
    }
  ]
}

Definiciones

Nombre	Description
ManagedInstanceEncryptionProtector	Protector de cifrado de instancia administrada.
ManagedInstanceEncryptionProtectorListResult	Lista de protectores de cifrado de instancia administrada.
ServerKeyType	El tipo de protector de cifrado, como "ServiceManaged", "AzureKeyVault".

ManagedInstanceEncryptionProtector

Protector de cifrado de instancia administrada.

Nombre	Tipo	Description
id	string	Identificador del recurso.
kind	string	Tipo de protector de cifrado. Estos son los metadatos que se usan para la experiencia de Azure Portal.
name	string	Nombre del recurso.
properties.autoRotationEnabled	boolean	Marca de participación de rotación automática de claves. Puede ser true o false.
properties.serverKeyName	string	Nombre de la clave de instancia administrada.
properties.serverKeyType	ServerKeyType	El tipo de protector de cifrado, como "ServiceManaged", "AzureKeyVault".
properties.thumbprint	string	Huella digital de la clave del servidor.
properties.uri	string	URI de la clave del servidor.
type	string	Tipo de recurso.

ManagedInstanceEncryptionProtectorListResult

Lista de protectores de cifrado de instancia administrada.

Nombre	Tipo	Description
nextLink	string	Vínculo para recuperar la página siguiente de resultados.
value	ManagedInstanceEncryptionProtector[]	Matriz de resultados.

ServerKeyType

El tipo de protector de cifrado, como "ServiceManaged", "AzureKeyVault".

Nombre	Tipo	Description
AzureKeyVault	string
ServiceManaged	string