Compartilhar via


Sensitivity Labels - Create Or Update

Cria ou atualiza o rótulo 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=2023-08-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.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.

schemaName
path True

string

O nome do esquema.

sensitivityLabelSource
path True

CurrentSensitivityLabelSource

A origem do rótulo de confidencialidade.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID da 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.clientClassificationSource

ClientClassificationSource

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

Atualizou com êxito o rótulo de confidencialidade.

201 Created

SensitivityLabel

Criou com êxito o rótulo de confidencialidade.

Other Status Codes

ErrorResponse

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 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 {0} caracteres

  • 400 InformationTypeTooLong – O tipo de informação não pode exceder {0} caracteres

  • 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 '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 SensitivityLabelsSchemaNotFound - Não foi possível encontrar o esquema {0}

  • 404 SensitivityLabelsTableNotFound - A tabela {0} não pôde ser encontrada no esquema {1}

  • 404 SensitivityLabelsColumnNotFound - Não foi possível encontrar a coluna {0} na tabela {2}.{1}

  • 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

  • 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 the sensitivity label of a given column with all parameters

Solicitação de exemplo

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=2023-08-01

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

Resposta de exemplo

{
  "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"
  }
}
{
  "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

Nome Description
ClientClassificationSource
CurrentSensitivityLabelSource

A origem do rótulo de confidencialidade.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

SensitivityLabel

Um rótulo de confidencialidade.

SensitivityLabelRank

ClientClassificationSource

Valor Description
MIP
Native
None
Recommended

CurrentSensitivityLabelSource

A origem do rótulo de confidencialidade.

Valor Description
current

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

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.clientClassificationSource

ClientClassificationSource

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

Valor Description
Critical
High
Low
Medium
None