管理應用程式執行個體

建構及部署應用程式後，您可以使用 Google Cloud 控制台或指令列管理這些應用程式執行個體。

查看已部署的應用程式執行個體和輸出內容

您可以使用 Google Cloud 控制台或指令列查看應用程式執行個體和輸出內容。接著，您可以使用這項資訊讀取模型輸出串流，以及取得資產。

網路使用者介面

在 Google Cloud 控制台中查看應用程式的執行個體和輸出內容。

  1. 開啟 Vertex AI Vision 資訊主頁的「應用程式」分頁。

    前往「應用程式」分頁

  2. 選取要查看的應用程式名稱。系統會將您帶往應用程式詳細資料頁面。

    應用程式詳細資料頁面會顯示應用程式資源的表格。這個表格會列出應用程式的所有執行中執行個體。應用程式的每個輸入串流都有自己的執行個體。每個執行個體下方都會列出自己的輸入和輸出資源。

    應用程式資源詳細資料頁面圖片

  3. 如要在執行個體表格中檢查串流或資料倉儲資產資源，請按一下輸入或輸出 ID，或選取路徑。

    • 按一下「串流」資源，系統會將您重新導向至串流詳細資料頁面，您可以在該頁面檢查串流的詳細資訊。

      如要瞭解如何使用指令列讀取模型的輸出串流，請參閱「建立及管理串流」。

      串流資源詳細資料圖片

    • 按一下倉儲資產資源，即可前往 Vision 倉儲資產詳細資料頁面。

      如要取得 Vision Warehouse 資產，請參閱使用 Vision Warehouse API 管理資源。

      倉庫資源詳細資料圖片

REST

如要列出應用程式例項，請使用 projects.locations.applications.instances.list 方法傳送 GET 要求。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT：您的 Google Cloud 專案 ID 或專案編號。
  • LOCATION_ID：您使用 Vertex AI Vision 的區域。例如：us-central1、europe-west4。請參閱可用區域。
  • APPLICATION_ID：目標應用程式的 ID。

HTTP 方法和網址：

GET https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances"

PowerShell

執行下列指令：

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

{
  "instances": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID/instances/INSTANCE_ID",
      "createTime": "2022-03-01T20:05:45.863836157Z",
      "inputResources": [
        {
          "inputResource": "input-stream",
          "consumerNode": "builtin-input-stream"
        }
      ],
      "outputResources": [
        {
          "outputResource": "sample-resource-1",
          "producerNode": "builtin-occupancy-count",
          "isTemporary": true
        },
        {
          "outputResource": "sample-resource-2",
          "producerNode": "builtin-input-stream"
        },
        {
          "outputResource": "sample-resource-3",
          "producerNode": "builtin-input-stream",
          "isTemporary": true
        },
        {
          "outputResource": "sample-resource-4",
          "producerNode": "builtin-input-stream",
          "isTemporary": true
        }
      ]
    }
  ]
}

刪除應用程式執行個體

REST

如要刪除應用程式例項，請使用 projects.locations.applications.deleteApplicationInstances 方法傳送 POST 要求。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_NUMBER：您的 Google Cloud專案編號。
  • LOCATION_ID：您使用 Vertex AI Vision 的區域。例如：us-central1、europe-west4。請參閱可用區域。
  • APPLICATION_ID：目標應用程式的 ID。

HTTP 方法和網址：

POST https://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances

JSON 要求主體：

{
  "instanceIds": [
    "INSTANCE_ID1",
    "INSTANCE_ID2",
    [...]
  ]
}

如要傳送要求，請選擇以下其中一個選項：

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://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances"

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://visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID:deleteApplicationInstances" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.visionai.v1.OperationMetadata",
    "createTime": "[...]",
    "Target": "projects/PROJECT_NUMBER/locations/LOCATION_ID/applications/APPLICATION_ID"
    "Verb": "update"
    "apiVersion": "v1"
  },
  "done": false
}

管理大型應用程式

部署和取消部署方法適用於執行個體少於 20 個的應用程式。如果應用程式有超過 20 個執行個體，您必須使用 API 逐步建立及移除執行個體。建議的工作流程如下：

  1. 建立應用程式。
  2. 新增 1 到 20 個實驗性執行個體。
  3. 部署您的應用程式。
  4. 確認應用程式運作正常。
  5. 使用 createApplicationInstances 方法，逐步將更多輸入內容新增至已部署的應用程式。
  6. 允許應用程式執行。
  7. 使用 deleteApplicationInstances 方法，從已部署的應用程式逐步移除輸入內容。
  8. 取消部署應用程式。