שליטה בגישה לטווחים של קבוצות מולטיקאסט

בדף הזה מוסבר איך לשלוט בגישה לטווחים של קבוצות מולטיקאסט.

ההגדרה שמתוארת בדף הזה קובעת אם פרויקט צרכן מולטיקאסט יכול להפעיל רשת VPC של צרכן מולטיקאסט עבור טווח קבוצות.

סקירה כללית

כדי לעדכן את הפרויקטים של הלקוחות ב-Multicast שיכולים לגשת לטווח של קבוצת Multicast:

מידע על ביטול ושחזור של גישה לטווחים של קבוצות

לפני שמעדכנים את הגישה לטווח של קבוצות מולטיקאסט, כדאי לשים לב לנקודות הבאות:

  • אם העדכון מבטל את הגישה לפרויקט קיים של צרכן מולטיקאסט שבו מופעל צרכן קבוצת מולטיקאסט, אזGoogle Cloud ההפעלה של צרכן קבוצת המולטיקאסט מושבתת, אבל המשאב עדיין קיים בפרויקט צרכן המולטיקאסט עם סטטוס של INACTIVE.
  • אם מעניקים גישה לפרויקט צרכן של שידור מרובה משתתפים, שלגביו בוטלה הגישה בעבר, האדמין של רשת הצרכנים של השידור המרובה צריך למחוק את ההפעלה הקיימת של צרכן הקבוצה וליצור הפעלה חדשה. אי אפשר לעשות שימוש חוזר במשאבים קיימים של INACTIVE.

עדכון טווח הקבוצה כדי לאפשר את כל הפרויקטים

בקטע הזה מוסבר איך לעדכן את טווח קבוצות ה-Multicast כדי לאפשר את כל הפרויקטים.

אחרי שמבצעים את התהליך הזה, כל פרויקט שיש לו גישה לדומיין יכול להשתמש בטווח הקבוצות הזה.

gcloud

כדי לעדכן את הטווח של קבוצת מולטיקאסט כדי לאפשר את כל הפרויקטים, משתמשים בפקודה network-services multicast-group-ranges update ומציינים את הדגלים הבאים:

  • --no-require-explicit-accept
  • אם רשימת המשתמשים שמורשים לצפות בשידור המולטיקאסט לא ריקה, צריך לציין גם את הדגל --clear-consumer-accept-list.
  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --no-require-explicit-accept \
      --clear-consumer-accept-list

מחליפים את GROUP_RANGE_NAME בשם של טווח קבוצות ה-Multicast.

API

כדי לעדכן את טווח קבוצת ה-Multicast כדי לאפשר את כל הפרויקטים, משתמשים בשיטה multicastGroupRanges.patch.

מגדירים את השדה requireExplicitAccept לערך false. אם רשימת הצרכנים המורשים לא ריקה, צריך גם לנקות את השדה consumerAcceptList על ידי הגדרת הערך שלו כ-[].

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=requireExplicitAccept,consumerAcceptList
  {
    "requireExplicitAccept": "false",
    "consumerAcceptList": []
  }

מחליפים את הערכים הבאים:

  • ‫PROJECT_ID: המזהה של פרויקט האדמין של ה-Multicast
  • ‫GROUP_RANGE_NAME: השם של טווח כתובות המולטיקאסט

עדכון טווח הקבוצה כדי לדחות את כל הפרויקטים כברירת מחדל

בקטע הזה מוסבר איך מעדכנים את טווח קבוצות ה-Multicast כדי לדחות את כל הפרויקטים כברירת מחדל.

בתהליך הבא, אפשר לספק רשימה של פרויקטים ספציפיים שיכולים לגשת לטווח של קבוצת ה-Multicast. אפשר גם לציין פרויקטים שיוגדרו בהמשך, כמו שמתואר במאמר הגדרת רשימת ההיתרים של צרכן המולטיקאסט.

gcloud

כדי לעדכן את טווח הקבוצה של כתובות מולטיקאסט כדי לדחות את כל הפרויקטים כברירת מחדל, משתמשים בפקודה network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --require-explicit-accept \
      [--consumer-accept-list=LIST_OF_CONSUMERS]

מחליפים את הערכים הבאים:

  • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast.

  • ‫LIST_OF_CONSUMERS: רשימה של פרויקטים של צרכנים שיכולים להשתמש בטווח הזה של קבוצות מולטיקאסט. אפשר לציין עד 100 פרויקטים לפי המזהה או השם שלהם.

    אם פרויקט קיים של צרכן מולטיקאסט משתמש בטווח של קבוצת מולטיקאסט ואתם רוצים להמשיך לתת לו גישה, אתם צריכים לציין את הפרויקט ברשימה. אחרת, Google Cloud כל ההפעלות הקיימות של צרכנים בקבוצת שידור מרובה משתתפים בטווח הקבוצות מושבתות. אם פרויקט יתווסף לרשימת הצרכנים המורשים בהמשך, האדמין של רשת הצרכנים של שידור מרובה משתתפים יצטרך ליצור הפעלות חדשות של צרכני קבוצות.

    אפשר גם להשמיט את הדגל הזה ולציין פרויקטים שיוגדרו בהמשך, כמו שמתואר במאמר הגדרת רשימת הצרכנים המורשים.

