Managed Database Sensitivity Labels - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Skapar eller uppdaterar känslighetsetiketten för en viss kolumn

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}/sensitivityLabels/current?api-version=2021-11-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
columnName	path	True	string	Namnet på kolumnen.
databaseName	path	True	string	Namnet på databasen.
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
schemaName	path	True	string	Namnet på schemat.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	Källan till känslighetsetiketten.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
tableName	path	True	string	Namnet på tabellen.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
properties.informationType	string	Informationstypen.
properties.informationTypeId	string	Informationstypens ID.
properties.labelId	string	Etikett-ID:t.
properties.labelName	string	Etikettnamnet.
properties.rank	SensitivityLabelRank

Svar

Name	Typ	Description
200 OK	SensitivityLabel	Känslighetsetiketten har uppdaterats.
201 Created	SensitivityLabel	Känslighetsetiketten har skapats.
Other Status Codes		Felsvar: *** 400 DatawarehouseDatabaseIsDeactivated – Det gick inte att köra dataklassificeringsåtgärden eftersom databasen har pausats. Återuppta den. 400 SensitivityLabelSourceNameNotSupported – den angivna källan för känslighetsetiketter är inte giltig 400 InvalidSensitivityLabelResource – den angivna resursen för känslighetsetiketter är inte giltig 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Minst ett av LabelName och InformationType måste anges 400 LabelNameTooLong – Etikettnamn får inte överskrida {0} tecken 400 InformationTypeTooLong – Informationstypen får inte överskrida {0} tecken 400 LabelIdMustBeGuid – det angivna "labelId" är ogiltigt. Värdet måste vara ett GUID 400 InformationTypeIdMustBeGuid – det angivna "informationTypeId" är ogiltigt. Värdet måste vara ett GUID 400 LabelMissing – Etikett krävs. Minst ett av "labelName" eller "labelId" måste anges 400 InformationTypeMissing – Informationstyp krävs. Minst en av "informationType" eller "informationTypeId" måste anges 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen. 404 SensitivityLabelsLabelNotFound – Det gick inte att hitta den angivna känslighetsetiketten 404 SensitivityLabelsSchemaNotFound – det gick inte att hitta schemat {0} 404 SensitivityLabelsTableNotFound – Det gick inte att hitta tabellen {0} i schemat {1} 404 SensitivityLabelsColumnNotFound – Det gick inte att hitta kolumnen {0} i tabellen {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported – "Rekommenderad" källa för känslighetsetiketter stöds inte ännu 501 SensitivityLabelRecommendedSourceNameNotSupported – "Rekommenderad" källa för känslighetsetiketter stöds inte ännu

Exempel

Updates or creates a sensitivity label of a given column with all parameters in a managed database

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/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": "High"
  }
}

Java

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

/** Samples for ManagedDatabaseSensitivityLabels CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseColumnSensitivityLabelCreate.json
     */
    /**
     * Sample code: Updates or creates a sensitivity label of a given column with all parameters in a managed database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updatesOrCreatesASensitivityLabelOfAGivenColumnWithAllParametersInAManagedDatabase(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseSensitivityLabels().createOrUpdateWithResponse(
            "myRG", "myManagedInstanceName", "myDatabase", "dbo", "myTable", "myColumn",
            new SensitivityLabelInner().withLabelName("PII").withLabelId("bf91e08c-f4f0-478a-b016-25164b2a65ff")
                .withInformationType("PhoneNumber").withInformationTypeId("d22fa6e9-5ee4-3bde-4c2b-a409604c4646")
                .withRank(SensitivityLabelRank.HIGH),
            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/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/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": "High"
  }
}

Status code:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/schemas/dbo/tables/myTable/columns/myColumn/sensitivityLabels/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/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": "High"
  }
}

Definitioner

Name	Description
SensitivityLabel	En känslighetsetikett.
SensitivityLabelRank
WritableSensitivityLabelSource	Källan till känslighetsetiketten.

SensitivityLabel

En känslighetsetikett.

Name	Typ	Description
id	string	Resurs-ID.
managedBy	string	Resurs som hanterar känslighetsetiketten.
name	string	Resursnamn.
properties.columnName	string	Kolumnnamnet.
properties.informationType	string	Informationstypen.
properties.informationTypeId	string	Informationstypens ID.
properties.isDisabled	boolean	Är känslighetsrekommendations inaktiverad. Gäller endast för rekommenderad känslighetsetikett. Anger om känslighetsrekommendationsen för den här kolumnen är inaktiverad (avvisad) eller inte.
properties.labelId	string	Etikett-ID:t.
properties.labelName	string	Etikettnamnet.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Schemanamnet.
properties.tableName	string	Tabellnamnet.
type	string	Resurstyp.

SensitivityLabelRank

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

WritableSensitivityLabelSource

Källan till känslighetsetiketten.

Name	Typ	Description
current	string