Datasets - Update

サービス:: Azure AI Services

API バージョン:: v3.2-preview.2

ID によって識別されるデータセットの変更可能な詳細を更新します。

PATCH {endpoint}/speechtotext/v3.2-preview.2/datasets/{id}

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名、例: https://westus.api.cognitive.microsoft.com)。
id	path	True	string (uuid)	データセットの識別子。

要求本文

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

名前	型	説明
customProperties	object	このエンティティのカスタムプロパティ。許可されるキーの最大長は 64 文字、最大許容値の長さは 256 文字、許可されるエントリの数は 10 です。
description	string	オブジェクトの説明。
displayName	string	オブジェクトの名前。
project	EntityReference	EntityReference

応答

名前	型	説明
200 OK	Dataset	わかりましたヘッダー Retry-After: integer
Other Status Codes	Error	エラーが発生しました。

名前

型

説明

200 OK

Dataset

わかりました

ヘッダー

Retry-After: integer

Other Status Codes

Error

エラーが発生しました。

セキュリティ

Ocp-Apim-Subscription-Key

コグニティブサービスアカウントキーをここで指定します。

型: apiKey
/: header

Authorization

このリージョンの STS によって返される JWT からアクセストークンを指定します。 STS URL に次のクエリ文字列を追加して、トークンに管理スコープを追加してください: ?scope=speechservicesmanagement

型: apiKey
/: header

例

Update a dataset

要求のサンプル

HTTP

PATCH {endpoint}/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1

{
  "displayName": "Updated dataset name",
  "description": "Updated dataset description",
  "customProperties": {
    "key": "value"
  }
}

応答のサンプル

状態コード:: 200

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

定義

名前	説明
Dataset	データセット
DatasetKind	DatasetKind
DatasetLinks	DatasetLinks
DatasetProperties	DatasetProperties
DatasetUpdate	DatasetUpdate
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	エラー
ErrorCode	エラーコード
InnerError	InnerError
Status	ステータス
TextNormalizationKind	TextNormalizationKind

Dataset

Object

データセット

名前	型	説明
contentUrl	string (uri)	データセットのデータの URL。
createdDateTime	string (date-time)	オブジェクトが作成されたときのタイムスタンプ。タイムスタンプは ISO 8601 の日付と時刻の形式 ("YYYY-MM-DDThh:mm:ssZ"、 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations参照) としてエンコードされます。
customProperties	object	このエンティティのカスタムプロパティ。許可されるキーの最大長は 64 文字、最大許容値の長さは 256 文字、許可されるエントリの数は 10 です。
description	string	オブジェクトの説明。
displayName	string minLength: 1	オブジェクトの表示名。
kind	DatasetKind	DatasetKind データインポートの種類。
lastActionDateTime	string (date-time)	現在の状態が入力されたときのタイムスタンプ。タイムスタンプは ISO 8601 の日付と時刻の形式 ("YYYY-MM-DDThh:mm:ssZ"、 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations参照) としてエンコードされます。
links	DatasetLinks	DatasetLinks
locale	string minLength: 1	格納されているデータのロケール。
project	EntityReference	EntityReference
properties	DatasetProperties	DatasetProperties
self	string (uri)	このエンティティの場所。
status	Status	ステータス API の現在の状態について説明する

DatasetKind

列挙

DatasetKind

値	説明
Language	言語データセット。
Acoustic	音響データセット。
Pronunciation	発音データセット。
AudioFiles	オーディオファイルデータセット。
LanguageMarkdown	言語マークダウンデータセット。
OutputFormatting	逆テキスト正規化、大文字と小文字の変換、再入力、不適切な表現をカスタマイズするルールを含むデータセット。また、データセット検証のテストも定義します

DatasetLinks

Object

DatasetLinks

名前	型	説明
commitBlocks	string (uri)	ブロックを使用してデータセットをアップロードするときにブロックの一覧をコミットする場所。詳細については、操作 "Datasets_CommitBlocks" を参照してください。
files	string (uri)	このエンティティのすべてのファイルを取得する場所。詳細については、操作 "Datasets_ListFiles" を参照してください。
listBlocks	string (uri)	ブロックを使用してデータセットをアップロードするときに、このエンティティのアップロード済みブロックを一覧表示する場所。詳細については、操作 "Datasets_GetBlocks" を参照してください。
uploadBlocks	string (uri)	ブロックを使用してデータセットをアップロードするときにブロックをアップロードする場所。詳細については、操作 "Datasets_UploadBlock" を参照してください。

