REST Resource: projects.locations.processors

リソース: Processor

Processor オブジェクトについて説明するメッセージ。次の ID: 19

JSON 表現
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "displayName": string,
  "description": string,
  "processorType": enum (ProcessorType),
  "modelType": enum (ModelType),
  "customProcessorSourceInfo": {
    object (CustomProcessorSourceInfo)
  },
  "state": enum (ProcessorState),
  "processorIoSpec": {
    object (ProcessorIOSpec)
  },
  "configurationTypeurl": string,
  "supportedAnnotationTypes": [
    enum (StreamAnnotationType)
  ],
  "supportsPostProcessing": boolean
}
フィールド
name

string

リソースの名前。

createTime

string (Timestamp format)

出力専用。[出力専用] 作成タイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

出力専用。[出力のみ] 更新タイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

labels

map (key: string, value: string)

Key-Value ペアとしてのラベル。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

displayName

string

必須。プロセッサのわかりやすい表示名。

description

string

プロセッサの機能を説明する例文。

processorType

enum (ProcessorType)

出力専用。プロセッサ タイプ。

modelType

enum (ModelType)

モデルタイプ。

customProcessorSourceInfo

object (CustomProcessorSourceInfo)

お客様が作成したプロセッサのソース情報。

state

enum (ProcessorState)

出力専用。プロセッサの状態。

processorIoSpec

object (ProcessorIOSpec)

出力専用。[出力専用] プロセッサの入出力仕様。各タイプのプロセッサには、お客様が変更できない固定の入出力仕様があります。

configurationTypeurl

string

出力専用。対応する構成は、アプリケーションでプロセッサの動作をカスタマイズするために使用できます。

supportedAnnotationTypes[]

enum (StreamAnnotationType)

supportsPostProcessing

boolean

プロセッサがポスト処理をサポートしているかどうかを示します。

ProcessorType

タイプ

列挙型
PROCESSOR_TYPE_UNSPECIFIED プロセッサの種類が UNSPECIFIED です。
PRETRAINED プロセッサ タイプは PRETRAINED です。事前トレーニング済みプロセッサは、占有人数のカウントや人物のぼかしなど、最先端のビジョン データ処理機能を備えた Vision AI App Platform によって開発されています。事前トレーニング済みプロセッサは通常、一般公開されています。
CUSTOM プロセッサ タイプはカスタムです。カスタム プロセッサは、お客様がアップロードするか、他の Google Cloud プラットフォーム(Vertex AI など)からインポートする特殊なプロセッサです。カスタム プロセッサはクリエイターのみに表示されます。
CONNECTOR プロセッサ タイプ CONNECTOR。コネクタ プロセッサは、アプリケーションの I/O を実行する特別なプロセッサです。データを処理するのではなく、他のプロセッサにデータを配信するか、他のプロセッサからデータを受信します。

ModelType

Vision AI App Platform でサポートされているすべてのモデルタイプ。

列挙型
MODEL_TYPE_UNSPECIFIED プロセッサの種類が UNSPECIFIED です。
IMAGE_CLASSIFICATION モデルタイプ: 画像分類。
OBJECT_DETECTION モデルタイプはオブジェクト検出です。
VIDEO_CLASSIFICATION モデルタイプ: 動画分類。
VIDEO_OBJECT_TRACKING モデルタイプ: オブジェクト トラッキング。
VIDEO_ACTION_RECOGNITION モデルタイプは動作認識です。
OCCUPANCY_COUNTING モデルタイプ: 占有人数のカウント。
PERSON_BLUR モデルタイプ: 人のぼかし。
VERTEX_CUSTOM モデルタイプは Vertex Custom です。

CustomProcessorSourceInfo

カスタム プロセッサのソース情報を記述します。

JSON 表現
{
  "sourceType": enum (SourceType),
  "additionalInfo": {
    string: string,
    ...
  },
  "modelSchema": {
    object (ModelSchema)
  },

  // Union field artifact_path can be only one of the following:
  "vertexModel": string
  // End of list of possible types for union field artifact_path.
}
フィールド
sourceType

