Delen via

Sensitivity Labels - Create Or Update

Service:
SQL Database
API-versie:
2023-08-01

Het vertrouwelijkheidslabel van een bepaalde kolom maken of bijwerken

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

URI-parameters

Name In Vereist Type Description
columnName
 path True

string

De naam van de kolom.
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.
schemaName
 path True

string

De naam van het schema.
sensitivityLabelSource
 path True

CurrentSensitivityLabelSource

De bron van het vertrouwelijkheidslabel.
serverName
 path True

string

De naam van de server.
subscriptionId
 path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
tableName
 path True

string

De naam van de tabel.
api-version
 query True

string

De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name Type Description
properties.clientClassificationSource

ClientClassificationSource

properties.informationType

string

Het informatietype.
properties.informationTypeId

string

De id van het informatietype.
properties.labelId

string

De label-id.
properties.labelName

string

De labelnaam.
properties.rank

SensitivityLabelRank

Antwoorden

Name Type Description
200 OK

SensitivityLabel

Het vertrouwelijkheidslabel is bijgewerkt.
201 Created

SensitivityLabel

Het vertrouwelijkheidslabel is gemaakt.
Other Status Codes

ErrorResponse

Foutreacties: ***

  • 400 DatawarehouseDatabaseIsDeactivated - Kan de gegevensclassificatiebewerking niet uitvoeren omdat de database is onderbroken. Hervat het.

  • 400 SensitivityLabelSourceNameNotSupported - De opgegeven vertrouwelijkheidslabelbron is ongeldig

  • 400 InvalidSensitivityLabelResource : de opgegeven vertrouwelijkheidslabelresource is ongeldig

  • 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Ten minste één van LabelName en InformationType moet worden opgegeven

  • 400 LabelNameTooLong - Labelnaam mag niet groter zijn dan {0} tekens

  • 400 InformationTypeTooLong - Informatietype mag niet langer zijn dan {0} tekens

  • 400 LabelIdMustBeGuid: de opgegeven label-id is ongeldig. Waarde moet een GUID zijn

  • 400 InformationTypeIdMustBeGuid - De opgegeven 'informationTypeId' is ongeldig. Waarde moet een GUID zijn

  • 400 LabelMissing - Label is vereist. Er moet ten minste één van 'labelName' of 'labelId' worden opgegeven

  • 400 InformationTypeMissing - Informatietype is vereist. Ten minste één van 'informationType' of 'informationTypeId' moet worden opgegeven

  • 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden

  • 404 SensitivityLabelsSchemaNotFound - Het schema {0} kan niet worden gevonden

  • 404 SensitivityLabelsTableNotFound: de tabel {0} niet gevonden in het schema {1}

  • 404 SensitivityLabelsColumnNotFound - De kolom {0} is niet gevonden in tabel {2}.{1}

  • 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren.

  • 404 SensitivityLabelsLabelNotFound - Het opgegeven vertrouwelijkheidslabel is niet gevonden

  • 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Aanbevolen' vertrouwelijkheidslabelbron wordt nog niet ondersteund

  • 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Aanbevolen' vertrouwelijkheidslabelbron wordt nog niet ondersteund

Voorbeelden

Updates the sensitivity label of a given column with all parameters

Voorbeeldaanvraag

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

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

Voorbeeldrespons

Statuscode:
200 
{
  "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"
  }
}
Statuscode:
201 
{
  "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"
  }
}

Definities

Name Description
ClientClassificationSource
CurrentSensitivityLabelSource

De bron van het vertrouwelijkheidslabel.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
SensitivityLabel

Een vertrouwelijkheidslabel.
SensitivityLabelRank

ClientClassificationSource

Inventarisatie
Waarde Description
None
Native
Recommended
MIP

CurrentSensitivityLabelSource

Inventarisatie

De bron van het vertrouwelijkheidslabel.

Waarde Description
current

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.

SensitivityLabelRank

Inventarisatie
Waarde Description
None
Low
Medium
High
Critical