Projects - Create

Service:

Azure AI Services

Version d'API:

2024-02-01-preview

Crée un projet.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : 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 de la ressource.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string	Fournissez votre clé de ressource Speech ici.

Corps de la demande

Nom	Obligatoire	Type	Description
kind	True	ProjectKind	Type de projet
description		string	Description du projet
displayName		string minLength: 1	Nom du projet
id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID de ressource

Réponses

Nom	Type	Description
201 Created	Project	Créé
Other Status Codes	ErrorResponse	Une erreur s’est produite. En-têtes x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Fournissez votre clé de ressource Speech ici.

Type: apiKey
Dans: header

Exemples

Create a project

Exemple de requête

HTTP

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


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

Exemple de réponse

Code d’état:

201

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

Définitions

Nom	Description
Error	L’erreur de niveau supérieur suit les instructions de l’API REST Microsoft Azure qui est disponible à https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Cela contient une erreur de niveau supérieur avec le code d’erreur, le message, les détails, la cible et une erreur interne avec des détails plus descriptifs.
ErrorCode	Code d’erreur de niveau supérieur
ErrorResponse	La réponse d’erreur suit les instructions de l’API REST Microsoft Azure qui sont disponibles sur https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	L’erreur interne suit les instructions de l’API REST Microsoft Azure qui est disponible à https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Cela contient le code d’erreur des propriétés requises, le message et la cible de propriétés facultatives, erreur interne (cela peut être imbriqué).
Project	Objet Project. Les consentements, les jeux d’entraînement, les modèles et les points de terminaison sont organisés dans un projet.
ProjectKind	Type de projet

Error

Object

L’erreur de niveau supérieur suit les instructions de l’API REST Microsoft Azure qui est disponible à https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Cela contient une erreur de niveau supérieur avec le code d’erreur, le message, les détails, la cible et une erreur interne avec des détails plus descriptifs.

Nom	Type	Description
code	ErrorCode	Code d’erreur de niveau supérieur
details	Error[]	Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.
innererror	InnerError	L’erreur interne suit les instructions de l’API REST Microsoft Azure qui est disponible à https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Cela contient le code d’erreur des propriétés requises, le message et la cible de propriétés facultatives, erreur interne (cela peut être imbriqué).
message	string	Message d’erreur de niveau supérieur.
target	string	Source de l’erreur. Par exemple, il s’agirait de « modèle » ou d'« ID de modèle » en cas de modèle non valide.

ErrorCode

Énumération

Code d’erreur de niveau supérieur

Valeur	Description
BadRequest
BadArgument
Unauthorized
Forbidden
NotFound
UnsupportedMediaType
TooManyRequests
InternalServerError
ServiceUnavailable

ErrorResponse

Object

La réponse d’erreur suit les instructions de l’API REST Microsoft Azure qui sont disponibles sur https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nom	Type	Description
error	Error	L’erreur de niveau supérieur suit les instructions de l’API REST Microsoft Azure qui est disponible à https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Cela contient une erreur de niveau supérieur avec le code d’erreur, le message, les détails, la cible et une erreur interne avec des détails plus descriptifs.

InnerError

Object

L’erreur interne suit les instructions de l’API REST Microsoft Azure qui est disponible à https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Cela contient le code d’erreur des propriétés requises, le message et la cible de propriétés facultatives, erreur interne (cela peut être imbriqué).

Nom	Type	Description
code	string	Code d’erreur détaillé pour faciliter le diagnostic.
innererror	InnerError	L’erreur interne suit les instructions de l’API REST Microsoft Azure qui est disponible à https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Cela contient le code d’erreur des propriétés requises, le message et la cible de propriétés facultatives, erreur interne (cela peut être imbriqué).
message	string	Message d’erreur détaillé.
target	string	Source de l’erreur. Par exemple, il s’agirait de « modèle » ou d'« ID de modèle » en cas de modèle non valide.

Project

Object

Objet Project. Les consentements, les jeux d’entraînement, les modèles et les points de terminaison sont organisés dans un projet.

Nom	Type	Description
createdDateTime	string (date-time)	Horodatage lors de la création de l’objet. L’horodatage est encodé en tant que format de date et d’heure ISO 8601 (« AAAA-MM-DDThh :mm :ssZ », voir https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Description du projet
displayName	string minLength: 1	Nom du projet
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID de ressource
kind	ProjectKind	Type de projet

ProjectKind

Énumération

Type de projet

Valeur	Description
ProfessionalVoice
PersonalVoice