Sensitivity Labels - List Current By Database

  • Riferimento
Servizio:
SQL Database
Versione API:
2021-11-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=2021-11-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=2021-11-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 contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure 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

È stato recuperato correttamente le etichette di riservatezza.
Other Status Codes

Risposte agli errori: **

  • 400 DatawarehouseDatabaseIsDeactivated - Impossibile eseguire l'operazione di classificazione dei dati perché il database viene sospeso. 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=2021-11-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
SensitivityLabel

Etichetta di riservatezza.
SensitivityLabelListResult

Elenco delle etichette di riservatezza.
SensitivityLabelRank

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

string

Nome della colonna.
properties.informationType

string

Tipo di informazioni.
properties.informationTypeId

string

ID tipo di informazioni.
properties.isDisabled

boolean

È disabilitata la raccomandazione di riservatezza. 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 dell'etichetta.
properties.labelName

string

Nome dell'etichetta.
properties.rank

SensitivityLabelRank

properties.schemaName

string

Nome dello schema.
properties.tableName

string

Il nome della tabella.
type

string

Tipo di risorsa.

SensitivityLabelListResult

Elenco delle etichette di riservatezza.

Nome Tipo Descrizione
nextLink

string

Collegamento per recuperare la pagina successiva dei risultati.
value

SensitivityLabel[]

Matrice di risultati.

SensitivityLabelRank

Nome Tipo Descrizione
Critical

string

High

string

Low

string

Medium

string

None

string