Conversation Authoring Project - Swap Deployments

Hizmet:

Azure AI Services

API Sürümü:

2025-11-01

Mevcut iki dağıtımı birbiriyle değiştirir.

POST {Endpoint}/language/authoring/analyze-conversations/projects/{projectName}/deployments/:swap?api-version=2025-11-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
Endpoint	path	True	string (uri)	Desteklenen Bilişsel Hizmetler uç noktası, örneğin, https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Kullanılacak projenin adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
firstDeploymentName	True	string	İlk dağıtım adını temsil eder.
secondDeploymentName	True	string	İkinci dağıtım adını temsil eder.

Yanıtlar

Name	Tür	Description
202 Accepted		İstek işlenmek üzere kabul edildi, ancak işlem henüz tamamlanmadı. Üst Bilgiler Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize
Belirteç URL'si: https://login.microsoftonline.com/common/oauth2/token

Kapsamlar

Name	Description
https://cognitiveservices.azure.com/.default

Örnekler

Successful Swap Deployments

Örnek isteği

HTTP

POST {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/:swap?api-version=2025-11-01

{
  "firstDeploymentName": "production",
  "secondDeploymentName": "staging"
}

Örnek yanıt

Durum kodu:

202

operation-location: {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/swap/jobs/c36a8775-35b9-4cb5-a8db-665e7d91aafe_637858368000000000?api-version=2025-11-01

Tanımlar

Name	Description
AnalyzeConversationAuthoringSwapDeploymentsOptions	İki dağıtımı birlikte değiştirme seçeneklerini temsil eder.
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

AnalyzeConversationAuthoringSwapDeploymentsOptions

Object

İki dağıtımı birlikte değiştirme seçeneklerini temsil eder.

Name	Tür	Description
firstDeploymentName	string	İlk dağıtım adını temsil eder.
secondDeploymentName	string	İkinci dağıtım adını temsil eder.

Azure.Core.Foundations.Error

Object

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Object

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Object

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.