Sensitivity Labels - Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Atualize os rótulos de confidencialidade 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 de URI

Nome	Em	Obrigató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 por meio da API do Gerenciador de Recursos do Azure ou por meio 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 da solicitação

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

Respostas

Nome	Tipo	Description
200 OK		Rótulos de confidencialidade atualizados com êxito.
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á em pausa. 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á em pausa. Por favor, retome-o. 400 SensitivityLabelSourceNameNotSupported - A origem do rótulo de confidencialidade especificada não é válida 400 InvalidSensitivityLabelsBatch – o lote de rótulos de confidencialidade especificados 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 de tabela ausentes 400 SensitivityLabelsMissingColumn - Operation[{0}]: Informações de 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 confidencialidade 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 caracteres {0} 400 InformationTypeTooLong - O tipo de informação não pode exceder caracteres {0} 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 - O rótulo é necessário. Pelo menos um de 'labelName' ou 'labelId' deve ser fornecido 400 InformationTypeMissing - O tipo de informação é necessário. Pelo menos um de '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 de 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 de servidor. 404 SensitivityLabelsLabelNotFound - O rótulo de confidencialidade especificado não pôde ser encontrado 404 SensitivityLabelsSchemaNotFound - Não foi possível encontrar o esquema {0} 404 SensitivityLabelsTableNotFound - Não foi possível encontrar a tabela {0} no esquema {1} 404 SensitivityLabelsColumnNotFound - A coluna {0} não pôde ser encontrada na tabela {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported - A origem do rótulo de confidencialidade 'Recomendado' ainda não tem suporte 501 SensitivityLabelRecommendedSourceNameNotSupported - A origem do rótulo de confidencialidade 'Recomendado' ainda não tem suporte 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.

Solicitação de exemplo

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

Resposta de exemplo

Código de status:

200

Definições

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

SensitivityLabel

Um rótulo de confidencialidade.

Nome	Tipo	Description
id	string	ID do recurso.
managedBy	string	Recurso que gerencia o rótulo de confidencialidade.
name	string	Nome do recurso.
properties.columnName	string	O nome da coluna.
properties.informationType	string	O tipo de informação.
properties.informationTypeId	string	A ID do tipo de informação.
properties.isDisabled	boolean	A recomendação de confidencialidade está desabilitada. Aplicável somente ao rótulo de confidencialidade recomendado. Especifica se a recomendação de confidencialidade nesta coluna está desabilitada (ignorada) ou não.
properties.labelId	string	A 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

Nome	Tipo	Description
Critical	string
High	string
Low	string
Medium	string
None	string

SensitivityLabelUpdate

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

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

SensitivityLabelUpdateKind

Nome	Tipo	Description
remove	string
set	string

SensitivityLabelUpdateList

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

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