Method: organizations.locations.addressGroups.cloneItems

משכפל פריטים מקבוצת כתובות אחת לקבוצת כתובות אחרת.

בקשת HTTP

POST https://networksecurity.googleapis.com/v1beta1/{addressGroup=organizations/*/locations/*/addressGroups/*}:cloneItems

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
addressGroup

string

חובה. שם של קבוצת כתובות שאליה יש לשכפל את הפריטים. חייב להיות בפורמט projects|organization/*/locations/{location}/addressGroups/*.

כדי לתת הרשאה, צריך את הרשאת IAM הבאה במשאב שצוין addressGroup:

  • networksecurity.addressGroups.update

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "sourceAddressGroup": string,
  "requestId": string
}
שדות
sourceAddressGroup

string

חובה. קבוצת כתובות המקור שממנה יש לשכפל פריטים.

כדי לתת הרשאה, צריך את הרשאת IAM הבאה במשאב שצוין sourceAddressGroup:

  • networksecurity.addressGroups.get
requestId

string

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

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

מזהה הבקשה צריך להיות מזהה ייחודי אוניברסלי (UUID) תקין, למעט מזהה UUID אפס שלא נתמך (00000000-0000-0000-0000-000000000000).

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

מידע נוסף מופיע במאמר סקירה כללית על אימות.