Freigeben über


Sensitivity Labels - List Recommended By Database

Ruft die Vertraulichkeitsbezeichnungen einer bestimmten Datenbank ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
path True

string

Der Name der Datenbank.

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serverName
path True

string

Name des Servers

subscriptionId
path True

string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True

string

API-Version, die für die Anforderung verwendet werden soll.

$filter
query

string

Ein OData-Filterausdruck, der Elemente in der Auflistung filtert.

$skipToken
query

string

includeDisabledRecommendations
query

boolean

Gibt an, ob deaktivierte Empfehlungen eingeschlossen werden sollen oder nicht.

Antworten

Name Typ Beschreibung
200 OK

SensitivityLabelListResult

Die Vertraulichkeitsbezeichnungen wurden erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

  • 400 DatawarehouseDatabaseIsDeactivated: Der Datenklassifizierungsvorgang konnte nicht ausgeführt werden, da die Datenbank angehalten wurde. Bitte setzen Sie sie fort.

  • 400 SensitivityLabelsInvalidODataQuery: Die angegebene OData-Abfrage ist entweder ungültig oder nicht unterstützt.

  • 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden

  • 404 DatabaseDoesNotExist: Der Benutzer hat einen Datenbanknamen angegeben, der auf diesem Server instance nicht vorhanden ist.

  • 503 DatabaseUnavailable: Fehler beim Vorgang, weil die Datenbank nicht verfügbar ist.

Beispiele

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
SensitivityLabel

Eine Vertraulichkeitsbezeichnung.

SensitivityLabelListResult

Eine Liste von Vertraulichkeitsbezeichnungen.

SensitivityLabelRank

SensitivityLabel

Eine Vertraulichkeitsbezeichnung.

Name Typ Beschreibung
id

string

Ressourcen-ID

managedBy

string

Ressource, die die Vertraulichkeitsbezeichnung verwaltet.

name

string

Name der Ressource.

properties.columnName

string

Der Spaltenname.

properties.informationType

string

Der Informationstyp.

properties.informationTypeId

string

Die Informationstyp-ID.

properties.isDisabled

boolean

Ist die Vertraulichkeitsempfehlung deaktiviert. Gilt nur für die empfohlene Vertraulichkeitsbezeichnung. Gibt an, ob die Vertraulichkeitsempfehlung für diese Spalte deaktiviert (verworfen) ist oder nicht.

properties.labelId

string

Die Bezeichnungs-ID.

properties.labelName

string

Der Bezeichnungsname.

properties.rank

SensitivityLabelRank

properties.schemaName

string

Der Schemaname.

properties.tableName

string

Der Tabellenname.

type

string

Der Ressourcentyp.

SensitivityLabelListResult

Eine Liste von Vertraulichkeitsbezeichnungen.

Name Typ Beschreibung
nextLink

string

Link zum Abrufen der nächsten Ergebnisseite.

value

SensitivityLabel[]

Array von Ergebnissen.

SensitivityLabelRank

Name Typ Beschreibung
Critical

string

High

string

Low

string

Medium

string

None

string