REST Resource: projects.locations.processors

• 資源：處理器
  • JSON 表示法
• ProcessorType
• ModelType
• CustomProcessorSourceInfo
  • JSON 表示法
• SourceType
• ModelSchema
  • JSON 表示法
• GcsSource
  • JSON 表示法
• ProcessorState
• ProcessorIOSpec
  • JSON 表示法
• GraphInputChannelSpec
  • JSON 表示法
• DataType
• GraphOutputChannelSpec
  • JSON 表示法
• InstanceResourceInputBindingSpec
  • JSON 表示法
• InstanceResourceOutputBindingSpec
  • JSON 表示法
• 方法

資源：處理器

說明 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 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime	string (Timestamp format) 僅供輸出。[僅供輸出] 更新時間戳記。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
labels	map (key: string, value: string) 標籤為鍵/值組合。 包含 "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 模型，必須提供執行個體結構定義。如果在建立處理器時未指定執行個體結構定義，Vision AI 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) 處理器會為每個執行個體產生的輸出資源。除了這裡明確列出的輸出繫結之外，所有處理器的 GraphOutputChannels 都可以繫結至串流資源。繫結名稱會與 GraphOutputChannel 的名稱相同。

GraphInputChannelSpec

輸入管道規格訊息。

JSON 表示法
{ "name": string, "dataType": enum (DataType), "acceptedDataTypeUris": [ string ], "required": boolean, "maxConnectionAllowed": string }

欄位
name	string 目前輸入頻道的名稱。
dataType	enum (DataType) 目前輸入頻道的資料類型。如果這個欄位有超過 1 個值，表示這個輸入管道可以連結至這些不同資料類型中的任一類型。
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 資源的設定 proto。例如 type.googleapis.com/google.cloud.vision.v1.StreamWithAnnotation
resourceTypeUri	string Googleapis 資源的直接類型網址，例如 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	刪除單一處理器。
get	取得單一處理器的詳細資料。
list	列出指定專案和位置中的處理器。
patch	更新單一處理器的參數。
prebuilt	ListPrebuiltProcessors 是自訂的傳送動詞，可列出預先建構的處理器。