Projects - Create

Servizio:

Azure AI Services

Versione API:

2024-02-01-preview

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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID della risorsa.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string	Specificare la chiave della risorsa Voce qui.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
kind	True	ProjectKind	Tipo di progetto
description		string	Descrizione progetto
displayName		string minLength: 1	Nome progetto
id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa

Risposte

Nome	Tipo	Descrizione
201 Created	Project	Creato
Other Status Codes	ErrorResponse	Si è verificato un errore. Intestazioni x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Specificare la chiave della risorsa Voce qui.

Tipo: apiKey
In: header

Esempio

Create a project

Esempio di richiesta

HTTP

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


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

Risposta di esempio

Codice di stato:

201

{
  "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 dell'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 errore interno con dettagli più descrittivi.
ErrorCode	Codice di errore di primo livello
ErrorResponse	La risposta di errore 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.
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 (che 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

Object

L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.

Nome	Tipo	Descrizione
code	ErrorCode	Codice di errore di primo livello
details	Error[]	Ulteriori dettagli 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 (che può essere annidato).
message	string	Messaggio di errore di primo livello.
target	string	Origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

ErrorCode

Enumerazione

Codice di errore di primo livello

Valore	Descrizione
BadRequest
BadArgument
Unauthorized
Forbidden
NotFound
UnsupportedMediaType
TooManyRequests
InternalServerError
ServiceUnavailable

ErrorResponse

Object

La risposta di errore 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.

Nome	Tipo	Descrizione
error	Error	L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.

InnerError

Object

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 (che 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 (che può essere annidato).
message	string	Messaggio di errore dettagliato.
target	string	Origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

Project

Object

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

Nome	Tipo	Descrizione
createdDateTime	string (date-time)	Timestamp di creazione dell'oggetto. Il timestamp viene 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 progetto
displayName	string minLength: 1	Nome progetto
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa
kind	ProjectKind	Tipo di progetto

ProjectKind

Enumerazione

Tipo di progetto

Valore	Descrizione
ProfessionalVoice
PersonalVoice