Freigeben über

Datasets - Update

  • Referenz
Dienst:
Cognitive Services - Computer Vision
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
 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

Beispiele

Datasets_Update

Sample request

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

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

Sample response

Status code:
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.