REST Resource: projects.locations.processors

Ressource: Prozessor

Nachricht, die das Processor-Objekt beschreibt. Nächste ID: 19

JSON-Darstellung
{
  "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
}
Felder
name

string

name of resource.

createTime

string (Timestamp format)

Nur Ausgabe. [Nur Ausgabe] Erstellungszeitstempel.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Nur Ausgabe. [Nur Ausgabe] Aktualisierungszeitstempel.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Labels als Schlüssel/Wert-Paare

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

displayName

string

Pflichtangabe. Ein nutzerfreundlicher Anzeigename für den Prozessor.

description

string

Veranschaulichende Sätze zur Beschreibung der Funktionen des Prozessors.

processorType

enum (ProcessorType)

Nur Ausgabe. Prozessortyp

modelType

enum (ModelType)

Modelltyp

customProcessorSourceInfo

object (CustomProcessorSourceInfo)

Quellinformationen für vom Kunden erstellten Zahlungsabwickler

state

enum (ProcessorState)

Nur Ausgabe. Status des Prozessors.

processorIoSpec

object (ProcessorIOSpec)

Nur Ausgabe. [Nur Ausgabe] Die Eingabe-/Ausgabespezifikationen eines Prozessors. Jeder Prozessortyp hat feste Eingabe-/Ausgabespezifikationen, die vom Kunden nicht geändert werden können.

configurationTypeurl

string

Nur Ausgabe. Die entsprechende Konfiguration kann in der Anwendung verwendet werden, um das Verhalten des Prozessors anzupassen.

supportedAnnotationTypes[]

enum (StreamAnnotationType)

supportsPostProcessing

boolean

Gibt an, ob der Prozessor die Nachbearbeitung unterstützt.

ProcessorType

Typ

Enums
PROCESSOR_TYPE_UNSPECIFIED Prozessortyp: UNBEKANNT
PRETRAINED Prozessortyp: PRETRAINED. Der vortrainierte Prozessor wurde von der Vision AI App Platform entwickelt und bietet modernste Funktionen zur Verarbeitung von Bilddaten, z. B. Personenzählung oder Unkenntlichmachung von Personen. Der vorab trainierte Prozessor ist in der Regel öffentlich verfügbar.
CUSTOM Prozessortyp: BENUTZERDEFINIERT. Benutzerdefinierte Prozessoren sind spezielle Prozessoren, die entweder von Kunden hochgeladen oder aus anderen Google Cloud-Plattformen (z. B. Vertex AI) importiert werden. Der benutzerdefinierte Prozessor ist nur für den Creator sichtbar.
CONNECTOR Prozessortyp CONNECTOR. Connector-Prozessoren sind spezielle Prozessoren, die E/A-Vorgänge für die Anwendung ausführen. Sie verarbeiten die Daten nicht, sondern übergeben sie entweder an andere Prozessoren oder empfangen Daten von anderen Prozessoren.

ModelType

Alle unterstützten Modelltypen in der Vision AI App Platform.

Enums
MODEL_TYPE_UNSPECIFIED Prozessortyp: UNBEKANNT
IMAGE_CLASSIFICATION Modelltyp: Bildklassifizierung.
OBJECT_DETECTION Modelltyp „Objekterkennung“
VIDEO_CLASSIFICATION Modelltyp: Videoklassifizierung
VIDEO_OBJECT_TRACKING Modelltyp „Objekt-Tracking“
VIDEO_ACTION_RECOGNITION Modelltyp „Aktionserkennung“
OCCUPANCY_COUNTING Modelltyp: Anwesenheitszähler
PERSON_BLUR Modelltyp „Unkenntlichmachen von Personen“
VERTEX_CUSTOM Modelltyp: Vertex Custom

CustomProcessorSourceInfo

Hier werden die Quellinformationen für einen benutzerdefinierten Prozessor beschrieben.

JSON-Darstellung
{
  "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.
}
Felder
sourceType

enum (SourceType)

Das Originalprodukt, das die Funktionalität des benutzerdefinierten Prozessors enthält.

additionalInfo

map (key: string, value: string)

Nur Ausgabe. Zusätzliche Informationen zum importierten benutzerdefinierten Prozessor. Die Daten werden von der App-Plattform beim Erstellen des Prozessors ausgefüllt.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

modelSchema

object (ModelSchema)