API

כדי לעדכן את טווח קבוצת ה-Multicast כך שכל הפרויקטים יידחו כברירת מחדל, משתמשים בשיטה multicastGroupRanges.patch.

מגדירים את השדה requireExplicitAccept לערך true. אפשר גם להגדיר את השדה consumerAcceptList.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=requireExplicitAccept,consumerAcceptList
  {
    "requireExplicitAccept": "true",
    "consumerAcceptList": [LIST_OF_CONSUMERS]
  }

מחליפים את הערכים הבאים:

  • ‫PROJECT_ID: המזהה של פרויקט האדמין של ה-Multicast
  • ‫GROUP_RANGE_NAME: השם של טווח כתובות המולטיקאסט

  • ‫LIST_OF_CONSUMERS: רשימה של פרויקטים של צרכנים שיכולים להשתמש בטווח הזה של קבוצות מולטיקאסט. הפורמט הנדרש הוא: "project-1", "project-2". אפשר לציין עד 100 פרויקטים לפי המזהה או השם שלהם.

    אם פרויקט קיים של צרכן מולטיקאסט משתמש בטווח של קבוצת מולטיקאסט ואתם רוצים להמשיך לתת לו גישה, אתם צריכים לציין את הפרויקט ברשימה. אחרת, Google Cloud כל ההפעלות הקיימות של צרכנים בקבוצת שידור מרובה משתתפים בטווח הקבוצות מושבתות. אם פרויקט יתווסף לרשימת הצרכנים המורשים בהמשך, האדמין של רשת הצרכנים של שידור מרובה משתתפים יצטרך ליצור הפעלות חדשות של צרכני קבוצות.

    אפשר להשמיט את consumerAcceptList מגוף הבקשה וממסכת העדכון, ולציין פרויקטים שיוגדרו בהמשך, כמו שמתואר במאמר הגדרת רשימת הפרויקטים שאושרו לשימוש.

הגדרה של רשימת היתרים של צרכני Multicast

בקטע הזה מוסבר איך להגדיר את רשימת ההיתרים של צרכני שידור מרובה כתובות לטווח של קבוצות שידור מרובה כתובות.

אם טווח קבוצות ה-Multicast חוסם את כל הפרויקטים כברירת מחדל, אפשר להגדיר את רשימת הצרכנים המורשים באופן הבא:

הגדרת רשימת כתובות חדשה לאישור

בקטע הזה מוסבר איך להגדיר רשימת צרכנים חדשה של שידור מרובה משתתפים לטווח של קבוצות שידור מרובה משתתפים.

פועלים לפי השלבים שבקטע הזה אם אתם מגדירים את רשימת ההיתרים של צרכני מולטיקאסט בפעם הראשונה, או אם אתם רוצים להחליף את רשימת ההיתרים הקיימת של הצרכנים. אם רוצים לשמור את הרשימה הקיימת ולהוסיף או להסיר פרויקט צרכן של שידור מרובה כתובות, אפשר לעיין במאמרים הוספת פרויקט לרשימת ההיתרים או הסרת פרויקט מרשימת ההיתרים.

gcloud

כדי להגדיר את רשימת ההיתרים לטווח של קבוצות מולטיקאסט, משתמשים בפקודה network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --consumer-accept-list=LIST_OF_CONSUMERS

מחליפים את הערכים הבאים:

  • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
  • ‫LIST_OF_CONSUMERS: פרויקט צרכני אחד או יותר שיכולים להשתמש בטווח של קבוצת ה-Multicast הזו. אפשר לציין עד 100 פרויקטים לפי המזהה או השם שלהם.

API

כדי להגדיר את רשימת ההיתרים לטווח של קבוצות מולטיקאסט, משתמשים ב-method ‏multicastGroupRanges.patch.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
  {
    "consumerAcceptList": [LIST_OF_CONSUMERS]
  }

מחליפים את הערכים הבאים:

  • ‫PROJECT_ID: המזהה של פרויקט האדמין של ה-Multicast
  • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
  • ‫LIST_OF_CONSUMERS: פרויקט צרכני אחד או יותר שיכולים להשתמש בטווח של קבוצת ה-Multicast הזו. צריך להשתמש בפורמט הבא: "project-1", "project-2". אפשר לציין עד 100 פרויקטים לפי המזהה או השם שלהם.

הוספת פרויקט לרשימת הפרויקטים שאפשר להשתמש בהם

בקטע הזה מוסבר איך מוסיפים פרויקט צרכן של שידור מרובה משתתפים לרשימת ההיתרים של טווח קבוצות של שידור מרובה משתתפים.

