Datasets - Update

Referenz

Dienst:: Azure AI Services

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

Aktualisiert die Eigenschaften eines vorhandenen Datasets.

Zurückgegebene Statuscodes:

200: Vorgang erfolgreich abgeschlossen.
400: Die Anforderung wurde falsch formatiert.
404: Ein Dataset mit dem angegebenen Namen wurde nicht gefunden.
412: Es wurde ein If-Match-Header bereitgestellt, aber das angegebene ETag stimmte nicht mit dem aktuellen ETag-Wert überein.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung

Name	In	Erforderlich	Typ	Beschreibung
name	path	True	string	Der Name des zu aktualisierenden Datasets. RegEx-Muster: `^[a-zA-Z0-9][a-zA-Z0-9._-]*$`
api-version	query	True	string	Api-Version angefordert.

name

path

True

string

Der Name des zu aktualisierenden Datasets.

RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$

api-version

query

True

string

Api-Version angefordert.

Anforderungsheader

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

Name	Erforderlich	Typ	Beschreibung
If-Match		string	Optionales ETag für das zu aktualisierende Dataset. Wenn ein ETag bereitgestellt wird, wird das Dataset nur aktualisiert, wenn sein aktueller ETag-Wert mit dem angegebenen ETag übereinstimmt. Wenn die ETag-Werte nicht übereinstimmen, schlägt der Aktualisierungsvorgang mit Statuscode 412 (Vorbedingung fehlgeschlagen) fehl. Dies gibt an, dass das Dataset seit dem letzten Abrufen von Informationen für das Dataset aktualisiert wurde. Wenn kein ETag bereitgestellt wird oder dessen Wert "*" lautet, wird das Dataset unabhängig vom aktuellen ETag-Wert immer aktualisiert.

Anforderungstext

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

Name	Typ	Beschreibung
annotationFileUris	string[]	Liste der absoluten URIs für Anmerkungsdateien, die jeweils als Blob in einem Azure Storage-Blobcontainer gespeichert werden müssen. Jede Datei muss das COCO-Format für das angegebene AnnotationKind-Format aufweisen, wobei jeder Imagepfad 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 systemverwaltete Identitäten für die Ressource maschinelles Sehen aktivieren und dann die Identität 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 der Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Mehrklassen-Bildklassifizierungsmodells 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 der beliebigen 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 beim Aktualisieren oder Löschen eines Datasets mit dem "If-Match"-Header verwendet werden.
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
200 OK	Dataset	Erfolg
Other Status Codes	ErrorResponse	Fehler Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

Dataset

Erfolg

Other Status Codes

ErrorResponse

Fehler

Header

x-ms-error-code: string

Beispiele

Datasets_Update

Beispielanforderung

HTTP

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

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://microsoft.com/a"
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://microsoft.com/a"
  ],
  "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 der Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Mehrklassen-Bildklassifizierungsmodells 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	Antwort, die zurückgegeben wird, wenn ein Fehler auftritt.
ErrorResponseDetails	Fehlerinformationen.
ErrorResponseInnerError	Detaillierter Fehler.
StorageAuthenticationKind	Die Speicherauthentifizierungsart.
StorageAuthenticationSettingsApiModel	Beschreibt die Speicherauthentifizierungseinstellungen.

AnnotationKind

Die Art der Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Mehrklassen-Bildklassifizierungsmodells 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, die jeweils als Blob in einem Azure Storage-Blobcontainer gespeichert werden müssen. Jede Datei muss das COCO-Format für das angegebene AnnotationKind-Format aufweisen, wobei jeder Imagepfad 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 systemverwaltete Identitäten für die Ressource maschinelles Sehen aktivieren und dann die Identität 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 der Anmerkungen, die in den Anmerkungsdateien enthalten sind. Beispiel: "ImageClassification", um anzugeben, dass die Anmerkungsdatei Objektbeschriftungen zum Trainieren oder Testen eines Mehrklassen-Bildklassifizierungsmodells 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 der beliebigen 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 beim Aktualisieren oder Löschen eines Datasets mit dem "If-Match"-Header verwendet werden.
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

Antwort, die zurückgegeben wird, 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.

Freigeben über

Datasets - Update

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Beispiele

Datasets_Update

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel

Zusätzliche Ressourcen