REST Resource: projects.locations.processors

资源:处理器

用于描述 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,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

仅限输出。[仅限输出] 更新时间戳。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"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 处理器类型为预训练。预训练处理器由 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 自定义。

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 平台会尝试从 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 资源的配置 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 是一个用于列出预构建处理器的自定义传递动词。