Dela via

Sensitivity Labels - Create Or Update

Tjänst:
SQL Database
API-version:
2023-08-01

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

CurrentSensitivityLabelSource

Källan till känslighetsetiketten.
serverName
 path True

string

Namnet på servern.
subscriptionId
 path True

string

Det prenumerations-ID 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.clientClassificationSource

ClientClassificationSource

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

ErrorResponse

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 ogiltig

  • 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 – Etikettnamnet får inte överstiga {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 EtikettMissing – 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 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}

  • 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

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

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

Exempelsvar

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

Definitioner

Name Description
ClientClassificationSource
CurrentSensitivityLabelSource

Källan till känslighetsetiketten.
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.
ErrorDetail

Felinformationen.
ErrorResponse

Felsvar
SensitivityLabel

En känslighetsetikett.
SensitivityLabelRank

ClientClassificationSource

Uppräkning
Värde Description
None
Native
Recommended
MIP

CurrentSensitivityLabelSource

Uppräkning

Källan till känslighetsetiketten.

Värde Description
current

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.
type

string

Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

ErrorDetail[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

ErrorResponse

Objekt

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

SensitivityLabel

Objekt

En känslighetsetikett.

Name Typ Description
id

string

Resurs-ID.
managedBy

string

Resurs som hanterar känslighetsetiketten.
name

string

Resursnamn.
properties.clientClassificationSource

ClientClassificationSource

properties.columnName

string

Kolumnnamnet.
properties.informationType

string

Informationstypen.
properties.informationTypeId

string

Informationstypens ID.
properties.isDisabled

boolean

Är känslighetsrekommendationsen 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

Uppräkning
Värde Description
None
Low
Medium
High
Critical