Sensitivity Labels - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

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

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

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 contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
schemaName	path	True	string	Nome dello schema.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	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.informationType	string	Tipo di informazioni.
properties.informationTypeId	string	ID tipo di informazioni.
properties.labelId	string	ID dell'etichetta.
properties.labelName	string	Nome dell'etichetta.
properties.rank	SensitivityLabelRank

Risposte

Nome	Tipo	Descrizione
200 OK	SensitivityLabel	È stato aggiornato correttamente l'etichetta di riservatezza.
201 Created	SensitivityLabel	È stata creata correttamente l'etichetta di riservatezza.
Other Status Codes		Risposte agli errori: ** 400 DatawarehouseDatabaseIsDeactivated - Impossibile eseguire l'operazione di classificazione dei dati perché il database viene sospeso. Riprenderlo. 400 SensitivityLabelSourceNameNotSupported - L'origine dell'etichetta di riservatezza specificata non è valida 400 InvalidSensitivityLabelResource - La risorsa dell'etichetta di riservatezza specificata non è valida 400 SensitivityLabelLabelLabelNameAndInfoTypeNotProvided - È necessario specificare almeno uno di LabelName e InformationType 400 LabelNameTooLong - Nome etichetta non può superare {0} i caratteri 400 InformationTypeTooLong - Tipo di informazioni non può superare {0} i caratteri 400 LabelIdMustBeGuid : l'oggetto 'labelId' specificato non è valido. Il valore deve essere un GUID 400 InformationTypeIdMustBeGuid: l'oggetto 'informationTypeId' specificato non è valido. Il valore deve essere un GUID 400 LabelMissing : è necessaria l'etichetta. È necessario specificare almeno uno di 'labelName' o 'labelId' 400 InformationTypeMissing : è necessario il tipo di informazioni. È necessario specificare almeno uno di '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 SensitivityLabelsLabelNotFound - Impossibile trovare l'etichetta di riservatezza specificata 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} 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

Sample Request

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=2021-11-01

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SensitivityLabelInner;
import com.azure.resourcemanager.sql.models.SensitivityLabelRank;

/** Samples for SensitivityLabels CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ColumnSensitivityLabelCreateMax.json
     */
    /**
     * Sample code: Updates the sensitivity label of a given column with all parameters.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesTheSensitivityLabelOfAGivenColumnWithAllParameters(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSensitivityLabels().createOrUpdateWithResponse("myRG",
            "myServer", "myDatabase", "dbo", "myTable", "myColumn",
            new SensitivityLabelInner().withLabelName("PII").withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff")
                .withInformationType("PhoneNumber").withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                .withRank(SensitivityLabelRank.LOW),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

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

Status code:

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
SensitivityLabel	Etichetta di riservatezza.
SensitivityLabelRank
WritableSensitivityLabelSource	Origine dell'etichetta di riservatezza.

SensitivityLabel

Etichetta di riservatezza.

Nome	Tipo	Descrizione
id	string	ID risorsa.
managedBy	string	Risorsa che gestisce l'etichetta di riservatezza.
name	string	Nome risorsa.
properties.columnName	string	Nome della colonna.
properties.informationType	string	Tipo di informazioni.
properties.informationTypeId	string	ID tipo di informazioni.
properties.isDisabled	boolean	È disabilitata la raccomandazione di riservatezza. 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 dell'etichetta.
properties.labelName	string	Nome dell'etichetta.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Nome dello schema.
properties.tableName	string	Il nome della tabella.
type	string	Tipo di risorsa.

SensitivityLabelRank

Nome	Tipo	Descrizione
Critical	string
High	string
Low	string
Medium	string
None	string

WritableSensitivityLabelSource

Origine dell'etichetta di riservatezza.

Nome	Tipo	Descrizione
current	string