Recommended Sensitivity Labels - Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Atualize os estados de rótulos de confidencialidade recomendados 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}/recommendedSensitivityLabels?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	RecommendedSensitivityLabelUpdate[]	Uma operação de atualização de rótulo de confidencialidade recomendada.

Respostas

Nome	Tipo	Description
200 OK		Os rótulos de confidencialidade recomendados foram 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. 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. Retome-o. 400 SensitivityLabelSourceNameNotSupported - A origem do rótulo de confidencialidade especificada não é válida 400 InvalidRecommendedSensitivityLabelsBatch – As operações de rótulos de confidencialidade recomendadas especificadas não são válidas 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 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 - 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 'recomendada' ainda não tem suporte 501 SensitivityLabelRecommendedSourceNameNotSupported - A origem do rótulo de confidencialidade 'recomendada' ainda não tem suporte 503 DatabaseUnavailable – A operação falhou porque o banco de dados não está disponível.

Exemplos

Update recommended 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/recommendedSensitivityLabels?api-version=2021-11-01

{
  "operations": [
    {
      "properties": {
        "op": "enable",
        "schema": "dbo",
        "table": "table1",
        "column": "column1"
      }
    },
    {
      "properties": {
        "op": "enable",
        "schema": "dbo",
        "table": "table2",
        "column": "column2"
      }
    },
    {
      "properties": {
        "op": "disable",
        "schema": "dbo",
        "table": "table1",
        "column": "column3"
      }
    }
  ]
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.RecommendedSensitivityLabelUpdate;
import com.azure.resourcemanager.sql.models.RecommendedSensitivityLabelUpdateKind;
import com.azure.resourcemanager.sql.models.RecommendedSensitivityLabelUpdateList;
import java.util.Arrays;

/** Samples for RecommendedSensitivityLabels Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SensitivityLabelsRecommendedUpdate.
     * json
     */
    /**
     * Sample code: Update recommended 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 updateRecommendedSensitivityLabelsOfAGivenDatabaseUsingAnOperationsBatch(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getRecommendedSensitivityLabels().updateWithResponse("myRG",
            "myServer", "myDatabase",
            new RecommendedSensitivityLabelUpdateList().withOperations(Arrays.asList(
                new RecommendedSensitivityLabelUpdate().withOp(RecommendedSensitivityLabelUpdateKind.ENABLE)
                    .withSchema("dbo").withTable("table1").withColumn("column1"),
                new RecommendedSensitivityLabelUpdate().withOp(RecommendedSensitivityLabelUpdateKind.ENABLE)
                    .withSchema("dbo").withTable("table2").withColumn("column2"),
                new RecommendedSensitivityLabelUpdate().withOp(RecommendedSensitivityLabelUpdateKind.DISABLE)
                    .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
RecommendedSensitivityLabelUpdate	Uma operação de atualização de rótulo de confidencialidade recomendada.
RecommendedSensitivityLabelUpdateKind
RecommendedSensitivityLabelUpdateList	Uma lista de operações recomendadas de atualização de rótulo de confidencialidade.

RecommendedSensitivityLabelUpdate

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

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.column	string	Nome da coluna a ser atualizado.
properties.op	RecommendedSensitivityLabelUpdateKind
properties.schema	string	Nome do esquema da coluna a ser atualizada.
properties.table	string	Nome da tabela da coluna a ser atualizada.
type	string	Tipo de recurso.

RecommendedSensitivityLabelUpdateKind

Nome	Tipo	Description
disable	string
enable	string

RecommendedSensitivityLabelUpdateList

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

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