Sensitivity Labels - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Het vertrouwelijkheidslabel van een bepaalde kolom maken of bijwerken

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

URI-parameters

Name	In	Vereist	Type	Description
columnName	path	True	string	De naam van de kolom.
databaseName	path	True	string	De naam van de database.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
schemaName	path	True	string	De naam van het schema.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	De bron van het vertrouwelijkheidslabel.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
tableName	path	True	string	De naam van de tabel.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Type	Description
properties.informationType	string	Het informatietype.
properties.informationTypeId	string	De informatietype-id.
properties.labelId	string	De label-id.
properties.labelName	string	De labelnaam.
properties.rank	SensitivityLabelRank

Antwoorden

Name	Type	Description
200 OK	SensitivityLabel	Het vertrouwelijkheidslabel is bijgewerkt.
201 Created	SensitivityLabel	Het vertrouwelijkheidslabel is gemaakt.
Other Status Codes		Foutreacties: *** 400 DatawarehouseDatabaseIsDeactivated - Kan de gegevensclassificatiebewerking niet uitvoeren omdat de database is onderbroken. Ga verder. 400 SensitivityLabelSourceNameNotSupported - De opgegeven bron van het vertrouwelijkheidslabel is ongeldig 400 InvalidSensitivityLabelResource - De opgegeven resource voor het gevoeligheidslabel is ongeldig 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Er moet ten minste één labelnaam en informationtype worden opgegeven 400 LabelNameTooLong - Labelnaam mag niet langer zijn dan {0} tekens 400 InformationTypeTooLong - Informatietype mag niet meer dan tekens bevatten {0} 400 LabelIdMustBeGuid - De opgegeven labelId is ongeldig. Waarde moet een GUID zijn 400 InformationTypeIdMustBeGuid - De opgegeven 'informationTypeId' is ongeldig. Waarde moet een GUID zijn 400 LabelMissing - Label is vereist. Er moet ten minste één van 'labelName' of 'labelId' worden opgegeven 400 InformationTypeMissing - Informatietype is vereist. Er moet ten minste één 'informationType' of 'informationTypeId' worden opgegeven 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren. 404 SensitivityLabelsLabelNotFound - Het opgegeven vertrouwelijkheidslabel kan niet worden gevonden 404 SensitivityLabelsSchemaNotFound - Het schema {0} kan niet worden gevonden 404 SensitivityLabelsTableNotFound - De tabel {0} kan niet worden gevonden in het schema {1} 404 SensitivityLabelsColumnNotFound - De kolom {0} kan niet worden gevonden in de tabel {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Aanbevolen' vertrouwelijkheidslabelbron wordt nog niet ondersteund 501 SensitivityLabelRecommendedSourceNameNotSupported - 'Aanbevolen' vertrouwelijkheidslabelbron wordt nog niet ondersteund

Voorbeelden

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

Definities

Name	Description
SensitivityLabel	Een vertrouwelijkheidslabel.
SensitivityLabelRank
WritableSensitivityLabelSource	De bron van het vertrouwelijkheidslabel.

SensitivityLabel

Een vertrouwelijkheidslabel.

Name	Type	Description
id	string	Resource-id.
managedBy	string	Resource die het vertrouwelijkheidslabel beheert.
name	string	Resourcenaam.
properties.columnName	string	De kolomnaam.
properties.informationType	string	Het informatietype.
properties.informationTypeId	string	De informatietype-id.
properties.isDisabled	boolean	Is gevoeligheidsaanvveling uitgeschakeld. Alleen van toepassing op aanbevolen vertrouwelijkheidslabel. Hiermee geeft u op of de aanbeveling voor vertrouwelijkheid voor deze kolom is uitgeschakeld (gesloten) of niet.
properties.labelId	string	De label-id.
properties.labelName	string	De labelnaam.
properties.rank	SensitivityLabelRank
properties.schemaName	string	De schemanaam.
properties.tableName	string	De tabelnaam.
type	string	Resourcetype.

SensitivityLabelRank

Name	Type	Description
Critical	string
High	string
Low	string
Medium	string
None	string

WritableSensitivityLabelSource

De bron van het vertrouwelijkheidslabel.

Name	Type	Description
current	string