Endpoints - Suspend

Service:

Cognitive Services - Custom Voice

API Version:

2023-12-01-preview

Hält den durch die angegebene ID identifizierten Endpunkt an.

POST {endpoint}/customvoice/endpoints/{id}:suspend?api-version=2023-12-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://eastus.api.cognitive.microsoft.com
id	path	True	string uuid	Die Ressourcen-ID, die UUID sein sollte.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string	Geben Sie hier Ihren Speech-Ressourcenschlüssel an.
Operation-Id		string	ID des status-Monitors für den Vorgang. Wenn der Operation-Id-Header mit einem vorhandenen Vorgang übereinstimmt und die Anforderung nicht mit der vorherigen Anforderung identisch ist, tritt ein Fehler mit einer 400 ungültigen Anforderung auf. Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Antworten

Name	Typ	Beschreibung
202 Accepted	Endpoint	Akzeptiert Headers Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Ein Fehler ist aufgetreten.

Sicherheit

Ocp-Apim-Subscription-Key

Geben Sie hier Ihren Speech-Ressourcenschlüssel an.

Type: apiKey
In: header

Beispiele

Suspend an endpoint

Sample Request

HTTP

POST {endpoint}/customvoice/endpoints/9f50c644-2121-40e9-9ea7-544e48bfe3cb:suspend?api-version=2023-12-01-preview

Sample Response

Status code:

202

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/23f53763-5f21-442a-a944-18f72cdcaa4f?api-version=2023-12-01-preview
Operation-Id: 23f53763-5f21-442a-a944-18f72cdcaa4f

Response Body

{
  "id": "9f50c644-2121-40e9-9ea7-544e48bfe3cb",
  "description": "Endpoint for Jessica voice",
  "projectId": "Jessica",
  "modelId": "Jessica",
  "properties": {
    "kind": "HighPerformance"
  },
  "status": "Disabling",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Definitionen

Name	Beschreibung
Endpoint	Endpunktobjekt
EndpointKind	Endpunktart
EndpointProperties	Endpunkteigenschaften
Error	Fehler auf oberster Ebene folgen den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler der obersten Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.
ErrorCode	Fehlercode auf oberster Ebene
ErrorResponse	Die Fehlerantwort folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist.
InnerError	Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).
Status	Status einer Ressource.

Endpoint

Endpunktobjekt

Name	Typ	Beschreibung
createdDateTime	string	Der Zeitstempel, bei dem das Objekt erstellt wurde. Der Zeitstempel ist als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-TTThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Endpunktbeschreibung
displayName	string	Endpunktname
id	string	Endpunkt-ID
lastActionDateTime	string	Der Zeitstempel, bei dem die aktuelle status eingegeben wurde. Der Zeitstempel ist als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-TTThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
modelId	string	Ressourcen-ID
projectId	string	Ressourcen-ID
properties	EndpointProperties	Endpunkteigenschaften
status	Status	Status einer Ressource.

EndpointKind

Endpunktart

Name	Typ	Beschreibung
FastResume	string
HighPerformance	string

EndpointProperties

Endpunkteigenschaften

Name	Typ	Beschreibung
kind	EndpointKind	Endpunktart

Error

Fehler auf oberster Ebene folgen den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler der obersten Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.

Name	Typ	Beschreibung
code	ErrorCode	Fehlercode auf oberster Ebene
details	Error[]	Zusätzliche unterstützende Details zum Fehler und/oder zu den erwarteten Richtlinien.
innererror	InnerError	Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).
message	string	Fehlermeldung auf oberster Ebene.
target	string	Die Ursache des Fehlers. Im Falle eines ungültigen Modells wäre es z. B. "Model" oder "Model ID".

ErrorCode

Fehlercode auf oberster Ebene

Name	Typ	Beschreibung
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Die Fehlerantwort folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist.

Name	Typ	Beschreibung
error	Error	Fehler auf oberster Ebene folgen den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler der obersten Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.

InnerError

Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).

Name	Typ	Beschreibung
code	string	Detaillierter Fehlercode zur Unterstützung der Diagnose.
innererror	InnerError	Der innere Fehler folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar ist. Dies enthält den erforderlichen Eigenschaftenfehlercode, Nachricht und optionale Eigenschaften ziel, innerer Fehler (dies kann geschachtelt werden).
message	string	Ausführliche Fehlermeldung.
target	string	Die Ursache des Fehlers. Im Falle eines ungültigen Modells wäre es z. B. "Model" oder "Model ID".

Status

Status einer Ressource.

Name	Typ	Beschreibung
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string