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

要求のサンプル

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

応答のサンプル

状態コード:
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