Freigeben über


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/servers/{serverName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2021-11-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
columnName
path True

string

Der Name der Spalte.

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.

schemaName
path True

string

Der Name des Schemas.

sensitivityLabelSource
path True

WritableSensitivityLabelSource

Die Quelle der Vertraulichkeitsbezeichnung.

serverName
path True

string

Name des Servers

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 Typ Beschreibung
properties.informationType

string

Der Informationstyp.

properties.informationTypeId

string

Die Informationstyp-ID.

properties.labelId

string

Die Bezeichnungs-ID.

properties.labelName

string

Der Bezeichnungsname.

properties.rank

SensitivityLabelRank

Antworten

Name Typ Beschreibung
200 OK

SensitivityLabel

Die Vertraulichkeitsbezeichnung wurde erfolgreich aktualisiert.

201 Created

SensitivityLabel

Die Vertraulichkeitsbezeichnung wurde erfolgreich erstellt.

Other Status Codes

Fehlerantworten: ***

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

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

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

  • 400 SensitivityLabelLabelNameAndInfoTypeNotProvided: Mindestens einer von LabelName und InformationType muss angegeben werden.

  • 400 LabelNameTooLong : Der Bezeichnungsname darf Zeichen nicht überschreiten {0}

  • 400 InformationTypeTooLong : Der Informationstyp darf keine Zeichen überschreiten {0}

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

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

  • 400 LabelMissing : Label ist erforderlich. Mindestens eine von "labelName" oder "labelId" muss angegeben werden.

  • 400 InformationTypeMissing: Der Informationstyp ist erforderlich. Mindestens einer von "informationType" oder "informationTypeId" muss angegeben werden.

  • 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden

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

  • 404 SensitivityLabelsLabelNotFound: Die angegebene Vertraulichkeitsbezeichnung wurde nicht gefunden

  • 404 SensitivityLabelsSchemaNotFound: Das Schema {0} wurde nicht gefunden

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

  • 404 SensitivityLabelsColumnNotFound: Die Spalte {0} konnte in der Tabelle {2}nicht gefunden werden.{1}

  • 501 SensitivityLabelRecommendedSourceNameNotSupported : Quelle der Vertraulichkeitsbezeichnung "Empfohlen" wird noch nicht unterstützt

  • 501 SensitivityLabelRecommendedSourceNameNotSupported : Quelle der Vertraulichkeitsbezeichnung "Empfohlen" wird noch nicht unterstützt

Beispiele

Updates the sensitivity label of a given column with all parameters

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/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": "Low"
  }
}

Beispiel für eine Antwort

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/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": "Medium"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/schemas/tables/columns/sensitivityLabels",
  "properties": {
    "informationType": "PhoneNumber",
    "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
    "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
    "labelName": "PII",
    "rank": "High"
  }
}

Definitionen

Name Beschreibung
SensitivityLabel

Eine Vertraulichkeitsbezeichnung.

SensitivityLabelRank
WritableSensitivityLabelSource

Die Quelle der Vertraulichkeitsbezeichnung.

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.

SensitivityLabelRank

Name Typ Beschreibung
Critical

string

High

string

Low

string

Medium

string

None

string

WritableSensitivityLabelSource

Die Quelle der Vertraulichkeitsbezeichnung.

Name Typ Beschreibung
current

string