enum (SourceType)

カスタム プロセッサの機能を保持する元のプロダクト。

additionalInfo

map (key: string, value: string)

出力専用。インポートされたカスタム プロセッサに関する追加情報。データは、プロセッサの作成時にアプリ プラットフォームによって入力されます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

modelSchema

object (ModelSchema)

モデルのシグネチャを指定するモデル スキーマ ファイル。VERTEX_CUSTOM モデルの場合、インスタンス スキーマが必要です。プロセッサの作成時にインスタンス スキーマが指定されていない場合、VisionAI Platform は Vertex からインスタンス スキーマを取得しようとします。インスタンス スキーマが存在しない場合、作成は失敗します。

共用体フィールド artifact_path。App Platform がカスタム プロセッサのアーティファクトを読み込むパス。artifact_path は次のいずれかになります。
vertexModel

string

Vertex AI プラットフォームでホストされている元のモデルのリソース名。

SourceType

インポートされたカスタム プロセッサのソースタイプ。

列挙型
SOURCE_TYPE_UNSPECIFIED ソースタイプが指定されていません。
VERTEX_AUTOML Vertex AutoML プロダクトのカスタム プロセッサ。
VERTEX_CUSTOM Vertex の一般的なカスタムモデルから取得したカスタム プロセッサ。
PRODUCT_RECOGNIZER 商品認識ツールのソース。

ModelSchema

スキーマは OpenAPI 3.0.2 のスキーマ オブジェクトとして定義されます。

JSON 表現
{
  "instancesSchema": {
    object (GcsSource)
  },
  "parametersSchema": {
    object (GcsSource)
  },
  "predictionsSchema": {
    object (GcsSource)
  }
}
フィールド
instancesSchema

object (GcsSource)

予測リクエストと説明リクエストで使用される単一インスタンスの形式を定義する YAML ファイルの Cloud Storage 内の場所。

parametersSchema

object (GcsSource)

予測パラメータと説明パラメータを定義する YAML ファイルの Cloud Storage 内の場所。

predictionsSchema

object (GcsSource)

単一の予測または説明の形式を定義する YAML ファイルの Cloud Storage 内の場所。

GcsSource

Google Cloud Storage 上で、入力コンテンツの配置先とする場所。

JSON 表現
{
  "uris": [
    string
  ]
}
フィールド
uris[]

string

必須。Google Cloud Storage パスへの参照。

ProcessorState

列挙型
PROCESSOR_STATE_UNSPECIFIED 未指定のプロセッサの状態。
CREATING プロセッサの作成中(使用できる状態ではない)。
ACTIVE プロセッサが使用可能になりました。
DELETING プロセッサが削除中です(使用できません)。
FAILED プロセッサが削除されたか、作成に失敗しました。

ProcessorIOSpec

プロセッサの入出力仕様を説明するメッセージ。

JSON 表現
{
  "graphInputChannelSpecs": [
    {
      object (GraphInputChannelSpec)
    }
  ],
  "graphOutputChannelSpecs": [
    {
      object (GraphOutputChannelSpec)
    }
  ],
  "instanceResourceInputBindingSpecs": [
    {
      object (InstanceResourceInputBindingSpec)
    }
  ],
  "instanceResourceOutputBindingSpecs": [
    {
      object (InstanceResourceOutputBindingSpec)
    }
  ]
}
フィールド
graphInputChannelSpecs[]

object (GraphInputChannelSpec)

input_channel_specs を持つプロセッサの場合、プロセッサを別のプロセッサに明示的に接続する必要があります。

graphOutputChannelSpecs[]

object (GraphOutputChannelSpec)

現在のプロセッサの出力アーティファクトの仕様。

instanceResourceInputBindingSpecs[]

object (InstanceResourceInputBindingSpec)

アプリケーション インスタンスからフィードする必要がある入力リソース。

instanceResourceOutputBindingSpecs[]

object (InstanceResourceOutputBindingSpec)

