Sensitivity Labels - Create Or Update

サービス:

SQL Database

API バージョン:

2021-11-01

特定の列の秘密度ラベルを作成または更新します

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 パラメーター

名前	/	必須	型	説明
columnName	path	True	string	列の名前。
databaseName	path	True	string	データベースの名前。
resourceGroupName	path	True	string	リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。
schemaName	path	True	string	スキーマの名前です。
sensitivityLabelSource	path	True	WritableSensitivityLabelSource	秘密度ラベルのソース。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
tableName	path	True	string	テーブルの名前。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	型	説明
properties.informationType	string	情報の種類。
properties.informationTypeId	string	情報の種類 ID。
properties.labelId	string	ラベル ID。
properties.labelName	string	ラベル名。
properties.rank	SensitivityLabelRank

応答

名前	型	説明
200 OK	SensitivityLabel	秘密度ラベルが正常に更新されました。
201 Created	SensitivityLabel	秘密度ラベルが正常に作成されました。
Other Status Codes		エラー応答: *** 400 DatawarehouseDatabaseIsDeactivated - データベースが一時停止しているため、データ分類操作を実行できませんでした。 再開してください。 400 SensitivityLabelSourceNameNotSupported - 指定された秘密度ラベル ソースが無効です 400 InvalidSensitivityLabelResource - 指定された秘密度ラベル リソースが無効です 400 SensitivityLabelLabelNameAndInfoTypeNotProvided - LabelName と InformationType の少なくとも 1 つを指定する必要があります 400 LabelNameTooLong - ラベル名は文字を超 {0} えることはできません 400 InformationTypeTooLong - 情報の種類が文字を超 {0} えることはできません 400 LabelIdMustBeGuid - 指定された 'labelId' が無効です。 値は GUID である必要があります 400 InformationTypeIdMustBeGuid - 指定された 'informationTypeId' が無効です。 値は GUID である必要があります 400 LabelMissing - Label が必要です。 少なくとも 1 つの 'labelName' または 'labelId' を指定する必要があります 400 InformationTypeMissing - 情報の種類が必要です。 少なくとも 1 つの 'informationType' または 'informationTypeId' を指定する必要があります 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 DatabaseDoesNotExist - ユーザーがこのサーバー インスタンスに存在しないデータベース名を指定しました。 404 SensitivityLabelsLabelNotFound - 指定された秘密度ラベルが見つかりませんでした 404 SensitivityLabelsSchemaNotFound - スキーマ {0} が見つかりませんでした 404 SensitivityLabelsTableNotFound - テーブル {0} がスキーマで見つかりませんでした {1} 404 SensitivityLabelsColumnNotFound - テーブル {2}に列{0}が見つかりませんでした。{1} 501 SensitivityLabelRecommendedSourceNameNotSupported - "推奨" 秘密度ラベル ソースはまだサポートされていません 501 SensitivityLabelRecommendedSourceNameNotSupported - "推奨" 秘密度ラベル ソースはまだサポートされていません

例

Updates the sensitivity label of a given column with all parameters

要求のサンプル

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

応答のサンプル

状態コード:

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

状態コード:

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

定義

名前	説明
SensitivityLabel	秘密度ラベル。
SensitivityLabelRank
WritableSensitivityLabelSource	秘密度ラベルのソース。

SensitivityLabel

秘密度ラベル。

名前	型	説明
id	string	リソースの ID
managedBy	string	秘密度ラベルを管理するリソース。
name	string	リソース名。
properties.columnName	string	列名。
properties.informationType	string	情報の種類。
properties.informationTypeId	string	情報の種類 ID。
properties.isDisabled	boolean	秘密度の推奨事項が無効になっています。 推奨される秘密度ラベルにのみ適用されます。 この列の秘密度の推奨事項を無効 (無視) するかどうかを指定します。
properties.labelId	string	ラベル ID。
properties.labelName	string	ラベル名。
properties.rank	SensitivityLabelRank
properties.schemaName	string	スキーマ名。
properties.tableName	string	テーブル名。
type	string	リソースの種類。

SensitivityLabelRank

名前	型	説明
Critical	string
High	string
Low	string
Medium	string
None	string

WritableSensitivityLabelSource

秘密度ラベルのソース。

名前	型	説明
current	string