Sensitivity Labels - Create Or Update

Szolgáltatás:

SQL Database

API-verzió:

2021-11-01

Egy adott oszlop bizalmassági címkéjének létrehozása vagy frissítése

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-paraméterek

Name	In	Kötelező	Típus	Description
columnName	path	True	string	Az oszlop neve.
databaseName	path	True	string	Az adatbázis neve.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
schemaName	path	True	string	A séma neve.
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	A bizalmassági címke forrása.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
tableName	path	True	string	A tábla neve.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name	Típus	Description
properties.informationType	string	Az információ típusa.
properties.informationTypeId	string	Az információtípus azonosítója.
properties.labelId	string	A címke azonosítója.
properties.labelName	string	A címke neve.
properties.rank	SensitivityLabelRank

Válaszok

Name	Típus	Description
200 OK	SensitivityLabel	A bizalmassági címke frissítése sikerült.
201 Created	SensitivityLabel	Sikerült létrehozni a bizalmassági címkét.
Other Status Codes		Hibaválaszok: *** 400 DatawarehouseDatabaseIsDeactivated – Nem sikerült végrehajtani az adatbesorolási műveletet, mert az adatbázis szüneteltetve van. Kérjük, folytassa. 400 SensitivityLabelSourceNameNotSupported – A megadott bizalmassági címkeforrás érvénytelen 400 InvalidSensitivityLabelResource – A megadott bizalmassági címke erőforrás érvénytelen 400 SensitivityLabelLabelNameAndInfoTypeNotProvided – Legalább egy LabelName és InformationType értéket meg kell adni 400 LabelNameTooLong – A címke neve nem haladhatja meg a {0} karaktereket 400 InformationTypeTooLong – Az adattípus nem haladhatja meg a {0} karaktereket 400 LabelIdMustBeGuid – A megadott "labelId" érvénytelen. Az értéknek GUID azonosítónak kell lennie 400 InformationTypeIdMustBeGuid – A megadott "informationTypeId" érvénytelen. Az értéknek GUID azonosítónak kell lennie 400 LabelMissing – A címke megadása kötelező. A "labelName" vagy a "labelId" közül legalább egyet meg kell adni 400 InformationTypeMissing – Az adattípus megadása kötelező. Az "informationType" vagy az "informationTypeId" közül legalább egyet meg kell adni 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon. 404 SensitivityLabelsLabelNotFound – A megadott bizalmassági címke nem található 404 SensitivityLabelsSchemaNotFound – A séma {0} nem található 404 SensitivityLabelsTableNotFound – A tábla {0} nem található a sémában {1} 404 SensitivityLabelsColumnNotFound – Az oszlop {0} nem található a táblában {2}.{1} 501 SensitivityLabelRecommendedSourceNameNotSupported – Az "Ajánlott" bizalmassági címkeforrás még nem támogatott 501 SensitivityLabelRecommendedSourceNameNotSupported – Az "Ajánlott" bizalmassági címkeforrás még nem támogatott

Példák

Updates the sensitivity label of a given column with all parameters

Mintakérelem

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

Mintaválasz

Állapotkó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"
  }
}

Állapotkó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"
  }
}

Definíciók

Name	Description
SensitivityLabel	Bizalmassági címke.
SensitivityLabelRank
WritableSensitivityLabelSource	A bizalmassági címke forrása.

SensitivityLabel

Bizalmassági címke.

Name	Típus	Description
id	string	Erőforrás-azonosító.
managedBy	string	A bizalmassági címkét kezelő erőforrás.
name	string	Erőforrás neve.
properties.columnName	string	Az oszlop neve.
properties.informationType	string	Az információ típusa.
properties.informationTypeId	string	Az információtípus azonosítója.
properties.isDisabled	boolean	A bizalmassági javaslat le van tiltva. Csak az ajánlott bizalmassági címke esetén alkalmazható. Megadja, hogy az oszlop bizalmassági javaslata le van-e tiltva (elvetve) vagy sem.
properties.labelId	string	A címke azonosítója.
properties.labelName	string	A címke neve.
properties.rank	SensitivityLabelRank
properties.schemaName	string	A séma neve.
properties.tableName	string	A tábla neve.
type	string	Erőforrástípus.

SensitivityLabelRank

Name	Típus	Description
Critical	string
High	string
Low	string
Medium	string
None	string

WritableSensitivityLabelSource

A bizalmassági címke forrása.

Name	Típus	Description
current	string