Datasets - Create

Hizmet:

Azure AI Services

API Sürümü:

2023-04-01-preview

Yeni bir veri kümesi kaydedin.

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

• 201: İşlem başarıyla tamamlandı.
• 400: İstek yanlış biçimlendirilmiş.
• 409: Belirtilen ada sahip bir veri kümesi zaten var.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
name	path	True	string	Kaydedildikten sonra veri kümesini benzersiz olarak tanımlamak için kullanılabilecek bir ad. Normal ifade deseni: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	İstenen API sürümü.

İstek Gövdesi

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

Name	Tür	Description
annotationFileUris	string[]	Ek açıklama dosyalarına yönelik mutlak URI'lerin listesi. Bunların her biri bir Azure Depolama blob kapsayıcısında blob olarak depolanmalıdır. Her dosya, belirtilen AnnotationKind için COCO biçimini izlemelidir ve her görüntü yolu blob kapsayıcısında 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'i açıp 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 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ştirilildiği tarih ve saat (UTC olarak).

Yanıtlar

Name	Tür	Description
201 Created	Dataset	Oluşturulan
Other Status Codes	ErrorResponse	Hata Üst Bilgiler x-ms-error-code: string

Örnekler

RegisterDataset_ImageClassification

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:

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

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ü ve ek açıklamayı temsil eden bir veri kümesini açıklar.
ErrorResponse	Bir hata oluştuğunda yanıt döndürülür.
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ü ve ek açıklamayı temsil eden bir veri kümesini açıklar.

Name	Tür	Description
annotationFileUris	string[]	Ek açıklama dosyalarına yönelik mutlak URI'lerin listesi. Bunların her biri bir Azure Depolama blob kapsayıcısında blob olarak depolanmalıdır. Her dosya, belirtilen AnnotationKind için COCO biçimini izlemelidir ve her görüntü yolu blob kapsayıcısında 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'i açıp 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 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ştirilildiği tarih ve saat (UTC olarak).

ErrorResponse

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

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 mesajı.
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 mesajı.

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.