Managed Database Sensitivity Labels - Create Or Update

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

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

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	WritableSensitivityLabelSource	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

Nombre	Tipo	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	SensitivityLabelRank

Respuestas

Nombre	Tipo	Description
200 OK	SensitivityLabel	Se actualizó correctamente la etiqueta de confidencialidad.
201 Created	SensitivityLabel	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".

Nombre

Tipo

Description

200 OK

SensitivityLabel

Se actualizó correctamente la etiqueta de confidencialidad.

201 Created

SensitivityLabel

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

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"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelRank;

/** Samples for ManagedDatabaseSensitivityLabels CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseColumnSensitivityLabelCreate.json
     */
    /**
     * Sample code: Updates or creates a sensitivity label of a given column with all parameters in a managed database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesOrCreatesASensitivityLabelOfAGivenColumnWithAllParametersInAManagedDatabase(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseSensitivityLabels().createOrUpdateWithResponse(
            "myRG", "myManagedInstanceName", "myDatabase", "dbo", "myTable", "myColumn",
            new SensitivityLabelInner().withLabelName("PII").withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff")
                .withInformationType("PhoneNumber").withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                .withRank(SensitivityLabelRank.HIGH),
            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

Respuesta de muestra

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

status code:: 201

{
  "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

Nombre	Description
SensitivityLabel	Etiqueta de confidencialidad.
SensitivityLabelRank
WritableSensitivityLabelSource	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

WritableSensitivityLabelSource

Origen de la etiqueta de confidencialidad.

Nombre	Tipo	Description
current	string

Compartir a través de

Managed Database Sensitivity Labels - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

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

Solicitud de ejemplo

Respuesta de muestra

Definiciones

SensitivityLabel

SensitivityLabelRank

WritableSensitivityLabelSource

Recursos adicionales