管理標記

您可以對 Datastream 資源 (例如串流、連線設定檔或私人連線) 附加、卸離及列出標記,以便整理資源及控管存取權。如要概略瞭解 Datastream 中的標記運作方式,請參閱「使用標記控管存取權」。

關於代碼

標記是一種鍵/值組合,可附加至Google Cloud內的資源。您可以將資源是否具備特定標記設為條件,並按照這項條件允許或拒絕政策。舉例來說,您可以根據資源是否具有特定標記,有條件地授予 Identity and Access Management (IAM) 角色。如要進一步瞭解標記,請參閱「標記總覽」。

如要將標記附加至資源,請建立標記繫結資源,將值連結至 Google Cloud 資源。

如要將 Datastream 中的串流、連線設定檔或私人連線分組,以便自動化和計費,請使用標籤。標記和標籤各自獨立運作,您可以將兩者套用至資源。

所需權限

如要取得管理標記所需的權限,請要求管理員授予您下列 IAM 角色:

  • 對附加標記的資源,具備標記檢視者 (roles/resourcemanager.tagViewer) 角色
  • 查看及管理組織層級的標記:組織的組織檢視者 (roles/resourcemanager.organizationViewer)
  • 建立、更新及刪除標記定義:針對要建立、更新或刪除標記的資源,具備標記管理員 (roles/resourcemanager.tagAdmin) 角色
  • 在資源中附加及移除標記:標記值和您要附加或移除標記值的資源,須具備標記使用者 (roles/resourcemanager.tagUser) 角色

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

如要將標記附加至 Datastream 資源,您必須具備 Datastream 管理員角色 (roles/datastream.admin),或其他包含下列權限的角色:

所需權限

  • datastream.connectionProfiles.createTagBinding
  • datastream.connectionProfiles.deleteTagBinding
  • datastream.connectionProfiles.listTagBindings
  • datastream.connectionProfiles.listEffectiveTags
  • datastream.streams.createTagBinding
  • datastream.streams.deleteTagBinding
  • datastream.streams.listTagBindings
  • datastream.streams.listEffectiveTags
  • datastream.privateConnections.createTagBinding
  • datastream.privateConnections.deleteTagBinding
  • datastream.privateConnections.listTagBindings
  • datastream.privateConnections.listEffectiveTags

建立標記鍵和值

您必須先建立標記並設定其值,才能附加標記。如要建立標記鍵和標記值,請參閱「建立標記」和「新增標記值」。

為現有資源新增標記

如要為現有串流、連線設定檔或私人連線新增標記,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的「Datastream」頁面。
  2. 前往 Datastream

  3. 選取要附加標記的資源頁面。 舉例來說,如要將標記附加至連線設定檔,請前往「Connection profiles」(連線設定檔) 頁面。
  4. 按一下 「Tags」(標記)。
  5. 如果「Tags」(標記) 面板中未顯示貴組織,請按一下「Select scope」(選取範圍)。選取您的組織,然後按一下「Open」(開啟)。
  6. 按一下「新增標記」。
  7. 從清單中選取要附加的標記鍵。您可以輸入關鍵字來篩選清單。
  8. 從清單中選取要附加的標記值。您可以輸入關鍵字來篩選清單。
  9. 按一下「儲存」。
  10. 在「Confirm」(確認) 對話方塊中,按一下「Confirm」(確認) 即可附加標記。
  11. 系統會顯示通知,確認代碼已更新。

gcloud

如要將標記附加至串流、連線設定檔或私人連線,您必須使用 gcloud resource-manager tags bindings create 指令建立標記繫結資源:

      gcloud resource-manager tags bindings create \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION
      

更改下列內容:

  • TAGVALUE_NAME:附加至資源的標記值永久 ID 或命名空間名稱,例如 tagValues/567890123456。
  • RESOURCE_ID 是資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//datastream.googleapis.com/)。舉例來說,如要將標記附加至 projects/PROJECT_NAME/locations/LOCATION/streams/STREAM_NAME,完整 ID 為://datastream.googleapis.com/projects/PROJECT_NAME/locations/LOCATION/streams/STREAM_NAME。
  • LOCATION:資源的位置。如要將標記附加至資料夾或專案等全域資源,請省略這個旗標。如要將標記附加至區域性或可用區資源,您必須指定位置,例如 us-central1 (區域) 或 us-central1-a (可用區)。