プロセッサがインスタンスごとに生成する出力リソース。ここで明示的にリストされている出力バインディングを除き、すべてのプロセッサの GraphOutputChannel をストリーム リソースにバインドできます。バインディング名は、GraphOutputChannel の名前と同じになります。

GraphInputChannelSpec

入力チャネルの仕様に関するメッセージ。

JSON 表現
{
  "name": string,
  "dataType": enum (DataType),
  "acceptedDataTypeUris": [
    string
  ],
  "required": boolean,
  "maxConnectionAllowed": string
}
フィールド
name

string

現在の入力チャンネルの名前。

dataType

enum (DataType)

現在の入力チャネルのデータ型。このフィールドに複数の値が設定されている場合、この入力チャネルはこれらの異なるデータ型のいずれかに接続できます。

acceptedDataTypeUris[]

string

指定した場合、プロセッサに接続できるのは、指定した詳細なデータ型のみです。たとえば、MEDIA の場合は JPEG ストリーム、PROTO タイプの場合は PredictionResult proto です。指定しない場合は、任意のプロトコルが受け入れられます。

required

boolean

現在の入力チャネルがプロセッサで必要かどうか。たとえば、必須の映像入力とオプションの音声入力を備えたプロセッサの場合、映像入力がない場合、申請は不承認になりますが、映像入力が存在する限り、音声入力は省略できます。

maxConnectionAllowed

string (int64 format)

この入力チャネルに接続できる入力エッジの数。0 は制限なしを意味します。

DataType

サポートされているすべてのデータ型。

列挙型
DATA_TYPE_UNSPECIFIED DataType のデフォルト値。
VIDEO H264 などの動画データタイプ。
IMAGE 画像データの種類。
PROTO Protobuf データ型。通常は一般的なデータ BLOB に使用されます。

GraphOutputChannelSpec

出力チャネルの仕様に関するメッセージ。

JSON 表現
{
  "name": string,
  "dataType": enum (DataType),
  "dataTypeUri": string
}
フィールド
name

string

現在の出力チャネルの名前。

dataType

enum (DataType)

現在の出力チャネルのデータ型。

dataTypeUri

string

InstanceResourceInputBindingSpec

インスタンス リソース チャネルの仕様に関するメッセージ。外部リソースは、アプリケーション グラフには表現されない仮想ノードです。各プロセッサはアウトグラフ仕様を表現するため、お客様は外部ソースまたは宛先をオーバーライドして、

JSON 表現
{
  "name": string,

  // Union field resource_type can be only one of the following:
  "configTypeUri": string,
  "resourceTypeUri": string
  // End of list of possible types for union field resource_type.
}
フィールド
name

string

入力バインディングの名前。プロセッサ内で一意です。

共用体フィールド resource_type

resource_type は次のいずれかになります。

configTypeUri

string

Googleapis リソースを含む構成プロト。たとえば、type.googleapis.com/google.cloud.vision.v1.StreamWithAnnotation などです。

resourceTypeUri

string

Googleapis リソースの直接型の URL(type.googleapis.com/google.cloud.vision.v1.Asset など)

InstanceResourceOutputBindingSpec

JSON 表現
{
  "name": string,
  "resourceTypeUri": string,
  "explicit": boolean
}
フィールド
name

string

出力バインディングの名前。プロセッサ内で一意です。

resourceTypeUri

string

使用可能な出力リソースのリソースタイプ URI。

explicit

boolean

出力リソースをインスタンスで明示的に設定する必要があるかどうか。false の場合、必要に応じてプロセッサが自動的に生成します。

メソッド

create

指定されたプロジェクトとロケーションに新しいプロセッサを作成します。

delete

1 つのプロセッサを削除します。

get

1 つのプロセッサの詳細を取得します。

list

指定されたプロジェクトとロケーションのプロセッサを一覧表示します。

patch

単一のプロセッサのパラメータを更新します。

prebuilt

ListPrebuiltProcessors は、ビルド済みプロセッサを一覧表示するカスタム パススルー動詞です。