Sensitivity Labels - Create Or Update

Service:

SQL Database

API-versie:

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 id van het informatietype.
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. Hervat het. 400 SensitivityLabelSourceNameNotSupported - De opgegeven vertrouwelijkheidslabelbron is ongeldig 400 InvalidSensitivityLabelResource : de opgegeven vertrouwelijkheidslabelresource is ongeldig 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - Ten minste één van LabelName en InformationType moet worden opgegeven 400 LabelNameTooLong - Labelnaam mag niet groter zijn dan {0} tekens 400 InformationTypeTooLong - Informatietype mag niet langer zijn dan {0} tekens 400 LabelIdMustBeGuid: de opgegeven label-id 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. Ten minste één van 'informationType' of 'informationTypeId' moet 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 is niet gevonden 404 SensitivityLabelsSchemaNotFound - Het schema {0} kan niet worden gevonden 404 SensitivityLabelsTableNotFound: de tabel {0} niet gevonden in het schema {1} 404 SensitivityLabelsColumnNotFound - De kolom {0} is niet gevonden in 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

Voorbeeldaanvraag

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.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),
            com.azure.core.util.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

Voorbeeldrespons

Statuscode:

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

Statuscode:

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

Object

Een vertrouwelijkheidslabel.

Name	Type	Description
id	string	Resource-id.
managedBy	string	Resource waarmee het vertrouwelijkheidslabel wordt beheerd.
name	string	Resourcenaam.
properties.columnName	string	De kolomnaam.
properties.informationType	string	Het informatietype.
properties.informationTypeId	string	De id van het informatietype.
properties.isDisabled	boolean	Is de aanbeveling voor gevoeligheid uitgeschakeld. Alleen van toepassing op aanbevolen vertrouwelijkheidslabels. Hiermee geeft u op of de vertrouwelijkheidsaanveling 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

Inventarisatie

Waarde	Description
Critical
High
Low
Medium
None

WritableSensitivityLabelSource

Inventarisatie

De bron van het vertrouwelijkheidslabel.

Waarde	Description
current