Dela via


Sensitivity Labels - Create Or Update

Skapar eller uppdaterar känslighetsetiketten för en viss kolumn

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-parametrar

Name I Obligatorisk Typ Description
columnName
path True

string

Namnet på kolumnen.

databaseName
path True

string

Namnet på databasen.

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

schemaName
path True

string

Namnet på schemat.

sensitivityLabelSource
path True

WritableSensitivityLabelSource

Källan till känslighetsetiketten.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Prenumerations-ID:t som identifierar en Azure-prenumeration.

tableName
path True

string

Namnet på tabellen.

api-version
query True

string

DEN API-version som ska användas för begäran.

Begärandetext

Name Typ Description
properties.informationType

string

Informationstypen.

properties.informationTypeId

string

Informationstypens ID.

properties.labelId

string

Etikett-ID:t.

properties.labelName

string

Etikettnamnet.

properties.rank

SensitivityLabelRank

Svar

Name Typ Description
200 OK

SensitivityLabel

Känslighetsetiketten har uppdaterats.

201 Created

SensitivityLabel

Känslighetsetiketten har skapats.

Other Status Codes

Felsvar: ***

  • 400 DatawarehouseDatabaseIsDeactivated – Det gick inte att köra dataklassificeringsåtgärden eftersom databasen har pausats. Återuppta den.

  • 400 SensitivityLabelSourceNameNotSupported – den angivna källan för känslighetsetiketter är inte giltig

  • 400 InvalidSensitivityLabelResource – den angivna resursen för känslighetsetiketter är inte giltig

  • 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Minst ett av LabelName och InformationType måste anges

  • 400 LabelNameTooLong – Etikettnamn får inte överskrida {0} tecken

  • 400 InformationTypeTooLong – Informationstypen får inte överskrida {0} tecken

  • 400 LabelIdMustBeGuid – det angivna "labelId" är ogiltigt. Värdet måste vara ett GUID

  • 400 InformationTypeIdMustBeGuid – det angivna "informationTypeId" är ogiltigt. Värdet måste vara ett GUID

  • 400 LabelMissing – Etikett krävs. Minst ett av "labelName" eller "labelId" måste anges

  • 400 InformationTypeMissing – Informationstyp krävs. Minst en av "informationType" eller "informationTypeId" måste anges

  • 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte

  • 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen.

  • 404 SensitivityLabelsLabelNotFound – Det gick inte att hitta den angivna känslighetsetiketten

  • 404 SensitivityLabelsSchemaNotFound – det gick inte att hitta schemat {0}

  • 404 SensitivityLabelsTableNotFound – Det gick inte att hitta tabellen {0} i schemat {1}

  • 404 SensitivityLabelsColumnNotFound – Det gick inte att hitta kolumnen {0} i tabellen {2}.{1}

  • 501 SensitivityLabelRecommendedSourceNameNotSupported – "Rekommenderad" källa för känslighetsetiketter stöds inte ännu

  • 501 SensitivityLabelRecommendedSourceNameNotSupported – "Rekommenderad" källa för känslighetsetiketter stöds inte ännu

Exempel

Updates the sensitivity label of a given column with all parameters

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
SensitivityLabel

En känslighetsetikett.

SensitivityLabelRank
WritableSensitivityLabelSource

Källan till känslighetsetiketten.

SensitivityLabel

En känslighetsetikett.

Name Typ Description
id

string

Resurs-ID.

managedBy

string

Resurs som hanterar känslighetsetiketten.

name

string

Resursnamn.

properties.columnName

string

Kolumnnamnet.

properties.informationType

string

Informationstypen.

properties.informationTypeId

string

Informationstypens ID.

properties.isDisabled

boolean

Är känslighetsrekommendations inaktiverad. Gäller endast för rekommenderad känslighetsetikett. Anger om känslighetsrekommendationsen för den här kolumnen är inaktiverad (avvisad) eller inte.

properties.labelId

string

Etikett-ID:t.

properties.labelName

string

Etikettnamnet.

properties.rank

SensitivityLabelRank

properties.schemaName

string

Schemanamnet.

properties.tableName

string

Tabellnamnet.

type

string

Resurstyp.

SensitivityLabelRank

Name Typ Description
Critical

string

High

string

Low

string

Medium

string

None

string

WritableSensitivityLabelSource

Källan till känslighetsetiketten.

Name Typ Description
current

string