Datasets - Get

Service:

Azure AI Services

Version d'API:

2023-04-01-preview

Obtient des informations sur un jeu de données spécifique.

Codes d’état retournés :

• 200 : Opération terminée avec succès.
• 400 : La demande a été mal formée.
• 404 : Un jeu de données portant le nom spécifié est introuvable.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
name	path	True	string	Nom du jeu de données à obtenir. 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.

Réponses

Nom	Type	Description
200 OK	Dataset	Succès
Other Status Codes	ErrorResponse	Error En-têtes x-ms-error-code: string

Exemples

Datasets_Get

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

200

{
  "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’annotations. 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’apprentissage ou le test d’un modèle.
ErrorResponse	Réponse retournée lorsqu’une erreur se produit.
ErrorResponseDetails	Informations sur l’erreur.
ErrorResponseInnerError	Erreur détaillée.
StorageAuthenticationKind	Type d’authentification de stockage.
StorageAuthenticationSettingsApiModel	Décrit les paramètres d’authentification du stockage.

AnnotationKind

Type d’annotations contenues dans les fichiers d’annotations. 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’apprentissage ou le test d’un modèle.

Nom	Type	Description
annotationFileUris	string[]	Liste des URI absolus des fichiers d’annotation, chacun 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 identités gérées par le système pour la ressource Vision par ordinateur, puis affectez l’identité à un rôle qui a l’autorisation de 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’annotations. 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 le jeu de données de manière unique.
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 sur l’erreur.

ErrorResponseDetails

Informations sur l’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 de 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 de stockage.
sasToken	string	facultatif. Jeton sas pour accéder au conteneur. Nécessaire uniquement lorsque Kind = Sas.