Sensitivity Labels - List Recommended By Database

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Získá popisky citlivosti dané databáze.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/recommendedSensitivityLabels?api-version=2021-11-01

S volitelnými parametry:

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=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.
$filter	query		string	Výraz filtru OData, který filtruje prvky v kolekci.
$skipToken	query		string
includeDisabledRecommendations	query		boolean	Určuje, jestli se mají zahrnout zakázaná doporučení, nebo ne.

Odpovědi

Name	Typ	Description
200 OK	SensitivityLabelListResult	Popisky citlivosti se úspěšně načetly.
Other Status Codes		Chybové odpovědi: *** 400 DatawarehouseDatabaseIsDeactivated – Nelze spustit operaci klasifikace dat, protože databáze je pozastavená. Prosím, pokračujte v tom. 400 SensitivityLabelsInvalidODataQuery – zadaný dotaz OData není platný nebo není podporovaný. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje. 503 DatabaseUnavailable – operace selhala, protože databáze není k dispozici.

Příklady

Gets the recommended sensitivity labels of a given database

Ukázkový požadavek

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for SensitivityLabels ListRecommendedByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * SensitivityLabelsListByDatabaseWithSourceRecommended.json
     */
    /**
     * Sample code: Gets the recommended sensitivity labels of a given database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getsTheRecommendedSensitivityLabelsOfAGivenDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().listRecommendedByDatabase("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

Ukázková odpověď

Stavový kód:

200

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

Definice

Name	Description
SensitivityLabel	Popisek citlivosti.
SensitivityLabelListResult	Seznam popisků citlivosti.
SensitivityLabelRank

SensitivityLabel

Popisek citlivosti.

Name	Typ	Description
id	string	ID prostředku.
managedBy	string	Prostředek, který spravuje popisek citlivosti.
name	string	Název prostředku.
properties.columnName	string	Název sloupce.
properties.informationType	string	Typ informací.
properties.informationTypeId	string	ID typu informací.
properties.isDisabled	boolean	Je doporučení citlivosti zakázané. Platí jenom pro doporučený popisek citlivosti. Určuje, jestli je doporučení citlivosti pro tento sloupec zakázané (zavřené) nebo ne.
properties.labelId	string	ID popisku.
properties.labelName	string	Název popisku.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Název schématu.
properties.tableName	string	Název tabulky.
type	string	Typ prostředku.

SensitivityLabelListResult

Seznam popisků citlivosti.

Name	Typ	Description
nextLink	string	Odkaz na načtení další stránky výsledků
value	SensitivityLabel[]	Pole výsledků

SensitivityLabelRank

Name	Typ	Description
Critical	string
High	string
Low	string
Medium	string
None	string