REST Resource: projects.locations.operators

Recurso: Operador

Mensaje que describe el objeto Operator.

Representación JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "operatorDefinition": {
    object (OperatorDefinition)
  }
}
Campos
name

string

Nombre del recurso.

createTime

string (Timestamp format)

Solo salida. La 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. La 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" }.

operatorDefinition

object (OperatorDefinition)

La definición del operador.

OperatorDefinition

Define la interfaz de un operador.

Los argumentos de un operador son flujos de entrada/salida que se procesan o se devuelven, mientras que los atributos son parámetros de configuración fijos.

Representación JSON
{
  "operator": string,
  "inputArgs": [
    {
      object (ArgumentDefinition)
    }
  ],
  "outputArgs": [
    {
      object (ArgumentDefinition)
    }
  ],
  "attributes": [
    {
      object (AttributeDefinition)
    }
  ],
  "resources": {
    object (ResourceSpecification)
  }
}
Campos
operator

string

Es el nombre de este operador.

De forma tentativa, [A-Z][a-zA-Z0-9]*, p.ej., BboxCounter, PetDetector, PetDetector1.

inputArgs[]

object (ArgumentDefinition)

Declara los argumentos de entrada.

outputArgs[]

object (ArgumentDefinition)

Declara argumentos de salida.

attributes[]

object (AttributeDefinition)

Declara los atributos.

resources

object (ResourceSpecification)

Los recursos para ejecutar el operador

ArgumentDefinition

Define un argumento para un operador.

Se usa para entradas y salidas.

Representación JSON
{
  "argument": string,
  "type": string
}
Campos
argument

string

Es el nombre del argumento.

De forma tentativa, [_a-z0-9]*[a-z0-9]?, p.ej., video, audio, high_fps_frame.

type

string

Es el tipo de datos del argumento.

Debe coincidir con la representación textual de un tipo de flujo o paquete.

AttributeDefinition

Define un atributo de un operador.

Representación JSON
{
  "attribute": string,
  "type": string,
  "defaultValue": {
    object (AttributeValue)
  }
}
Campos
attribute

string

Es el nombre del atributo.

De forma tentativa, [_a-z0-9]*[a-z0-9]?, p.ej., max_frames_per_video, resize_height.

type

string

Es el tipo de este atributo.

Consulta attribute_value.proto para conocer las posibilidades.

defaultValue

object (AttributeValue)

Es el valor predeterminado del atributo.

ResourceSpecification

ResourceSpec recopila un conjunto de recursos que se pueden usar para especificar solicitudes y requisitos.

Nota: Es muy experimental, ya que puede depender del entorno de ejecución. Puedes usar el campo "extras" para experimentar primero antes de intentar abstraerlo.

Representación JSON
{
  "cpu": string,
  "memory": string,
  "gpus": integer,
  "latencyBudgetMs": integer
}
Campos
cpu

string

Especificación de la CPU.

Ejemplos: "100m", "0.5", "1", "2", … corresponden a 0.1, la mitad, 1 o 2 CPU.

Deja el campo vacío para que el sistema decida.

Ten en cuenta que esto no determina el vendedor o la marca de la CPU, ni su velocidad de reloj subyacente ni sus funciones SIMD específicas. Es solo la cantidad de tiempo que requiere en el tiempo de corte.

memory

string

Especificación de memoria (en bytes)

Ejemplos: “128974848”, “129e6”, “129M”, “123Mi”, … corresponden a 128974848 bytes, 129000000 bytes, 129 mebibytes y 123 megabytes.

Deja el campo vacío para que el sistema decida.

gpus

integer

Cantidad de GPUs.

latencyBudgetMs

integer

Es la latencia máxima que puede usar este operador para procesar un elemento.

Si no es positivo, se usará un valor predeterminado del sistema. Los desarrolladores de operadores deben organizar los recursos de procesamiento del sistema para que se alineen con este presupuesto de latencia. Por ejemplo, si deseas que un modelo de AA genere resultados en un plazo de 500 ms, debes asegurarte de solicitar suficiente CPU, GPU o memoria para lograrlo.

Métodos

create

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

delete

Borra un solo operador.

get

Obtiene los detalles de un solo operador.

list

Enumera operadores en una ubicación y un proyecto determinados.

patch

Actualiza los parámetros de un solo operador.