マルチキャスト コンシューマーの構成を表示する

このページでは、マルチキャスト コンシューマー構成の詳細を一覧取得して表示する方法について説明します。

このページのリソースを一覧表示するコマンドは、超低遅延(ULL)マルチキャストやクラウド マルチキャストなど、すべてのマルチキャスト構成を表示します。

このページで説明するマルチキャスト リソースの詳細については、マルチキャスト リソースモデルをご覧ください。

始める前に

マルチキャスト リソースを表示するプロジェクトを使用するように 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 リソースを削除して再作成する必要があります。

マルチキャスト コンシューマーの構成を表示する

このセクションでは、マルチキャスト コンシューマーの既存の構成を表示する方法について説明します。

マルチキャスト コンシューマーの関連付けを表示する

gcloud

  • マルチキャスト コンシューマーの関連付けの一覧を取得するには、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: マルチキャスト コンシューマーの関連付けが作成されたゾーン

API

  • マルチキャスト コンシューマーの関連付けの一覧を取得するには、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: マルチキャスト コンシューマーの関連付けが作成されたゾーン

マルチキャスト グループ コンシューマーの有効化を表示する

gcloud

  • マルチキャスト グループ コンシューマーの有効化を一覧取得するには、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: マルチキャスト コンシューマー ネットワークが有効になったゾーン

API

  • マルチキャスト グループ コンシューマーの有効化を一覧取得するには、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: マルチキャスト コンシューマー ネットワークが有効になったゾーン