Subscription Rai Policy - Get

Hizmet:: AI Foundry

API Sürümü:: 2025-10-01-preview

Abonelikle ilişkili belirtilen İçerik Filtrelerini alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/raiPolicy/{raiPolicyName}?api-version=2025-10-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
raiPolicyName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$	Bilişsel Hizmetler Hesabı ile ilişkili RaiPolicy'nin adı
subscriptionId	path	True	string minLength: 1	Hedef aboneliğin kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	RaiPolicy	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

GetRaiPolicy

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CognitiveServices/raiPolicy/raiPolicyName?api-version=2025-10-01-preview

Örnek yanıt

Durum kodu:: 200

{
  "name": "raiPolicyName",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/raiPolicies/raiPolicyName",
  "properties": {
    "basePolicyName": "Microsoft.Default",
    "contentFilters": [
      {
        "name": "Hate",
        "blocking": false,
        "enabled": false,
        "severityThreshold": "High",
        "source": "Prompt"
      },
      {
        "name": "Hate",
        "blocking": true,
        "enabled": true,
        "severityThreshold": "Medium",
        "source": "Completion"
      },
      {
        "name": "Sexual",
        "blocking": true,
        "enabled": true,
        "severityThreshold": "High",
        "source": "Prompt"
      },
      {
        "name": "Sexual",
        "blocking": true,
        "enabled": true,
        "severityThreshold": "Medium",
        "source": "Completion"
      },
      {
        "name": "Selfharm",
        "blocking": true,
        "enabled": true,
        "severityThreshold": "High",
        "source": "Prompt"
      },
      {
        "name": "Selfharm",
        "blocking": true,
        "enabled": true,
        "severityThreshold": "Medium",
        "source": "Completion"
      },
      {
        "name": "Violence",
        "blocking": true,
        "enabled": true,
        "severityThreshold": "Medium",
        "source": "Prompt"
      },
      {
        "name": "Violence",
        "blocking": true,
        "enabled": true,
        "severityThreshold": "Medium",
        "source": "Completion"
      },
      {
        "name": "Jailbreak",
        "blocking": true,
        "enabled": true,
        "source": "Prompt"
      },
      {
        "name": "Protected Material Text",
        "blocking": true,
        "enabled": true,
        "source": "Completion"
      },
      {
        "name": "Protected Material Code",
        "blocking": true,
        "enabled": true,
        "source": "Completion"
      },
      {
        "name": "Profanity",
        "blocking": true,
        "enabled": true,
        "source": "Prompt"
      }
    ],
    "mode": "Asynchronous_filter"
  }
}

Tanımlar

Name	Description
ContentLevel	İçeriğin filtrelendiği düzey.
createdByType	Kaynağı oluşturan kimliğin türü.
CustomBlocklistConfig	Filtrenin uygulanacağı kaynağı alır veya ayarlar.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
RaiActionType	İçerik filtrelerine uygulanacak eylem türleri
RaiPolicy	Bilişsel Hizmetler RaiPolicy.
RaiPolicyContentFilter	Azure OpenAI Content Filter.
RaiPolicyContentSource	İçerik Filtrelerini uygulamak için içerik kaynağı.
RaiPolicyMode	Rai ilke modu. Sabit listesi değer eşlemesi aşağıdaki gibidir: Varsayılan = 0, Ertelenmiş=1, Engelleme=2, Asynchronous_filter =3. Lütfen 2025-06-01'den sonra 'Asynchronous_filter' kullanın. Önceki sürümdeki 'Ertelendi' ile aynıdır.
RaiPolicyProperties	Azure OpenAI Content Filters özellikleri.
RaiPolicyType	İçerik Filtreleri ilke türü.
SafetyProviderConfig	Hangi güvenlik sağlayıcısının başvuracağı kaynağı alır veya belirler.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

ContentLevel

Numaralandırma

İçeriğin filtrelendiği düzey.

Değer	Description
Low
Medium
High

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

CustomBlocklistConfig

Nesne

Filtrenin uygulanacağı kaynağı alır veya ayarlar.

