Sensitivity Labels - Create Or Update

Servizio:

SQL Database

Versione API:

2023-08-01

Crea o aggiorna l'etichetta di riservatezza di una determinata colonna

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
columnName	path	True	string	Nome della colonna.
databaseName	path	True	string	Nome del database.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
schemaName	path	True	string	Nome dello schema.
sensitivityLabelSource	path	True	CurrentSensitivityLabelSource	Origine dell'etichetta di riservatezza.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
tableName	path	True	string	Nome della tabella.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.clientClassificationSource	ClientClassificationSource
properties.informationType	string	Tipo di informazioni.
properties.informationTypeId	string	ID del tipo di informazioni.
properties.labelId	string	ID etichetta.
properties.labelName	string	Nome dell'etichetta.
properties.rank	SensitivityLabelRank

Risposte

Nome	Tipo	Descrizione
200 OK	SensitivityLabel	Aggiornamento dell'etichetta di riservatezza completata.
201 Created	SensitivityLabel	Creazione dell'etichetta di riservatezza completata.
Other Status Codes	ErrorResponse	Risposte di errore: 400 DatawarehouseDatabaseIsDeactivated - Impossibile eseguire l'operazione di classificazione dei dati perché il database è in pausa. Si prega di riprenderlo. 400 SensitivityLabelSourceNameNotSupported - L'origine dell'etichetta di riservatezza specificata non è valida 400 InvalidSensitivityLabelResource - La risorsa etichetta di riservatezza specificata non è valida 400 SensitivityLabelLabelNameAndInfoTypeNotProvided- È necessario specificare almeno un elemento LabelName e InformationType 400 LabelNameTooLong - Il nome dell'etichetta non può superare {0} caratteri 400 InformationTypeTooLong - Il tipo di informazioni non può superare {0} caratteri 400 LabelIdMustBeGuid: l'elemento 'labelId' specificato non è valido. Il valore deve essere un GUID 400 InformationTypeIdMustBeGuid- L'elemento 'informationTypeId' specificato non è valido. Il valore deve essere un GUID 400 LabelMissing: l'etichetta è obbligatoria. È necessario specificare almeno un 'labelName' o 'labelId' 400 InformationTypeMissing : è necessario il tipo di informazioni. È necessario specificare almeno un 'informationType' o 'informationTypeId' 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 SensitivityLabelsSchemaNotFound - Impossibile trovare lo schema {0} 404 SensitivityLabelsTableNotFound - Impossibile trovare la tabella {0} nello schema {1} 404 SensitivityLabelsColumnNotFound- Impossibile trovare la colonna {0} nella tabella {2}.{1} 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server. 404 SensitivityLabelsLabelNotFound - Impossibile trovare l'etichetta di riservatezza specificata 501 SensitivityLabelRecommendedSourceNameNotSupported - L'origine dell'etichetta di riservatezza "Consigliata" non è ancora supportata 501 SensitivityLabelRecommendedSourceNameNotSupported - L'origine dell'etichetta di riservatezza "Consigliata" non è ancora supportata

Esempio

Updates the sensitivity label of a given column with all parameters

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Definizioni

Nome	Descrizione
ClientClassificationSource
CurrentSensitivityLabelSource	Origine dell'etichetta di riservatezza.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
SensitivityLabel	Etichetta di riservatezza.
SensitivityLabelRank

ClientClassificationSource

Enumerazione

Valore	Descrizione
MIP
Native
None
Recommended

CurrentSensitivityLabelSource

Enumerazione

Origine dell'etichetta di riservatezza.

Valore	Descrizione
current

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

SensitivityLabel

Object

Etichetta di riservatezza.

Nome	Tipo	Descrizione
id	string	ID risorsa.
managedBy	string	Risorsa che gestisce l'etichetta di riservatezza.
name	string	Nome risorsa.
properties.clientClassificationSource	ClientClassificationSource
properties.columnName	string	Nome della colonna.
properties.informationType	string	Tipo di informazioni.
properties.informationTypeId	string	ID del tipo di informazioni.
properties.isDisabled	boolean	Raccomandazione di riservatezza disabilitata. Applicabile solo per l'etichetta di riservatezza consigliata. Specifica se la raccomandazione di riservatezza in questa colonna è disabilitata (ignorata) o meno.
properties.labelId	string	ID etichetta.
properties.labelName	string	Nome dell'etichetta.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Nome dello schema.
properties.tableName	string	Nome della tabella.
type	string	Tipo di risorsa.

SensitivityLabelRank

Enumerazione

Valore	Descrizione
Critical
High
Low
Medium
None