Managed Database Sensitivity Labels - Create Or Update

Referência

Service:: SQL Database

API Version:: 2021-11-01

Cria ou atualiza o rótulo de confidencialidade de uma determinada coluna

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2021-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
columnName	path	True	string	O nome da coluna.
databaseName	path	True	string	O nome do banco de dados.
managedInstanceName	path	True	string	O nome da instância gerenciada.
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.
schemaName	path	True	string	O nome do esquema.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	A origem do rótulo de confidencialidade.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
tableName	path	True	string	O nome da tabela.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Tipo	Description
properties.informationType	string	O tipo de informação.
properties.informationTypeId	string	A ID do tipo de informação.
properties.labelId	string	A ID do rótulo.
properties.labelName	string	O nome do rótulo.
properties.rank	SensitivityLabelRank

Respostas

Nome	Tipo	Description
200 OK	SensitivityLabel	O rótulo de confidencialidade foi atualizado com êxito.
201 Created	SensitivityLabel	O rótulo de confidencialidade foi criado 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 SensitivityLabelSourceNameNotSupported - A origem do rótulo de confidencialidade especificada não é válida 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 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

Nome

Tipo

Description

200 OK

SensitivityLabel

O rótulo de confidencialidade foi atualizado com êxito.

201 Created

SensitivityLabel

O rótulo de confidencialidade foi criado 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 SensitivityLabelSourceNameNotSupported - A origem do rótulo de confidencialidade especificada não é válida
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 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

Exemplos

Updates or creates a sensitivity label of a given column with all parameters in a managed database

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current?api-version=2021-11-01

{
  "properties": {
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelRank;

/** Samples for ManagedDatabaseSensitivityLabels CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseColumnSensitivityLabelCreate.json
     */
    /**
     * Sample code: Updates or creates a sensitivity label of a given column with all parameters in a managed database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesOrCreatesASensitivityLabelOfAGivenColumnWithAllParametersInAManagedDatabase(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseSensitivityLabels().createOrUpdateWithResponse(
            "myRG", "myManagedInstanceName", "myDatabase", "dbo", "myTable", "myColumn",
            new SensitivityLabelInner().withLabelName("PII").withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff")
                .withInformationType("PhoneNumber").withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                .withRank(SensitivityLabelRank.HIGH),
            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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Definições

Nome	Description
SensitivityLabel	Um rótulo de confidencialidade.
SensitivityLabelRank
WritableSensitivityLabelSource	A origem do 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

WritableSensitivityLabelSource

A origem do rótulo de confidencialidade.

Nome	Tipo	Description
current	string

Managed Database Sensitivity Labels - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Updates or creates a sensitivity label of a given column with all parameters in a managed database

Sample Request

Sample Response

Definições

SensitivityLabel

SensitivityLabelRank

WritableSensitivityLabelSource

Recursos adicionais