Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ניהול משאבים של Data Transfer Essentials

בדף הזה מוסבר איך לנהל משאבים שנוצרו באמצעות Data Transfer Essentials.

ניהול תצורות

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

הצגת רשימת ההגדרות בפרויקט

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

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs list.

gcloud network-connectivity multicloud-data-transfer-configs list \
    --location=LOCATION

מחליפים את LOCATION באזור של התצורה.

API

משתמשים בשיטה multicloudDataTransferConfigs.get.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION: האזור של ההגדרה

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

צפייה בפרטים של הגדרה

כדי לראות את הפרטים של הגדרה, אפשר להשתמש באחת מהשיטות הבאות:

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs describe.

gcloud network-connectivity multicloud-data-transfer-configs describe CONFIGURATION_NAME \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

‫CONFIGURATION_NAME: השם של ההגדרה
‫LOCATION: האזור של ההגדרה

בדוגמת הפלט הבאה אפשר לראות שהתנועה מ-compute-engine מוכנה לחיוב ב-Data Transfer Essentials. במקרה של cloud-sql ו-cloud-storage, העדכון בהמתנה. הערך effectiveTime מציין את השעה שבה המצב צפוי להיכנס לתוקף. בדוגמה מוצג גם המספר הכולל של יעדים בהגדרה ומספר היעדים הפעילים.

description: 'sample config'
destinationsCount: 2
destinationsActiveCount: 0
name: config1
region: https://www.googleapis.com/network-connectivity/v1/projects/my-project/locations/europe-west3
services:
- cloud-sql:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: DELETING
- cloud-storage:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: ADDING
- compute-engine:
  states:
  - state: ACTIVE
…

API

משתמשים בשיטה multicloudDataTransferConfigs.list.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION: האזור של ההגדרה
‫CONFIGURATION_NAME: השם של ההגדרה

בדוגמה הבאה של פלט אפשר לראות שהתנועה מ-compute-engine מוכנה לחיוב ב-Data Transfer Essentials. במקרה של cloud-storage ו-cloud-sql, העדכון בהמתנה. הערך effectiveTime מציין את השעה שבה המצב אמור להיכנס לתוקף. בדוגמה מוצג גם המספר הכולל של יעדים בהגדרה ומספר היעדים שפעילים.

{
  "multicloudDataTransferConfig": [
    {
      "name": "projects/test-project/locations/europe-west1/multicloudDataTransferConfigs/config1",
      "createTime": "2025-05-14T10:16:22.761275571Z",
      "updateTime": "2025-05-14T10:16:25.872465362Z",
      "etag": "l-WY4OT6hBsMT8sAwEbuSpviLsE9iC_UDJXDyfE265I",
      "description": "sample config",
      "destinationsCount": 1,
      "destinationsActiveCount": 1,
      "services": {
        "cloud-sql": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "DELETING"
            }
          ]
        },
        "cloud-storage": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "ADDING"
            }
          ]
        },
        "compute-engine": {
          "states": [
            {
              "state": "ACTIVE"
            }
          ]
        }
      }
    }
  ]
}

המצב של שירות יכול להיות אחד מהבאים:

‫ADDING: השירות שמוסיפים.
‫DELETING: השירות נמחק.
‫ACTIVE: השירות מוגדר לחיוב ב-Data Transfer Essentials.

עדכון של הגדרה

כדי להוסיף או למחוק שירותים מההגדרה, אפשר להשתמש באחת מהדרכים הבאות:

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs update.

כדי לציין שירותים, משתמשים באחת מהאפשרויות הבאות:

‫services: מחליף את השירותים בהגדרה ברשימה שצוינה
‫update-services: מוסיף את השירותים שצוינו להגדרה
‫remove-services: מסיר את השירותים שצוינו מההגדרות
‫clear-services: מסיר את כל השירותים מההגדרה

gcloud network-connectivity multicloud-data-transfer-configs update CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --services=SERVICE-A,... |
        --update-services=SERVICE-A,... |
        --remove-services=SERVICE-A,... |
        --clear-services

מחליפים את מה שכתוב בשדות הבאים:

‫CONFIGURATION_NAME: השם של ההגדרה שרוצים לעדכן.
‫LOCATION: האזור של ההגדרה.
‫DESCRIPTION: תיאור של ההגדרה והמטרה שלה.
‫SERVICE-A,...: סדרה של מחרוזות שמייצגות את השירותים שרוצים להוסיף או למחוק מההגדרה. במאמר שירותים ואזורים נתמכים מפורטות מחרוזות תקינות. משתמשים ב-clear-services כדי להסיר את כל השירותים מההגדרה.

API

משתמשים בשיטה multicloudDataTransferConfigs.patch.

PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
{
  "description": "DESCRIPTION",
  "services": {
    "SERVICE-A",
    "SERVICE-B"
  }
}

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור של ההגדרה.
‫CONFIGURATION_NAME: השם של ההגדרה.
‫DESCRIPTION: תיאור של ההגדרה והמטרה שלה.
‫SERVICE-A: סדרה של מחרוזות שמייצגות את השירותים שרוצים להוסיף או למחוק מההגדרה. במאמר שירותים ואזורים נתמכים מפורטות מחרוזות תקינות.

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

עדכונים בהגדרות של Data Transfer Essentials נכנסים לתוקף תוך 24 שעות בערך.

מחיקת הגדרה

אפשר למחוק הגדרה רק אחרי שמוחקים את כל יעדי ההפצה שמשויכים אליה.

כדי למחוק הגדרה, משתמשים באחת מהשיטות הבאות:

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs delete.

gcloud network-connectivity multicloud-data-transfer-configs delete CONFIGURATION_NAME \
    --location=LOCATION

API

משתמשים בשיטה multicloudDataTransferConfigs.delete.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME

ניהול היעדים

אתם יכולים לראות את רשימת היעדים של Data Transfer Essentials בפרויקט, לבדוק את המצב של יעד, לעדכן יעד או למחוק אותו.

הצגת רשימת היעדים בפרויקט

כדי לראות רשימה של כל היעדים בפרויקט, אפשר להשתמש באחת מהשיטות הבאות:

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs destinations list.

gcloud network-connectivity multicloud-data-transfer-configs destinations list \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

‫CONFIGURATION_NAME: השם של ההגדרה שרוצים להציג את היעדים שלה
‫LOCATION: האזור של ההגדרה

API

משתמשים בשיטה multicloudDataTransferConfigs.destinations.list.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION: האזור של ההגדרה
‫CONFIGURATION_NAME: השם של ההגדרה שרוצים להציג את היעדים שלה

הצגת פרטים של יעד

כדי לראות את פרטי היעד, משתמשים באחת מהשיטות הבאות:

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs destinations describe.

gcloud network-connectivity multicloud-data-transfer-configs destinations describe DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

‫DESTINATION_NAME: השם של היעד
‫CONFIGURATION_NAME: השם של ההגדרה שרוצים לראות את היעד שלה
‫LOCATION: האזור של ההגדרה

בדוגמה הבאה אפשר לראות שנקודת הקצה שצוינה עבור destination1 תקינה, והיעד מתווסף בזמן שמצוין על ידי effectiveTime.

createTime: '2025-05-28T13:08:00.171978514Z'
description: 'sample destination'
endpoints:
- asn: 16509
  csp: aws
  state: VALID
etag: tag1
ipPrefix: 203.0.113.0/24
name: projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1
stateTimeline:
  states:
  - effectiveTime: '2025-05-29T07:00:00Z'
    state: ADDING
updateTime: '2025-05-28T13:08:03.431862259Z'
…

API

משתמשים בשיטה multicloudDataTransferConfigs.destinations.get.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION: האזור של ההגדרה
‫CONFIGURATION_NAME: השם של ההגדרה
‫DESTINATION_NAME: השם של היעד

בדוגמת הפלט הבאה אפשר לראות שהנקודה שהוגדרה ל-destination1 תקפה, והיעד יתווסף עד השעה שמצוינת ב-effectiveTime.

{
  "destination": [
    {
      "name": "projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1",
      "createTime": "2025-05-14T10:18:16.941520739Z",
      "updateTime": "2025-05-14T10:18:20.028116272Z",
      "etag": "tag1",
      "description": "sample destination",
      "ipPrefix": "203.0.113.0/24",
      "endpoints": [
        {
          "asn": 16509,
          "csp": "aws",
          "state": "VALID"
        }
      ],
      "stateTimeline": {
        "states": [
          {
            "state": "ADDING",
            "effectiveTime": "2025-05-29T07:00:00Z"
          }
        ]
      }
    }
  ]
}

הסטטוס של יעד יכול להיות אחד מהבאים:

‫ADDING: היעד מתווסף.
‫DELETING: היעד נמחק.
‫SUSPENDING: היעד מושעה על סמך ביקורת.
‫ACTIVE: היעד נכלל בחיוב של Data Transfer Essentials.
‫SUSPENDED: היעד נמחק או שהוא מפר את תנאי השימוש, ולכן הוא לא ייכלל בחיוב של Data Transfer Essentials.

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

‫VALID: השילוב של ערכי ה-ASN וה-CSP תקין.
‫INVALID: השילוב של ערכי ה-ASN וה-CSP לא תקין.

