Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

查看多點傳播消費者設定

本頁說明如何列出及查看多點播送消費者設定的詳細資料。

本頁面列出資源的指令會顯示所有多播設定，包括超低延遲 (ULL) 多播和 Cloud Multicast。

如要進一步瞭解本頁面提及的多播資源，請參閱「多播資源模型」。

事前準備

將 gcloud CLI 設為使用要查看多播資源的專案。或者，您也可以在下列程序中，為每個指令加入 --project=PROJECT_ID 標記。

    gcloud config set project PROJECT_ID

將 PROJECT_ID 替換為專案 ID。

您設定的多播資源包含唯讀屬性，可說明資源的目前狀態。使用本頁面的程序查看多播設定時，您可以在指令或要求的輸出內容中，查看 state 欄位中個別資源的狀態。

下表說明可能狀態：

狀態	說明
`CREATING`	正在建立資源。
`ACTIVE`	資源處於正常狀態，可供使用。
`DELETING`	正在刪除資源。
`DELETE_FAILED`	嘗試刪除資源時發生錯誤。
`UPDATING`	正在更新資源。
`UPDATE_FAILED`	無法更新資源。
`INACTIVE`	這個狀態適用於多點傳播用戶設定。這表示多點傳播管理員執行了停用多點傳播用戶端資源的動作，例如撤銷網域或群組範圍的存取權。現有的多播消費者資源 (具有 `INACTIVE` 狀態) 無法重複使用。如果多點傳播管理員還原網域或群組範圍的存取權，多點傳播用戶網路管理員就必須刪除並重新建立 `INACTIVE` 資源。

本節說明如何查看現有的多點傳播用戶設定。

如要列出多點傳播用戶端關聯，請使用 network-services multicast-consumer-associations list 指令。
```
gcloud network-services multicast-consumer-associations list --location=ZONE
```
將 ZONE 替換為要列出多點傳播用戶關聯的可用區。
如要描述多點傳播用戶端關聯，請使用 network-services multicast-consumer-associations describe 指令。
```
gcloud network-services multicast-consumer-associations describe CONSUMER_ASSOCIATION_NAME \
    --location=ZONE
```
替換下列值：
- CONSUMER_ASSOCIATION_NAME：多點傳播用戶端關聯的名稱
- ZONE：建立多點傳播用戶端關聯的可用區

如要列出多點傳播用戶端關聯，請使用 multicastConsumerAssociations.list 方法。
```
GET https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastConsumerAssociations
```
將 ZONE 替換為要列出多點傳播用戶關聯的區域。
如要說明多點傳播用戶關聯，請使用 multicastConsumerAssociations.get 方法。
```
GET https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastConsumerAssociations/CONSUMER_ASSOCIATION_NAME
```
替換下列值：
- CONSUMER_ASSOCIATION_NAME：多點傳播用戶端關聯的名稱
- ZONE：建立多點傳播用戶端關聯的可用區

如要列出多點傳播群組用戶啟用作業，請使用 network-services multicast-group-consumer-activations list 指令。
```
gcloud network-services multicast-group-consumer-activations list --location=ZONE
```
將 ZONE 替換為要列出多點傳播群組用戶啟用作業的區域。
如要描述多點傳播群組用戶啟用作業，請使用 network-services multicast-group-consumer-activations describe 指令。
```
gcloud network-services multicast-group-consumer-activations describe GROUP_CONSUMER_ACTIVATION_NAME \
    --location=ZONE
```
替換下列值：
- GROUP_CONSUMER_ACTIVATION_NAME：多點傳播群組用戶啟用名稱
- ZONE：啟用多點傳播用戶網路的區域

如要列出多點傳播群組用戶啟用作業，請使用 multicastGroupConsumerActivations.list 方法。
```
GET https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastGroupConsumerActivations
```
將 ZONE 替換為要列出多點傳播群組用戶啟用作業的區域。
如要描述多點傳播群組用戶啟用作業，請使用 multicastGroupConsumerActivations.get 方法。
```
GET https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastGroupConsumerActivations/GROUP_CONSUMER_ACTIVATION_NAME
```
替換下列值：
- GROUP_CONSUMER_ACTIVATION_NAME：多點傳播群組用戶啟用名稱
- ZONE：啟用多點傳播用戶網路的區域