列出附加至資源的標記

您可以查看直接附加至串流、連線設定檔或私人連線,或由這些項目繼承的標記繫結清單。

控制台

  1. 前往 Google Cloud 控制台的「Datastream」頁面。
  2. 前往 Datastream

  3. 選取要查看標記的資源頁面。 舉例來說,如要查看連線設定檔的標記,請前往「Connection profiles」(連線設定檔) 頁面。

    標記會顯示在串流、連線設定檔或私人連線的「Tags」(標記) 欄中。

gcloud

如要取得附加至資源的標記繫結清單,請使用 gcloud resource-manager tags bindings list 指令:

      gcloud resource-manager tags bindings list \
          --parent=RESOURCE_ID \
          --location=LOCATION
      

更改下列內容:

  • RESOURCE_ID 是資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//datastream.googleapis.com/)。舉例來說,如要將標記附加至 projects/PROJECT_NAME/locations/LOCATION/streams/STREAM_NAME,完整 ID 為://datastream.googleapis.com/projects/PROJECT_NAME/locations/LOCATION/streams/STREAM_NAME。
  • LOCATION:資源的位置。如要查看附加至全域資源 (例如資料夾或專案) 的標記,請省略這個旗標。如果查看的是附加至區域或可用區資源的標記,則必須指定位置,例如 us-central1 (區域) 或 us-central1-a (可用區)。

您應該會收到類似以下的回覆:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //datastream.googleapis.com/projects/project-abc/locations/us-central1/streams/stream-xyz
      

從資源中卸除標記

您可以卸離直接附加至串流、連線設定檔或私人連線的標記。如要覆寫繼承的標記,請附加具有相同鍵和不同值的標記,但無法卸離。

控制台

  1. 前往 Google Cloud 控制台的「Datastream」頁面。
  2. 前往 Datastream

  3. 選取要移除標記的資源頁面。 舉例來說,如要從連線設定檔中移除標記,請前往「Connection profiles」(連線設定檔) 頁面。
  4. 按一下 「Tags」(標記)。
  5. 在「Tags」(標記) 面板中,按一下要卸載的標記旁邊的 「Delete item」(刪除項目)。
  6. 按一下「儲存」。
  7. 在「Confirm」(確認) 對話方塊中,按一下「Confirm」(確認) 即可卸離標記。

系統會顯示通知,確認代碼已更新。

gcloud

如要刪除標記繫結,請使用 gcloud resource-manager tags bindings delete 指令:

      gcloud resource-manager tags bindings delete \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION
      

更改下列內容:

  • TAGVALUE_NAME:附加標記值的永久 ID 或命名空間名稱,例如 tagValues/567890123456。
  • RESOURCE_ID 是資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//datastream.googleapis.com/)。舉例來說,如要將標記附加至 projects/PROJECT_NAME/locations/LOCATION/streams/STREAM_NAME,完整 ID 為://datastream.googleapis.com/projects/PROJECT_NAME/locations/LOCATION/streams/STREAM_NAME。
  • LOCATION:資源的位置。如要將標記附加至資料夾或專案等全域資源,請省略這個旗標。如要將標記附加至區域性或可用區資源,您必須指定位置,例如 us-central1 (區域) 或 us-central1-a (可用區)。

刪除標記鍵和值

移除標記鍵或值定義時,請務必將標記從串流、連線設定檔或私人連線中卸載。您必須先刪除現有的標記連結 (稱為標記繫結),才能刪除標記定義本身。如要刪除標記鍵和標記值,請參閱「刪除標記」。

Identity and Access Management 條件和標記

您可以使用標記和 IAM 條件,有條件地將角色繫結授予階層中的使用者。如果已套用具備條件式角色繫結的 IAM 政策,變更或刪除附加至資源的標記,可能會移除使用者對該資源的存取權。詳情請參閱「Identity and Access Management 條件和標記」。

後續步驟