Datasets - Update

Hizmet:

Azure AI Services

API Sürümü:

2023-04-01-preview

Mevcut bir veri kümesinin özelliklerini güncelleştirin.

Durum kodları döndürüldü:

• 200: İşlem başarıyla tamamlandı.
• 400: İstek hatalı biçimlendirilmiş.
• 404: Belirtilen ada sahip bir veri kümesi bulunamadı.
• 412: bir If-Match üst bilgisi sağlandı, ancak verilen ETag geçerli ETag değeriyle eşleşmedi.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
name	path	True	string	Güncelleştirilecek veri kümesinin adı. Normal ifade deseni: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	api sürümü istendi.

İstek Başlığı

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

Name	Gerekli	Tür	Description
If-Match		string	Veri kümesinin güncelleştirilecek isteğe bağlı ETag'i. Bir ETag sağlanırsa, veri kümesi yalnızca geçerli ETag değeri verilen ETag ile eşleşiyorsa güncelleştirilir. ETag değerleri eşleşmiyorsa güncelleştirme işlemi 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu). Bu, veri kümesinin, veri kümesine ilişkin bilgilerin son alındığı zamandan bu yana güncelleştirildiğini gösterir. Bir ETag sağlanmazsa veya değeri '*' ise veri kümesi geçerli ETag değerinden bağımsız olarak her zaman güncelleştirilir.

İstek Gövdesi

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

Name	Tür	Description
annotationFileUris	string[]	Her biri Azure Depolama blob kapsayıcısında blob olarak depolanması gereken ek açıklama dosyalarına mutlak URI'lerin listesi. Her dosya, belirtilen AnnotationKind için COCO biçimini izlemelidir ve her görüntü yolu blob kapsayıcıdaki bir blob için mutlak bir URI'dir. Görüntü İşleme kaynağının ek açıklama dosyalarını ve başvuruda bulunan tüm görüntü dosyalarını okuma izni olmalıdır. Bu işlem, Görüntü İşleme kaynağı için Sistem tarafından yönetilen kimlikler etkinleştirilip ardından kimliği ek açıklama ve görüntü dosyalarını içeren blob kapsayıcısından okuma izni olan bir role atayarak yapılabilir.
annotationKind	AnnotationKind	Ek açıklama dosyalarında yer alan ek açıklamaların türü. Örneğin, ek açıklama dosyasının çok sınıflı görüntü sınıflandırma modelini eğitmek veya test etmek için nesne etiketleri içerdiğini belirtmek için "ImageClassification".
authentication	StorageAuthenticationSettingsApiModel	Depolama kimlik doğrulaması ayarlarını açıklar.
createdDateTime	string	Salt okunur. Veri kümesinin UTC olarak ilk kaydedilildiği tarih ve saat.
customProperties	object	Uygulama tarafından kullanılmak üzere rastgele anahtar-değer çiftlerinin sözlüğü. En fazla 10 anahtar-değer çifti kullanılabilir.
eTag	string	Salt okunur. Veri kümesi için en son ETag. Bir veri kümesini güncelleştirirken veya silerken 'If-Match' üst bilgisi ile birlikte kullanılabilir.
name	string	Salt okunur. Veri kümesini benzersiz olarak tanımlamak için kullanılan ad.
updatedDateTime	string	Salt okunur. Veri kümesinin en son güncelleştirildiği tarih ve saat (UTC).

Yanıtlar

Name	Tür	Description
200 OK	Dataset	Başarılı
Other Status Codes	ErrorResponse	Hata Üst Bilgiler x-ms-error-code: string

Örnekler

Datasets_Update

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:

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

Tanımlar

Name	Description
AnnotationKind	Ek açıklama dosyalarında yer alan ek açıklamaların türü. Örneğin, ek açıklama dosyasının çok sınıflı görüntü sınıflandırma modelini eğitmek veya test etmek için nesne etiketleri içerdiğini belirtmek için "ImageClassification".
Dataset	Bir modeli eğitmek veya test etme amacıyla kullanılabilecek bir dizi görüntüyü ve ek açıklamayı temsil eden bir veri kümesini açıklar.
ErrorResponse	Bir hata oluştuğunda yanıt döndürüldü.
ErrorResponseDetails	Hata bilgileri.
ErrorResponseInnerError	Ayrıntılı hata.
StorageAuthenticationKind	Depolama kimlik doğrulaması türü.
StorageAuthenticationSettingsApiModel	Depolama kimlik doğrulaması ayarlarını açıklar.

