Datasets - Create

Référence

Service:: Azure AI Services

Version d'API:: 2023-04-01-preview

Inscrit un nouveau jeu de données.

Codes d’état retournés :

201 : L’opération s’est terminée avec succès.
400 : La demande a été mal formée.
409 : Un jeu de données portant le nom spécifié existe déjà.

PUT /datasets/{name}?api-version=2023-04-01-preview

Paramètres URI

Nom Dans Obligatoire Type Description

Nom	Dans	Obligatoire	Type	Description
name	path	True	string	Nom qui peut être utilisé pour identifier de manière unique le jeu de données une fois qu’il a été inscrit. Modèle d’expression régulière: `^[a-zA-Z0-9][a-zA-Z0-9._-]*$`
api-version	query	True	string	Version de l’API demandée.

name

path

True

string

Nom qui peut être utilisé pour identifier de manière unique le jeu de données une fois qu’il a été inscrit.

Modèle d’expression régulière: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$

api-version

query

True

string

Version de l’API demandée.

Corps de la demande

Media Types: "application/json-patch+json"

Nom	Type	Description
annotationFileUris	string[]	Liste des URI absolus des fichiers d’annotation, chacun d’eux devant être stocké en tant qu’objet blob dans un conteneur d’objets blob stockage Azure. Chaque fichier doit suivre le format COCO pour le annotationKind spécifié, chaque chemin d’accès d’image étant un URI absolu vers un objet blob dans un conteneur d’objets blob. La ressource Vision par ordinateur doit être autorisée à lire les fichiers d’annotation et tous les fichiers image référencés. Pour ce faire, activez les identités gérées par le système pour la ressource Vision par ordinateur, puis affectez l’identité à un rôle qui est autorisé à lire à partir du conteneur d’objets blob contenant les fichiers d’annotation et d’image.
annotationKind	AnnotationKind	Type d’annotations contenues dans les fichiers d’annotation. Par exemple, « ImageClassification » pour spécifier que le fichier d’annotation contient des étiquettes d’objet pour l’apprentissage ou le test d’un modèle de classification d’images multiclasse.
authentication	StorageAuthenticationSettingsApiModel	Décrit les paramètres d’authentification du stockage.
createdDateTime	string	Lecture seule. Date et heure auxquelles le jeu de données a été inscrit pour la première fois, en UTC.
customProperties	object	Dictionnaire de paires clé-valeur arbitraires à utiliser par l’application. Un maximum de 10 paires clé-valeur sont autorisées.
eTag	string	Lecture seule. Dernier ETag pour le jeu de données. Peut être utilisé avec l’en-tête « If-Match » lors de la mise à jour ou de la suppression d’un jeu de données.
name	string	Lecture seule. Nom utilisé pour identifier de manière unique le jeu de données.
updatedDateTime	string	Lecture seule. Date et heure de la dernière mise à jour du jeu de données, en UTC.

Réponses

Nom	Type	Description
201 Created	Dataset	Date de création
Other Status Codes	ErrorResponse	Erreur En-têtes x-ms-error-code: string

Nom

Type

Description

201 Created

Dataset

Date de création

Other Status Codes

ErrorResponse

Erreur

En-têtes

x-ms-error-code: string

Exemples

RegisterDataset_ImageClassification

Exemple de requête

HTTP

PUT /datasets/my_dataset_name?api-version=2023-04-01-preview

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://example.com/dataset.json"
  ]
}

Exemple de réponse

Code d’état:: 201

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://example.com/dataset.json"
  ],
  "name": "my_dataset_name",
  "createdDateTime": "2023-01-13T20:46:20.189Z",
  "updatedDateTime": "2023-01-13T20:46:20.189Z",
  "eTag": "kzktjgnqkjagdlkualdzikaseg"
}

Définitions

