Sensitivity Labels - Create Or Update

Serviço:: SQL Database

Versão da API:: 2025-01-01

Cria ou atualiza o rótulo de sensibilidade 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=2025-01-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 do banco de dados.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
schemaName	path	True	string	O nome do esquema.
sensitivityLabelSource	path	True	CurrentSensitivityLabelSource	A fonte do rótulo de sensibilidade.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
tableName	path	True	string	O nome da tabela.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

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

Respostas

Name	Tipo	Description
200 OK	SensitivityLabel	Operação de atualização do recurso 'SensibilityLabel' bem-sucedida
201 Created	SensitivityLabel	Recurso 'SensibilityLabel' criar operação bem-sucedida
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

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=2025-01-01

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

Resposta da amostra

Código de estado:: 200

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

Código de estado:: 201

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

Definições

Name	Description
ClientClassificationSource
createdByType	O tipo de identidade que criou o recurso.
CurrentSensitivityLabelSource
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
SensitivityLabel	Um rótulo de sensibilidade.
SensitivityLabelRank
systemData	Metadados referentes à criação e última modificação do recurso.

ClientClassificationSource

Enumeração

Valor	Description
None	Nenhum
Native	Nativo
Recommended	Recomendado
MIP	PDM

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

CurrentSensitivityLabelSource

Enumeração

Valor	Description
current	atual

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

SensitivityLabel

Object

Um rótulo de sensibilidade.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
managedBy	string	Recurso que gerencia o rótulo de sensibilidade.
name	string	O nome do recurso
properties.clientClassificationSource	ClientClassificationSource
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 sensibilidade está desativada. Aplicável apenas para o rótulo de sensibilidade recomendado. Especifica se a recomendação de sensibilidade nesta coluna está desabilitada (descartada) ou não.
properties.labelId	string	O 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.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

SensitivityLabelRank

Enumeração

Valor	Description
None	Nenhum
Low	Baixo
Medium	Medium
High	Alto
Critical	Crítico

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.