gcloud

כדי להוסיף פרויקט צרכן של שידור מרובה משתתפים לרשימת ההיתרים, משתמשים בפקודה network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --add-consumer-accept-list=LIST_OF_CONSUMERS

מחליפים את הערכים הבאים:

  • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
  • ‫LIST_OF_CONSUMERS: פרויקט אחד או יותר של צרכני מולטיקאסט שרוצים להוסיף לרשימת ההיתרים כדי שיוכלו להשתמש בטווח של קבוצת המולטיקאסט הזו.

API

כדי להוסיף פרויקט צרכן של שידור מרובה משתתפים לרשימת הפרויקטים המורשים, צריך לקבל את רשימת הפרויקטים המורשים הנוכחית ואז לשלוח בקשת API לעדכון הרשימה:

  1. כדי לראות את רשימת הכתובות הנוכחית של הקבוצה, פועלים לפי ההוראות במאמר הצגת טווחי כתובות של קבוצות מולטיקאסט. מעתיקים את רשימת ההיתרים כדי להשתמש בה בשלב הבא.

  2. כדי לעדכן את רשימת ההיתרים, משתמשים בשיטת multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
{
  "consumerAcceptList": [UPDATED_LIST_OF_CONSUMERS]
}

    מחליפים את הערכים הבאים:

    • ‫PROJECT_ID: המזהה של פרויקט האדמין של ה-Multicast
    • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
    • ‫UPDATED_LIST_OF_CONSUMERS: רשימת הפרויקטים המעודכנת שכוללת את הפרויקטים הקיימים שרוצים לשמור ואת הפרויקטים החדשים שרוצים להוסיף. צריך להשתמש בפורמט הבא: "project-1", "project-2". ממשק ה-API מחליף את כל רשימת הצרכנים שהסכימו ברשימה שאתם מספקים.

הסרת פרויקט מרשימת הפרויקטים שאפשר להצטרף אליהם

בקטע הזה מוסבר איך להסיר פרויקט של צרכן משידור מרובה כתובות מרשימת ההיתרים של טווח כתובות של קבוצת שידור מרובה כתובות.

gcloud

כדי להסיר פרויקט צרכן של שידור מרובה כתובות מרשימת הפרויקטים שאושרו, משתמשים בפקודה network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --remove-consumer-accept-list=LIST_OF_CONSUMERS

מחליפים את הערכים הבאים:

  • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
  • ‫LIST_OF_CONSUMERS: פרויקט צרכן אחד או יותר של שידור מרובה משתתפים להסרה מרשימת הצרכנים המאושרים, כדי שלא יוכלו להשתמש בטווח הזה של קבוצת שידור מרובה משתתפים.

API

כדי להסיר פרויקט צרכן של שידור מרובה משתתפים מרשימת ההסכמה, צריך לקבל את רשימת ההסכמה הנוכחית ואז לשלוח בקשת API לעדכון הרשימה:

  1. כדי לראות את רשימת הכתובות הנוכחית של הקבוצה, פועלים לפי ההוראות במאמר הצגת טווחי כתובות של קבוצות מולטיקאסט. מעתיקים את רשימת ההיתרים כדי להשתמש בה בשלב הבא.

  2. כדי לעדכן את רשימת ההיתרים, משתמשים בשיטת multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
{
  "consumerAcceptList": [UPDATED_LIST_OF_CONSUMERS]
}

    מחליפים את הערכים הבאים:

    • ‫PROJECT_ID: המזהה של פרויקט האדמין של ה-Multicast
    • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
    • ‫UPDATED_LIST_OF_CONSUMERS: רשימת הפרויקטים המעודכנת שכוללת את הפרויקטים הקיימים שרוצים לשמור, ולא כוללת את הפרויקטים שרוצים להסיר. צריך להשתמש בפורמט הבא: "project-1", "project-2". ממשק ה-API מחליף את כל רשימת המשתמשים שהביעו הסכמה ברשימה שאתם מספקים.

ניקוי רשימת ההסכמה

בקטע הזה נסביר איך מוחקים את רשימת ההיתרים של טווח קבוצות מולטיקאסט.

gcloud

כדי לנקות את רשימת המקבלים של טווח קבוצות מולטיקאסט, משתמשים בפקודה network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --clear-consumer-accept-list

מחליפים את GROUP_RANGE_NAME בשם של טווח קבוצת ה-Multicast.

API

כדי לנקות את רשימת הצרכנים המורשים לטווח של קבוצות מולטיקאסט, משתמשים בשיטה multicastGroupRanges.patch.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
  {
    "consumerAcceptList": []
  }

מחליפים את הערכים הבאים:

  • ‫PROJECT_ID: המזהה של פרויקט האדמין של ה-Multicast
  • ‫GROUP_RANGE_NAME: השם של טווח כתובות המולטיקאסט