Sensitivity Labels - List Recommended By Database

Service:

SQL Database

API-versie:

2023-08-01

Hiermee haalt u de vertrouwelijkheidslabels van een bepaalde database op

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

Met optionele parameters:

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=2023-08-01

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.
$filter	query		string	Een OData-filterexpressie waarmee elementen in de verzameling worden gefilterd.
$skipToken	query		string
includeDisabledRecommendations	query		boolean	Hiermee geeft u op of uitgeschakelde aanbevelingen moeten worden opgenomen of niet.

Antwoorden

Name	Type	Description
200 OK	SensitivityLabelListResult	De vertrouwelijkheidslabels zijn opgehaald.
Other Status Codes	ErrorResponse	Foutreacties: *** 400 DatawarehouseDatabaseIsDeactivated - Kan de gegevensclassificatiebewerking niet uitvoeren omdat de database is onderbroken. Hervat het. 400 SensitivityLabelsInvalidODataQuery - De opgegeven OData-query is niet geldig of wordt niet ondersteund 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren. 503 DatabaseUnavailable - De bewerking is mislukt omdat de database niet beschikbaar is.

Voorbeelden

Gets the recommended sensitivity labels of a given database

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
ClientClassificationSource
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
SensitivityLabel	Een vertrouwelijkheidslabel.
SensitivityLabelListResult	Een lijst met vertrouwelijkheidslabels.
SensitivityLabelRank

ClientClassificationSource

Inventarisatie

Waarde	Description
MIP
Native
None
Recommended

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

SensitivityLabel

Object

Een vertrouwelijkheidslabel.

Name	Type	Description
id	string	Resource-id.
managedBy	string	Resource waarmee het vertrouwelijkheidslabel wordt beheerd.
name	string	Resourcenaam.
properties.clientClassificationSource	ClientClassificationSource
properties.columnName	string	De kolomnaam.
properties.informationType	string	Het informatietype.
properties.informationTypeId	string	De id van het informatietype.
properties.isDisabled	boolean	Is de aanbeveling voor gevoeligheid uitgeschakeld. Alleen van toepassing op aanbevolen vertrouwelijkheidslabels. Hiermee geeft u op of de vertrouwelijkheidsaanveling voor deze kolom is uitgeschakeld (gesloten) of niet.
properties.labelId	string	De label-id.
properties.labelName	string	De labelnaam.
properties.rank	SensitivityLabelRank
properties.schemaName	string	De schemanaam.
properties.tableName	string	De tabelnaam.
type	string	Resourcetype.

SensitivityLabelListResult

Object

Een lijst met vertrouwelijkheidslabels.

Name	Type	Description
nextLink	string	Koppeling om de volgende pagina met resultaten op te halen.
value	SensitivityLabel[]	Matrix met resultaten.

SensitivityLabelRank

Inventarisatie

Waarde	Description
Critical
High
Low
Medium
None