Sensitivity Labels - Create Or Update

Referencia

Service:: SQL Database

API Version:: 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

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

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


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

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

Sensitivity Labels - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Példák

Updates the sensitivity label of a given column with all parameters

Sample Request

Sample Response

Definíciók

SensitivityLabel

SensitivityLabelRank

WritableSensitivityLabelSource

További források