Datasets - Create

  • リファレンス
サービス:
Azure AI Services
API バージョン:
2023-04-01-preview

新しいデータセットを登録します。

返される状態コード:

  • 201: 操作が正常に完了しました。
  • 400: 要求の形式が正しくありません。
  • 409: 指定した名前のデータセットが既に存在します。
PUT /datasets/{name}?api-version=2023-04-01-preview

URI パラメーター

名前 / 必須 型 説明
name
 path True

string

登録後にデータセットを一意に識別するために使用できる名前。

正規表現パターン: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version
 query True

string

要求された API バージョン。

要求本文

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

名前 型 説明
annotationFileUris

string[]

注釈ファイルに対する絶対 URI の一覧。各 URI は、Azure Storage BLOB コンテナーに BLOB として格納する必要があります。 各ファイルは、指定された AnnotationKind の COCO 形式に従う必要があります。各イメージ パスは BLOB コンテナー内の BLOB への絶対 URI です。 Computer Vision リソースには、注釈ファイルと参照されているすべてのイメージ ファイルを読み取るアクセス許可が必要です。 これを行うには、Computer Vision リソースのシステム マネージド ID を有効にしてから、注釈ファイルとイメージ ファイルを含む BLOB コンテナーから読み取るアクセス許可を持つロールに ID を割り当てます。
annotationKind

AnnotationKind

注釈ファイルに含まれる注釈の種類。 たとえば、"ImageClassification" は、注釈ファイルに、多クラス画像分類モデルをトレーニングまたはテストするためのオブジェクト ラベルが含まれていることを指定します。
authentication

StorageAuthenticationSettingsApiModel

ストレージ認証の設定について説明します。
createdDateTime

string

読み取り専用。 データセットが最初に登録された日時 (UTC)。
customProperties

object

アプリケーションで使用する任意のキーと値のペアのディクショナリ。 最大 10 個のキーと値のペアを使用できます。
eTag

string

読み取り専用。 データセットの最新の ETag。 データセットを更新または削除するときに、'If-Match' ヘッダーと共に使用できます。
name

string

読み取り専用。 データセットを一意に識別するために使用される名前。
updatedDateTime

string

読み取り専用。 データセットが最後に更新された日時 (UTC)。

応答

名前 型 説明
201 Created

Dataset

作成済み
Other Status Codes

ErrorResponse

エラー

ヘッダー

x-ms-error-code: string

例

RegisterDataset_ImageClassification

要求のサンプル

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

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

応答のサンプル

状態コード:
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"
}

定義

名前 説明
AnnotationKind

注釈ファイルに含まれる注釈の種類。 たとえば、"ImageClassification" は、注釈ファイルに、多クラス画像分類モデルをトレーニングまたはテストするためのオブジェクト ラベルが含まれていることを指定します。
Dataset

モデルのトレーニングまたはテストに使用できる画像と注釈のセットを表すデータセットについて説明します。
ErrorResponse

エラーが発生したときに返される応答。
ErrorResponseDetails

エラー情報。
ErrorResponseInnerError

詳細なエラー。
StorageAuthenticationKind

ストレージ認証の種類。
StorageAuthenticationSettingsApiModel

ストレージ認証の設定について説明します。

AnnotationKind

注釈ファイルに含まれる注釈の種類。 たとえば、"ImageClassification" は、注釈ファイルに、多クラス画像分類モデルをトレーニングまたはテストするためのオブジェクト ラベルが含まれていることを指定します。

名前 型 説明
imageClassification

string

imageObjectDetection

string

Dataset

モデルのトレーニングまたはテストに使用できる画像と注釈のセットを表すデータセットについて説明します。

名前 型 説明
annotationFileUris

string[]

注釈ファイルに対する絶対 URI の一覧。各 URI は、Azure Storage BLOB コンテナーに BLOB として格納する必要があります。 各ファイルは、指定された AnnotationKind の COCO 形式に従う必要があります。各イメージ パスは BLOB コンテナー内の BLOB への絶対 URI です。 Computer Vision リソースには、注釈ファイルと参照されているすべてのイメージ ファイルを読み取るアクセス許可が必要です。 これを行うには、Computer Vision リソースのシステム マネージド ID を有効にしてから、注釈ファイルとイメージ ファイルを含む BLOB コンテナーから読み取るアクセス許可を持つロールに ID を割り当てます。
annotationKind

AnnotationKind

注釈ファイルに含まれる注釈の種類。 たとえば、"ImageClassification" は、注釈ファイルに、多クラス画像分類モデルをトレーニングまたはテストするためのオブジェクト ラベルが含まれていることを指定します。
authentication

StorageAuthenticationSettingsApiModel

ストレージ認証の設定について説明します。
createdDateTime

string

読み取り専用。 データセットが最初に登録された日時 (UTC)。
customProperties

object

アプリケーションで使用する任意のキーと値のペアのディクショナリ。 最大 10 個のキーと値のペアを使用できます。
eTag

string

読み取り専用。 データセットの最新の ETag。 データセットを更新または削除するときに、'If-Match' ヘッダーと共に使用できます。
name

string

読み取り専用。 データセットを一意に識別するために使用される名前。
updatedDateTime

string

読み取り専用。 データセットが最後に更新された日時 (UTC)。

ErrorResponse

エラーが発生したときに返される応答。

名前 型 説明
error

ErrorResponseDetails

エラー情報。

ErrorResponseDetails

エラー情報。

名前 型 説明
code

string

エラー コード。
details

ErrorResponseDetails[]

詳細なエラーの一覧。
innererror

ErrorResponseInnerError

詳細なエラー。
message

string

エラー メッセージ。
target

string

エラーのターゲット。

ErrorResponseInnerError

詳細なエラー。

名前 型 説明
code

string

エラー コード。
innererror

ErrorResponseInnerError

詳細なエラー。
message

string

エラー メッセージ。

StorageAuthenticationKind

ストレージ認証の種類。

名前 型 説明
managedIdentity

string

none

string

sas

string

StorageAuthenticationSettingsApiModel

ストレージ認証の設定について説明します。

名前 型 説明
kind

StorageAuthenticationKind

ストレージ認証の種類。
sasToken

string

省略可能。 コンテナーにアクセスするための sas トークン。 Kind = Sas の場合にのみ必要です。