Sensitivity Labels - Update

Atualize os rótulos de confidencialidade 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}/currentSensitivityLabels?api-version=2025-01-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

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
operations

SensitivityLabelUpdate[]

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

Respostas

Nome Tipo Description
200 OK

A solicitação foi bem-sucedida.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Update sensitivity labels of a given database using an operations batch.

Solicitação de exemplo

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/currentSensitivityLabels?api-version=2025-01-01

{
  "operations": [
    {
      "properties": {
        "schema": "dbo",
        "column": "column1",
        "op": "set",
        "sensitivityLabel": {
          "properties": {
            "informationType": "Financial",
            "informationTypeId": "1D3652D6-422C-4115-82F1-65DAEBC665C8",
            "labelId": "3A477B16-9423-432B-AA97-6069B481CEC3",
            "labelName": "Highly Confidential",
            "rank": "Low"
          }
        },
        "table": "table1"
      }
    },
    {
      "properties": {
        "schema": "dbo",
        "column": "column2",
        "op": "set",
        "sensitivityLabel": {
          "properties": {
            "informationType": "PhoneNumber",
            "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
            "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
            "labelName": "PII",
            "rank": "Critical"
          }
        },
        "table": "table2"
      }
    },
    {
      "properties": {
        "schema": "dbo",
        "column": "Column3",
        "op": "remove",
        "table": "Table1"
      }
    }
  ]
}

Resposta de exemplo

Definições

Nome Description
ClientClassificationSource
createdByType

O tipo de identidade que criou o recurso.

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
SensitivityLabelUpdate

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

SensitivityLabelUpdateKind
SensitivityLabelUpdateList

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

systemData

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

ClientClassificationSource

Valor Description
None

Nenhum

Native

Native

Recommended

Recomendado

MIP

PIM

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

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 (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

managedBy

string

Recurso que gerencia o rótulo de confidencialidade.

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

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.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

SensitivityLabelRank

Valor Description
None

Nenhum

Low

Baixo

Medium

Medium

High

Alto

Critical

Crítico

SensitivityLabelUpdate

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

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.column

string

Nome da coluna a ser atualizado.

properties.op

SensitivityLabelUpdateKind

properties.schema

string

Nome do esquema da coluna a ser atualizada.

properties.sensitivityLabel

SensitivityLabel

As informações do rótulo de confidencialidade a serem aplicadas em uma coluna.

properties.table

string

Nome da tabela da coluna a ser atualizada.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

SensitivityLabelUpdateKind

Valor Description
set

configurar

remove

remover

SensitivityLabelUpdateList

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

Nome Tipo Description
operations

SensitivityLabelUpdate[]

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

systemData

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

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