Conversation Authoring Project - Swap Deployments

Tjänst:

Azure AI Services

API-version:

2025-11-01

Växlar två befintliga distributioner med varandra.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
Endpoint	path	True	string (uri)	Cognitive Services-slutpunkt som stöds, t.ex. https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	Namnet på projektet som ska användas.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
firstDeploymentName	True	string	Representerar det första distributionsnamnet.
secondDeploymentName	True	string	Representerar det andra distributionsnamnet.

Svar

Name	Typ	Description
202 Accepted		Begäran har godkänts för behandling, men bearbetningen har ännu inte slutförts. Sidhuvuden Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Typ: apiKey
I: header

OAuth2Auth

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize
Token-webbadress: https://login.microsoftonline.com/common/oauth2/token

Omfattningar

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

Exempel

Successful Swap Deployments

Exempelbegäran

HTTP

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

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

Exempelsvar

Statuskod:

202

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

Definitioner

Name	Description
AnalyzeConversationAuthoringSwapDeploymentsOptions	Representerar alternativen för att växla två distributioner tillsammans.
Azure.Core.Foundations.Error	Felobjektet.
Azure.Core.Foundations.ErrorResponse	Ett svar som innehåller felinformation.
Azure.Core.Foundations.InnerError	Ett objekt som innehåller mer specifik information om felet. Enligt riktlinjerna för Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.

AnalyzeConversationAuthoringSwapDeploymentsOptions

Objekt

Representerar alternativen för att växla två distributioner tillsammans.

Name	Typ	Description
firstDeploymentName	string	Representerar det första distributionsnamnet.
secondDeploymentName	string	Representerar det andra distributionsnamnet.

Azure.Core.Foundations.Error

Objekt

Felobjektet.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	Azure.Core.Foundations.Error[]	En matris med information om specifika fel som ledde till det rapporterade felet.
innererror	Azure.Core.Foundations.InnerError	Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.
message	string	En mänsklig läsbar representation av felet.
target	string	Målet för felet.

Azure.Core.Foundations.ErrorResponse

Objekt

Ett svar som innehåller felinformation.

Name	Typ	Description
error	Azure.Core.Foundations.Error	Felobjektet.

Azure.Core.Foundations.InnerError

Objekt

Ett objekt som innehåller mer specifik information om felet. Enligt riktlinjerna för Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
innererror	Azure.Core.Foundations.InnerError	Inre fel.