Condividi tramite


Projects - Create

Crea un nuovo progetto.

PUT {endpoint}/customvoice/projects/{id}?api-version=2024-02-01-preview

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpoint
path True

string

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://eastus.api.cognitive.microsoft.com).

id
path True

string

ID della risorsa.

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

api-version
query True

string

Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Ocp-Apim-Subscription-Key True

string

Specificare qui la chiave della risorsa Voce.

Corpo della richiesta

Nome Necessario Tipo Descrizione
kind True

ProjectKind

Tipo di progetto

description

string

Descrizione del progetto

displayName

string

Project name (Nome progetto)

id

string

ID risorsa

Risposte

Nome Tipo Descrizione
201 Created

Project

Data di creazione

Other Status Codes

ErrorResponse

Si è verificato un errore.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Specificare qui la chiave della risorsa Voce.

Tipo: apiKey
In: header

Esempio

Create a project

Esempio di richiesta

PUT {endpoint}/customvoice/projects/Jessica?api-version=2024-02-01-preview


{
  "description": "Project for Jessica Voice",
  "kind": "ProfessionalVoice"
}

Risposta di esempio

{
  "id": "Jessica",
  "description": "Project for Jessica Voice",
  "kind": "ProfessionalVoice",
  "createdDateTime": "2023-04-01T05:30:00.000Z"
}

Definizioni

Nome Descrizione
Error

L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.

ErrorCode

Codice di errore di primo livello

ErrorResponse

La risposta agli errori segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).

Project

Oggetto Project. I consenso, i set di training, i modelli e gli endpoint sono organizzati in un progetto.

ProjectKind

Tipo di progetto

Error

L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.

Nome Tipo Descrizione
code

ErrorCode

Codice di errore di primo livello

details

Error[]

Dettagli aggiuntivi di supporto relativi all'errore e/o ai criteri previsti.

innererror

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).

message

string

Messaggio di errore di primo livello.

target

string

Indica l'origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

ErrorCode

Codice di errore di primo livello

Nome Tipo Descrizione
BadArgument

string

BadRequest

string

Forbidden

string

InternalServerError

string

NotFound

string

ServiceUnavailable

string

TooManyRequests

string

Unauthorized

string

UnsupportedMediaType

string

ErrorResponse

La risposta agli errori segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome Tipo Descrizione
error

Error

L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).

Nome Tipo Descrizione
code

string

Codice di errore dettagliato per facilitare la diagnostica.

innererror

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).

message

string

Messaggio di errore dettagliato.

target

string

Indica l'origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

Project

Oggetto Project. I consenso, i set di training, i modelli e gli endpoint sono organizzati in un progetto.

Nome Tipo Descrizione
createdDateTime

string

Timestamp al momento della creazione dell'oggetto. Il timestamp è codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

description

string

Descrizione del progetto

displayName

string

Project name (Nome progetto)

id

string

ID risorsa

kind

ProjectKind

Tipo di progetto

ProjectKind

Tipo di progetto

Nome Tipo Descrizione
PersonalVoice

string

ProfessionalVoice

string