Projects - Create

Référence

Service:: Azure AI Services

Version d'API:: v3.2-preview.2

Crée un projet.

POST {endpoint}/speechtotext/v3.2-preview.2/projects

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://westus.api.cognitive.microsoft.com).

Corps de la demande

Nom	Obligatoire	Type	Description
displayName	True	string minLength: 1	Nom complet de l’objet.
locale	True	string minLength: 1	Paramètres régionaux des données contenues.
customProperties		object	Propriétés personnalisées de cette entité. La longueur maximale autorisée de la clé est de 64 caractères, la longueur maximale de la valeur autorisée est de 256 caractères et le nombre d’entrées autorisées est de 10.
description		string	Description de l'objet .

Réponses

Nom	Type	Description
201 Created	Project	La réponse contient des informations sur l’entité en tant que charge utile et son emplacement en tant qu’en-tête. En-têtes Location: string
Other Status Codes	Error	Une erreur est survenue.

Nom

Type

Description

201 Created

Project

La réponse contient des informations sur l’entité en tant que charge utile et son emplacement en tant qu’en-tête.

En-têtes

Location: string

Other Status Codes

Error

Une erreur est survenue.

Sécurité

Ocp-Apim-Subscription-Key

Fournissez la clé de votre compte Cognitive Services ici.

Type: apiKey
Dans: header

Authorization

Fournissez un jeton d’accès à partir du JWT retourné par le STS de cette région. Veillez à ajouter l’étendue de gestion au jeton en ajoutant la chaîne de requête suivante à l’URL STS : ?scope=speechservicesmanagement

Type: apiKey
Dans: header

Exemples

Create a project

Exemple de requête

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/projects

{
  "locale": "en-US",
  "displayName": "My speech project"
}

Exemple de réponse

Code d’état:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
  "links": {
    "evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
    "datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
    "models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
    "endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
    "transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
  },
  "properties": {
    "datasetCount": 23,
    "evaluationCount": 42,
    "modelCount": 2,
    "transcriptionCount": 1994,
    "endpointCount": 12
  },
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "My speech project"
}

Définitions

Nom	Description
DetailedErrorCode	DetailedErrorCode
Error	Erreur
ErrorCode	ErrorCode
InnerError	InnerError
Project	Project
ProjectLinks	ProjectLinks
ProjectProperties	ProjectProperties

DetailedErrorCode

Énumération

DetailedErrorCode

Valeur	Description
DataImportFailed	Échec de l’importation des données.
DeleteNotAllowed	Supprimer non autorisé.
DeployNotAllowed	Déploiement non autorisé.
DeployingFailedModel	Déploiement d’un modèle ayant échoué.
EmptyRequest	Requête vide.
EndpointCannotBeDefault	Le point de terminaison ne peut pas être par défaut.
EndpointNotUpdatable	Point de terminaison non modifiable.
EndpointWithoutLogging	Point de terminaison sans journalisation.
ExceededNumberOfRecordingsUris	Dépassement du nombre d’URI d’enregistrements.
FailedDataset	Échec du jeu de données.
Forbidden	Interdit.
InUseViolation	Violation en cours d’utilisation.
InaccessibleCustomerStorage	Stockage client inaccessible.
InvalidAdaptationMapping	Mappage d’adaptation non valide.
InvalidBaseModel	Modèle de base non valide.
InvalidCallbackUri	URI de rappel non valide.
InvalidCollection	Collection non valide.
InvalidDataset	Jeu de données non valide.
InvalidDocument	Document non valide.
InvalidDocumentBatch	Lot de documents non valide.
InvalidLocale	Paramètres régionaux non valides.
InvalidLogDate	Date de journal non valide.
InvalidLogEndTime	Heure de fin du journal non valide.
InvalidLogId	ID de journal non valide.
InvalidLogStartTime	Heure de début du journal non valide.
InvalidModel	Modèle non valide.
InvalidModelUri	URI de modèle non valide.
InvalidParameter	Paramètre non valide.
InvalidParameterValue	Valeur de paramètre non valide.
InvalidPayload	Charge utile non valide.
InvalidPermissions	Autorisations non valides.
InvalidPrerequisite	Prérequis non valides.
InvalidProductId	ID de produit non valide.
InvalidProject	Projet non valide.
InvalidProjectKind	Type de projet non valide.
InvalidRecordingsUri	Uri des enregistrements non valides.
InvalidRequestBodyFormat	Format du corps de la demande non valide.
InvalidSasValidityDuration	Durée de validité de sas non valide.
InvalidSkipTokenForLogs	Jeton d’ignorer non valide pour les journaux.
InvalidSourceAzureResourceId	ID de ressource Azure source non valide.
InvalidSubscription	Abonnement non valide.
InvalidTest	Test non valide.
InvalidTimeToLive	Durée de vie non valide.
InvalidTopForLogs	Top non valide pour les journaux.
InvalidTranscription	Transcription non valide.
InvalidWebHookEventKind	Type d’événement web hook non valide.
MissingInputRecords	Enregistrements d’entrée manquants.
ModelCopyOperationExists	L’opération de copie de modèle existe.
ModelDeploymentNotCompleteState	État non terminé du déploiement du modèle.
ModelDeprecated	Modèle déconseillé.
ModelExists	Le modèle existe.
ModelMismatch	Incompatibilité de modèle.
ModelNotDeployable	Modèle non déployable.
ModelVersionIncorrect	Version du modèle incorrecte.
NoUtf8WithBom	Pas de utf8 avec bom.
OnlyOneOfUrlsOrContainerOrDataset	Une seule url ou conteneur ou jeu de données.
ProjectGenderMismatch	Projet d’incompatibilité entre les sexes.
QuotaViolation	Violation de quota.
SingleDefaultEndpoint	Point de terminaison par défaut unique.
SkuLimitsExist	Des limites de référence SKU existent.
SubscriptionNotFound	Abonnement introuvable.
UnexpectedError	Erreur inattendue.
UnsupportedClassBasedAdaptation	Adaptation basée sur les classes non prise en charge.
UnsupportedDelta	Delta non pris en charge.
UnsupportedDynamicConfiguration	Configuration dynamique non prise en charge.
UnsupportedFilter	Filtre non pris en charge.
UnsupportedLanguageCode	Code de langue non pris en charge.
UnsupportedOrderBy	Commande non prise en charge par.
UnsupportedPagination	Pagination non prise en charge.
UnsupportedTimeRange	Intervalle de temps non pris en charge.

