Partilhar via


Sensitivity Labels - List Recommended By Database

Obtém os rótulos de sensibilidade de um determinado banco de dados

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/recommendedSensitivityLabels?api-version=2023-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/recommendedSensitivityLabels?$skipToken={$skipToken}&includeDisabledRecommendations={includeDisabledRecommendations}&$filter={$filter}&api-version=2023-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
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 da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True

string

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

$filter
query

string

Uma expressão de filtro OData que filtra elementos na coleção.

$skipToken
query

string

includeDisabledRecommendations
query

boolean

Especifica se as recomendações desabilitadas devem ser incluídas ou não.

Respostas

Name Tipo Description
200 OK

SensitivityLabelListResult

Recuperados com êxito os rótulos de sensibilidade.

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á pausado. Por favor, retome-o.

  • 400 SensitivityLabelsInvalidODataQuery - A consulta OData especificada não é válida ou não é suportada

  • 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 do servidor.

  • 503 DatabaseUnavailable - A operação falhou porque o banco de dados não está disponível.

Exemplos

Pedido de amostra

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

Resposta da amostra

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/recommended",
      "name": "recommended",
      "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
      "properties": {
        "schemaName": "dbo",
        "tableName": "myTable",
        "columnName": "myColumn",
        "informationType": "Financial",
        "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
        "labelId": "05e6eaa1-075a-4fb4-a732-a92215a2444a",
        "labelName": "Sensitive"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn2/sensitivityLabels/recommended",
      "name": "recommended",
      "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
      "properties": {
        "schemaName": "dbo",
        "tableName": "myTable",
        "columnName": "myColumn2",
        "informationType": "Email",
        "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
        "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
        "labelName": "PII"
      }
    }
  ]
}

Definições

Name Description
ClientClassificationSource
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.

SensitivityLabelListResult

Uma lista de rótulos de sensibilidade.

SensitivityLabelRank

ClientClassificationSource

Valor Description
None
Native
Recommended
MIP

ErrorAdditionalInfo

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

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 destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

SensitivityLabel

Um rótulo de sensibilidade.

Name Tipo Description
id

string

ID do recurso.

managedBy

string

Recurso que gerencia o rótulo de sensibilidade.

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

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.

type

string

Tipo de recurso.

SensitivityLabelListResult

Uma lista de rótulos de sensibilidade.

Name Tipo Description
nextLink

string

Link para recuperar a próxima página de resultados.

value

SensitivityLabel[]

Matriz de resultados.

SensitivityLabelRank

Valor Description
None
Low
Medium
High
Critical