Datasets - Create

Başvuru

Hizmet:: Azure AI Services

API Sürümü:: v3.2-preview.2

Belirtilen URL'den verileri alarak yeni bir veri kümesi yükler ve oluşturur veya veri bloklarının karşıya yüklenmesini beklemeye başlar.

POST {endpoint}/speechtotext/v3.2-preview.2/datasets

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://westus.api.cognitive.microsoft.com).

İstek Gövdesi

Name	Gerekli	Tür	Description
displayName	True	string	Nesnenin görünen adı.
kind	True	DatasetKind	DatasetKind Veri içeri aktarma türü.
locale	True	string	Kapsanan verilerin yerel ayarı.
contentUrl		string	Veri kümesi için verilerin URL'si.
customProperties		object	Bu varlığın özel özellikleri. İzin verilen anahtar uzunluğu üst sınırı 64 karakter, izin verilen değer uzunluğu üst sınırı 256 karakter ve izin verilen girdi sayısı 10'dur.
description		string	Nesnenin açıklaması.
project		EntityReference	EntityReference
properties		DatasetProperties	DatasetProperties

Yanıtlar

Name	Tür	Description
201 Created	Dataset	Yanıt, yük olarak varlık ve üst bilgi olarak konumu hakkında bilgi içerir. Üst Bilgiler Location: string
Other Status Codes	Error	Bir hata oluşmuştur.

Name

Tür

Description

201 Created

Dataset

Yanıt, yük olarak varlık ve üst bilgi olarak konumu hakkında bilgi içerir.

Üst Bilgiler

Location: string

Other Status Codes

Error

Bir hata oluşmuştur.

Güvenlik

Ocp-Apim-Subscription-Key

Bilişsel hizmetler hesap anahtarınızı burada sağlayın.

Tür: apiKey
İçinde: header

Authorization

Bu bölgenin STS tarafından döndürülen JWT'den bir erişim belirteci sağlayın. STS URL'sine aşağıdaki sorgu dizesini ekleyerek yönetim kapsamını belirteci eklediğinizden emin olun: ?scope=speechservicesmanagement

Tür: apiKey
İçinde: header

Örnekler

Create a dataset with content url

Create dataset from data blocks

Create a dataset with content url

Örnek isteği

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/datasets

{
  "kind": "Acoustic",
  "contentUrl": "https://contoso.com/location",
  "locale": "en-US",
  "displayName": "My speech dataset name",
  "description": "My speech dataset description"
}

Örnek yanıt

Durum kodu:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1",
  "kind": "Acoustic",
  "contentUrl": "https://www.contoso.com/acousticdata/sourcelocation",
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files"
  },
  "properties": {
    "textNormalizationKind": "Default",
    "acceptedLineCount": 11,
    "rejectedLineCount": 2,
    "duration": "PT4M12S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Acoustic dataset"
}

Create dataset from data blocks

Örnek isteği

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/datasets

{
  "kind": "Acoustic",
  "locale": "en-US",
  "displayName": "My speech dataset name",
  "description": "My speech dataset description"
}

Örnek yanıt

Durum kodu:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1",
  "kind": "Acoustic",
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files",
    "commitBlocks": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/blocks:commit",
    "listBlocks": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/blocks",
    "uploadBlocks": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/blocks"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "NotStarted",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Acoustic dataset"
}

Tanımlar

Name	Description
Dataset	Veri kümesi
DatasetKind	DatasetKind
DatasetLinks	DatasetLinks
DatasetProperties	DatasetProperties
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Hata
ErrorCode	ErrorCode
InnerError	InnerError
Status	Durum
TextNormalizationKind	TextNormalizationKind

Dataset

Veri kümesi

Name	Tür	Description
contentUrl	string	Veri kümesi için verilerin URL'si.
createdDateTime	string	Nesnenin oluşturulduğu zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-AA-GGThh:mm:ssZ", bkz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ).
customProperties	object	Bu varlığın özel özellikleri. İzin verilen anahtar uzunluğu üst sınırı 64 karakter, izin verilen değer uzunluğu üst sınırı 256 karakter ve izin verilen girdi sayısı 10'dur.
description	string	Nesnenin açıklaması.
displayName	string	Nesnenin görünen adı.
kind	DatasetKind	DatasetKind Veri içeri aktarma türü.
lastActionDateTime	string	Geçerli durumun girildiği zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-AA-GGThh:mm:ssZ", bkz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ).
links	DatasetLinks	DatasetLinks
locale	string	Kapsanan verilerin yerel ayarı.
project	EntityReference	EntityReference
properties	DatasetProperties	DatasetProperties
self	string	Bu varlığın konumu.
status	Status	Durum API'nin geçerli durumunu açıklama

DatasetKind

Name	Tür	Description
Acoustic	string	Akustik veri kümesi.
AudioFiles	string	Ses dosyaları veri kümesi.
Language	string	Dil veri kümesi.
LanguageMarkdown	string	Bir dil markdown veri kümesi.
OutputFormatting	string	Ters metin normalleştirme, büyük harf kullanımı, reformasyon, küfür özelleştirme kuralları içeren ve veri kümesi doğrulama testlerini tanımlayan veri kümesi
Pronunciation	string	Söyleniş veri kümesi.