Nom	Description
AnnotationKind	Type d’annotations contenues dans les fichiers d’annotation. Par exemple, « ImageClassification » pour spécifier que le fichier d’annotation contient des étiquettes d’objet pour l’apprentissage ou le test d’un modèle de classification d’images multiclasse.
Dataset	Décrit un jeu de données, qui représente un ensemble d’images et d’annotations qui peuvent être utilisées pour l’entraînement ou le test d’un modèle.
ErrorResponse	Réponse retournée lorsqu’une erreur se produit.
ErrorResponseDetails	Informations d’erreur.
ErrorResponseInnerError	Erreur détaillée.
StorageAuthenticationKind	Type d’authentification du stockage.
StorageAuthenticationSettingsApiModel	Décrit les paramètres d’authentification du stockage.

AnnotationKind

Type d’annotations contenues dans les fichiers d’annotation. Par exemple, « ImageClassification » pour spécifier que le fichier d’annotation contient des étiquettes d’objet pour l’apprentissage ou le test d’un modèle de classification d’images multiclasse.

Nom	Type	Description
imageClassification	string
imageObjectDetection	string

Dataset

Décrit un jeu de données, qui représente un ensemble d’images et d’annotations qui peuvent être utilisées pour l’entraînement ou le test d’un modèle.

Nom	Type	Description
annotationFileUris	string[]	Liste des URI absolus des fichiers d’annotation, chacun d’eux devant être stocké en tant qu’objet blob dans un conteneur d’objets blob stockage Azure. Chaque fichier doit suivre le format COCO pour le annotationKind spécifié, chaque chemin d’accès d’image étant un URI absolu vers un objet blob dans un conteneur d’objets blob. La ressource Vision par ordinateur doit être autorisée à lire les fichiers d’annotation et tous les fichiers image référencés. Pour ce faire, activez les identités gérées par le système pour la ressource Vision par ordinateur, puis affectez l’identité à un rôle qui est autorisé à lire à partir du conteneur d’objets blob contenant les fichiers d’annotation et d’image.
annotationKind	AnnotationKind	Type d’annotations contenues dans les fichiers d’annotation. Par exemple, « ImageClassification » pour spécifier que le fichier d’annotation contient des étiquettes d’objet pour l’apprentissage ou le test d’un modèle de classification d’images multiclasse.
authentication	StorageAuthenticationSettingsApiModel	Décrit les paramètres d’authentification du stockage.
createdDateTime	string	Lecture seule. Date et heure auxquelles le jeu de données a été inscrit pour la première fois, en UTC.
customProperties	object	Dictionnaire de paires clé-valeur arbitraires à utiliser par l’application. Un maximum de 10 paires clé-valeur sont autorisées.
eTag	string	Lecture seule. Dernier ETag pour le jeu de données. Peut être utilisé avec l’en-tête « If-Match » lors de la mise à jour ou de la suppression d’un jeu de données.
name	string	Lecture seule. Nom utilisé pour identifier de manière unique le jeu de données.
updatedDateTime	string	Lecture seule. Date et heure de la dernière mise à jour du jeu de données, en UTC.

ErrorResponse

Réponse retournée lorsqu’une erreur se produit.

Nom	Type	Description
error	ErrorResponseDetails	Informations d’erreur.

ErrorResponseDetails

Informations d’erreur.

Nom	Type	Description
code	string	Code d’erreur.
details	ErrorResponseDetails[]	Liste des erreurs détaillées.
innererror	ErrorResponseInnerError	Erreur détaillée.
message	string	Message d’erreur.
target	string	Cible de l’erreur.

ErrorResponseInnerError

Erreur détaillée.

Nom	Type	Description
code	string	Code d’erreur.
innererror	ErrorResponseInnerError	Erreur détaillée.
message	string	Message d’erreur.

StorageAuthenticationKind

Type d’authentification du stockage.

Nom	Type	Description
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Décrit les paramètres d’authentification du stockage.

Nom	Type	Description
kind	StorageAuthenticationKind	Type d’authentification du stockage.
sasToken	string	facultatif. Jeton sas pour accéder au conteneur. Nécessaire uniquement lorsque Kind = Sas.

Partager via

Datasets - Create

Paramètres URI

Corps de la demande

Réponses

Exemples

RegisterDataset_ImageClassification

Exemple de requête

Exemple de réponse

Définitions

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel

Ressources supplémentaires