Conversation Authoring Project - Swap Deployments

Service:

Azure AI Services

API-versie:

2025-11-01

Hiermee wisselt u twee bestaande implementaties met elkaar.

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

URI-parameters

Name	In	Vereist	Type	Description
Endpoint	path	True	string (uri)	Ondersteund Cognitive Services-eindpunt, bijvoorbeeld https://< resource-name.api.cognitiveservices.azure.com>.
projectName	path	True	string maxLength: 100	De naam van het te gebruiken project.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
firstDeploymentName	True	string	Vertegenwoordigt de naam van de eerste implementatie.
secondDeploymentName	True	string	Vertegenwoordigt de tweede implementatienaam.

Antwoorden

Name	Type	Description
202 Accepted		De aanvraag is geaccepteerd voor verwerking, maar de verwerking is nog niet voltooid. Kopteksten Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

OAuth2Auth

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/token

Bereiken

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

Voorbeelden

Successful Swap Deployments

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

202

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

Definities

Name	Description
AnalyzeConversationAuthoringSwapDeploymentsOptions	Vertegenwoordigt de opties voor het verwisselen van twee implementaties.
Azure.Core.Foundations.Error	Het foutobject.
Azure.Core.Foundations.ErrorResponse	Een antwoord met foutdetails.
Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie over de fout. Volgens de Azure REST API-richtlijnen - . https://aka.ms/AzureRestApiGuidelines#handling-errors

AnalyzeConversationAuthoringSwapDeploymentsOptions

Object

Vertegenwoordigt de opties voor het verwisselen van twee implementaties.

Name	Type	Description
firstDeploymentName	string	Vertegenwoordigt de naam van de eerste implementatie.
secondDeploymentName	string	Vertegenwoordigt de tweede implementatienaam.

Azure.Core.Foundations.Error

Object

Het foutobject.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	Azure.Core.Foundations.Error[]	Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout.
innererror	Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie dan het huidige object over de fout.
message	string	Een leesbare weergave van de fout.
target	string	Het doel van de fout.

Azure.Core.Foundations.ErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	Azure.Core.Foundations.Error	Het foutobject.

Azure.Core.Foundations.InnerError

Object

Een object met meer specifieke informatie over de fout. Volgens de Azure REST API-richtlijnen - . https://aka.ms/AzureRestApiGuidelines#handling-errors

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
innererror	Azure.Core.Foundations.InnerError	Interne fout.