Datasets - Create

Dienst:

Azure AI Services

API-Version:

2023-04-01-preview

Registriert ein neues Dataset.

Zurückgegebene Statuscodes:

• 201: Der Vorgang wurde erfolgreich abgeschlossen.
• 400: Die Anforderung wurde falsch formatiert.
• 409: Ein Dataset mit dem angegebenen Namen ist bereits vorhanden.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
name	path	True	string	Ein Name, der verwendet werden kann, um das Dataset eindeutig zu identifizieren, nachdem es registriert wurde. RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Angeforderte API-Version.

Anforderungstext

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

Name	Typ	Beschreibung
annotationFileUris	string[]	Liste der absoluten URIs für Anmerkungsdateien, von denen jede als Blob in einem Azure Storage-Blobcontainer gespeichert werden muss. Jede Datei muss das COCO-Format für das angegebene AnnotationKind-Format aufweisen, wobei jeder Bildpfad ein absoluter URI zu einem Blob in einem Blobcontainer ist. Die Ressource für maschinelles Sehen muss über die Berechtigung zum Lesen der Anmerkungsdateien und aller Bilddateien verfügen, auf die verwiesen wird. Hierzu können Sie vom System verwaltete Identitäten für die Ressource maschinelles Sehen aktivieren und die Identität dann einer Rolle zuweisen, die über die Berechtigung zum Lesen aus dem Blobcontainer verfügt, der die Anmerkungs- und Bilddateien enthält.
annotationKind	AnnotationKind	Die Art von Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Bildklassifizierungsmodells mit mehreren Klassen enthält.
authentication	StorageAuthenticationSettingsApiModel	Beschreibt die Speicherauthentifizierungseinstellungen.
createdDateTime	string	Schreibgeschützt. Das Datum und die Uhrzeit der erstmaligen Registrierung des Datasets in UTC.
customProperties	object	Wörterbuch beliebiger Schlüssel-Wert-Paare zur Verwendung durch die Anwendung. Maximal 10 Schlüssel-Wert-Paare sind zulässig.
eTag	string	Schreibgeschützt. Das neueste ETag für das Dataset. Kann mit dem If-Match-Header verwendet werden, wenn ein Dataset aktualisiert oder gelöscht wird.
name	string	Schreibgeschützt. Der Name, der verwendet wird, um das Dataset eindeutig zu identifizieren.
updatedDateTime	string	Schreibgeschützt. Das Datum und die Uhrzeit der letzten Aktualisierung des Datasets in UTC.

Antworten

Name	Typ	Beschreibung
201 Created	Dataset	Erstellt
Other Status Codes	ErrorResponse	Fehler Header x-ms-error-code: string

Beispiele

RegisterDataset_ImageClassification

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

Statuscode:

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"
}

Definitionen

Name	Beschreibung
AnnotationKind	Die Art von Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Bildklassifizierungsmodells mit mehreren Klassen enthält.
Dataset	Beschreibt ein Dataset, das eine Reihe von Bildern und Anmerkungen darstellt, die zum Trainieren oder Testen eines Modells verwendet werden können.
ErrorResponse	Die Antwort wird zurückgegeben, wenn ein Fehler auftritt.
ErrorResponseDetails	Fehlerinformationen.
ErrorResponseInnerError	Detaillierter Fehler.
StorageAuthenticationKind	Die Speicherauthentifizierungsart.
StorageAuthenticationSettingsApiModel	Beschreibt die Speicherauthentifizierungseinstellungen.

AnnotationKind

Die Art von Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Bildklassifizierungsmodells mit mehreren Klassen enthält.

Name	Typ	Beschreibung
imageClassification	string
imageObjectDetection	string

Dataset

Beschreibt ein Dataset, das eine Reihe von Bildern und Anmerkungen darstellt, die zum Trainieren oder Testen eines Modells verwendet werden können.

Name	Typ	Beschreibung
annotationFileUris	string[]	Liste der absoluten URIs für Anmerkungsdateien, von denen jede als Blob in einem Azure Storage-Blobcontainer gespeichert werden muss. Jede Datei muss das COCO-Format für das angegebene AnnotationKind-Format aufweisen, wobei jeder Bildpfad ein absoluter URI zu einem Blob in einem Blobcontainer ist. Die Ressource für maschinelles Sehen muss über die Berechtigung zum Lesen der Anmerkungsdateien und aller Bilddateien verfügen, auf die verwiesen wird. Hierzu können Sie vom System verwaltete Identitäten für die Ressource maschinelles Sehen aktivieren und die Identität dann einer Rolle zuweisen, die über die Berechtigung zum Lesen aus dem Blobcontainer verfügt, der die Anmerkungs- und Bilddateien enthält.
annotationKind	AnnotationKind	Die Art von Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Bildklassifizierungsmodells mit mehreren Klassen enthält.
authentication	StorageAuthenticationSettingsApiModel	Beschreibt die Speicherauthentifizierungseinstellungen.
createdDateTime	string	Schreibgeschützt. Das Datum und die Uhrzeit der erstmaligen Registrierung des Datasets in UTC.
customProperties	object	Wörterbuch beliebiger Schlüssel-Wert-Paare zur Verwendung durch die Anwendung. Maximal 10 Schlüssel-Wert-Paare sind zulässig.
eTag	string	Schreibgeschützt. Das neueste ETag für das Dataset. Kann mit dem If-Match-Header verwendet werden, wenn ein Dataset aktualisiert oder gelöscht wird.
name	string	Schreibgeschützt. Der Name, der verwendet wird, um das Dataset eindeutig zu identifizieren.
updatedDateTime	string	Schreibgeschützt. Das Datum und die Uhrzeit der letzten Aktualisierung des Datasets in UTC.

ErrorResponse

Die Antwort wird zurückgegeben, wenn ein Fehler auftritt.

Name	Typ	Beschreibung
error	ErrorResponseDetails	Fehlerinformationen.

ErrorResponseDetails

Fehlerinformationen.

Name	Typ	Beschreibung
code	string	Fehlercode
details	ErrorResponseDetails[]	Liste der detaillierten Fehler.
innererror	ErrorResponseInnerError	Detaillierter Fehler.
message	string	Fehlermeldung.
target	string	Ziel des Fehlers.

ErrorResponseInnerError

Detaillierter Fehler.

Name	Typ	Beschreibung
code	string	Fehlercode
innererror	ErrorResponseInnerError	Detaillierter Fehler.
message	string	Fehlermeldung.

StorageAuthenticationKind

Die Speicherauthentifizierungsart.

Name	Typ	Beschreibung
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Beschreibt die Speicherauthentifizierungseinstellungen.

Name	Typ	Beschreibung
kind	StorageAuthenticationKind	Die Speicherauthentifizierungsart.
sasToken	string	Optional. Das SAS-Token für den Zugriff auf den Container. Nur erforderlich, wenn Kind = Sas.