Sensitivity Labels - Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Atualize as etiquetas de confidencialidade de uma determinada base de dados com 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 da base de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Tipo	Description
operations	SensitivityLabelUpdate[]	Uma operação de atualização da etiqueta de confidencialidade.

Respostas

Name	Tipo	Description
200 OK		Etiquetas de confidencialidade atualizadas 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 a base de dados está em pausa. Retome-o. 400 DatawarehouseDatabaseIsDeactivated – não foi possível executar a operação de Classificação de Dados porque a base de dados está em pausa. Retome-o. 400 SensitivityLabelSourceNameNotSupported - A origem da etiqueta de confidencialidade especificada não é válida 400 InvalidSensitivityLabelsBatch – o lote de etiquetas de confidencialidade especificado não é válido. Forneça operações em lote 400 SensitivityLabelsMissingSchema - Operation[{0}]: Informações de esquema em falta 400 SensitivityLabelsMissingTable - Operation[{0}]: Informações da tabela em falta 400 SensitivityLabelsMissingColumn - Operation[{0}]: Informações da coluna em falta 400 SensitivityLabelsUpdateSameColumnMoreThanOnce - A coluna {0} não pode ser atualizada mais do que uma vez num único comando 400 InvalidSensitivityLabelResource - O recurso de etiqueta de confidencialidade especificado não é válido 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Tem de especificar pelo menos um de LabelName e InformationType 400 LabelNameTooLong – O nome da etiqueta não pode exceder os {0} carateres 400 InformationTypeTooLong - O tipo de informação não pode exceder os {0} carateres 400 LabelIdMustBeGuid – o "labelId" fornecido é inválido. O valor tem de ser um GUID 400 InformationTypeIdMustBeGuid – o "informationTypeId" fornecido é inválido. O valor tem de ser um GUID 400 LabelMissing - É necessário etiqueta. Tem de ser fornecido pelo menos um "labelName" ou "labelId" 400 InformationTypeMissing – é necessário o tipo de informação. Tem de ser fornecido pelo menos um de "informationType" ou "informationTypeId" 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor. 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor. 404 SensitivityLabelsLabelNotFound – Não foi possível encontrar a etiqueta de confidencialidade especificada 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 – não foi possível encontrar a coluna {0} na tabela {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported – a origem da etiqueta de confidencialidade "Recomendada" ainda não é suportada 501 SensitivityLabelRecommendedSourceNameNotSupported – a origem da etiqueta de confidencialidade "Recomendada" ainda não é suportada 503 DatabaseUnavailable - A operação falhou porque a base 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.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 da amostra

Código de estado:

200

Definições

Name	Description
SensitivityLabel	Uma etiqueta de confidencialidade.
SensitivityLabelRank
SensitivityLabelUpdate	Uma operação de atualização da etiqueta de confidencialidade.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Uma lista de operações de atualização de etiquetas de confidencialidade.

SensitivityLabel

Uma etiqueta de confidencialidade.

Name	Tipo	Description
id	string	ID do Recurso.
managedBy	string	Recurso que gere a etiqueta 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	O ID do tipo de informação.
properties.isDisabled	boolean	A recomendação de confidencialidade está desativada. Aplicável apenas à etiqueta de confidencialidade recomendada. Especifica se a recomendação de confidencialidade nesta coluna está desativada (dispensada) ou não.
properties.labelId	string	O ID da etiqueta.
properties.labelName	string	O nome da etiqueta.
properties.rank	SensitivityLabelRank
properties.schemaName	string	O nome do esquema.
properties.tableName	string	O nome da tabela.
type	string	Tipo de recurso.

SensitivityLabelRank

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

SensitivityLabelUpdate

Uma operação de atualização da etiqueta de confidencialidade.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.column	string	Nome da coluna a atualizar.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Nome do esquema da coluna a atualizar.
properties.sensitivityLabel	SensitivityLabel	As informações da etiqueta de confidencialidade a aplicar numa coluna.
properties.table	string	Nome da tabela da coluna a atualizar.
type	string	Tipo de recurso.

SensitivityLabelUpdateKind

Name	Tipo	Description
remove	string
set	string

SensitivityLabelUpdateList

Uma lista de operações de atualização de etiquetas de confidencialidade.

Name	Tipo	Description
operations	SensitivityLabelUpdate[]	Uma operação de atualização da etiqueta de confidencialidade.