Sensitivity Labels - Create Or Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Vytvoří nebo aktualizuje popisek citlivosti daného sloupce.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
columnName	path	True	string	Název sloupce.
databaseName	path	True	string	Název databáze.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
schemaName	path	True	string	Název schématu.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	Zdroj popisku citlivosti.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
tableName	path	True	string	Název tabulky.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
properties.informationType	string	Typ informací.
properties.informationTypeId	string	ID typu informací.
properties.labelId	string	ID popisku.
properties.labelName	string	Název popisku.
properties.rank	SensitivityLabelRank

Odpovědi

Name	Typ	Description
200 OK	SensitivityLabel	Popisek citlivosti byl úspěšně aktualizován.
201 Created	SensitivityLabel	Popisek citlivosti byl úspěšně vytvořen.
Other Status Codes		Chybové odpovědi: *** 400 DatawarehouseDatabaseIsDeactivated - Nelze spustit operaci klasifikace dat, protože databáze je pozastavena. Obnovte ho prosím. 400 SensitivityLabelSourceNameNotSupported – Zadaný zdroj popisku citlivosti není platný. 400 InvalidSensitivityLabelResource – zadaný prostředek popisku citlivosti není platný. 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Musí být zadán nejméně jeden z LabelName a InformationType. 400 LabelNameTooLong – Název popisku nesmí překročit {0} znaků 400 InformationTypeTooLong – Typ informací nesmí překročit {0} znaků 400 LabelIdMustBeGuid – zadaný labelId je neplatný. Hodnota musí být IDENTIFIKÁTOR GUID. 400 InformationTypeIdMustBeGuid – zadané 'informationTypeId' je neplatné. Hodnota musí být IDENTIFIKÁTOR GUID. 400 LabelMissing – Popisek je povinný. Musí být k dispozici alespoň jeden z labelName nebo labelId. 400 InformationTypeMissing – Typ informací je povinný. Je nutné zadat alespoň jeden z "informationType" nebo "informationTypeId". 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který v této instanci serveru neexistuje. 404 SensitivityLabelsLabelsLabelNotFound – zadaný popisek citlivosti nebyl nalezen. 404 SensitivityLabelsSchemaNotFound – schéma {0} nebylo nalezeno. 404 SensitivityLabelsTableNotFound – v {0} schématu nebyla nalezena tabulka {1} 404 SensitivityLabelsColumnNotFound - Sloupec {0} nebyl nalezen v tabulce {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported – Doporučený zdroj popisků citlivosti se zatím nepodporuje. 501 SensitivityLabelRecommendedSourceNameNotSupported – Doporučený zdroj popisků citlivosti se zatím nepodporuje.

Příklady

Updates the sensitivity label of a given column with all parameters

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

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

Definice

Name	Description
SensitivityLabel	Popisek citlivosti.
SensitivityLabelRank
WritableSensitivityLabelSource	Zdroj popisku citlivosti.

SensitivityLabel

Objekt

Popisek citlivosti.

Name	Typ	Description
id	string	ID prostředku.
managedBy	string	Prostředek, který spravuje popisek citlivosti.
name	string	Název prostředku
properties.columnName	string	Název sloupce.
properties.informationType	string	Typ informací.
properties.informationTypeId	string	ID typu informací.
properties.isDisabled	boolean	Je doporučení citlivosti zakázané. Platí jenom pro doporučený popisek citlivosti. Určuje, jestli je doporučení citlivosti pro tento sloupec zakázané (zamítnuto) nebo ne.
properties.labelId	string	ID popisku.
properties.labelName	string	Název popisku.
properties.rank	SensitivityLabelRank
properties.schemaName	string	Název schématu.
properties.tableName	string	Název tabulky.
type	string	Typ prostředku.

SensitivityLabelRank

Výčet

Hodnota	Description
Critical
High
Low
Medium
None

WritableSensitivityLabelSource

Výčet

Zdroj popisku citlivosti.

Hodnota	Description
current