Sensitivity Labels - List Current By Database

Service:

SQL Database

API Version:

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

With optional parameters:

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

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for SensitivityLabels ListCurrentByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * SensitivityLabelsListByDatabaseWithSourceCurrent.json
     */
    /**
     * Sample code: Gets the current sensitivity labels of a given database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheCurrentSensitivityLabelsOfAGivenDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().listCurrentByDatabase("myRG", "myServer",
            "myDatabase", null, null, null, Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

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