Connection Rai Policy - Create

Szolgáltatás:: Machine Learning

API-verzió:: 2026-01-15-preview

Frissítse az Azure OpenAI-kapcsolathoz társított megadott tartalomszűrők állapotát.

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

Opcionális paraméterekkel:

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-paraméterek

Name	In	Kötelező	Típus	Description
connectionName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	A munkaterület-kapcsolat rövid neve
raiPolicyName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$	A Rai szabályzat neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Azure Machine Learning munkaterület neve
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
proxy-api-version	query		string	A proxyhívás által használt API-verzió

Kérelem törzse

Name	Kötelező	Típus	Description
properties	True	RaiPolicyProperties	Azure OpenAI Content Filters tulajdonságok.

Válaszok

Name	Típus	Description
200 OK	RaiPolicyPropertiesBasicResource	A 'RaiPolicyPropertiesBasicResource' erőforrás frissítési művelete sikeres
201 Created	RaiPolicyPropertiesBasicResource	Resource 'RaiPolicyPropertiesBasicResource' létrehozása sikeres Fejlécek Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Name

Típus

Description

200 OK

RaiPolicyPropertiesBasicResource

A 'RaiPolicyPropertiesBasicResource' erőforrás frissítési művelete sikeres

201 Created

RaiPolicyPropertiesBasicResource

Resource 'RaiPolicyPropertiesBasicResource' létrehozása sikeres

Fejlécek

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Create Rai policy

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
  }
}

Állapotkód:: 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"
  }
}

Definíciók

Name	Description
AllowedContentLevel	A tartalom szűrésének szintje.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
RaiBlocklistConfig	Azure OpenAI blokklista konfigurációja.
RaiPolicyContentFilter	Azure OpenAI Content Filter.
RaiPolicyContentSource	Tartalomforrás a tartalomszűrők alkalmazásához.
RaiPolicyMode	Tartalomszűrő mód.
RaiPolicyProperties	Azure OpenAI Content Filters tulajdonságok.
RaiPolicyPropertiesBasicResource	Azure OpenAI tartalomszűrők erőforrás.
RaiPolicyType	Tartalomszűrők házirendtípusa.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

AllowedContentLevel

Felsorolás

A tartalom szűrésének szintje.

Érték	Description
Low
Medium
High

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

RaiBlocklistConfig

Tárgy

Azure OpenAI blokklista konfigurációja.

Name	Típus	Description
blocking	boolean	Ha blokkolás történne.
blocklistName	string	A ContentFilter neve.

RaiPolicyContentFilter

Tárgy

Azure OpenAI Content Filter.

Name	Típus	Description
allowedContentLevel	AllowedContentLevel	A tartalom szűrésének szintje.
blocking	boolean	Ha blokkolás történne.
enabled	boolean	Ha a ContentFilter engedélyezve van.
name	string	A ContentFilter neve.
source	RaiPolicyContentSource	Tartalomforrás a tartalomszűrők alkalmazásához.

RaiPolicyContentSource

Felsorolás

Tartalomforrás a tartalomszűrők alkalmazásához.

Érték	Description
Prompt
Completion

RaiPolicyMode

Felsorolás

Tartalomszűrő mód.

Érték	Description
Default
Deferred
Blocking

RaiPolicyProperties

Tárgy

Azure OpenAI Content Filters tulajdonságok.

Name	Típus	Description
basePolicyName	string	Az alapszintű tartalomszűrők neve.
completionBlocklists	RaiBlocklistConfig[]	Azure OpenAI blokklista konfigurációja.
contentFilters	RaiPolicyContentFilter[]	Azure OpenAI Content Filter.
mode	RaiPolicyMode	Tartalomszűrő mód.
promptBlocklists	RaiBlocklistConfig[]	Azure OpenAI blokklista konfigurációja.
type	RaiPolicyType	Tartalomszűrők házirendtípusa.

RaiPolicyPropertiesBasicResource

Tárgy

Azure OpenAI tartalomszűrők erőforrás.

Name	Típus	Description
id	string	Az erőforrás teljes erőforrás-azonosítója. Example - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Az erőforrás neve
properties	RaiPolicyProperties	Azure OpenAI Content Filters tulajdonságok.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

RaiPolicyType

Felsorolás

Tartalomszűrők házirendtípusa.

Érték	Description
UserManaged
SystemManaged

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

Megosztás a következőn keresztül:

Connection Rai Policy - Create

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Create Rai policy

Mintakérelem

Mintaválasz

Definíciók

AllowedContentLevel

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

RaiBlocklistConfig

RaiPolicyContentFilter

RaiPolicyContentSource

RaiPolicyMode

RaiPolicyProperties

RaiPolicyPropertiesBasicResource

RaiPolicyType

systemData