Leggere in inglese

Condividi tramite

Sensitivity Labels - Update

  • Riferimento
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/servers/{serverName}/databases/{databaseName}/currentSensitivityLabels?api-version=2023-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
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.
serverName
 path True

string

Nome del server.
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

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/myServer/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",
            "rank": "Low"
          }
        }
      }
    },
    {
      "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",
            "rank": "Critical"
          }
        }
      }
    },
    {
      "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
MIP
Native
None
Recommended

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

SensitivityLabelUpdate

Object

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
remove
set

SensitivityLabelUpdateList

Object

Elenco di operazioni di aggiornamento delle etichette di riservatezza.

Nome Tipo Descrizione
operations

SensitivityLabelUpdate[]

Operazione di aggiornamento delle etichette di riservatezza.