AnnotationKind

Ek açıklama dosyalarında yer alan ek açıklamaların türü. Örneğin, ek açıklama dosyasının çok sınıflı görüntü sınıflandırma modelini eğitmek veya test etmek için nesne etiketleri içerdiğini belirtmek için "ImageClassification".

Name	Tür	Description
imageClassification	string
imageObjectDetection	string

Dataset

Bir modeli eğitmek veya test etme amacıyla kullanılabilecek bir dizi görüntüyü ve ek açıklamayı temsil eden bir veri kümesini açıklar.

Name	Tür	Description
annotationFileUris	string[]	Her biri Azure Depolama blob kapsayıcısında blob olarak depolanması gereken ek açıklama dosyalarına mutlak URI'lerin listesi. Her dosya, belirtilen AnnotationKind için COCO biçimini izlemelidir ve her görüntü yolu blob kapsayıcıdaki bir blob için mutlak bir URI'dir. Görüntü İşleme kaynağının ek açıklama dosyalarını ve başvuruda bulunan tüm görüntü dosyalarını okuma izni olmalıdır. Bu işlem, Görüntü İşleme kaynağı için Sistem tarafından yönetilen kimlikler etkinleştirilip ardından kimliği ek açıklama ve görüntü dosyalarını içeren blob kapsayıcısından okuma izni olan bir role atayarak yapılabilir.
annotationKind	AnnotationKind	Ek açıklama dosyalarında yer alan ek açıklamaların türü. Örneğin, ek açıklama dosyasının çok sınıflı görüntü sınıflandırma modelini eğitmek veya test etmek için nesne etiketleri içerdiğini belirtmek için "ImageClassification".
authentication	StorageAuthenticationSettingsApiModel	Depolama kimlik doğrulaması ayarlarını açıklar.
createdDateTime	string	Salt okunur. Veri kümesinin UTC olarak ilk kaydedilildiği tarih ve saat.
customProperties	object	Uygulama tarafından kullanılmak üzere rastgele anahtar-değer çiftlerinin sözlüğü. En fazla 10 anahtar-değer çifti kullanılabilir.
eTag	string	Salt okunur. Veri kümesi için en son ETag. Bir veri kümesini güncelleştirirken veya silerken 'If-Match' üst bilgisi ile birlikte kullanılabilir.
name	string	Salt okunur. Veri kümesini benzersiz olarak tanımlamak için kullanılan ad.
updatedDateTime	string	Salt okunur. Veri kümesinin en son güncelleştirildiği tarih ve saat (UTC).

ErrorResponse

Bir hata oluştuğunda yanıt döndürüldü.

Name	Tür	Description
error	ErrorResponseDetails	Hata bilgileri.

ErrorResponseDetails

Hata bilgileri.

Name	Tür	Description
code	string	Hata kodu.
details	ErrorResponseDetails[]	Ayrıntılı hataların listesi.
innererror	ErrorResponseInnerError	Ayrıntılı hata.
message	string	Hata iletisi.
target	string	Hatanın hedefi.

ErrorResponseInnerError

Ayrıntılı hata.

Name	Tür	Description
code	string	Hata kodu.
innererror	ErrorResponseInnerError	Ayrıntılı hata.
message	string	Hata iletisi.

StorageAuthenticationKind

Depolama kimlik doğrulaması türü.

Name	Tür	Description
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Depolama kimlik doğrulaması ayarlarını açıklar.

Name	Tür	Description
kind	StorageAuthenticationKind	Depolama kimlik doğrulaması türü.
sasToken	string	İsteğe bağlı. Kapsayıcıya erişmek için sas belirteci. Yalnızca Kind = Sas olduğunda gereklidir.