Condividi tramite


Sensitivity Labels - List Current By Database

Ottiene le etichette di riservatezza di un determinato database

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database.

resourceGroupName
path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.

serverName
path True

string

Nome del server.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True

string

Versione dell'API da usare per la richiesta.

$count
query

boolean

$filter
query

string

Espressione di filtro OData che filtra gli elementi nella raccolta.

$skipToken
query

string

Risposte

Nome Tipo Descrizione
200 OK

SensitivityLabelListResult

Sono state recuperate correttamente le etichette di riservatezza.

Other Status Codes

ErrorResponse

Risposte di errore:

  • 400 DatawarehouseDatabaseIsDeactivated - Impossibile eseguire l'operazione di classificazione dei dati perché il database è in pausa. Si prega di riprenderlo.

  • 400 SensitivityLabelsInvalidODataQuery - La query OData specificata non è valida o non è supportata

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server.

  • 503 DatabaseUnavailable: operazione non riuscita perché il database non è disponibile.

Esempio

Gets the current sensitivity labels of a given database

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
ClientClassificationSource
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

SensitivityLabel

Etichetta di riservatezza.

SensitivityLabelListResult

Elenco di etichette di riservatezza.

SensitivityLabelRank

ClientClassificationSource

Valore Descrizione
MIP
Native
None
Recommended

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

SensitivityLabel

Etichetta di riservatezza.

Nome Tipo Descrizione
id

string

ID risorsa.

managedBy

string

Risorsa che gestisce l'etichetta di riservatezza.

name

string

Nome risorsa.

properties.clientClassificationSource

ClientClassificationSource

properties.columnName

string

Nome della colonna.

properties.informationType

string

Tipo di informazioni.

properties.informationTypeId

string

ID del tipo di informazioni.

properties.isDisabled

boolean

Raccomandazione di riservatezza disabilitata. Applicabile solo per l'etichetta di riservatezza consigliata. Specifica se la raccomandazione di riservatezza in questa colonna è disabilitata (ignorata) o meno.

properties.labelId

string

ID etichetta.

properties.labelName

string

Nome dell'etichetta.

properties.rank

SensitivityLabelRank

properties.schemaName

string

Nome dello schema.

properties.tableName

string

Nome della tabella.

type

string

Tipo di risorsa.

SensitivityLabelListResult

Elenco di etichette di riservatezza.

Nome Tipo Descrizione
nextLink

string

Collegamento per recuperare la pagina successiva dei risultati.

value

SensitivityLabel[]

Matrice di risultati.

SensitivityLabelRank

Valore Descrizione
Critical
High
Low
Medium
None