Managed Database Sensitivity Labels - Create Or Update

Erstellt oder aktualisiert die Vertraulichkeitsbezeichnung einer bestimmten Spalte

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2021-11-01

URI-Parameter

Name In Required Type Description
columnName
path True
  • string

Der Name der Spalte.

databaseName
path True
  • string

Der Name der Datenbank.

managedInstanceName
path True
  • string

Der Name der verwalteten Instanz.

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.

schemaName
path True
  • string

Der Name des Schemas.

sensitivityLabelSource
path True

Die Quelle der Vertraulichkeitsbezeichnung.

subscriptionId
path True
  • string

Abonnement-ID für ein Azure-Abonnement.

tableName
path True
  • string

Der Name der Tabelle.

api-version
query True
  • string

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

Anforderungstext

Name Type Description
properties.informationType
  • string

Der Informationstyp.

properties.informationTypeId
  • string

Die Informationstyp-ID.

properties.labelId
  • string

Die Bezeichnungs-ID.

properties.labelName
  • string

Der Bezeichnungsname.

properties.rank

Antworten

Name Type Description
200 OK

Die Vertraulichkeitsbezeichnung wurde erfolgreich aktualisiert.

201 Created

Die Vertraulichkeitsbezeichnung wurde erfolgreich erstellt.

Other Status Codes

Fehlerantworten: ***

  • 400 DatawarehouseDatabaseIsDeactivated – Datenklassifizierungsvorgang konnte nicht ausgeführt werden, da die Datenbank angehalten wird. Bitte fortsetzen Sie sie.

  • 400 SensitivityLabelSourceNameNotSupported – Die angegebene Vertraulichkeitsbezeichnungsquelle ist ungültig.

  • 400 InvalidSensitivityLabelResource – Die angegebene Vertraulichkeitsbezeichnungsressource ist ungültig.

  • 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Mindestens eine der Bezeichnungsname und InformationType muss angegeben werden.

  • 400 LabelNameTooLong - Bezeichnungsname darf keine Zeichen überschreiten {0}

  • 400 InformationTypeTooLong - Informationstyp kann keine Zeichen überschreiten {0}

  • 400 LabelIdMustBeGuid – Die bereitgestellte "labelId" ist ungültig. Wert muss eine GUID sein

  • 400 InformationTypeIdMustBeGuid – Die bereitgestellte "informationTypeId" ist ungültig. Wert muss eine GUID sein

  • 400 LabelMissing – Bezeichnung ist erforderlich. Mindestens eine der "labelName" oder "labelId" muss bereitgestellt werden.

  • 400 InformationTypeMissing – Informationstyp ist erforderlich. Mindestens eine der "informationType" oder "informationTypeId" muss bereitgestellt werden.

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 DatabaseDoesNotExist – Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist.

  • 404 SensitivityLabelsLabelNotFound - Die angegebene Vertraulichkeitsbezeichnung konnte nicht gefunden werden.

  • 404 SensitivityLabelsSchemaNotFound - Das Schema {0} konnte nicht gefunden werden.

  • 404 SensitivityLabelsTableNotFound – Die Tabelle {0} konnte nicht im Schema gefunden werden. {1}

  • 404 SensitivityLabelsColumnNotFound - Die Spalte {0} konnte in tabelle {2}nicht gefunden werden.{1}

  • 501 SensitivityLabelRecommendedSourceNameNotSupported – "Empfohlene" Vertraulichkeitsbezeichnungsquelle wird noch nicht unterstützt.

  • 501 SensitivityLabelRecommendedSourceNameNotSupported – "Empfohlene" Vertraulichkeitsbezeichnungsquelle wird noch nicht unterstützt.

Beispiele

Updates or creates a sensitivity label of a given column with all parameters in a managed database

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current?api-version=2021-11-01

{
  "properties": {
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "schemaName": "dbo",
    "tableName": "myTable",
    "columnName": "myColumn",
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Definitionen

SensitivityLabel

Eine Vertraulichkeitsbezeichnung.

SensitivityLabelRank
WritableSensitivityLabelSource

Die Quelle der Vertraulichkeitsbezeichnung.

SensitivityLabel

Eine Vertraulichkeitsbezeichnung.

Name Type Description
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 empfohlene Vertraulichkeitsbezeichnungen. Gibt an, ob die Vertraulichkeitsempfehlung für diese Spalte deaktiviert ist (geschlossen) oder nicht.

properties.labelId
  • string

Die Bezeichnungs-ID.

properties.labelName
  • string

Der Bezeichnungsname.

properties.rank
properties.schemaName
  • string

Der Schemaname.

properties.tableName
  • string

Der Tabellenname.

type
  • string

Der Ressourcentyp.

SensitivityLabelRank

Name Type Description
Critical
  • string
High
  • string
Low
  • string
Medium
  • string
None
  • string

WritableSensitivityLabelSource

Die Quelle der Vertraulichkeitsbezeichnung.

Name Type Description
current
  • string