本頁面由 Cloud Translation API 翻譯而成。

查看、編輯及刪除政策自動調度管理工具

本頁說明如何查看及刪除資料夾或機構中的政策協調器。

事前準備

查看「OS 政策和 OS 政策指派作業」。
查看 OS 設定配額。
確認您符合使用政策自動調度管理工具的必要條件。
如果尚未設定驗證，請先完成設定。驗證可確認您的身分，以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，可以選取下列任一選項，向 Compute Engine 進行驗證：
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. 安裝 Google Cloud CLI。安裝完成後，執行下列指令初始化 Google Cloud CLI：
  gcloud init
  如果您使用外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。
  
  注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。
2. Set a default region and zone.
REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。
詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。

列出 OS 政策自動化調度管理工具

如要查看專案、資料夾或機構中的所有政策協調器，請完成下列步驟：

主控台

如要列出政策協調器，請按照下列步驟操作：

前往 Google Cloud 控制台的「OS policies」(作業系統政策) 頁面。

前往 OS 政策
按一下 Google Cloud 控制台動作列上的「專案選擇器」，然後選取要建立政策協調器的資料夾。
按一下「全域自動調度管理工具」。

gcloud

如要查看在資料夾中建立的政策自動調度管理工具詳細資料，請執行 os-config policy-orchestrators list 指令：

  gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators list \
    --folder=FOLDER_NUMBER \

更改下列內容：

QUOTA_PROJECT_ID：配額或帳單專案的專案 ID。
FOLDER_NUMBER：您建立政策協調器的資料夾數值 ID。

示例

  gcloud compute os-config policy-orchestrators list \
    --folder=123456 \

REST

如要查看資料夾中的所有政策協調器，請向 folders.locations.global.policyOrchestrators.list 方法發出 GET 要求：

GET https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

將 FOLDER_NUMBER 替換為您建立政策協調器的資料夾的數值 ID。

查看政策自動調度管理工具的詳細資料

如要查看資料夾中政策協調器的詳細資料，請完成下列步驟：

主控台

如要查看政策自動化調度管理工具，請按照下列步驟操作：

前往 Google Cloud 控制台的「OS policies」(作業系統政策) 頁面。

前往 OS 政策
在 Google Cloud 控制台的動作列中，按一下「專案選取器」，然後選取包含政策自動調度管理工具的專案、資料夾或機構。
按一下「全域自動調度管理工具」。
選取要查看的政策協調器名稱。「Orchestrator details」(協調器詳細資料) 頁面隨即開啟。
如要查看套用至 VM 的 OS 政策詳細資料，請前往「已指派的 OS 政策」部分，然後按一下「查看」。

gcloud

如要查看在資料夾中建立的政策自動調度管理工具詳細資料，請執行 os-config policy-orchestrators describe 指令：

gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators describe ORCHESTRATOR_NAME \
  --folder=FOLDER_NUMBER \

更改下列內容：

QUOTA_PROJECT_ID：配額或帳單專案的專案 ID。
ORCHESTRATOR_NAME：政策自動化調度管理工具的名稱。
FOLDER_NUMBER：您建立政策自動化調度管理工具的資料夾數值 ID。

示例

  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators describe my-os-policy-orchestrator \
      --folder=123456 \

REST

如要查看政策自動調度管理工具的詳細資料，請將 GET 請求傳送至 folders.locations.global.policyOrchestrators.get 方法，

GET https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

更改下列內容：

QUOTA_PROJECT_ID：配額或帳單專案的專案 ID。
FOLDER_NUMBER：政策自動化調度管理工具所在資料夾的數值 ID。
ORCHESTRATOR_NAME：要刪除的政策自動化調度管理工具名稱。

要求主體必須為空白。

編輯 OS 政策自動調度管理工具

您可以修改政策自動化調度管理工具，新增或更新 OS 政策指派項目、自動化調度管理工具範圍和資源。

主控台

如要變更政策自動化調度管理工具的設定，請按照下列步驟操作：

前往 Google Cloud 控制台的「OS policies」(作業系統政策) 頁面。

前往 OS 政策
按一下 Google Cloud 控制台動作列的專案選取器，然後選取政策自動調度管理工具所在的專案、資料夾或機構。
按一下「全域自動調度管理工具」。
選取要編輯的政策協調器名稱。「Orchestrator details」(協調器詳細資料) 頁面隨即開啟。
按一下 [編輯]。
在「OS 政策」部分，上傳 OS 政策檔案。
選用步驟：在「狀態」部分中，選取下列任一選項，指定政策協調器的行為：
- ACTIVE：政策自動化調度管理工具建立完成後，會立即採取行動。
- STOPPED：在此狀態下建立的政策自動化調度管理工具不會立即採取任何動作。您稍後可以編輯政策協調器，變更其狀態。
在「自動化調度範圍」部分，指定要推出 OS 政策的資料夾和專案。這些欄位只能輸入專案編號和資料夾編號。例如 123456、7654321。
選用：選取要套用 OS 政策的 VM 所在區域。
選用：在「目標 VM 執行個體」區段中，指定要套用 OS 政策的目標 VM。
- 選取 OS 系列。
- 您可以指定要納入和排除的標籤，進一步篩選 VM。
  
  舉例來說，您可以選取測試環境中的所有 Ubuntu VM，然後指定下列項目，排除執行 Google Kubernetes Engine 的 VM：
  - 作業系統系列：ubuntu
  - 包含：env:test、env:staging
  - 排除：goog-gke-node
