Data Masking Policies - Create Or Update

リファレンス

サービス:: SQL Database

API バージョン:: 2023-08-01

データベースデータマスクポリシーを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/dataMaskingPolicies/Default?api-version=2023-08-01

URI パラメーター

名前	/	必須	型	説明
databaseName	path	True	string	データベースの名前。
dataMaskingPolicyName	path	True	DataMaskingPolicyName	データマスクポリシーが適用されるデータベースの名前。
resourceGroupName	path	True	string	リソースを含むリソースグループの名前。この値は、Azure Resource Manager API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求に使用する API バージョン。

要求本文

名前	必須	型	説明
properties.dataMaskingState	True	DataMaskingState	データマスクポリシーの状態。
properties.exemptPrincipals		string	除外プリンシパルの一覧。データマスクポリシーが適用されないデータベースユーザーのセミコロン区切りの一覧を指定します。指定されたユーザーは、すべてのデータベースクエリをマスクせずにデータの結果を受け取ります。

応答

名前	型	説明
200 OK	DataMaskingPolicy	データベースデータマスクポリシーが正常に作成されました。
201 Created	DataMaskingPolicy	データベースデータマスクポリシーが正常に作成されました。.
Other Status Codes	ErrorResponse	エラー応答: *** 400 InvalidDatabaseNameForDataMaskingOperation - マスターデータベースにデータマスクポリシーとルールを直接適用することはできません。データマスクポリシー/ルールは、ユーザーデータベースにのみ適用されます。

名前

型

説明

200 OK

DataMaskingPolicy

データベースデータマスクポリシーが正常に作成されました。

201 Created

DataMaskingPolicy

データベースデータマスクポリシーが正常に作成されました。.

Other Status Codes

ErrorResponse

エラー応答: ***

400 InvalidDatabaseNameForDataMaskingOperation - マスターデータベースにデータマスクポリシーとルールを直接適用することはできません。データマスクポリシー/ルールは、ユーザーデータベースにのみ適用されます。

例

Create or update data masking policy max

Create or update data masking policy min.

Create or update data masking policy max

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2023-08-01

{
  "properties": {
    "dataMaskingState": "Enabled",
    "exemptPrincipals": "testuser;"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}

状態コード:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "testuser;",
    "maskingLevel": ""
  }
}

Create or update data masking policy min.

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default?api-version=2023-08-01

{
  "properties": {
    "dataMaskingState": "Enabled"
  }
}

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}

状態コード:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6852/providers/Microsoft.Sql/servers/sqlcrudtest-2080/databases/sqlcrudtest-331/dataMaskingPolicies/Default",
  "name": "Default",
  "type": "Microsoft.Sql/servers/databases/dataMaskingPolicies",
  "location": "Central US",
  "kind": null,
  "properties": {
    "dataMaskingState": "Enabled",
    "applicationPrincipals": "",
    "exemptPrincipals": "",
    "maskingLevel": ""
  }
}

定義

名前	説明
DataMaskingPolicy	データベースデータマスクポリシー。
DataMaskingPolicyName	データマスクポリシーが適用されるデータベースの名前。
DataMaskingState	データマスクポリシーの状態。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答

DataMaskingPolicy

Object

データベースデータマスクポリシー。

名前	型	説明
id	string	リソース ID。
kind	string	データマスクポリシーの種類。メタデータ。Azure portal に使用されます。
location	string	データマスクポリシーの場所。
name	string	リソース名。
properties.applicationPrincipals	string	アプリケーションプリンシパルの一覧。これは従来のパラメーターであり、使用されなくなりました。
properties.dataMaskingState	DataMaskingState	データマスクポリシーの状態。
properties.exemptPrincipals	string	除外プリンシパルの一覧。データマスクポリシーが適用されないデータベースユーザーのセミコロン区切りの一覧を指定します。指定されたユーザーは、すべてのデータベースクエリをマスクせずにデータの結果を受け取ります。
properties.maskingLevel	string	マスクレベル。これは従来のパラメーターであり、使用されなくなりました。
type	string	リソースの種類。

DataMaskingPolicyName

列挙

データマスクポリシーが適用されるデータベースの名前。

値	説明
Default

DataMaskingState

列挙

データマスクポリシーの状態。

値	説明
Disabled
Enabled

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

次の方法で共有

Data Masking Policies - Create Or Update

URI パラメーター

要求本文

応答

例

Create or update data masking policy max

要求のサンプル

応答のサンプル

Create or update data masking policy min.

要求のサンプル

応答のサンプル

定義

DataMaskingPolicy

DataMaskingPolicyName

DataMaskingState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

その他のリソース