Connection Rai Policy - Create

Service:: Machine Learning

Version d'API:: 2026-01-15-preview

Mettez à jour l’état des filtres de contenu spécifiés associés à la connexion 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

Avec des paramètres facultatifs:

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}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
connectionName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nom convivial de la connexion à l’espace de travail
raiPolicyName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$	Nom de la politique de la Rai.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nom de l’espace de travail Azure Machine Learning
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
proxy-api-version	query		string	Version de l’API utilisée par l’appel proxy

Corps de la demande

Nom	Obligatoire	Type	Description
properties	True	RaiPolicyProperties	Azure OpenAI Filtres de contenu.

Réponses

Nom	Type	Description
200 OK	RaiPolicyPropertiesBasicResource	Opération de mise à jour de la ressource 'RaiPolicyPropertiesBasicResource' réussie
201 Created	RaiPolicyPropertiesBasicResource	Ressource 'RaiPolicyPropertiesBasicResource' créer l’opération a réussi En-têtes Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

RaiPolicyPropertiesBasicResource

Opération de mise à jour de la ressource 'RaiPolicyPropertiesBasicResource' réussie

201 Created

RaiPolicyPropertiesBasicResource

Ressource 'RaiPolicyPropertiesBasicResource' créer l’opération a réussi

En-têtes

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Create Rai policy

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: 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"
  }
}

Définitions

Nom	Description
AllowedContentLevel	Niveau auquel le contenu est filtré.
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
RaiBlocklistConfig	Configuration de la liste de blocage Azure OpenAI.
RaiPolicyContentFilter	Filtre de contenu Azure OpenAI.
RaiPolicyContentSource	Source de contenu pour appliquer les filtres de contenu.
RaiPolicyMode	Mode Filtres de contenu.
RaiPolicyProperties	Azure OpenAI Filtres de contenu.
RaiPolicyPropertiesBasicResource	Ressource Filtres de contenu Azure OpenAI.
RaiPolicyType	Type de stratégie Filtres de contenu.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

AllowedContentLevel

Énumération

Niveau auquel le contenu est filtré.

Valeur	Description
Low
Medium
High

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

RaiBlocklistConfig

Objet

Configuration de la liste de blocage Azure OpenAI.

Nom	Type	Description
blocking	boolean	Si le blocage se produit.
blocklistName	string	Nom de ContentFilter.

RaiPolicyContentFilter

Objet

Filtre de contenu Azure OpenAI.

Nom	Type	Description
allowedContentLevel	AllowedContentLevel	Niveau auquel le contenu est filtré.
blocking	boolean	Si le blocage se produit.
enabled	boolean	Si ContentFilter est activé.
name	string	Nom de ContentFilter.
source	RaiPolicyContentSource	Source de contenu pour appliquer les filtres de contenu.

RaiPolicyContentSource

Énumération

Source de contenu pour appliquer les filtres de contenu.

Valeur	Description
Prompt
Completion

RaiPolicyMode

Énumération

Mode Filtres de contenu.

Valeur	Description
Default
Deferred
Blocking

RaiPolicyProperties

Objet

Azure OpenAI Filtres de contenu.

Nom	Type	Description
basePolicyName	string	Nom des filtres de contenu de base.
completionBlocklists	RaiBlocklistConfig[]	Configuration de la liste de blocage Azure OpenAI.
contentFilters	RaiPolicyContentFilter[]	Filtre de contenu Azure OpenAI.
mode	RaiPolicyMode	Mode Filtres de contenu.
promptBlocklists	RaiBlocklistConfig[]	Configuration de la liste de blocage Azure OpenAI.
type	RaiPolicyType	Type de stratégie Filtres de contenu.

RaiPolicyPropertiesBasicResource

Objet

Ressource Filtres de contenu Azure OpenAI.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nom de la ressource
properties	RaiPolicyProperties	Azure OpenAI Filtres de contenu.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

RaiPolicyType

Énumération

Type de stratégie Filtres de contenu.

Valeur	Description
UserManaged
SystemManaged

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

Partager via

Connection Rai Policy - Create

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Create Rai policy

Exemple de requête

Exemple de réponse

Définitions

AllowedContentLevel

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

RaiBlocklistConfig

RaiPolicyContentFilter

RaiPolicyContentSource

RaiPolicyMode

RaiPolicyProperties

RaiPolicyPropertiesBasicResource

RaiPolicyType

systemData