指定推出計畫。
- 指定波浪大小 (也稱為中斷預算)。例如 10%。
- 指定等待時間。例如 15 分鐘。
按一下 [儲存]。

gcloud

如要更新政策自動化調度管理工具，請使用 os-config policy-orchestrators update 指令。

   gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators update ORCHESTRATOR_NAME \
   --folder=FOLDER_NUMBER
   --state=stopped

更改下列內容：

QUOTA_PROJECT_ID：配額或帳單專案的專案 ID。
ORCHESTRATOR_NAME：政策自動化調度管理工具的名稱。

FOLDER_NUMBER：政策協調器所在資料夾的數字 ID。

示例

  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators update my-os-policy-orchestrator \
    --folder=123456 \
    --include-projects=5432134,4567890

REST

如要在資料夾中更新政策自動化調度管理工具，請對 folders.locations.global.policyOrchestrators.patch 方法傳送 PATCH 要求。

在要求主體中，編輯 OS 政策指派作業規格。

    PATCH https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
    -H "x-goog-user-project: QUOTA_PROJECT_ID"

      {
        JSON_OS_POLICY_ORCHESTRATOR
      }

更改下列內容：

QUOTA_PROJECT_ID：配額或帳單專案的專案 ID
FOLDER_NUMBER：政策自動化調度管理工具所在資料夾的數值 ID。
ORCHESTRATOR_NAME：要編輯的政策自動化調度管理工具名稱。
JSON_OS_POLICY_ORCHESTRATOR：JSON 格式的政策自動化調度管理工具物件，定義自動化調度管理工具範圍、自動化調度管理資源和自動化調度管理狀態。如要進一步瞭解參數和格式，請參閱 Resource: folders.locations.global.policyOrchestrators。

刪除政策自動化調度管理工具

如要刪除政策自動化調度管理工具並取消所有進行中的推出作業，請完成下列步驟：

主控台

如要刪除政策自動化調度管理工具，請按照下列步驟操作：

前往 Google Cloud 控制台的「OS policies」(作業系統政策) 頁面。

前往 OS 政策
按一下 Google Cloud 控制台動作列的專案選取器，然後選取要刪除政策協調器的專案、資料夾或機構。
按一下「全域自動調度管理工具」。
選取要刪除的政策協調器名稱。「Orchestrator details」(協調器詳細資料) 頁面隨即開啟。
點選「刪除」。

gcloud

如要從資料夾中刪除政策自動化調度管理工具，請按照下列步驟操作：

使用 os-config policy-orchestrators delete 指令：
```
  gcloud --billing-project=QUOTA_PROJECT_IDcompute os-config policy-orchestrators delete ORCHESTRATOR_NAME \
    --folder=FOLDER_NUMBER \
    --policy-id=POLICY_ID
```
更改下列內容：
- QUOTA_PROJECT_ID：配額或帳單專案的專案 ID。
- ORCHESTRATOR_NAME：政策自動化調度管理工具的名稱。
- FOLDER_NUMBER：您建立政策自動化調度管理工具的資料夾數值 ID。
- POLICY_ID：指派給政策自動化調度管理工具的 ID。
示例
```
  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
    --folder=123456 \
    --policy-id=my-policy
```

REST

如要刪除資料夾中的政策自動化調度管理工具，請向 folders.locations.global.policyOrchestrators.delete 方法發出 DELETE 要求：

DELETE https://osconfig.googleapis.com/v2/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

更改下列內容：

QUOTA_PROJECT_ID：配額或帳單專案的專案 ID。
FOLDER_NUMBER：政策自動化調度管理工具所在資料夾的數值 ID。
ORCHESTRATOR_NAME：要刪除的政策自動化調度管理工具名稱。

後續步驟

瞭解如何使用政策自動化調度管理工具管理 OS 政策指派作業。

查看、編輯及刪除政策自動調度管理工具 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

Console

gcloud

REST

列出 OS 政策自動化調度管理工具

主控台

gcloud

REST

查看政策自動調度管理工具的詳細資料

主控台

gcloud

REST

編輯 OS 政策自動調度管理工具

主控台

gcloud

REST

刪除政策自動化調度管理工具

主控台

gcloud

REST

後續步驟

查看、編輯及刪除政策自動調度管理工具