REST Resource: projects.locations.processors

Recurso: Procesador

Mensaje que describe el objeto del procesador. ID siguiente: 17

Representación 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)
  ]
}
Campos
name

string

nombre del recurso.

createTime

string (Timestamp format)

Solo salida. [Solo salida] Marca de tiempo de creación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. [Solo salida] Marca de tiempo de actualización.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Etiquetas como pares clave-valor

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

displayName

string

Obligatorio. Es un nombre visible fácil de usar para el procesador.

description

string

Son oraciones ilustrativas para describir la funcionalidad del procesador.

processorType

enum (ProcessorType)

Solo salida. Tipo de procesador.

modelType

enum (ModelType)

Tipo de modelo.

customProcessorSourceInfo

object (CustomProcessorSourceInfo)

Información de la fuente del procesador creado por el cliente

state

enum (ProcessorState)

Solo salida. Estado del procesador

processorIoSpec

object (ProcessorIOSpec)

Solo salida. [Solo salida] Las especificaciones de entrada y salida de un procesador. Cada tipo de procesador tiene especificaciones de entrada y salida fijas que el cliente no puede modificar.

configurationTypeurl

string

Solo salida. La configuración correspondiente se puede usar en la aplicación para personalizar el comportamiento del procesador.

supportedAnnotationTypes[]

enum (StreamAnnotationType)

ProcessorType

Tipo

Enums
PROCESSOR_TYPE_UNSPECIFIED Tipo de procesador UNSPECIFIED.
PRETRAINED Tipo de procesador PREENTRENADO. El procesador previamente entrenado es desarrollado por Vision AI App Platform con una funcionalidad de procesamiento de datos de visión de vanguardia, como el recuento de ocupación o el desenfoque de personas. Por lo general, el procesador con entrenamiento previo está disponible para el público.
CUSTOM Tipo de procesador: PERSONALIZADO. Los procesadores personalizados son procesadores especializados que los clientes suben o importan desde otra plataforma de Google Cloud (por ejemplo, Vertex AI). Solo el creador puede ver el procesador personalizado.
CONNECTOR CONECTOR DE TIPO DE PROCESADOR. Los procesadores de conectores son procesadores especiales que realizan E/S para la aplicación. No procesan los datos, sino que los entregan a otros procesadores o reciben datos de otros procesadores.

ModelType

Todos los tipos de modelos compatibles en la plataforma de apps de Vision AI

Enums
MODEL_TYPE_UNSPECIFIED Tipo de procesador UNSPECIFIED.
IMAGE_CLASSIFICATION Tipo de modelo: Clasificación de imágenes.
OBJECT_DETECTION Detección de objetos de tipo de modelo
VIDEO_CLASSIFICATION Tipo de modelo: Clasificación de videos
VIDEO_OBJECT_TRACKING Seguimiento de objetos de tipo de modelo
VIDEO_ACTION_RECOGNITION Tipo de modelo: Reconocimiento de acciones
OCCUPANCY_COUNTING Recuento de ocupación del tipo de modelo
PERSON_BLUR Desenfoque de personas del tipo de modelo
VERTEX_CUSTOM Tipo de modelo Vertex personalizado.

CustomProcessorSourceInfo

Describe la información de origen de un procesador personalizado.

Representación JSON
{
  "sourceType": enum (SourceType),
  "additionalInfo": {
    string: string,
    ...
  },
  "modelSchema": {
    object (ModelSchema)
  },
  "vertexModel": string
}
Campos
sourceType

enum (SourceType)

El producto original que contiene la funcionalidad del procesador personalizado.

additionalInfo

map (key: string, value: string)

Solo salida. Es información adicional relacionada con el procesador personalizado importado. La plataforma de la app completa los datos durante la creación del procesador.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

modelSchema

object (ModelSchema)

Archivos de esquemas de modelos que especifican la firma del modelo. Para los modelos VERTEX_CUSTOM, se requiere el esquema de instancias. Si no se especifica el esquema de instancias durante la creación del procesador, VisionAI Platform intentará obtenerlo de Vertex. Si no existe, la creación fallará.

vertexModel

string

El modelo original del nombre del recurso alojado en la plataforma de Vertex AI.

SourceType

Es el tipo de fuente del procesador personalizado importado.

Enums
SOURCE_TYPE_UNSPECIFIED No se especificó el tipo de fuente.
VERTEX_AUTOML Procesadores personalizados provenientes del producto AutoML de Vertex
VERTEX_CUSTOM Procesadores personalizados provenientes de modelos personalizados generales de Vertex

ModelSchema

El esquema se define como un objeto de esquema de OpenAPI 3.0.2.

Representación JSON
{
  "instancesSchema": {
    object (GcsSource)
  },
  "parametersSchema": {
    object (GcsSource)
  },
  "predictionsSchema": {
    object (GcsSource)
  }
}
Campos
instancesSchema

object (GcsSource)

Ubicación de Cloud Storage a un archivo YAML que define el formato de una única instancia que se usa en las solicitudes de predicción y explicación.

parametersSchema

object (GcsSource)

Ubicación de Cloud Storage a un archivo YAML que define los parámetros de predicción y explicación.

predictionsSchema

object (GcsSource)

Ubicación de Cloud Storage a un archivo YAML que define el formato de una única predicción o explicación.

GcsSource

La ubicación de Google Cloud Storage para el contenido de entrada.

Representación JSON
{
  "uris": [
    string
  ]
}
Campos
uris[]

string

Obligatorio. Referencias a rutas de acceso de Google Cloud Storage