Name	Tür	Description
blocking	boolean	Engelleme gerçekleşirse.
blocklistName	string	ContentFilter adı.
source	RaiPolicyContentSource	İçerik Filtrelerini uygulamak için içerik kaynağı.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

RaiActionType

Numaralandırma

İçerik filtrelerine uygulanacak eylem türleri

Değer	Description
None
BLOCKING
ANNOTATING
HITL
RETRY

RaiPolicy

Nesne

Bilişsel Hizmetler RaiPolicy.

Name	Tür	Description
etag	string	Kaynak Etag'i.
id	string	Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Kaynağın adı
properties	RaiPolicyProperties	Bilişsel Hizmetler RaiPolicy özellikleri.
systemData	systemData	Azure Resource Manager metadata içeren createdBy ve modifiedBy bilgileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin "Microsoft. Compute/virtualMachines" veya "Microsoft. Depo/Depolama Hesapları"

RaiPolicyContentFilter

Nesne

Azure OpenAI Content Filter.

Name	Tür	Description
action	RaiActionType	İçerik filtrelerine uygulanacak eylem türleri
blocking	boolean	Engelleme gerçekleşirse.
enabled	boolean	ContentFilter etkinse.
name	string	ContentFilter adı.
severityThreshold	ContentLevel	İçeriğin filtrelendiği düzey.
source	RaiPolicyContentSource	İçerik Filtrelerini uygulamak için içerik kaynağı.

RaiPolicyContentSource

Numaralandırma

İçerik Filtrelerini uygulamak için içerik kaynağı.

Değer	Description
Prompt
Completion
PreToolCall
PostToolCall
PreRun
PostRun

RaiPolicyMode

Numaralandırma

Rai ilke modu. Sabit listesi değer eşlemesi aşağıdaki gibidir: Varsayılan = 0, Ertelenmiş=1, Engelleme=2, Asynchronous_filter =3. Lütfen 2025-06-01'den sonra 'Asynchronous_filter' kullanın. Önceki sürümdeki 'Ertelendi' ile aynıdır.

Değer	Description
Default
Deferred
Blocking
Asynchronous_filter

RaiPolicyProperties

Nesne

Azure OpenAI Content Filters özellikleri.

Name	Tür	Description
basePolicyName	string	Rai ilkesinin adı.
contentFilters	RaiPolicyContentFilter[]	İçerik Filtreleri listesi.
customBlocklists	CustomBlocklistConfig[]	Özel Blok Listesi listesi.
mode	RaiPolicyMode	Rai ilke modu. Sabit listesi değer eşlemesi aşağıdaki gibidir: Varsayılan = 0, Ertelenmiş=1, Engelleme=2, Asynchronous_filter =3. Lütfen 2025-06-01'den sonra 'Asynchronous_filter' kullanın. Önceki sürümdeki 'Ertelendi' ile aynıdır.
safetyProviders	SafetyProviderConfig[]	Güvenlik Sağlayıcılarının listesi.
type	RaiPolicyType	İçerik Filtreleri ilke türü.

RaiPolicyType

Numaralandırma

İçerik Filtreleri ilke türü.

Değer	Description
UserManaged
SystemManaged

SafetyProviderConfig

Nesne

Hangi güvenlik sağlayıcısının başvuracağı kaynağı alır veya belirler.

Name	Tür	Description
blocking	boolean	Engelleme gerçekleşirse.
safetyProviderName	string	RAI Güvenlik Sağlayıcısının Adı.
source	RaiPolicyContentSource	İçerik Filtrelerini uygulamak için içerik kaynağı.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

Aracılığıyla paylaş

Subscription Rai Policy - Get

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

GetRaiPolicy

Örnek isteği

Örnek yanıt

Tanımlar

ContentLevel

createdByType

CustomBlocklistConfig

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

RaiActionType

RaiPolicy

RaiPolicyContentFilter

RaiPolicyContentSource

RaiPolicyMode

RaiPolicyProperties

RaiPolicyType

SafetyProviderConfig

systemData