Managed Database 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/managedInstances/{managedInstanceName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2021-11-01

Parâmetros de URI

Name In Required Type 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

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

Name Type 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

Respostas

Name Type Description
200 OK

Atualizou com êxito o rótulo de confidencialidade.

201 Created

Criou com êxito o rótulo de confidencialidade.

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. 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 - O esquema {0} não pôde ser encontrado

  • 404 SensitivityLabelsTableNotFound - A tabela {0} não pôde ser encontrada 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

Sample Request

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

Sample Response

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

SensitivityLabel

Um rótulo de confidencialidade.

SensitivityLabelRank
WritableSensitivityLabelSource

A origem do rótulo de confidencialidade.

SensitivityLabel

Um rótulo de confidencialidade.

Name Type 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 (descartada) ou não.

properties.labelId
  • string

A ID do rótulo.

properties.labelName
  • string

O nome do rótulo.

properties.rank
properties.schemaName
  • string

O nome do esquema.

properties.tableName
  • string

O nome da tabela.

type
  • string

Tipo de recurso.

SensitivityLabelRank

Name Type Description
Critical
  • string
High
  • string
Low
  • string
Medium
  • string
None
  • string

WritableSensitivityLabelSource

A origem do rótulo de confidencialidade.

Name Type Description
current
  • string