Endpoints - Resume

Servizio:: Azure AI Services

Versione API:: 2026-01-01

Riprende l'endpoint identificato dall'ID indicato.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://eastus.api.cognitive.microsoft.com).
id	path	True	string (uuid)	L'ID della risorsa, che dovrebbe essere UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID del monitor di stato per l'operazione. Se l'intestazione Operation-Id corrisponde a un'operazione esistente e la richiesta non è identica a quella precedente, fallirà con una richiesta 400 Bad Request.

Risposte

Nome	Tipo	Descrizione
202 Accepted	Endpoint	La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata. Intestazioni Operation-Id: string Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

202 Accepted

Endpoint

La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata.

Intestazioni

Operation-Id: string
Operation-Location: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Resume an endpoint

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Endpoint	Oggetto endpoint
EndpointKind	Tipo di endpoint
EndpointProperties	Proprietà dell'endpoint
Status	Stato di una risorsa.

Azure.Core.Foundations.Error

Oggetto

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Oggetto

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Oggetto

Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

Endpoint

Oggetto

Oggetto endpoint

Nome	Tipo	Descrizione
createdDateTime	string (date-time)	Il timestamp in cui l'oggetto è stato creato. Il timestamp è codificato come data e ora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", vedi https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Descrizione dell'endpoint
displayName	string minLength: 1	Nome del punto finale
id	string (uuid)	Endpoint Id
lastActionDateTime	string (date-time)	Il timestamp in cui è stato inserito lo stato attuale. Il timestamp è codificato come data e ora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", vedi 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]$	ID risorsa
projectId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa
properties	EndpointProperties	Proprietà dell'endpoint
status	Status	Stato di una risorsa.

EndpointKind

Enumerazione

Tipo di endpoint

Valore	Descrizione
HighPerformance	HighPerformance
FastResume	FastResume

EndpointProperties

Oggetto

Proprietà dell'endpoint

Nome	Tipo	Descrizione
kind	EndpointKind	Tipo di endpoint

Status

Enumerazione

Stato di una risorsa.

Valore	Descrizione
NotStarted	Non Avviato
Running	In esecuzione
Succeeded	Succeeded
Failed	Non riuscito
Disabling	Disattivazione
Disabled	Disattivato