스트리밍 동영상 창고 만들기 및 업데이트

비전 웨어하우스는 앱에 추가하여 모델 출력과 스트리밍 데이터를 저장할 수 있는 구성요소입니다.

스트리밍 동영상 창고 만들기

앱 그래프의 다른 구성요소 노드를 창고에 연결하려면 먼저 스트리밍 동영상 창고를 만들어야 합니다.

콘솔

  1. Vertex AI Vision 대시보드의 창고 탭을 엽니다.

    창고 탭으로 이동

  2. 만들기를 선택합니다.

  3. 웨어하우스의 이름을 추가하고 웨어하우스에 저장된 애셋의 TTL (수명) 기간을 선택합니다. 이 값은 나중에 수정할 수 있습니다.

    창고를 만든 후 애플리케이션 그래프에 창고를 추가할 수 있습니다.

REST 및 명령줄

지정된 프로젝트에 새 corpus 리소스를 만들고 corpus 표시 이름, 설명, TTL을 지정할 수 있는 옵션을 제공합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • REGIONALIZED_ENDPOINT: 엔드포인트에 LOCATION_ID와 일치하는 접두사(예: europe-west4-)가 포함될 수 있습니다. 지역화된 엔드포인트에 대해 자세히 알아보세요.
  • PROJECT_NUMBER: 프로젝트 번호입니다. Google Cloud
  • LOCATION_ID: Vertex AI Vision을 사용하는 리전입니다. 예를 들면 다음과 같습니다. us-central1, europe-west4 사용 가능한 리전을 참고하세요.
  • DISPLAY_NAME: 창고의 표시 이름입니다.
  • WAREHOUSE_DESCRIPTION: 창고에 대한 설명입니다 (corpus).
  • TIME_TO_LIVE: 자료에 포함된 모든 애셋의 TTL (수명) 또는 특정 애셋의 TTL입니다. 예를 들어 TTL이 100일인 애셋이 있는 자료의 경우 8640000 (초) 값을 제공합니다.

HTTP 메서드 및 URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora

JSON 요청 본문:

{
  "display_name": "DISPLAY_NAME",
  "description": "WAREHOUSE_DESCRIPTION",
  "type": "STREAM_VIDEO",
  "default_ttl": {
    "seconds": TIME_TO_LIVE
  }
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다. 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다. 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/warehouseoperations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.CreateCorpusMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.Corpus",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID",
    "displayName": "DISPLAY_NAME",
    "description": "WAREHOUSE_DESCRIPTION",
    "type": "STREAM_VIDEO",
    "defaultTtl": "TIME_TO_LIVE"
  }
}

스트리밍 동영상 창고 업데이트

표시 이름, 설명, 기본 TTL을 업데이트하거나 사용 가능한 모든 필드를 업데이트하는 옵션을 사용하여 지정된 프로젝트의 기존 자료 모음을 업데이트합니다.

REST 및 명령줄

지정된 프로젝트의 기존 corpus 리소스를 업데이트합니다. 이 샘플에서는 corpus 표시 이름을 업데이트하는 방법을 보여줍니다. 하지만 동일한 URL 형식과 업데이트된 요청 본문을 사용하여 설명, TTL 또는 모든 필드를 한 번에 업데이트할 수도 있습니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • REGIONALIZED_ENDPOINT: 엔드포인트에 LOCATION_ID와 일치하는 접두사(예: europe-west4-)가 포함될 수 있습니다. 지역화된 엔드포인트에 대해 자세히 알아보세요.
  • PROJECT_NUMBER: 프로젝트 번호입니다. Google Cloud
  • LOCATION_ID: Vertex AI Vision을 사용하는 리전입니다. 예를 들면 다음과 같습니다. us-central1, europe-west4 사용 가능한 리전을 참고하세요.
  • CORPUS_ID: 타겟 자료의 ID입니다.
  • ?updateMask=fieldToUpdate: updateMask를 적용할 수 있는 사용 가능한 필드 중 하나입니다. 요청 본문에서 해당하는 새 필드 값을 지정합니다. 이 새 값은 기존 필드 값을 대체합니다. 사용 가능한 필드:
    • 표시 이름: ?updateMask=display_name
    • 설명: ?updateMask=description
    • 기본 TTL (수명): ?updateMask=default_ttl
    • 모든 입력란을 업데이트합니다. ?updateMask=*
  • UPDATED_FIELD_VALUE: 지정된 필드의 새 값입니다. 이 예에서는 사용자가 제공한 창고 리소스의 새 표시 이름입니다.

HTTP 메서드 및 URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name

JSON 요청 본문:

{
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": {
    "seconds": "7800"
  }
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다. 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다. 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID?update_mask=display_name" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/corpora/CORPORA_ID",
  "displayName": "UPDATED_FIELD_VALUE",
  "description": "Original description",
  "defaultTtl": "7800s"
}