Endpoints - Resume

服務:

Azure AI Services

API 版本:

2026-01-01

恢復由指定 ID 識別的端點。

POST {endpoint}/customvoice/endpoints/{id}:resume?api-version=2026-01-01

URI 參數

名稱	位於	必要	類型	Description
endpoint	path	True	string (uri)	支援的認知服務端點 （通訊協定和主機名稱，例如： https://eastus.api.cognitive.microsoft.com）。
id	path	True	string (uuid)	資源 ID，應該是 UUID。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

要求標頭

名稱	必要	類型	Description
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	操作狀態監控器的識別碼。 若 Operation-Id 標頭與現有操作相符，且請求與先前請求不完全相同，則會以400錯誤請求失敗。

回應

名稱	類型	Description
202 Accepted	Endpoint	要求已接受進行處理，但尚未完成處理。 標題 Operation-Id: string Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	未預期的錯誤回應。 標題 x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

類型: apiKey
位於: header

OAuth2Auth

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
https://cognitiveservices.azure.com/.default

範例

Resume an endpoint

範例要求

HTTP

POST {endpoint}/customvoice/endpoints/9f50c644-2121-40e9-9ea7-544e48bfe3cb:resume?api-version=2026-01-01

範例回覆

狀態碼:

202

Operation-Id: 15cc4e23-3cc7-4811-adcc-75e5804765cc
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/15cc4e23-3cc7-4811-adcc-75e5804765cc?api-version=2026-01-01

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

定義

名稱	Description
Azure.Core.Foundations.Error	error 物件。
Azure.Core.Foundations.ErrorResponse	包含錯誤詳細數據的回應。
Azure.Core.Foundations.InnerError	物件，包含有關錯誤的更特定資訊。 根據 Azure REST API 指引 - https://aka.ms/AzureRestApiGuidelines#handling-errors。
Endpoint	端點物件
EndpointKind	端點類型
EndpointProperties	端點性質
Status	資源狀態。

Azure.Core.Foundations.Error

Object

error 物件。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
details	Azure.Core.Foundations.Error[]	導致此錯誤之特定錯誤的詳細數據陣列。
innererror	Azure.Core.Foundations.InnerError	物件，包含與目前對象有關錯誤更具體的資訊。
message	string	錯誤的人類可讀取表示法。
target	string	錯誤的目標。

Azure.Core.Foundations.ErrorResponse

Object

包含錯誤詳細數據的回應。

名稱	類型	Description
error	Azure.Core.Foundations.Error	error 物件。

Azure.Core.Foundations.InnerError

Object

物件，包含有關錯誤的更特定資訊。 根據 Azure REST API 指引 - https://aka.ms/AzureRestApiGuidelines#handling-errors。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
innererror	Azure.Core.Foundations.InnerError	內部錯誤。

Endpoint

Object

端點物件

名稱	類型	Description
createdDateTime	string (date-time)	物件被創造的時間戳。 時間戳以 ISO 8601 日期與時間格式編碼（「YYYY-MM-DDThh：mm：ssZ」，參見 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations）。
description	string	終點描述
displayName	string minLength: 1	端點名稱
id	string (uuid)	端點識別碼
lastActionDateTime	string (date-time)	輸入目前狀態的時間戳。 時間戳以 ISO 8601 日期與時間格式編碼（「YYYY-MM-DDThh：mm：ssZ」，參見 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations）。
modelId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	資源識別碼
projectId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	資源識別碼
properties	EndpointProperties	端點性質
status	Status	資源狀態。

EndpointKind

列舉型別

端點類型

值	Description
HighPerformance	HighPerformance
FastResume	快速履歷

EndpointProperties

Object

端點性質

名稱	類型	Description
kind	EndpointKind	端點類型

Status

列舉型別

資源狀態。

值	Description
NotStarted	尚未開始
Running	Running
Succeeded	成功
Failed	失敗
Disabling	停用
Disabled	Disabled