אם המצב של נקודת קצה אחת לפחות הוא VALID, היעד נחשב כמתאים לחיוב ב-Data Transfer Essentials.

אם הסטטוס של כל נקודות הקצה הוא INVALID, היעד לא עומד בדרישות לחיוב על Data Transfer Essentials. במקרה כזה, המצב של היעד מוגדר ל-SUSPENDING או ל-SUSPENDED, בהתאם למצב הנוכחי שהוא ADDING או ACTIVE, בהתאמה. התנועה ליעד כזה נחשבת לתנועה רגילה באינטרנט.

עדכון יעד

לכל יעד צריכה להיות לפחות נקודת קצה אחת, ולא יותר מחמש נקודות קצה.

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

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs destinations update.

כדי לציין נקודות קצה, משתמשים באחת מהאפשרויות הבאות. אפשר לציין את הדגלים add-endpoints או remove-endpoints כמה פעמים באותה פקודה.

‫endpoints: מחליף את נקודות הקצה ביעד ברשימה שצוינה
‫add-endpoints: מוסיף את נקודות הקצה שצוינו ליעד
‫remove-endpoints: מסיר את נקודות הקצה שצוינו מהיעד

gcloud network-connectivity multicloud-data-transfer-configs destinations update DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --ip-prefix=IP_PREFIX \
    --endpoints=asn=ASN,csp=CSP |
        --add-endpoints=asn=ASN,csp=CSP |
        --remove-endpoints=asn=ASN,csp=CSP

מחליפים את מה שכתוב בשדות הבאים:

‫DESTINATION_NAME: השם של היעד.
‫CONFIGURATION_NAME: השם של ההגדרה שרוצים לעדכן.
‫LOCATION: האזור של ההגדרה.
‫DESCRIPTION: תיאור של היעד והמטרה שלו.
‫IP_PREFIX: קידומת ה-IP של היעד שצוין כטווח או כערך.
לכל נקודת קצה, מציינים את הפרטים הבאים:
- ‫ASN: מספר ה-ASN שצפוי לפרסם את הקידומת. רשימת מספרי מערכות אוטונומיות (ASN) מוכרים
- ‫CSP: מחרוזת שמייצגת את ה-CSP של ה-ASN שמפרסם את הקידומת.

API

משתמשים בשיטה multicloudDataTransferConfigs.destinations.patch.

PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
  "description": "DESCRIPTION",
  "ip_prefix": "IP_PREFIX",
  "endpoints": [
    {
      "asn": "ASN",
      "csp": "CSP"
    }
  ]
}

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: האזור של ההגדרה.
‫CONFIGURATION_NAME: השם של ההגדרה.
‫DESTINATION_NAME: השם של היעד.
‫DESCRIPTION: תיאור של היעד והמטרה שלו.
‫IP_PREFIX: קידומת ה-IP של היעד שצוין כטווח (לדוגמה, 203.0.113.0/24 או 2001:db8::/32) או כערך (לדוגמה, 203.0.113.6 או 2001:db8:2:2:2:2:2:2). אפשר להשתמש בקידומת IP רק פעם אחת בהגדרה, ורק עבור ASN אחד.
מציינים מחרוזות שמתאימות לנקודות קצה שרוצים להוסיף ליעד, או מסירים נקודות קצה שלא רוצים לשמור ביעד:
- ‫ASN: מספר ה-ASN שצפוי לפרסם את הקידומת. רשימת מספרי מערכות אוטונומיות (ASN) מוכרים
- ‫CSP: מחרוזת שמייצגת את ה-CSP של ה-ASN שמפרסם את הקידומת.

העדכונים ביעדים של Data Transfer Essentials ובהגדרות שקשורות אליהם נכנסים לתוקף תוך 24 שעות בערך.

מחיקת יעד

כדי למחוק יעד, משתמשים באחת מהשיטות הבאות:

gcloud

משתמשים בפקודה gcloud network-connectivity multicloud-data-transfer-configs destinations delete.

gcloud network-connectivity multicloud-data-transfer-configs destinations delete DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

API

משתמשים בשיטה multicloudDataTransferConfigs.destinations.delete.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME

ניהול משאבים של Data Transfer Essentials קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

ניהול תצורות

הצגת רשימת ההגדרות בפרויקט

gcloud

API

צפייה בפרטים של הגדרה

gcloud

API

עדכון של הגדרה

gcloud

API

מחיקת הגדרה

gcloud

API

ניהול היעדים

הצגת רשימת היעדים בפרויקט

gcloud

API

הצגת פרטים של יעד

gcloud

API

עדכון יעד

gcloud

API

מחיקת יעד

gcloud

API

ניהול משאבים של Data Transfer Essentials