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 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. [출력 전용] 업데이트 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "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 앱 플랫폼에서 개발합니다. 사전 학습된 프로세서는 일반적으로 공개적으로 제공됩니다.
CUSTOM 프로세서 유형 CUSTOM. 맞춤 프로세서는 고객이 업로드하거나 다른 Google Cloud 플랫폼 (예: Vertex AI)에서 가져온 특수 프로세서입니다. 맞춤 프로세서는 크리에이터에게만 표시됩니다.
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 모델의 경우 인스턴스 스키마가 필요합니다. 프로세서 생성 중에 인스턴스 스키마가 지정되지 않으면 VisionAI Platform이 Vertex에서 가져오려고 시도합니다. 스키마가 없으면 생성에 실패합니다.
통합 필드 artifact_path. 앱 플랫폼이 커스텀 프로세서의 아티팩트를 로드하는 경로입니다. 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)

현재 입력 채널의 데이터 유형입니다. 이 필드에 값이 2개 이상 있으면 이 입력 채널을 이러한 서로 다른 데이터 유형 중 하나에 연결할 수 있음을 의미합니다.
acceptedDataTypeUris[]

string

지정된 경우 이러한 세부 데이터 유형만 프로세서에 연결할 수 있습니다. 예를 들어 MEDIA의 경우 jpeg 스트림, PROTO 유형의 경우 PredictionResult 프로토가 있습니다. 지정하지 않으면 모든 프로토가 허용됩니다.
required

boolean

프로세서에 현재 입력 채널이 필요한지 여부입니다. 예를 들어 필수 동영상 입력과 선택적 오디오 입력이 있는 프로세서의 경우 동영상 입력이 누락되면 애플리케이션이 거부되지만 동영상 입력이 있는 한 오디오 입력은 누락될 수 있습니다.
maxConnectionAllowed

string (int64 format)

이 입력 채널에 연결할 수 있는 입력 에지의 수입니다. 0은 무제한을 의미합니다.

DataType

지원되는 모든 데이터 유형

열거형
DATA_TYPE_UNSPECIFIED DataType의 기본값입니다.
VIDEO H264와 같은 동영상 데이터 유형입니다.
IMAGE 이미지 데이터 유형입니다.
PROTO 일반적으로 일반 데이터 blob에 사용되는 Protobuf 데이터 유형입니다.

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 리소스를 포함하는 구성 프로토입니다. 즉, type.googleapis.com/google.cloud.vision.v1.StreamWithAnnotation
resourceTypeUri

string

Googleapis 리소스의 직접 유형 URL입니다(예: 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는 사전 빌드된 프로세서를 나열하는 맞춤 패스스루 동사입니다.