Managed Database Sensitivity Labels - Update

Servizio:

SQL Database

Versione API:

2023-08-01

Aggiornare le etichette di riservatezza di un determinato database usando un batch di operazioni.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/currentSensitivityLabels?api-version=2023-08-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
managedInstanceName	path	True	string	Nome dell'istanza gestita.
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.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Tipo	Descrizione
operations	SensitivityLabelUpdate[]	Operazione di aggiornamento delle etichette di riservatezza.

Risposte

Nome	Tipo	Descrizione
200 OK		Le etichette di riservatezza sono state aggiornate correttamente.
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 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 InvalidSensitivityLabelsBatch: il batch di etichette di riservatezza specificato non è valido. Specificare le operazioni batch 400 SensitivityLabelsMissingSchema - Operazione[{0}]: Informazioni sullo schema mancanti 400 SensitivityLabelsMissingTable - Operation[{0}]: Informazioni sulla tabella mancanti 400 SensitivityLabelsMissingColumn - Operation[{0}]: Informazioni sulle colonne mancanti 400 SensitivityLabelsUpdateSameColumnMoreThanOnce : la colonna {0} non può essere aggiornata più volte in un singolo comando 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 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server. 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 503 DatabaseUnavailable: operazione non riuscita perché il database non è disponibile.

Esempio

Update sensitivity labels of a given database using an operations batch.

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/currentSensitivityLabels?api-version=2023-08-01

{
  "operations": [
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table1",
        "column": "column1",
        "sensitivityLabel": {
          "properties": {
            "labelName": "Highly Confidential",
            "labelId": "3A477B16-9423-432B-AA97-6069B481CEC3",
            "informationType": "Financial",
            "informationTypeId": "1D3652D6-422C-4115-82F1-65DAEBC665C8"
          }
        }
      }
    },
    {
      "properties": {
        "op": "set",
        "schema": "dbo",
        "table": "table2",
        "column": "column2",
        "sensitivityLabel": {
          "properties": {
            "informationType": "PhoneNumber",
            "informationTypeId": "d22fa6e9-5ee4-3bde-4c2b-a409604c4646",
            "labelId": "bf91e08c-f4f0-478a-b016-25164b2a65ff",
            "labelName": "PII"
          }
        }
      }
    },
    {
      "properties": {
        "op": "remove",
        "schema": "dbo",
        "table": "Table1",
        "column": "Column3"
      }
    }
  ]
}

Risposta di esempio

Codice di stato:

200

Definizioni

Nome	Descrizione
ClientClassificationSource
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
SensitivityLabel	Etichetta di riservatezza.
SensitivityLabelRank
SensitivityLabelUpdate	Operazione di aggiornamento delle etichette di riservatezza.
SensitivityLabelUpdateKind
SensitivityLabelUpdateList	Elenco di operazioni di aggiornamento delle etichette di riservatezza.

ClientClassificationSource

Enumerazione

Valore	Descrizione
None
Native
Recommended
MIP

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Oggetto

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

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

SensitivityLabel

Oggetto

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
None
Low
Medium
High
Critical

SensitivityLabelUpdate

Oggetto

Operazione di aggiornamento delle etichette di riservatezza.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.column	string	Nome della colonna da aggiornare.
properties.op	SensitivityLabelUpdateKind
properties.schema	string	Nome dello schema della colonna da aggiornare.
properties.sensitivityLabel	SensitivityLabel	Informazioni sull'etichetta di riservatezza da applicare su una colonna.
properties.table	string	Nome tabella della colonna da aggiornare.
type	string	Tipo di risorsa.

SensitivityLabelUpdateKind

Enumerazione

Valore	Descrizione
set
remove

SensitivityLabelUpdateList

Oggetto

Elenco di operazioni di aggiornamento delle etichette di riservatezza.

Nome	Tipo	Descrizione
operations	SensitivityLabelUpdate[]	Operazione di aggiornamento delle etichette di riservatezza.