Projects - Create

Szolgáltatás:: Azure AI Services

API-verzió:: 2026-01-01

Új projektet hoz létre.

PUT {endpoint}/customvoice/projects/{id}?api-version=2026-01-01

URI-paraméterek

Név	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: 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]$	Az erőforrás azonosítója.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Név	Kötelező	Típus	Description
kind	True	ProjectKind	Project típusú
description		string	Project leírása
displayName		string minLength: 1	Project neve
locale		string	A projekt helyi beállítása. A helyszíni kód a BCP-47-et követi. A szöveg-beszéd helyi listát itt https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttstalálod.

Válaszok

Név	Típus	Description
201 Created	Project	A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Név

Típus

Description

201 Created

Project

A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Description
https://cognitiveservices.azure.com/.default

Példák

Create a project

Mintakérelem

HTTP

PUT {endpoint}/customvoice/projects/Jessica?api-version=2026-01-01

{
  "description": "Project for Jessica Voice",
  "kind": "ProfessionalVoice",
  "locale": "en-US"
}

Mintaválasz

Állapotkód:: 201

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

Definíciók

Név	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Azure REST API irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Project	Project objektum. A beleegyezések, a képzési készletek, modellek és végpontok egy projektben vannak szervezve.
ProjectKind	Project típusú

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Név	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Név	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Azure REST API irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Név	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

Project

Tárgy

Project objektum. A beleegyezések, a képzési készletek, modellek és végpontok egy projektben vannak szervezve.

Név	Típus	Description
createdDateTime	string (date-time)	Az objektum létrehozásakor megadott időbélyeg. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("YYYY-MM-DDThh:mm:ssZ", lásd https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Project leírása
displayName	string minLength: 1	Project neve
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Erőforrás-azonosító
kind	ProjectKind	Project típusú
locale	string	A projekt helyi beállítása. A helyszíni kód a BCP-47-et követi. A szöveg-beszéd helyi listát itt https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttstalálod.

ProjectKind

Felsorolás

Project típusú

Érték	Description
ProfessionalVoice	ProfessionalVoice
PersonalVoice	PersonalVoice