Managed Database Sensitivity Labels - Get

Service:

SQL Database

API Version:

2021-11-01

Obtiene la etiqueta de confidencialidad de una columna determinada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/{sensitivityLabelSource}?api-version=2021-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
columnName	path	True	string	El nombre de la columna.
databaseName	path	True	string	El nombre de la base de datos.
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.
schemaName	path	True	string	Nombre del esquema.
sensitivityLabelSource	path	True	SensitivityLabelSource	Origen de la etiqueta de confidencialidad.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
tableName	path	True	string	Nombre de la tabla.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	SensitivityLabel	Recuperó correctamente la etiqueta de confidencialidad.
Other Status Codes		Respuestas de error: *** 400 DatawarehouseDatabaseIsDeactivated: no se pudo ejecutar la operación de clasificación de datos porque la base de datos está en pausa. Por favor reanudarlo. 400 SensitivityLabelSourceNameNotSupported: el origen de la etiqueta de confidencialidad especificado no es válido. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado. 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor. 404 SensitivityLabelsLabelNotFound: no se encontró la etiqueta de confidencialidad especificada. 404 SensitivityLabelsSchemaNotFound: no se encontró el esquema {0} 404 SensitivityLabelsTableNotFound: no se encontró la tabla {0} en el esquema. {1} 404 SensitivityLabelsColumnNotFound: no se encontró la columna {0} en la tabla {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported: todavía no se admite el origen de la etiqueta de confidencialidad "Recomendado". 501 SensitivityLabelRecommendedSourceNameNotSupported: todavía no se admite el origen de la etiqueta de confidencialidad "Recomendado".

Ejemplos

Gets the sensitivity label of a given column in a managed database

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current?api-version=2021-11-01

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.SensitivityLabelSource;

/** Samples for ManagedDatabaseSensitivityLabels Get. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseColumnSensitivityLabelGet.json
     */
    /**
     * Sample code: Gets the sensitivity label of a given column in a managed database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheSensitivityLabelOfAGivenColumnInAManagedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseSensitivityLabels().getWithResponse("myRG",
            "myManagedInstanceName", "myDatabase", "dbo", "myTable", "myColumn", SensitivityLabelSource.CURRENT,
            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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "Low"
  }
}

Definiciones

Nombre	Description
SensitivityLabel	Etiqueta de confidencialidad.
SensitivityLabelRank
SensitivityLabelSource	Origen de la etiqueta de confidencialidad.

SensitivityLabel

Etiqueta de confidencialidad.

Nombre	Tipo	Description
id	string	Identificador del recurso.
managedBy	string	Recurso que administra la etiqueta de confidencialidad.
name	string	Nombre del recurso.
properties.columnName	string	Nombre de columna.
properties.informationType	string	Tipo de información.
properties.informationTypeId	string	Identificador de tipo de información.
properties.isDisabled	boolean	Está deshabilitada la recomendación de confidencialidad. Aplicable solo a la etiqueta de confidencialidad recomendada. Especifica si la recomendación de confidencialidad de esta columna está deshabilitada (descartada) o no.
properties.labelId	string	Identificador de la etiqueta.
properties.labelName	string	Nombre de la etiqueta.
properties.rank	SensitivityLabelRank
properties.schemaName	string	El nombre del esquema.
properties.tableName	string	El nombre de la tabla.
type	string	Tipo de recurso.

SensitivityLabelRank

Nombre	Tipo	Description
Critical	string
High	string
Low	string
Medium	string
None	string

SensitivityLabelSource

Origen de la etiqueta de confidencialidad.

Nombre	Tipo	Description
current	string
recommended	string