Connection Rai Policy - Create

サービス:: Machine Learning

API バージョン:: 2026-01-15-preview

Azure OpenAI 接続に関連付けられている指定されたコンテンツフィルターの状態を更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}/raiPolicies/{raiPolicyName}?api-version=2026-01-15-preview

省略可能なパラメーターを含む:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}/raiPolicies/{raiPolicyName}?api-version=2026-01-15-preview&proxy-api-version={proxy-api-version}

URI パラメーター

名前	/	必須	型	説明
connectionName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	ワークスペース接続のフレンドリ名
raiPolicyName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$	Rai ポリシーの名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string minLength: 1	ターゲットサブスクリプションの ID。
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Azure Machine Learning ワークスペース名
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。
proxy-api-version	query		string	プロキシ呼び出しで使用される API バージョン

要求本文

名前	必須	型	説明
properties	True	RaiPolicyProperties	Azure OpenAI Content Filters properties.

応答

名前	型	説明
200 OK	RaiPolicyPropertiesBasicResource	リソース「RaiPolicyPropertiesBasicResource」更新操作が成功しました
201 Created	RaiPolicyPropertiesBasicResource	リソース 'RaiPolicyPropertiesBasicResource' create 操作が成功しましたヘッダー Location: string Retry-After: integer
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

RaiPolicyPropertiesBasicResource

リソース「RaiPolicyPropertiesBasicResource」更新操作が成功しました

201 Created

RaiPolicyPropertiesBasicResource

リソース 'RaiPolicyPropertiesBasicResource' create 操作が成功しました

ヘッダー

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Create Rai policy

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/connections/testConnection/raiPolicies/raiPolicyName?api-version=2026-01-15-preview

{
  "properties": {
    "type": "SystemManaged",
    "basePolicyName": "112",
    "completionBlocklists": [
      {
        "blocking": false,
        "blocklistName": "blocklistName"
      }
    ],
    "contentFilters": [
      {
        "name": "policyName",
        "allowedContentLevel": "Low",
        "blocking": false,
        "enabled": false,
        "source": "Prompt"
      }
    ],
    "mode": "Blocking",
    "promptBlocklists": [
      {
        "blocking": false,
        "blocklistName": "blocklistName"
      }
    ]
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "raiPolicyName",
  "type": "Microsoft.MachineLearningServices/workspaces/connections/raiPolicies",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/connections/testConnection/raiPolicies/raiPolicyName",
  "properties": {
    "type": "SystemManaged",
    "basePolicyName": "112",
    "completionBlocklists": [
      {
        "blocking": false,
        "blocklistName": "blocklistName"
      }
    ],
    "contentFilters": [
      {
        "name": "policyName",
        "allowedContentLevel": "Low",
        "blocking": false,
        "enabled": false,
        "source": "Prompt"
      }
    ],
    "mode": "Blocking",
    "promptBlocklists": [
      {
        "blocking": false,
        "blocklistName": "blocklistName"
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T00:00:00Z",
    "createdBy": "00000000-1111-2222-3333-444444444444",
    "createdByType": "Application",
    "lastModifiedAt": "2020-01-01T00:00:00Z",
    "lastModifiedBy": "00000000-1111-2222-3333-444444444444",
    "lastModifiedByType": "Application"
  }
}

状態コード:: 201

{
  "name": "raiPolicyName",
  "type": "Microsoft.MachineLearningServices/workspaces/connections/raiPolicies",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/connections/testConnection/raiPolicies/raiPolicyName",
  "properties": {
    "type": "SystemManaged",
    "basePolicyName": "112",
    "completionBlocklists": [
      {
        "blocking": false,
        "blocklistName": "blocklistName"
      }
    ],
    "contentFilters": [
      {
        "name": "policyName",
        "allowedContentLevel": "Low",
        "blocking": false,
        "enabled": false,
        "source": "Prompt"
      }
    ],
    "mode": "Blocking",
    "promptBlocklists": [
      {
        "blocking": false,
        "blocklistName": "blocklistName"
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T00:00:00Z",
    "createdBy": "00000000-1111-2222-3333-444444444444",
    "createdByType": "Application",
    "lastModifiedAt": "2020-01-01T00:00:00Z",
    "lastModifiedBy": "00000000-1111-2222-3333-444444444444",
    "lastModifiedByType": "Application"
  }
}

定義

名前	説明
AllowedContentLevel	コンテンツがフィルター処理されるレベル。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
RaiBlocklistConfig	Azure OpenAI ブロックリスト構成。
RaiPolicyContentFilter	Azure OpenAI Content Filter.
RaiPolicyContentSource	コンテンツフィルターを適用するコンテンツソース。
RaiPolicyMode	コンテンツフィルターモード。
RaiPolicyProperties	Azure OpenAI Content Filters properties.
RaiPolicyPropertiesBasicResource	Azure OpenAI コンテンツフィルターリソース。
RaiPolicyType	コンテンツフィルターポリシーの種類。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AllowedContentLevel

列挙

コンテンツがフィルター処理されるレベル。

値	説明
Low
Medium
High

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

エラーの詳細。

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

ErrorResponse

Object

エラー応答

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

RaiBlocklistConfig

Object

Azure OpenAI ブロックリスト構成。

名前	型	説明
blocking	boolean	ブロックが発生した場合。
blocklistName	string	ContentFilter の名前。

RaiPolicyContentFilter

Object

Azure OpenAI Content Filter.

名前	型	説明
allowedContentLevel	AllowedContentLevel	コンテンツがフィルター処理されるレベル。
blocking	boolean	ブロックが発生した場合。
enabled	boolean	ContentFilter が有効になっている場合。
name	string	ContentFilter の名前。
source	RaiPolicyContentSource	コンテンツフィルターを適用するコンテンツソース。

RaiPolicyContentSource

列挙

コンテンツフィルターを適用するコンテンツソース。

値	説明
Prompt
Completion

RaiPolicyMode

列挙

コンテンツフィルターモード。

値	説明
Default
Deferred
Blocking

RaiPolicyProperties

Object

Azure OpenAI Content Filters properties.

名前	型	説明
basePolicyName	string	基本コンテンツフィルターの名前。
completionBlocklists	RaiBlocklistConfig[]	Azure OpenAI ブロックリスト構成。
contentFilters	RaiPolicyContentFilter[]	Azure OpenAI Content Filter.
mode	RaiPolicyMode	コンテンツフィルターモード。
promptBlocklists	RaiBlocklistConfig[]	Azure OpenAI ブロックリスト構成。
type	RaiPolicyType	コンテンツフィルターポリシーの種類。

RaiPolicyPropertiesBasicResource

Object

Azure OpenAI コンテンツフィルターリソース。

名前	型	説明
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties	RaiPolicyProperties	Azure OpenAI Content Filters properties.
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

RaiPolicyType

列挙

コンテンツフィルターポリシーの種類。

値	説明
UserManaged
SystemManaged

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

Connection Rai Policy - Create

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

Create Rai policy

要求のサンプル

応答のサンプル

定義

AllowedContentLevel

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

RaiBlocklistConfig

RaiPolicyContentFilter

RaiPolicyContentSource

RaiPolicyMode

RaiPolicyProperties

RaiPolicyPropertiesBasicResource

RaiPolicyType

systemData