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 minLength: 3maxLength: 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 |
Tipo di progetto |
|
description |
string |
Descrizione progetto |
|
displayName |
string minLength: 1 |
Nome progetto |
|
id |
string minLength: 3maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$ |
ID risorsa |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
201 Created |
Creato |
|
Other Status Codes |
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
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 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. |
Error |
Codice di errore di primo livello |
Error |
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. |
Inner |
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. |
Project |
Tipo di progetto |
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.
Nome | Tipo | Descrizione |
---|---|---|
code |
Codice di errore di primo livello |
|
details |
Error[] |
Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti. |
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
Codice di errore di primo livello
Valore | Descrizione |
---|---|
BadArgument | |
BadRequest | |
Forbidden | |
InternalServerError | |
NotFound | |
ServiceUnavailable | |
TooManyRequests | |
Unauthorized | |
UnsupportedMediaType |
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.
Nome | Tipo | 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. |
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).
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore dettagliato per facilitare la diagnostica. |
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
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: 3maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$ |
ID risorsa |
kind |
Tipo di progetto |
ProjectKind
Tipo di progetto
Valore | Descrizione |
---|---|
PersonalVoice | |
ProfessionalVoice |