Modellschemadateien, die die Signatur des Modells angeben. Für VERTEX_CUSTOM-Modelle ist das Instanzschema erforderlich. Wenn das Instanzschema beim Erstellen des Prozessors nicht angegeben wird, versucht die VisionAI-Plattform, es von Vertex abzurufen. Wenn es nicht vorhanden ist, schlägt die Erstellung fehl.

Union-Feld artifact_path. Der Pfad, unter dem die App-Plattform die Artefakte für den benutzerdefinierten Prozessor lädt. Für artifact_path ist nur einer der folgenden Werte zulässig:
vertexModel

string

Der Name der ursprünglichen Modellressource, die auf der Vertex AI-Plattform gehostet wird.

SourceType

Quelltyp des importierten benutzerdefinierten Prozessors.

Enums
SOURCE_TYPE_UNSPECIFIED Quelltyp nicht angegeben.
VERTEX_AUTOML Benutzerdefinierte Prozessoren aus dem Vertex AutoML-Produkt
VERTEX_CUSTOM Benutzerdefinierte Prozessoren aus allgemeinen benutzerdefinierten Modellen von Vertex
PRODUCT_RECOGNIZER Quelle für die Produkterkennung.

ModelSchema

Das Schema ist als Schemaobjekt von OpenAPI 3.0.2 definiert.

JSON-Darstellung
{
  "instancesSchema": {
    object (GcsSource)
  },
  "parametersSchema": {
    object (GcsSource)
  },
  "predictionsSchema": {
    object (GcsSource)
  }
}
Felder
instancesSchema

object (GcsSource)

Cloud Storage-Speicherort einer YAML-Datei, die das Format einer einzelnen Instanz definiert, die in Vorhersage- und Erklärungsanfragen verwendet wird.

parametersSchema

object (GcsSource)

Cloud Storage-Speicherort einer YAML-Datei, die die Vorhersage- und Erklärungsparameter definiert.

predictionsSchema

object (GcsSource)

Cloud Storage-Speicherort einer YAML-Datei, die das Format einer einzelnen Vorhersage oder Erklärung definiert.

GcsSource

Der Google Cloud Storage-Speicherort für den eingegebenen Inhalt.

JSON-Darstellung
{
  "uris": [
    string
  ]
}
Felder
uris[]

string

Pflichtangabe. Verweise auf Google Cloud Storage-Pfade

ProcessorState

Enums
PROCESSOR_STATE_UNSPECIFIED Nicht angegebener Prozessorstatus.
CREATING Der Prozessor wird erstellt und ist noch nicht einsatzbereit.
ACTIVE Der Prozessor ist einsatzbereit.
DELETING Der Prozessor wird gelöscht und kann nicht verwendet werden.
FAILED Der Prozessor wurde gelöscht oder die Erstellung ist fehlgeschlagen .

ProcessorIOSpec

Nachricht, die die Eingabe-/Ausgabespezifikationen eines Prozessors beschreibt.

JSON-Darstellung
{
  "graphInputChannelSpecs": [
    {
      object (GraphInputChannelSpec)
    }
  ],
  "graphOutputChannelSpecs": [
    {
      object (GraphOutputChannelSpec)
    }
  ],
  "instanceResourceInputBindingSpecs": [
    {
      object (InstanceResourceInputBindingSpec)
    }
  ],
  "instanceResourceOutputBindingSpecs": [
    {
      object (InstanceResourceOutputBindingSpec)
    }
  ]
}
Felder
graphInputChannelSpecs[]

object (GraphInputChannelSpec)

Bei Prozessoren mit „input_channel_specs“ muss der Prozessor explizit mit einem anderen Prozessor verbunden sein.

graphOutputChannelSpecs[]

object (GraphOutputChannelSpec)

Die Spezifikationen für das Ausgabeartefakt für den aktuellen Prozessor.

instanceResourceInputBindingSpecs[]

object (InstanceResourceInputBindingSpec)

Die Eingaberessource, die von der Anwendungsinstanz bereitgestellt werden muss.

instanceResourceOutputBindingSpecs[]

object (InstanceResourceOutputBindingSpec)

Die Ausgaberessource, die der Prozessor pro Instanz generiert. Außer den hier ausdrücklich aufgeführten Ausgabebindungen können alle GraphOutputChannels der Prozessoren an die Streamressource gebunden werden. Der Bindungsname entspricht dann dem Namen des GraphOutputChannel.

