Sensitivity Labels - List Current By Database

Servizio:

SQL Database

Versione API:

2023-08-01

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

Con parametri facoltativi:

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

HTTP

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

Codice di stato:

200

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

Enumerazione

Valore	Descrizione
MIP
Native
None
Recommended

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

SensitivityLabel

Object

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

Object

Elenco di etichette di riservatezza.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	SensitivityLabel[]	Matrice di risultati.

SensitivityLabelRank

Enumerazione

Valore	Descrizione
Critical
High
Low
Medium
None