Sensitivity Labels - Get

  • Referencia
Servicio:
SQL Database
Versión de la API:
2021-11-01

Obtiene la etiqueta de confidencialidad de una columna determinada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/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.
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.
serverName
 path True

string

El nombre del servidor.
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

Solicitud de ejemplo

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

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/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": "High"
  }
}

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