Sensitivity Labels - Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Atualize os rótulos de sensibilidade de um determinado banco de dados usando um lote de operações.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome do banco de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo do Pedido

Name	Tipo	Description
operations	SensitivityLabelUpdate[]	Uma operação de atualização de rótulo de sensibilidade.

Respostas

Name	Tipo	Description
200 OK		Rótulos de sensibilidade atualizados com sucesso.
Other Status Codes		Respostas de erro: *** 400 DatawarehouseDatabaseIsDeactivated - Não foi possível executar a operação de classificação de dados porque o banco de dados está pausado. Por favor, retome-o. 400 DatawarehouseDatabaseIsDeactivated - Não foi possível executar a operação de classificação de dados porque o banco de dados está pausado. Por favor, retome-o. 400 SensitivityLabelSourceNameNotSupported - A origem do rótulo de sensibilidade especificado não é válida 400 InvalidSensitivityLabelsBatch - O lote de rótulos de sensibilidade especificado não é válido. Forneça operações em lote 400 SensitivityLabelsMissingSchema - Operation[{0}]: Informações de esquema ausentes 400 SensitivityLabelsMissingTable - Operation[{0}]: Informações da tabela ausentes 400 SensitivityLabelsMissingColumn - Operation[{0}]: Informações da coluna ausentes 400 SensitivityLabelsUpdateSameColumnMoreThanOnce - A coluna {0} não pode ser atualizada mais de uma vez em um único comando 400 InvalidSensitivityLabelResource - O recurso de rótulo de sensibilidade especificado não é válido 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Pelo menos um de LabelName e InformationType deve ser especificado 400 LabelNameTooLong - O nome do rótulo não pode exceder {0} caracteres 400 InformationTypeTooLong - O tipo de informação não pode exceder {0} caracteres 400 LabelIdMustBeGuid - O 'labelId' fornecido é inválido. O valor deve ser um GUID 400 InformationTypeIdMustBeGuid - O 'informationTypeId' fornecido é inválido. O valor deve ser um GUID 400 LabelMissing - A etiqueta é obrigatória. Pelo menos um dos 'labelName' ou 'labelId' deve ser fornecido 400 InformationTypeMissing - O tipo de informação é necessário. Pelo menos um dos 'informationType' ou 'informationTypeId' deve ser fornecido 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor. 404 SensitivityLabelsLabelNotFound - Não foi possível encontrar o rótulo de sensibilidade especificado 404 SensitivityLabelsSchemaNotFound - Não foi possível encontrar o {0} do esquema 404 SensitivityLabelsTableNotFound - A tabela {0} não pôde ser encontrada no esquema {1} 404 SensitivityLabelsColumnNotFound - A coluna {0} não pôde ser encontrada na tabela {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported - A fonte do rótulo de sensibilidade 'Recomendado' ainda não é suportada 501 SensitivityLabelRecommendedSourceNameNotSupported - A fonte do rótulo de sensibilidade 'Recomendado' ainda não é suportada 503 DatabaseUnavailable - A operação falhou porque o banco de dados não está disponível.

Exemplos

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

Pedido de amostra

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.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"))),
            com.azure.core.util.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

Resposta da amostra

Código de estado:

200

Definições

Name	Description
SensitivityLabel	Um rótulo de sensibilidade.
SensitivityLabelRank
SensitivityLabelUpdate	Uma operação de atualização de rótulo de sensibilidade.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Uma lista de operações de atualização de rótulo de sensibilidade.

SensitivityLabel

Object

Um rótulo de sensibilidade.

Name	Tipo	Description
id	string	ID do recurso.
managedBy	string	Recurso que gerencia o rótulo de sensibilidade.
name	string	Nome do recurso.
properties.columnName	string	O nome da coluna.
properties.informationType	string	O tipo de informação.
properties.informationTypeId	string	O ID do tipo de informação.
properties.isDisabled	boolean	A recomendação de sensibilidade está desativada. Aplicável apenas para o rótulo de sensibilidade recomendado. Especifica se a recomendação de sensibilidade nesta coluna está desabilitada (descartada) ou não.
properties.labelId	string	O ID do rótulo.
properties.labelName	string	O nome do rótulo.
properties.rank	SensitivityLabelRank
properties.schemaName	string	O nome do esquema.
properties.tableName	string	O nome da tabela.
type	string	Tipo de recurso.

SensitivityLabelRank

Enumeração

Valor	Description
Critical
High
Low
Medium
None

SensitivityLabelUpdate

Object

Uma operação de atualização de rótulo de sensibilidade.

Name	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.column	string	Nome da coluna a ser atualizado.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Nome do esquema da coluna a ser atualizada.
properties.sensitivityLabel	SensitivityLabel	As informações do rótulo de sensibilidade a serem aplicadas em uma coluna.
properties.table	string	Nome da tabela da coluna a ser atualizada.
type	string	Tipo de recurso.

SensitivityLabelUpdateKind

Enumeração

Valor	Description
remove
set

SensitivityLabelUpdateList

Object

Uma lista de operações de atualização de rótulo de sensibilidade.

Name	Tipo	Description
operations	SensitivityLabelUpdate[]	Uma operação de atualização de rótulo de sensibilidade.