ProcessorState

Enums
PROCESSOR_STATE_UNSPECIFIED Estado del procesador sin especificar.
CREATING Se está creando el procesador (no está listo para usarse).
ACTIVE El procesador está listo para usarse.
DELETING Se está borrando el procesador (no está listo para usarse).
FAILED Se borró el procesador o no se pudo crear .

ProcessorIOSpec

Es un mensaje que describe las especificaciones de entrada y salida de un procesador.

Representación JSON
{
  "graphInputChannelSpecs": [
    {
      object (GraphInputChannelSpec)
    }
  ],
  "graphOutputChannelSpecs": [
    {
      object (GraphOutputChannelSpec)
    }
  ],
  "instanceResourceInputBindingSpecs": [
    {
      object (InstanceResourceInputBindingSpec)
    }
  ],
  "instanceResourceOutputBindingSpecs": [
    {
      object (InstanceResourceOutputBindingSpec)
    }
  ]
}
Campos
graphInputChannelSpecs[]

object (GraphInputChannelSpec)

En el caso de los procesadores con input_channel_specs, el procesador debe estar conectado de forma explícita a otro procesador.

graphOutputChannelSpecs[]

object (GraphOutputChannelSpec)

Las especificaciones del artefacto de salida para el procesador actual

instanceResourceInputBindingSpecs[]

object (InstanceResourceInputBindingSpec)

Es el recurso de entrada que se debe ingresar desde la instancia de la aplicación.

instanceResourceOutputBindingSpecs[]

object (InstanceResourceOutputBindingSpec)

Es el recurso de salida que el procesador generará por instancia. Además de las vinculaciones de salida que se enumeran de forma explícita aquí, todos los GraphOutputChannels de los procesadores se pueden vincular al recurso de transmisión. El nombre de vinculación es el mismo que el nombre de GraphOutputChannel.

GraphInputChannelSpec

Es un mensaje para la especificación del canal de entrada.

Representación JSON
{
  "name": string,
  "dataType": enum (DataType),
  "acceptedDataTypeUris": [
    string
  ],
  "required": boolean,
  "maxConnectionAllowed": string
}
Campos
name

string

Es el nombre del canal de entrada actual.

dataType

enum (DataType)

Los tipos de datos del canal de entrada actual. Cuando este campo tiene más de 1 valor, significa que este canal de entrada se puede conectar a cualquiera de estos tipos de datos diferentes.

acceptedDataTypeUris[]

string

Si se especifican, solo se pueden conectar al procesador esos tipos de datos detallados. Por ejemplo, flujo de JPEG para MEDIA o el proto PredictionResult para el tipo PROTO. Si no se especifica, se acepta cualquier proto.

required

boolean

Indica si el procesador requiere el canal de entrada actual. Por ejemplo, en el caso de un procesador con entrada de video obligatoria y entrada de audio opcional, si falta la entrada de video, se rechazará la solicitud, mientras que la entrada de audio puede faltar siempre que exista la entrada de video.

maxConnectionAllowed

string (int64 format)

Indica cuántos bordes de entrada se pueden conectar a este canal de entrada. 0 significa ilimitado.

DataType

Son los tipos de datos de alto nivel que admite el procesador.

Enums
DATA_TYPE_UNSPECIFIED Es el valor predeterminado de DataType.
VIDEO Tipo de datos de video, como H264.
PROTO Es un tipo de datos de Protobuf que se suele usar para el blob de datos general.

GraphOutputChannelSpec

Mensaje para la especificación del canal de salida.

Representación JSON
{
  "name": string,
  "dataType": enum (DataType),
  "dataTypeUri": string
}
Campos
name

string

Es el nombre del canal de salida actual.

dataType

enum (DataType)

Es el tipo de datos del canal de salida actual.

dataTypeUri

string

InstanceResourceInputBindingSpec

Mensaje para la especificación del canal de recursos de instancia. Los recursos externos son nodos virtuales que no se expresan en el gráfico de la aplicación. Cada procesador expresa sus especificaciones fuera del gráfico, de modo que el cliente pueda anular la fuente o los destinos externos para el

Representación 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.
}
Campos
name

string

Es el nombre de la vinculación de entrada, único dentro del procesador.

Campo de unión resource_type.

resource_type puede ser una de las siguientes opciones:

configTypeUri

string

El proto de configuración que incluye los recursos de Googleapis. Es decir, type.googleapis.com/google.cloud.vision.v1.StreamWithAnnotation

resourceTypeUri

string

La URL de tipo directa del recurso de Googleapis, es decir, type.googleapis.com/google.cloud.vision.v1.Asset

InstanceResourceOutputBindingSpec

Representación JSON
{
  "name": string,
  "resourceTypeUri": string,
  "explicit": boolean
}
Campos
name

string

Es el nombre de la vinculación de salida, único dentro del procesador.

resourceTypeUri

string

El URI del tipo de recurso del recurso de salida aceptable.

explicit

boolean

Indica si el recurso de salida se debe establecer de forma explícita en la instancia. Si es falso, el procesador lo generará automáticamente si es necesario.

Métodos

create

Crea un nuevo procesador en un proyecto y una ubicación determinados.

delete

Borra un solo procesador.

get

Obtiene detalles de un solo procesador.

list

Enumera los procesadores en una ubicación y un proyecto determinados.

patch

Actualiza los parámetros de un solo procesador.

prebuilt

ListPrebuiltProcessors es un verbo de transferencia personalizado que muestra una lista de procesadores precompilados.