Managed Database Sensitivity Labels - Create Or Update

Crea o actualiza la etiqueta de confidencialidad de una columna determinada.

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

Parámetros de identificador URI

Name In Required Type 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

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.

Cuerpo de la solicitud

Name Type Description
properties.informationType
  • string

Tipo de información.

properties.informationTypeId
  • string

Identificador de tipo de información.

properties.labelId
  • string

Identificador de la etiqueta.

properties.labelName
  • string

Nombre de la etiqueta.

properties.rank

Respuestas

Name Type Description
200 OK

Se actualizó correctamente la etiqueta de confidencialidad.

201 Created

Se creó 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

  • 400 InvalidSensitivityLabelResource: el recurso de etiqueta de confidencialidad especificado no es válido

  • 400 SensitivityLabelLabelNameAndInfoTypeNotProvided: se debe especificar al menos uno de LabelName e InformationType.

  • 400 LabelNameTooLong: el nombre de la etiqueta no puede superar los {0} caracteres

  • 400 InformationTypeTooLong: el tipo de información no puede superar {0} los caracteres

  • 400 LabelIdMustBeGuid: el "labelId" proporcionado no es válido. El valor debe ser un GUID

  • 400 InformationTypeIdMustBeGuid: el elemento "informationTypeId" proporcionado no es válido. El valor debe ser un GUID

  • 400 LabelMissing: se requiere etiqueta. Se debe proporcionar al menos uno de 'labelName' o 'labelId'

  • 400 InformationTypeMissing: se requiere el tipo de información. Se debe proporcionar al menos uno de 'informationType' o 'informationTypeId'

  • 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

Updates or creates a sensitivity label of a given column with all parameters in a managed database

Sample Request

PUT 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

{
  "properties": {
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Sample Response

{
  "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": "High"
  }
}
{
  "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": "High"
  }
}

Definiciones

SensitivityLabel

Etiqueta de confidencialidad.

SensitivityLabelRank
WritableSensitivityLabelSource

Origen de la etiqueta de confidencialidad.

SensitivityLabel

Etiqueta de confidencialidad.

Name Type 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
properties.schemaName
  • string

El nombre del esquema.

properties.tableName
  • string

El nombre de la tabla.

type
  • string

Tipo de recurso.

SensitivityLabelRank

Name Type Description
Critical
  • string
High
  • string
Low
  • string
Medium
  • string
None
  • string

WritableSensitivityLabelSource

Origen de la etiqueta de confidencialidad.

Name Type Description
current
  • string