Error

Object

Erreur

Nom	Type	Description
code	ErrorCode	ErrorCode Codes d’erreur de haut niveau.
details	Error[]	Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.
innerError	InnerError	InnerError Nouveau format d’erreur interne conforme aux instructions de l’API Cognitive Services, disponible à l’adresse https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ce format contient les propriétés obligatoires ErrorCode, message et les propriétés facultatives target, details (paire clé-valeur), et l’erreur interne (qui peut être imbriquée).
message	string	Message d’erreur de haut niveau.
target	string	Source de l’erreur. Par exemple, « documents » ou « document id » en présence d’un document non valide.

ErrorCode

Énumération

ErrorCode

Valeur	Description
Conflict	Représentant le code d’erreur de conflit.
Forbidden	Représentant le code d’erreur interdit.
InternalCommunicationFailed	Représentant le code d’erreur d’échec de la communication interne.
InternalServerError	Représentant le code d’erreur interne du serveur.
InvalidArgument	Représentant le code d’erreur de l’argument non valide.
InvalidRequest	Représentant le code d’erreur de requête non valide.
NotAllowed	Représentant le code d’erreur non autorisé.
NotFound	Représentant le code d’erreur introuvable.
PipelineError	Représentant le code d’erreur du pipeline.
ServiceUnavailable	Représentant le code d’erreur indisponible du service.
TooManyRequests	Représentant le code d’erreur de trop de requêtes.
Unauthorized	Représentant le code d’erreur non autorisé.
UnprocessableEntity	Représentant le code d’erreur d’entité non traité.
UnsupportedMediaType	Représentant le code d’erreur de type multimédia non pris en charge.

InnerError

Object

InnerError

Nom	Type	Description
code	DetailedErrorCode	DetailedErrorCode Énumération détaillée du code d’erreur.
details	object	Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.
innerError	InnerError	InnerError Nouveau format d’erreur interne conforme aux instructions de l’API Cognitive Services, disponible à l’adresse https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ce format contient les propriétés obligatoires ErrorCode, message et les propriétés facultatives target, details (paire clé-valeur), et l’erreur interne (qui peut être imbriquée).
message	string	Message d’erreur de haut niveau.
target	string	Source de l’erreur. Par exemple, « documents » ou « document id » en présence d’un document non valide.

Project

Object

Project

Nom	Type	Description
createdDateTime	string (date-time)	Horodatage de la création de l’objet. L’horodatage est encodé au format de date et d’heure ISO 8601 (« AAAA-MM-JJThh :mm :ssZ », voir https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Propriétés personnalisées de cette entité. La longueur maximale autorisée de la clé est de 64 caractères, la longueur maximale de la valeur autorisée est de 256 caractères et le nombre d’entrées autorisées est de 10.
description	string	Description de l'objet .
displayName	string minLength: 1	Nom complet de l’objet.
links	ProjectLinks	ProjectLinks
locale	string minLength: 1	Paramètres régionaux des données contenues.
properties	ProjectProperties	ProjectProperties
self	string (uri)	Emplacement de cette entité.

ProjectLinks

Object

ProjectLinks

Nom	Type	Description
datasets	string (uri)	Emplacement permettant d’obtenir la liste de tous les jeux de données de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListDatasets ».
endpoints	string (uri)	Emplacement permettant d’obtenir la liste de tous les points de terminaison de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListEndpoints ».
evaluations	string (uri)	Emplacement où obtenir la liste de toutes les évaluations de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListEvaluations ».
models	string (uri)	Emplacement pour obtenir la liste de tous les modèles de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListModels ».
transcriptions	string (uri)	Emplacement pour obtenir la liste de toutes les transcriptions de ce projet. Pour plus d’informations, consultez l’opération « Projects_ListTranscriptions ».

ProjectProperties

Object

ProjectProperties

Nom	Type	Description
datasetCount	integer (int32)	Nombre de jeux de données associés à ce projet.
endpointCount	integer (int32)	Nombre de points de terminaison associés à ce projet.
evaluationCount	integer (int32)	Nombre d’évaluations associées à ce projet.
modelCount	integer (int32)	Nombre de modèles associés à ce projet.
transcriptionCount	integer (int32)	Nombre de transcriptions associées à ce projet.

Partager via

Projects - Create

Paramètres URI

Corps de la demande

Réponses

Sécurité

Ocp-Apim-Subscription-Key

Authorization

Exemples

Create a project

Exemple de requête

Exemple de réponse

Définitions

DetailedErrorCode

Error

ErrorCode

InnerError

Project

ProjectLinks

ProjectProperties

Ressources supplémentaires