Sensitivity Labels - Update

Servicio:

SQL Database

Versión de la API:

2021-11-01

Actualice las etiquetas de confidencialidad de una base de datos determinada mediante un lote de operaciones.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/currentSensitivityLabels?api-version=2021-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
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.
serverName	path	True	string	El nombre del servidor.
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.

Cuerpo de la solicitud

Nombre	Tipo	Description
operations	SensitivityLabelUpdate[]	Una operación de actualización de etiquetas de confidencialidad.

Respuestas

Nombre	Tipo	Description
200 OK		Etiquetas de confidencialidad actualizadas correctamente.
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 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 InvalidSensitivityLabelsBatch: el lote de etiquetas de confidencialidad especificado no es válido. Proporcione operaciones por lotes. 400 SensitivityLabelsMissingSchema - Operation[{0}]: Falta información de esquema 400 SensitivityLabelsMissingTable - Operation[{0}]: Falta información de tabla 400 SensitivityLabelsMissingColumn - Operation[{0}]: Falta información de columna 400 SensitivityLabelsUpdateSameColumnMoreThanOnce: la columna {0} no se puede actualizar más de una vez en un solo comando. 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 los {0} caracteres 400 LabelIdMustBeGuid: el valor "labelId" proporcionado no es válido. El valor debe ser un GUID 400 InformationTypeIdMustBeGuid: el valor de "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. Debe proporcionarse 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 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". 503 DatabaseUnavailable: error en la operación porque la base de datos no está disponible.

Ejemplos

Update sensitivity labels of a given database using an operations batch.

Solicitud de ejemplo

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/currentSensitivityLabels?api-version=2021-11-01

{
  "operations": [
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table1",
        "column": "column1",
        "sensitivityLabel": {
          "properties": {
            "labelName": "Highly Confidential",
            "labelId": "3A477B16-9423-432B-AA97-6069B481CEC3",
            "informationType": "Financial",
            "informationTypeId": "1D3652D6-422C-4115-82F1-65DAEBC665C8",
            "rank": "Low"
          }
        }
      }
    },
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table2",
        "column": "column2",
        "sensitivityLabel": {
          "properties": {
            "informationType": "PhoneNumber",
            "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
            "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
            "labelName": "PII",
            "rank": "Critical"
          }
        }
      }
    },
    {
      "properties": {
        "op": "remove",
        "schema": "dbo",
        "table": "Table1",
        "column": "Column3"
      }
    }
  ]
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelUpdateInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelRank;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateKind;
import com.azure.resourcemanager.sql.models.SensitivityLabelUpdateList;
import java.util.Arrays;

/** Samples for SensitivityLabels Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SensitivityLabelsCurrentUpdate.json
     */
    /**
     * Sample code: Update sensitivity labels of a given database using an operations batch.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateSensitivityLabelsOfAGivenDatabaseUsingAnOperationsBatch(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().updateWithResponse("myRG", "myServer",
            "myDatabase",
            new SensitivityLabelUpdateList().withOperations(Arrays.asList(new SensitivityLabelUpdateInner()
                .withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo").withTable("table1").withColumn("column1")
                .withSensitivityLabel(new SensitivityLabelInner().withLabelName("Highly Confidential")
                    .withLabelId("3A477B16-9423-432B-AA97-6069B481CEC3").withInformationType("Financial")
                    .withInformationTypeId("1D3652D6-422C-4115-82F1-65DAEBC665C8").withRank(SensitivityLabelRank.LOW)),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.SET).withSchema("dbo")
                    .withTable("table2").withColumn("column2")
                    .withSensitivityLabel(new SensitivityLabelInner().withLabelName("PII")
                        .withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff").withInformationType("PhoneNumber")
                        .withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                        .withRank(SensitivityLabelRank.CRITICAL)),
                new SensitivityLabelUpdateInner().withOp(SensitivityLabelUpdateKind.REMOVE).withSchema("dbo")
                    .withTable("Table1").withColumn("Column3"))),
            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

Definiciones

Nombre	Description
SensitivityLabel	Etiqueta de confidencialidad.
SensitivityLabelRank
SensitivityLabelUpdate	Una operación de actualización de etiquetas de confidencialidad.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Lista de operaciones de actualización de etiquetas 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

SensitivityLabelUpdate

Una operación de actualización de etiquetas de confidencialidad.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.column	string	Nombre de columna que se va a actualizar.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Nombre de esquema de la columna que se va a actualizar.
properties.sensitivityLabel	SensitivityLabel	La información de la etiqueta de confidencialidad que se va a aplicar en una columna.
properties.table	string	Nombre de tabla de la columna que se va a actualizar.
type	string	Tipo de recurso.

SensitivityLabelUpdateKind

Nombre	Tipo	Description
remove	string
set	string

SensitivityLabelUpdateList

Lista de operaciones de actualización de etiquetas de confidencialidad.

Nombre	Tipo	Description
operations	SensitivityLabelUpdate[]	Una operación de actualización de etiquetas de confidencialidad.