Sensitivity Labels - Create Or Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Cria ou atualiza a etiqueta de confidencialidade de uma determinada coluna

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
columnName	path	True	string	O nome da coluna.
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.
schemaName	path	True	string	O nome do esquema.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	A origem da etiqueta de confidencialidade.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
tableName	path	True	string	O nome da tabela.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Tipo	Description
properties.informationType	string	O tipo de informação.
properties.informationTypeId	string	O ID do tipo de informação.
properties.labelId	string	O ID da etiqueta.
properties.labelName	string	O nome da etiqueta.
properties.rank	SensitivityLabelRank

Respostas

Name	Tipo	Description
200 OK	SensitivityLabel	A etiqueta de confidencialidade foi atualizada com êxito.
201 Created	SensitivityLabel	A etiqueta de confidencialidade foi criada 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 SensitivityLabelSourceNameNotSupported – a origem da etiqueta de confidencialidade especificada não é válida 400 InvalidSensitivityLabelResource – o recurso de etiqueta de confidencialidade especificado não é válido 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – tem de ser especificado pelo menos um de LabelName e InformationType 400 LabelNameTooLong – O nome da etiqueta não pode exceder os carateres {0} 400 InformationTypeTooLong – o tipo de informação não pode exceder os carateres {0} 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 – a etiqueta é necessária. Tem de ser fornecido pelo menos um de "labelName" ou "labelId" 400 InformationTypeMissing – o tipo de informação é necessário. 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 SensitivityLabelsLabelNotFound – Não foi possível localizar a etiqueta de confidencialidade especificada 404 SensitivityLabelsSchemaNotFound – Não foi possível localizar 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

Exemplos

Updates the sensitivity label of a given column with all parameters

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/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": "Low"
  }
}

Java

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

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/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": "Medium"
  }
}

Código de estado:

201

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

Definições

Name	Description
SensitivityLabel	Uma etiqueta de confidencialidade.
SensitivityLabelRank
WritableSensitivityLabelSource	A origem da etiqueta 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 a etiquetas de confidencialidade recomendadas. 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

WritableSensitivityLabelSource

A origem da etiqueta de confidencialidade.

Name	Tipo	Description
current	string