GraphInputChannelSpec

Nachricht für die Eingabekanalspezifikation.

JSON-Darstellung
{
  "name": string,
  "dataType": enum (DataType),
  "acceptedDataTypeUris": [
    string
  ],
  "required": boolean,
  "maxConnectionAllowed": string
}
Felder
name

string

Der Name des aktuellen Eingabekanals.

dataType

enum (DataType)

Die Datentypen des aktuellen Eingabekanals. Wenn dieses Feld mehr als einen Wert hat, kann dieser Eingabekanal mit einem dieser Datentypen verbunden werden.

acceptedDataTypeUris[]

string

Wenn angegeben, können nur diese detaillierten Datentypen mit dem Auftragsverarbeiter verknüpft werden. Beispiel: JPEG-Stream für MEDIA oder PredictionResult-Prototyp für den PROTO-Typ. Wenn nichts angegeben wird, wird jedes Proto akzeptiert.

required

boolean

Gibt an, ob der aktuelle Eingabekanal vom Prozessor benötigt wird. Wenn bei einem Prozessor mit erforderlichem Videoeingang und optionalem Audioeingang beispielsweise der Videoeingang fehlt, wird die Anwendung abgelehnt. Der Audioeingang kann hingegen fehlen, solange der Videoeingang vorhanden ist.

maxConnectionAllowed

string (int64 format)

Gibt an, wie viele Eingabekanten mit diesem Eingabekanal verbunden werden können. 0 bedeutet „unbegrenzt“.

DataType

Alle unterstützten Datentypen.

Enums
DATA_TYPE_UNSPECIFIED Der Standardwert von „DataType“.
VIDEO Videodatentyp wie H264.
IMAGE Bilddatentyp.
PROTO Protobuf-Datentyp, der in der Regel für allgemeine Daten-Blobs verwendet wird.

GraphOutputChannelSpec

Nachricht für die Ausgabekanalspezifikation.

JSON-Darstellung
{
  "name": string,
  "dataType": enum (DataType),
  "dataTypeUri": string
}
Felder
name

string

Der Name des aktuellen Ausgabekanals.

dataType

enum (DataType)

Der Datentyp des aktuellen Ausgabekanals.

dataTypeUri

string

InstanceResourceInputBindingSpec

Nachricht für die Kanalspezifikation der Instanzressource. Externe Ressourcen sind virtuelle Knoten, die nicht im Anwendungsgraphen dargestellt werden. Jeder Prozessor gibt seine Out-Graph-Spezifikation an, damit der Kunde die externen Quellen oder Ziele für die

JSON-Darstellung
{
  "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.
}
Felder
name

string

Name der Eingabebindung, der innerhalb des Prozessors eindeutig ist.

Union-Feld resource_type.

Für resource_type ist nur einer der folgenden Werte zulässig:

configTypeUri

string

Das Konfigurations-Proto, das die Googleapis-Ressourcen enthält. Beispiel: type.googleapis.com/google.cloud.vision.v1.StreamWithAnnotation

resourceTypeUri

string

Die direkte Typ-URL der Googleapis-Ressource, z. B. type.googleapis.com/google.cloud.vision.v1.Asset

InstanceResourceOutputBindingSpec

JSON-Darstellung
{
  "name": string,
  "resourceTypeUri": string,
  "explicit": boolean
}
Felder
name

string

Name der Ausgabebindung, der innerhalb des Prozessors eindeutig ist.

resourceTypeUri

string

Die URI des Ressourcentyps der zulässigen Ausgaberessource.

explicit

boolean

Gibt an, ob die Ausgaberessource in der Instanz explizit festgelegt werden muss. Wenn „false“ festgelegt ist, wird der Wert bei Bedarf automatisch vom Prozessor generiert.

Methoden

create

Erstellt einen neuen Prozessor in einem bestimmten Projekt und an einem bestimmten Standort.

delete

Löscht einen einzelnen Prozessor.

get

Ruft Details zu einem einzelnen Prozessor ab.

list

Listet Prozessoren in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

Aktualisiert die Parameter eines einzelnen Prozessors.

prebuilt

„ListPrebuiltProcessors“ ist ein benutzerdefiniertes Passthrough-Verb, mit dem vordefinierte Prozessoren aufgelistet werden.