DatasetLinks

Name	Tür	Description
commitBlocks	string	Blokları kullanarak bir veri kümesini karşıya yüklerken blok listesinin işlendiği konum. Daha fazla ayrıntı için "Datasets_CommitBlocks" işlemine bakın.
files	string	Bu varlığın tüm dosyalarını alacak konum. Diğer ayrıntılar için "Datasets_ListFiles" işlemine bakın.
listBlocks	string	Blokları kullanarak bir veri kümesini karşıya yüklerken bu varlığın zaten karşıya yüklenmiş bloklarını listeleme konumu. Diğer ayrıntılar için bkz. "Datasets_GetBlocks" işlemi.
uploadBlocks	string	Bloklar kullanılarak veri kümesi karşıya yüklenirken blokların karşıya yüklendiği konum. Daha fazla ayrıntı için "Datasets_UploadBlock" işlemine bakın.

DatasetProperties

Name	Tür	Description
acceptedLineCount	integer	Bu veri kümesi için kabul edilen satır sayısı.
duration	string	Ses dosyaları içeriyorsa veri kümelerinin toplam süresi. Süre ISO 8601 süresi olarak kodlanmıştır ("PnYnMnDTnHnMnS", bkz https://en.wikipedia.org/wiki/ISO_8601#Durations. ).
email	string	İşlemin tamamlanması durumunda e-posta bildirimlerinin gönderilmesi için e-posta adresi. Değer, e-posta başarıyla gönderildikten sonra kaldırılır.
error	EntityError	EntityError
rejectedLineCount	integer	Bu veri kümesi için reddedilen satır sayısı.
textNormalizationKind	TextNormalizationKind	TextNormalizationKind Metin normalleştirme türü.

DetailedErrorCode

Name	Tür	Description
DataImportFailed	string	Veri içeri aktarma başarısız oldu.
DeleteNotAllowed	string	Silmeye izin verilmiyor.
DeployNotAllowed	string	Dağıtıma izin verilmiyor.
DeployingFailedModel	string	Başarısız modeli dağıtma.
EmptyRequest	string	Boş İstek.
EndpointCannotBeDefault	string	Uç nokta varsayılan olamaz.
EndpointNotUpdatable	string	Uç nokta güncelleştirilebilir değil.
EndpointWithoutLogging	string	Günlüğe kaydetmeden uç nokta.
ExceededNumberOfRecordingsUris	string	Kayıt sayısı aşıldı uris.
FailedDataset	string	Başarısız veri kümesi.
Forbidden	string	Yasak.
InUseViolation	string	Kullanım ihlali.
InaccessibleCustomerStorage	string	Erişilemez müşteri depolama alanı.
InvalidAdaptationMapping	string	Geçersiz uyarlama eşlemesi.
InvalidBaseModel	string	Geçersiz temel model.
InvalidCallbackUri	string	Geçersiz geri çağırma uri'si.
InvalidCollection	string	Geçersiz koleksiyon.
InvalidDataset	string	Geçersiz veri kümesi.
InvalidDocument	string	Geçersiz Belge.
InvalidDocumentBatch	string	Geçersiz Belge Toplu İşlemi.
InvalidLocale	string	Geçersiz yerel ayar.
InvalidLogDate	string	Geçersiz günlük tarihi.
InvalidLogEndTime	string	Geçersiz günlük bitiş saati.
InvalidLogId	string	Geçersiz günlük kimliği.
InvalidLogStartTime	string	Geçersiz günlük başlangıç saati.
InvalidModel	string	Geçersiz model.
InvalidModelUri	string	Geçersiz model uri'si.
InvalidParameter	string	Geçersiz parametre.
InvalidParameterValue	string	Geçersiz parametre değeri.
InvalidPayload	string	Geçersiz yük.
InvalidPermissions	string	Geçersiz izinler.
InvalidPrerequisite	string	Geçersiz önkoşul.
InvalidProductId	string	Geçersiz ürün kimliği.
InvalidProject	string	Geçersiz proje.
InvalidProjectKind	string	Geçersiz proje türü.
InvalidRecordingsUri	string	Geçersiz kayıt uri'si.
InvalidRequestBodyFormat	string	Geçersiz istek gövdesi biçimi.
InvalidSasValidityDuration	string	Geçersiz sas geçerlilik süresi.
InvalidSkipTokenForLogs	string	Günlükler için geçersiz atlama belirteci.
InvalidSourceAzureResourceId	string	Geçersiz kaynak Azure kaynak kimliği.
InvalidSubscription	string	Geçersiz abonelik.
InvalidTest	string	Geçersiz test.
InvalidTimeToLive	string	Geçersiz yaşam süresi.
InvalidTopForLogs	string	Günlükler için geçersiz üst.
InvalidTranscription	string	Geçersiz transkripsiyon.
InvalidWebHookEventKind	string	Geçersiz web kancası olay türü.
MissingInputRecords	string	Eksik Giriş Kayıtları.
ModelCopyOperationExists	string	Model kopyalama işlemi var.
ModelDeploymentNotCompleteState	string	Model dağıtımı tamamlanamadı durumu.
ModelDeprecated	string	Model kullanım dışı bırakıldı.
ModelExists	string	Model var.
ModelMismatch	string	Model uyuşmazlığı.
ModelNotDeployable	string	Model dağıtılamaz.
ModelVersionIncorrect	string	Model Sürümü Yanlış.
NoUtf8WithBom	string	Bom ile utf8 yok.
OnlyOneOfUrlsOrContainerOrDataset	string	Url'lerden, kapsayıcılardan veya veri kümelerinden yalnızca biri.
ProjectGenderMismatch	string	Proje cinsiyet uyuşmazlığı.
QuotaViolation	string	Kota ihlali.
SingleDefaultEndpoint	string	Tek varsayılan uç nokta.
SkuLimitsExist	string	Sku sınırları vardır.
SubscriptionNotFound	string	Abonelik bulunamadı.
UnexpectedError	string	Beklenmeyen hata.
UnsupportedClassBasedAdaptation	string	Desteklenmeyen sınıf tabanlı uyarlama.
UnsupportedDelta	string	Desteklenmeyen delta.
UnsupportedDynamicConfiguration	string	Desteklenmeyen dinamik yapılandırma.
UnsupportedFilter	string	Desteklenmeyen filtre.
UnsupportedLanguageCode	string	Desteklenmeyen dil kodu.
UnsupportedOrderBy	string	Desteklenmeyen sipariş ölçütü.
UnsupportedPagination	string	Desteklenmeyen sayfalandırma.
UnsupportedTimeRange	string	Desteklenmeyen zaman aralığı.

EntityError

Name	Tür	Description
code	string	Bu hatanın kodu.
message	string	Bu hatanın iletisi.

EntityReference

Name	Tür	Description
self	string	Başvuruda bulunılan varlığın konumu.

Error

Hata

Name	Tür	Description
code	ErrorCode	ErrorCode Üst düzey hata kodları.
details	Error[]	Hata ve/veya beklenen ilkelerle ilgili ek destekleyici ayrıntılar.
innerError	InnerError	InnerError adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellik hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
message	string	Üst düzey hata iletisi.
target	string	Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir.

ErrorCode

Name	Tür	Description
Conflict	string	Çakışma hata kodunu temsil ediyor.
Forbidden	string	Yasak hata kodunu temsil etme.
InternalCommunicationFailed	string	İç iletişim başarısız hata kodunu temsil ediyor.
InternalServerError	string	İç sunucu hata kodunu temsil ediyor.
InvalidArgument	string	Geçersiz bağımsız değişken hata kodunu temsil ediyor.
InvalidRequest	string	Geçersiz istek hata kodunu temsil ediyor.
NotAllowed	string	İzin verilmeyen hata kodunu temsil etme.
NotFound	string	Bulunamadı hata kodunu temsil ediyor.
PipelineError	string	İşlem hattı hata kodunu temsil eder.
ServiceUnavailable	string	Hizmet kullanılamıyor hata kodunu temsil etme.
TooManyRequests	string	Çok fazla istek hata kodunu temsil eder.
Unauthorized	string	Yetkisiz hata kodunu temsil etme.
UnprocessableEntity	string	İşlenemeyen varlık hata kodunu temsil eder.
UnsupportedMediaType	string	Desteklenmeyen medya türü hata kodunu temsil eder.

InnerError

Name	Tür	Description
code	DetailedErrorCode	DetailedErrorCode Ayrıntılı hata kodu sabit listesi.
details	object	Hata ve/veya beklenen ilkelerle ilgili ek destekleyici ayrıntılar.
innerError	InnerError	InnerError adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellik hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
message	string	Üst düzey hata iletisi.
target	string	Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir.

Status

Durum

Name	Tür	Description
Failed	string	Uzun süre çalışan işlem başarısız oldu.
NotStarted	string	Uzun süre çalışan işlem henüz başlatılmadı.
Running	string	Uzun süre çalışan işlem şu anda işleniyor.
Succeeded	string	Uzun süre çalışan işlem başarıyla tamamlandı.

TextNormalizationKind

Name	Tür	Description
Default	string	Varsayılan metin normalleştirmesi (ör. '2 ile 3' arası), en-US'de 'iki ile üç arası' ile değiştirilir.
None	string	Giriş metnine metin normalleştirmesi uygulanmaz. Bu, yalnızca karşıya yüklemeden önce metin normalleştirildiğinde kullanılması gereken bir geçersiz kılma seçeneğidir.

Aracılığıyla paylaş

Datasets - Create

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

Ocp-Apim-Subscription-Key

Authorization

Örnekler

Create a dataset with content url

Örnek isteği

Örnek yanıt

Create dataset from data blocks

Örnek isteği

Örnek yanıt

Tanımlar

Dataset

DatasetKind

DatasetLinks

DatasetProperties

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

InnerError

Status

TextNormalizationKind

Ek kaynaklar