DatasetProperties

Object

DatasetProperties

名前	型	説明
acceptedLineCount	integer (int32)	このデータセットに対して受け入れられる行数。
duration	string	オーディオファイルが含まれている場合のデータセットの合計期間。期間は ISO 8601 期間としてエンコードされます (「PnYnMnDTnHnMnS」を参照 https://en.wikipedia.org/wiki/ISO_8601#Durations)。
email	string	操作が完了した場合に電子メール通知を送信する電子メールアドレス。この値は、電子メールを正常に送信した後に削除されます。
error	EntityError	EntityError
rejectedLineCount	integer (int32)	このデータ・セットに対して拒否された行数。
textNormalizationKind	TextNormalizationKind	TextNormalizationKind テキスト正規化の種類。

DatasetUpdate

Object

DatasetUpdate

名前	型	説明
customProperties	object	このエンティティのカスタムプロパティ。許可されるキーの最大長は 64 文字、最大許容値の長さは 256 文字、許可されるエントリの数は 10 です。
description	string	オブジェクトの説明。
displayName	string	オブジェクトの名前。
project	EntityReference	EntityReference

DetailedErrorCode

列挙

DetailedErrorCode

値	説明
InvalidParameterValue	パラメーター値が無効です。
InvalidRequestBodyFormat	要求本文の形式が無効です。
EmptyRequest	空の要求。
MissingInputRecords	入力レコードがありません。
InvalidDocument	ドキュメントが無効です。
ModelVersionIncorrect	モデルのバージョンが正しくありません。
InvalidDocumentBatch	ドキュメントバッチが無効です。
UnsupportedLanguageCode	サポートされていない言語コード。
DataImportFailed	データのインポートに失敗しました。
InUseViolation	使用中の違反。
InvalidLocale	ロケールが無効です。
InvalidBaseModel	ベースモデルが無効です。
InvalidAdaptationMapping	適応マッピングが無効です。
InvalidDataset	データセットが無効です。
InvalidTest	テストが無効です。
FailedDataset	失敗したデータセット。
InvalidModel	モデルが無効です。
InvalidTranscription	文字起こしが無効です。
InvalidPayload	ペイロードが無効です。
InvalidParameter	パラメーターが無効です。
EndpointWithoutLogging	ログ記録なしのエンドポイント。
InvalidPermissions	アクセス許可が無効です。
InvalidPrerequisite	前提条件が無効です。
InvalidProductId	製品 ID が無効です。
InvalidSubscription	サブスクリプションが無効です。
InvalidProject	プロジェクトが無効です。
InvalidProjectKind	プロジェクトの種類が無効です。
InvalidRecordingsUri	無効な記録 URI。
OnlyOneOfUrlsOrContainerOrDataset	URL またはコンテナーまたはデータセットのいずれか 1 つだけ。
ExceededNumberOfRecordingsUris	記録 URI の数を超えました。
ModelMismatch	モデルの不一致。
ProjectGenderMismatch	プロジェクトの性別の不一致。
ModelDeprecated	モデルは非推奨になりました。
ModelExists	モデルが存在します。
ModelNotDeployable	モデルはデプロイできません。
EndpointNotUpdatable	エンドポイントは更新できません。
SingleDefaultEndpoint	単一の既定のエンドポイント。
EndpointCannotBeDefault	エンドポイントを既定にすることはできません。
InvalidModelUri	モデル URI が無効です。
SubscriptionNotFound	サブスクリプションが見つかりません。
QuotaViolation	クォータ違反。
UnsupportedDelta	サポートされていないデルタ。
UnsupportedFilter	サポートされていないフィルター。
UnsupportedPagination	サポートされていない改ページ位置。
UnsupportedDynamicConfiguration	サポートされていない動的構成。
UnsupportedOrderBy	サポートされていない注文者。
NoUtf8WithBom	bom を含む utf8 はありません。
ModelDeploymentNotCompleteState	モデルのデプロイが完了していない状態です。
SkuLimitsExist	SKU の制限が存在します。
DeployingFailedModel	失敗したモデルのデプロイ。
UnsupportedTimeRange	サポートされていない時間範囲。
InvalidLogDate	ログの日付が無効です。
InvalidLogId	無効なログ ID です。
InvalidLogStartTime	ログの開始時刻が無効です。
InvalidLogEndTime	ログの終了時刻が無効です。
InvalidTopForLogs	ログの top が無効です。
InvalidSkipTokenForLogs	ログのスキップトークンが無効です。
DeleteNotAllowed	削除は許可されていません。
Forbidden	禁じられた。
DeployNotAllowed	デプロイは許可されていません。
UnexpectedError	予期しないエラー。
InvalidCollection	コレクションが無効です。
InvalidCallbackUri	コールバック URI が無効です。
InvalidSasValidityDuration	SAS の有効期間が無効です。
InaccessibleCustomerStorage	お客様のストレージにアクセスできません。
UnsupportedClassBasedAdaptation	サポートされていないクラスベースの適応。
InvalidWebHookEventKind	Web フックイベントの種類が無効です。
InvalidTimeToLive	有効期限が無効です。
InvalidSourceAzureResourceId	ソース Azure リソース ID が無効です。
ModelCopyOperationExists	モデルのコピー操作が存在します。

EntityError

Object

EntityError

名前	型	説明
code	string	このエラーのコード。
message	string	このエラーのメッセージ。

EntityReference

Object

EntityReference

名前	型	説明
self	string (uri)	参照先エンティティの場所。

Error

Object

エラー

名前	型	説明
code	ErrorCode	エラーコード大まかなエラーコード。
details	Error[]	エラーや予想されるポリシーに関するその他のサポートの詳細。
innerError	InnerError	InnerError https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owで利用可能な Cognitive Services API ガイドラインに準拠した新しい内部エラー形式。これには、必須プロパティ ErrorCode、メッセージ、および省略可能なプロパティターゲット、details(キー値ペア)、内部エラー (入れ子にできます) が含まれます。
message	string	高レベルのエラーメッセージ。
target	string	エラーの原因。たとえば、無効なドキュメントの場合は "documents" または "document id" になります。

ErrorCode

列挙

エラーコード

値	説明
InvalidRequest	無効な要求エラーコードを表します。
InvalidArgument	無効な引数のエラーコードを表します。
InternalServerError	内部サーバーエラーコードを表します。
ServiceUnavailable	サービスを使用できないエラーコードを表します。
NotFound	見つからないエラーコードを表します。
PipelineError	パイプラインエラーコードを表します。
Conflict	競合エラーコードを表します。
InternalCommunicationFailed	内部通信に失敗したエラーコードを表します。
Forbidden	禁止されているエラーコードを表します。
NotAllowed	許可されていないエラーコードを表します。
Unauthorized	承認されていないエラーコードを表します。
UnsupportedMediaType	サポートされていないメディアの種類のエラーコードを表します。
TooManyRequests	要求の数が多すぎるエラーコードを表します。
UnprocessableEntity	処理不可能なエンティティエラーコードを表します。

InnerError

Object

InnerError

名前	型	説明
code	DetailedErrorCode	DetailedErrorCode 詳細なエラーコード列挙型。
details	object	エラーや予想されるポリシーに関するその他のサポートの詳細。
innerError	InnerError	InnerError https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owで利用可能な Cognitive Services API ガイドラインに準拠した新しい内部エラー形式。これには、必須プロパティ ErrorCode、メッセージ、および省略可能なプロパティターゲット、details(キー値ペア)、内部エラー (入れ子にできます) が含まれます。
message	string	高レベルのエラーメッセージ。
target	string	エラーの原因。たとえば、無効なドキュメントの場合は "documents" または "document id" になります。

Status

列挙

ステータス

値	説明
NotStarted	実行時間の長い操作がまだ開始されていません。
Running	実行時間の長い操作は現在処理中です。
Succeeded	実行時間の長い操作が正常に完了しました。
Failed	実行時間の長い操作が失敗しました。

TextNormalizationKind

列挙

TextNormalizationKind

値	説明
Default	既定のテキスト正規化 (たとえば、"2 から 3" は、en-USでは '2 から 3' に置き換えられます)。
None	入力テキストにはテキスト正規化は適用されません。これは、アップロード前にテキストを正規化する場合にのみ使用するオーバーライドオプションです。

次の方法で共有

Datasets - Update

URI パラメーター

要求本文

応答

セキュリティ

Ocp-Apim-Subscription-Key

Authorization

例

Update a dataset

要求のサンプル

応答のサンプル

定義

Dataset

DatasetKind

DatasetLinks

DatasetProperties

DatasetUpdate

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

InnerError

Status

TextNormalizationKind