שילוב של Compute Engine עם Google SecOps

במאמר הזה מוסבר איך לשלב את Compute Engine עם Google Security Operations.

תרחישים לדוגמה

השילוב עם Compute Engine משתמש ביכולות של Google SecOps כדי לתמוך בתרחישי השימוש הבאים:

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

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

  • ניהול נקודות חולשה: שילוב של כלי בדיקת נקודות חולשה עם Google SecOps כדי לסרוק באופן אוטומטי מכונות של Compute Engine לאיתור נקודות חולשה ידועות. ליצור כרטיסי תיקון או לתקן פגיעויות ישירות כדי להקטין את הסיכון לניצול לרעה ולשפר את מצב האבטחה.

  • אוטומציה של תאימות: אוטומציה של איסוף יומני ביקורת ונתוני הגדרה ממכונות Compute Engine כדי לעמוד בדרישות הרגולטוריות. יצירת דוחות ומרכזי בקרה עבור מבקרים כדי לפשט את הדיווח על תאימות ולצמצם את המאמץ הידני.

  • תזמור אבטחה: תזמור של תהליכי עבודה בתחום האבטחה במספר שירותים שלGoogle Cloud , כולל Compute Engine. לדוגמה, אפשר להגדיר טריגר ליצירת כלל חומת אש חדש בתגובה לאירוע אבטחה שזוהה במופע, וכך להשיג תיאום טוב יותר של מצב אבטחה אוטומטי.

לפני שמתחילים

לפני שמגדירים את השילוב של Compute Engine ב-Google SecOps, צריך לבצע את השלבים המקדימים הבאים:

  1. יצירה והגדרה של תפקיד בהתאמה אישית לניהול זהויות והרשאות גישה.

  2. יוצרים חשבון שירות.

  3. בוחרים ומגדירים אחת משיטות האימות הבאות:

    • אפשרות 1: Workload Identity (מומלץ): בשיטה הזו נעשה שימוש באסימוני גישה זמניים לטווח קצר באמצעות התחזות לחשבון שירות.

    • אפשרות 2: מפתח JSON של חשבון שירות: השיטה הזו מסתמכת על קובץ מפתח סודי סטטי לטווח ארוך.

יצירת תפקיד IAM בהתאמה אישית

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

  1. במסוף Google Cloud , עוברים אל IAM & Admin > Roles.

    לדף Roles

  2. לוחצים על הוספהיצירת תפקיד בהתאמה אישית.

  3. מציינים שם (לדוגמה, SecOps Compute Engine Integration), תיאור ומזהה ייחודי.

  4. מגדירים את שלב ההשקה של התפקיד לזמינות לכלל המשתמשים.

  5. לוחצים על Add Permissions ומוסיפים את ההרשאות הבאות:

    • compute.instances.list
    • compute.instances.start
    • compute.instances.stop
    • compute.instances.delete
    • compute.instances.setLabels
    • compute.instances.getIamPolicy
    • compute.instances.setIamPolicy
    • compute.instances.get
    • compute.zones.list

  6. לוחצים על יצירה.

יצירה של חשבון שירות

  1. במסוף Google Cloud , נכנסים אל IAM & Admin > Service Accounts.

    לדף Service accounts

  2. לוחצים על addCreate Service Account (הוספהיצירת חשבון שירות).

  3. מזינים שם ותיאור ולוחצים על יצירה והמשך.

  4. בשלב Grant this service account access to project (מתן גישה לחשבון השירות הזה לפרויקט), מקצים את התפקיד המותאם אישית שיצרתם.

  5. לוחצים על סיום. רושמים את כתובת האימייל של חשבון השירות.

הגדרת פרטי כניסה של Workload Identity

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

זיהוי הזהות הייחודית של המופע

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

  1. ב-Google SecOps, עוברים אל Content Hub > Response Integrations.

  2. בוחרים את השילוב Compute Engine ומזינים את כתובת האימייל בחשבון השירות ב-Workload Identity Email.

  3. לוחצים על שמירה > בדיקה. הבדיקה צפויה להיכשל.

  4. לוחצים על הכפתור close_small לצד בדיקה ומאתרים את כתובת האימייל של הזהות שמתחילה ב-gke-init-python@... או ב-soar-python@....

  5. מעתיקים את כתובת האימייל הייחודית הזו.

נותנים הרשאה לזהות המופע ב- Google Cloud

  1. במסוף Google Cloud , נכנסים אל IAM & Admin > Service Accounts.

    לדף Service accounts

  2. בוחרים את חשבון השירות של היעד ועוברים אל הרשאות > הענקת גישה.

  3. מדביקים את כתובת האימייל הייחודית בשדה New principals ומקצים את התפקיד Service Account Token Creator (roles/iam.serviceAccountTokenCreator).

הגדרת מפתח JSON

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

  1. במסוף Google Cloud , נכנסים אל IAM & Admin > Service Accounts ובוחרים את חשבון השירות.

    לדף Service accounts

  2. עוברים לכרטיסייה מפתחות ולוחצים על הוספת מפתח > יצירת מפתח חדש.

  3. בוחרים באפשרות JSON ולוחצים על Create (יצירה). הקובץ יורד אוטומטית למחשב.

הגדרת פרמטרים ידנית

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

פרמטרים של שילוב

כדי ליצור קישור בין Google SecOps לבין Compute Engine, צריך להגדיר את הפרמטרים הבאים. השילוב תומך בשלושה נתיבי אימות שונים. בוחרים אחת מהשיטות הבאות כדי לספק את פרטי הכניסה:

  • ‫Workload Identity: נעשה שימוש ב-Workload Identity Email.
  • קובץ JSON של חשבון שירות: משתמש ב-Service Account Json File Content כדי לספק את המפתח כולו בבת אחת.
  • פרמטרים ידניים נפרדים: שימוש בשדות נפרדים שהועתקו באופן ידני ממפתח JSON.
פרמטר תיאור
API Root

זה שינוי אופציונלי.

כתובת ה-URL הבסיסית של Compute Engine API.

ערך ברירת המחדל הוא https://compute.googleapis.com.
OS Config API Root

זה שינוי אופציונלי.

כתובת ה-URL הבסיסית של Cloud OS Config API.

ערך ברירת המחדל הוא https://osconfig.googleapis.com.
Workload Identity Email

זה שינוי אופציונלי.

כתובת האימייל של הלקוח בחשבון השירות. משתמשים בזה לאימות Workload Identity.
Service Account Json File Content

זה שינוי אופציונלי.

התוכן המלא של קובץ ה-JSON של מפתח חשבון השירות.

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

זה שינוי אופציונלי.

מזהה הפרויקט של Google Cloud שאליו רוצים לטרגט.

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

חובה.

מאמת את אישור ה-SSL של החיבור. ההגדרה הזו מופעלת כברירת מחדל.

פרמטרים של פרטי כניסה אישיים

משתמשים בפרמטרים הבאים רק אם מזינים פרטי כניסה באופן ידני, ולא אם משתמשים בתוכן המלא של קובץ JSON או ב-Workload Identity.

פרמטר תיאור
Account Type

זה שינוי אופציונלי.

הערך שמופיע בשדה type של מפתח ה-JSON (בדרך כלל service_account).
Private Key ID

זה שינוי אופציונלי.

הערך שמופיע בשדה private_key_id של מפתח ה-JSON.
Private Key

זה שינוי אופציונלי.

הערך שמופיע בשדה private_key במפתח ה-JSON.
Client Email

זה שינוי אופציונלי.

הערך שמופיע בשדה client_email של מפתח ה-JSON.
Client ID

זה שינוי אופציונלי.

הערך שמופיע בשדה client_id במפתח ה-JSON.
Auth URI

זה שינוי אופציונלי.

הערך שמופיע בשדה auth_uri של מפתח ה-JSON.

ערך ברירת המחדל הוא https://accounts.google.com/o/oauth2/auth.
Token URI

זה שינוי אופציונלי.

הערך שמופיע בשדה token_uri במפתח ה-JSON.

ערך ברירת המחדל הוא https://oauth2.googleapis.com/token.
Auth Provider X509 URL

זה שינוי אופציונלי.

הערך שמופיע בשדה auth_provider_x509_cert_url של מפתח ה-JSON.
Client X509 URL

זה שינוי אופציונלי.

הערך שמופיע בשדה client_x509_cert_url של מפתח ה-JSON.

הוראות להגדרת שילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

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

פעולות

מידע נוסף על פעולות זמין במאמרים איך מגיבים לפעולות שממתינות לאישור ב-Your Workdesk ואיך מבצעים פעולה ידנית.

הוספת כתובת IP לכלל חומת האש

משתמשים בפעולה Add IP Range to Firewall Rule כדי להוסיף טווח כתובות IP לכלל חומת אש קיים במכונה של Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Add IP To Firewall Rule (הוספת כתובת IP לכלל חומת האש) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /projects/PROJECT_ID/global/ firewallsFIREWALL.

הפרמטר הזה מקבל עדיפות על פני Project ID ו-Firewall Rule.
Project ID

זה שינוי אופציונלי.

שם הפרויקט שמשויך למופע Compute Engine.

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

זה שינוי אופציונלי.

השם של כלל חומת האש הספציפי שרוצים לעדכן.
Type

חובה.

כיוון התנועה לטווח כתובות ה-IP שמוסיפים.

הערכים האפשריים הם:

  • Source
  • Destination

ערך ברירת המחדל הוא Source.
IP Ranges

חובה.

רשימה מופרדת בפסיקים של טווחי כתובות IP (סימון CIDR) להוספה לכלל חומת האש.

פלט של פעולות

הפעולה Add IP To Firewall Rule מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Add IP To Firewall Rule:

{
  "kind": "compute#operation",
  "id": "0000000000000000000",
  "name": "operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "operationType": "patch",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name",
  "targetId": "7886634413370691799",
  "status": "DONE",
  "user": "compute-admin@project-id.iam.gserviceaccount.com",
  "progress": 100,
  "insertTime": "2024-05-20T09:42:05.150-07:00",
  "startTime": "2024-05-20T09:42:05.164-07:00",
  "endTime": "2024-05-20T09:42:09.381-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/operations/operation-1234567890",
  "firewall": {
    "kind": "compute#firewall",
    "id": "6297155974506248217",
    "creationTimestamp": "2023-09-13T07:28:06.690-07:00",
    "name": "firewall-name",
    "description": "",
    "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/vpc-network",
    "priority": 1000,
    "sourceRanges": [
      "0.0.0.0/0"
    ],
    "destinationRanges": [
      "0.0.0.0/21"
    ],
    "allowed": [
      {
        "IPProtocol": "tcp",
        "ports": [
          "22"
        ]
      }
    ],
    "direction": "INGRESS",
    "logConfig": {
      "enable": false
    },
    "disabled": false,
    "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name"
  }
}
הודעות פלט

הפעולה הוספת כתובת IP לכלל חומת אש יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully updated firewall rule in Google Cloud Compute.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.

 הפעולה הסתיימה בהצלחה.
Error executing action "Add IP To Firewall Rule". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Add IP To Firewall Rule:

שם התוצאה של הסקריפט ערך
is_success true או false

הוספת תוויות למופע

משתמשים בפעולה Add Labels to Instance כדי להוסיף או לעדכן תוויות במופע ספציפי של Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Add Labels to Instance דורשת את הפרמטרים הבאים:

פרמטר תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID,‏ Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של מופע Compute Engine.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance Labels

חובה.

רשימה מופרדת בפסיקים של תוויות להחלה על המופע, בפורמט key:value (למשל vm_label_key:label1).

פלט של פעולות

הפעולה Add Labels to Instance (הוספת תוויות למופע) מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט תוצאת ה-JSON שמתקבל כשמשתמשים בפעולה Add Labels to Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "setLabels",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "RUNNING",
   "user": "user@example.com",
   "progress": 0,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
הודעות פלט

הפעולה Add Labels to Instance יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Labels LABEL_LIST were successfully added to Compute Engine instance INSTANCE_ID.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

Labels were not added because provided label LABEL_ID has the key that already exist for the Compute Engine instance INSTANCE_ID.

 הפעולה הסתיימה בהצלחה.
Error executing action "Add Labels to Instance". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה הוספת תוויות למופע:

שם התוצאה של הסקריפט ערך
is_success true או false

הוספת תגי רשת

משתמשים בפעולה Add Network Tags (הוספת תגי רשת) כדי להוסיף תג רשת אחד או יותר למכונת Compute Engine ספציפית.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Add Network Tags (הוספת תגים לרשת) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID,‏ Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של מופע Compute Engine.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Network Tags

חובה.

רשימה מופרדת בפסיקים של תגי רשת להוספה למופע.

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

פלט של פעולות

הפעולה Add Network Tags מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Add Network Tags:

{
  "kind": "compute#instance",
  "id": "1459671903146615834",
  "creationTimestamp": "2023-09-13T04:20:21.993-07:00",
  "name": "instance-2",
  "description": "",
  "tags": {
    "items": [
      "another-tag",
      "tag"
    ],
    "fingerprint": "BCeEINC7Ths="
  },
  "machineType": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/machineTypes/e2-micro",
  "status": "RUNNING",
  "zone": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a",
  "canIpForward": false,
  "networkInterfaces": [
    {
      "kind": "compute#networkInterface",
      "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/default",
      "subnetwork": "https://www.googleapis.com/compute/v1/projects/project-id/regions/us-central1/subnetworks/default",
      "networkIP": "10.128.0.3",
      "name": "nic0",
      "fingerprint": "-ZnnV7hiDfs=",
      "stackType": "IPV4_ONLY"
    }
  ],
  "disks": [
    {
      "kind": "compute#attachedDisk",
      "type": "PERSISTENT",
      "mode": "READ_WRITE",
      "source": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/disks/instance-2",
      "deviceName": "instance-2",
      "index": 0,
      "boot": true,
      "autoDelete": true,
      "licenses": [
        "https://www.googleapis.com/compute/v1/projects/centos-cloud/global/licenses/centos-7"
      ],
      "interface": "SCSI",
      "guestOsFeatures": [
        { "type": "UEFI_COMPATIBLE" },
        { "type": "GVNIC" }
      ],
      "diskSizeGb": "20",
      "architecture": "X86_64"
    }
  ],
  "metadata": {
    "kind": "compute#metadata",
    "fingerprint": "NBmH4-7Jw9U=",
    "items": []
  },
  "serviceAccounts": [
    {
      "email": "1111111111-compute@developer.gserviceaccount.com",
      "scopes": [
        "https://www.googleapis.com/auth/devstorage.read_only",
        "https://www.googleapis.com/auth/logging.write",
        "https://www.googleapis.com/auth/monitoring.write",
        "https://www.googleapis.com/auth/servicecontrol",
        "https://www.googleapis.com/auth/service.management.readonly",
        "https://www.googleapis.com/auth/trace.append"
      ]
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/instances/instance-2",
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD"
  },
  "cpuPlatform": "Intel Broadwell",
  "deletionProtection": false,
  "shieldedInstanceConfig": {
    "enableSecureBoot": false,
    "enableVtpm": true,
    "enableIntegrityMonitoring": true
  }
}
הודעות פלט

הפעולה Add Network Tags יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully added network tags to the instance RESOURCE_PATH in Compute Engine.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Compute Engine.

 הפעולה הסתיימה בהצלחה.
Error executing action "Add Network Tags". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Add Network Tags:

שם התוצאה של הסקריפט ערך
is_success true או false

מחיקת מכונה

משתמשים בפעולה Delete Instance כדי למחוק מכונות וירטואליות ב-Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Delete Instance דורשת את הפרמטרים הבאים:

פרמטר תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID,‏ Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של המופע שרוצים להפעיל.

אפשר לאחזר את הערך הזה באמצעות הפעולה List Instances.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.

פלט של פעולות

הפעולה Delete Instance מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט של תוצאת JSON שמתקבלת כשמשתמשים בפעולה Delete Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "delete",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "RUNNING",
   "user": "user@example.com",
   "progress": 0,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
הודעות פלט

הפעולה Delete Instance יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Compute Engine instance INSTANCE_ID was deleted successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 הפעולה הסתיימה בהצלחה.

Error executing action "Start Instance". Reason: ERROR_REASON

Provided resource RESOURCE_PATH is not valid

הפעולה נכשלה.

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

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

שם התוצאה של הסקריפט ערך
is_success true או false

העשרת ישויות

אפשר להשתמש בפעולה Enrich Entities כדי להעשיר ישויות של Google SecOpsIP Address במידע על המכונה מ-Compute Engine.

הפעולה הזו מופעלת בישויות הבאות של Google SecOps:

  • IP Address

הוספת נתונים לפעולה

הפעולה Enrich Entities דורשת את הפרמטרים הבאים:

פרמטרים תיאור
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

פלט של פעולות

הפעולה Enrich Entities מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת יש גישה
טבלת העשרה יש גישה
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
טבלת קיר עם תושבת

אחרי השלמת ההרצה, הפעולה Enrich Entities (העשרת ישויות) מספקת את הטבלה הבאה:

שם הטבלה: ENTITY Enrichment Table

עמודות:

  • שדה של ישות
  • ערך
טבלת העשרה

הפעולה Enrich Entities (העשרת ישויות) תומכת בהעשרת הישויות הבאה:

שדה העשרה מקור (מפתח JSON) לוגיקה
Google_Compute_instance_id id לא זמין
Google_Compute_creation_timestamp creationTimestamp לא זמין
Google_Compute_instance_name name לא זמין
Google_Compute_description description לא זמין
Google_Compute_tags tags צריך לספק את התגים ברשימת CSV
Google_Compute_machine_type machineType לא זמין
Google_Compute_instance_status status לא זמין
Google_Compute_instance_zone zone לא זמין
Google_Compute_can_ip_forward canIpForward לא זמין
Google_Compute_instance_network_interfaces_name_INDEX networkInterfaces.name אפשר להרחיב אם יש עוד ממשקי רשת זמינים
Google_Compute_instance_network_interfaces_name_access_configs_type_INDEX networkInterfaces.accessConfigs.type אפשר להרחיב אם יש עוד ממשקי רשת זמינים
Google_Compute_instance_network_interfaces_name_access_configs_name_INDEX networkInterfaces.accessConfigs.name אפשר להרחיב אם יש עוד ממשקי רשת זמינים
Google_Compute_instance_network_interfaces_name_access_configs_natIP_INDEX networkInterfaces.accessConfigs.natIP אפשר להרחיב אם יש עוד ממשקי רשת זמינים
Google_Compute_instance_metadata metadata רשימת ערכים בפורמט CSV ממטא-נתונים של מופע
Google_Compute_service_account_INDEX serviceAccounts.email הרחבה אם יש עוד חשבונות שירות זמינים
Google_Compute_service_account_scopes_INDEX serviceAccounts.scopes הרחבה אם יש עוד חשבונות שירות זמינים
Google_Compute_link_to_Google_Compute selfLink לא זמין
Google_Compute_labels labels צריך לספק רשימת ערכים בפורמט CSV
Google_Compute_instance_last_start_timestamp lastStartTimestamp לא זמין
Google_Compute_instance_last_stop_timestamp lastStopTimestamp לא זמין
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט של תוצאת JSON שמתקבלת כשמשתמשים בפעולה Enrich Entities:

{
    "id": "ID",
    "creationTimestamp": "2021-04-28T21:34:57.369-07:00",
    "name": "instance-1",
    "description": "",
    "tags": {
        "fingerprint": "VALUE"
    },
    "machineType": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/machineTypes/f1-micro",
    "status": "RUNNING",
    "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
    "canIpForward": false,
    "networkInterfaces": [
        {
            "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
            "subnetwork": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1/subnetworks/default",
            "networkIP": "203.0.113.2",
            "name": "example",
            "accessConfigs": [
                {
                    "type": "ONE_TO_ONE_NAT",
                    "name": "External NAT",
                    "natIP": "198.51.100.59",
                    "networkTier": "PREMIUM",
                    "kind": "compute#accessConfig"
                }
            ],
            "fingerprint": "VALUE",
            "kind": "compute#networkInterface"
        }
    ],
    "disks": [
        {
            "type": "PERSISTENT",
            "mode": "READ_WRITE",
            "source": "https://www.googleapis.com/compute/v1/PROJECT_ID/zones/us-central1-a/disks/instance-1",
            "deviceName": "instance-1",
            "index": 0,
            "boot": true,
            "autoDelete": true,
            "licenses": [
                "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/licenses/LICENSE"
            ],
            "interface": "SCSI",
            "guestOsFeatures": [
                {
                    "type": "UEFI_COMPATIBLE"
                },
                {
                    "type": "VIRTIO_SCSI_MULTIQUEUE"
                }
            ],
            "diskSizeGb": "10",
            "kind": "compute#attachedDisk"
        }
    ],
    "metadata": {
        "fingerprint": "VALUE",
        "kind": "compute#metadata"
    },
    "serviceAccounts": [
        {
            "email": "user@example.com",
            "scopes": [
                "https://www.googleapis.com/auth/devstorage.read_only",
                "https://www.googleapis.com/auth/logging.write",
                "https://www.googleapis.com/auth/monitoring.write",
                "https://www.googleapis.com/auth/servicecontrol",
                "https://www.googleapis.com/auth/service.management.readonly",
                "https://www.googleapis.com/auth/trace.append"
            ]
        }
    ],
    "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/instance-1",
    "scheduling": {
        "onHostMaintenance": "MIGRATE",
        "automaticRestart": true,
        "preemptible": false
    },
    "cpuPlatform": "Intel Haswell",
    "labels": {
        "vm_test_tag": "tag1"
    },
    "labelFingerprint": "VALUE",
    "startRestricted": false,
    "deletionProtection": false,
    "reservationAffinity": {
        "consumeReservationType": "ANY_RESERVATION"
    },
    "displayDevice": {
        "enableDisplay": false
    },
    "shieldedInstanceConfig": {
        "enableSecureBoot": false,
        "enableVtpm": true,
        "enableIntegrityMonitoring": true
    },
    "shieldedInstanceIntegrityPolicy": {
        "updateAutoLearnPolicy": true
    },
    "confidentialInstanceConfig": {
        "enableConfidentialCompute": false
    },
    "fingerprint": "VALUE",
    "lastStartTimestamp": "2021-04-28T21:35:07.865-07:00",
    "kind": "compute#instance"
}
הודעות פלט

הפעולה Enrich Entities יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully enriched entities: ENTITY_ID.

Provided instance zone ZONE_ID is not valid.

Action was not able to find a match Compute Engine to enrich provided entities: ENTITY_ID.

No entities were enriched.

 הפעולה הסתיימה בהצלחה.
Error executing action "Enrich Entities". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Enrich Entities:

שם התוצאה של הסקריפט ערך
is_success true או false

ביצוע של משימת תיקון של מכונה וירטואלית

משתמשים בפעולה Execute VM Patch Job כדי להריץ עבודת תיקון של מכונות וירטואליות במכונות של Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Execute VM Patch Job (הפעלת עבודת תיקון של מכונה וירטואלית) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Instance Filter Object

חובה.

אובייקט JSON שמשמש לטירגוט מופעים ספציפיים לצורך תיקון.

ערך ברירת המחדל מכוון לכל המקרים:

{
  "all": "true"
}
Name

חובה.

השם הייחודי של עבודת התיקון.
Description

זה שינוי אופציונלי.

תיאור קצר של מטרת עבודת התיקון.
Patching Config Object

זה שינוי אופציונלי.

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

אם לא מציינים ערך, הפעולה משתמשת בערך ברירת המחדל הבא:

{
  "rebootConfig": "DEFAULT",
  "apt": {
    "type": "DIST"
  },
  "yum": {
    "security": true
  },
  "zypper": {
    "withUpdate": true
  },
  "windowsUpdate": {
    "classifications": ["CRITICAL", "SECURITY"]
  }
}
Patch Duration Timeout

חובה.

משך הזמן המקסימלי, בדקות, שמוקצה להרצת משימת התיקון.

ערך ברירת המחדל הוא 60.
Rollout Strategy

זה שינוי אופציונלי.

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

הערכים האפשריים הם:

  • ‫Zone By Zone: התיקונים מוחלים על אזור אחד בכל פעם כדי למזער את הסיכון.
  • ‫Concurrent Zones: התיקונים מוחלים על כל האזורים המיועדים בו-זמנית כדי לקצר את חלון הזמן הכולל לתחזוקה.

ערך ברירת המחדל הוא Zone By Zone.
Disruption Budget

חובה.

המספר או האחוז של המופעים שיכולים להיות אופליין בו-זמנית (לדוגמה, 5 או 10%).

ערך ברירת המחדל הוא 10%.
Wait For Completion

חובה.

אם בוחרים באפשרות הזו, הפעולה נשארת פעילה עד לסיום עבודת הטלאים.

ההגדרה הזו מופעלת כברירת מחדל.
Fail If Completed With Errors

חובה.

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

המערכת מתעלמת מהפרמטר הזה אם ההגדרה Wait For Completion מושבתת.

ההגדרה הזו מופעלת כברירת מחדל.

פלט של פעולות

הפעולה Execute VM Patch Job מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט תוצאת ה-JSON שמתקבל כשמשתמשים בפעולה Execute VM Patch Job:

{
            "name": "projects/PROJECT_ID/patchJobs/JOB_ID",
            "createTime": "2024-09-24T16:00:43.354907Z",
            "updateTime": "2024-09-24T16:00:44.626050Z",
            "state": "PATCHING",
            "patchConfig": {
                "rebootConfig": "DEFAULT",
                "apt": {
                    "type": "UPGRADE"
                },
                "yum": {},
                "zypper": {},
                "windowsUpdate": {}
            },
            "duration": "3600s",
            "instanceDetailsSummary": {
                "startedInstanceCount": "1"
            },
            "percentComplete": 20,
            "instanceFilter": {
                "instances": [
                    "zones/us-central1-a/instances/INSTANCE_ID"
                ]
            },
            "displayName": "test",
            "rollout": {
                "mode": "ZONE_BY_ZONE",
                "disruptionBudget": {
                    "percent": 25
                }
            }
        }
הודעות פלט

הפעולה Execute VM Patch Job יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully executed VM patching job in Google Cloud Compute.

Successfully executed and completed VM patching job in Google Cloud Compute.

The executed patching job was canceled in Google Cloud Compute.

The executed patching job was completed, but with errors in Compute Engine. Errors: ERROR_DESCRIPTION

 הפעולה הסתיימה בהצלחה.
Error executing action "Execute VM Patch Job". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Execute VM Patch Job:

שם התוצאה של הסקריפט ערך
is_success true או false

קבלת מדיניות IAM לגבי מכונה

משתמשים בפעולה Get Instance IAM Policy כדי לאחזר את מדיניות בקרת הגישה של ניהול הזהויות והרשאות הגישה (iam_name_short) למשאב ספציפי של Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Get Instance IAM Policy דורשת את הפרמטרים הבאים:

פרמטר תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID,‏ Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של המופע שרוצים להפעיל.

אפשר לאחזר את הערך הזה באמצעות הפעולה List Instances.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.

פלט של פעולות

הפעולה Get Instance IAM Policy מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Get Instance IAM Policy:

{
    "version": 1,
    "etag": "BwXBfsc47MI=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer_withcond_2f0c00",
            "members": [
                "user:user@example.com"
            ]
        }
    ]
}
הודעות פלט

הפעולה Get Instance IAM Policy יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Compute Engine instance INSTANCE_ID IAM policy was fetched successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 הפעולה הסתיימה בהצלחה.
Error executing action "Get Instance IAM Policy". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Get Instance IAM Policy:

שם התוצאה של הסקריפט ערך
is_success true או false

הצגת רשימה של מכונות

משתמשים בפעולה List Instances כדי להציג רשימה של מופעי Compute Engine על סמך קריטריוני חיפוש שצוינו.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה List Instances דורשת את הפרמטרים הבאים:

פרמטר תיאור
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שממנו רוצים להציג רשימה של מופעים.

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

זה שינוי אופציונלי.

האזור הספציפי שבו רוצים לחפש מופעים.

אם לא מציינים ערך, הפעולה מחפשת בכל האזורים הזמינים.
Instance Name

זה שינוי אופציונלי.

שם המופע לחיפוש.

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

זה שינוי אופציונלי.

המצב הנוכחי של המופעים שייכללו בתוצאות החיפוש, למשל RUNNING או TERMINATED.

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

זה שינוי אופציונלי.

התוויות שמשמשות לסינון התוצאות של המופע, בפורמט key:value (למשל env:production).

הפרמטר הזה מקבל כמה ערכים כמחרוזת שמופרדת באמצעות פסיקים.
Max Rows to Return

זה שינוי אופציונלי.

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

ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה List Instances מספקת את התוצאות הבאות:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת יש גישה
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
טבלת קיר עם תושבת

הפעולה List Instances מספקת את הטבלה הבאה:

שם הטבלה: Compute Engine Instances

עמודות בטבלה:

  • שם המכונה
  • מזהה מופע
  • מועד יצירת המופע
  • תיאור המופע
  • Instance Type
  • סטטוס המופע
  • תוויות של מכונות
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט של תוצאת JSON שמתקבלת כשמשתמשים בפעולה List Instances:

{ "id": "projects/PROJECT_ID/zones/us-central1-a/instances",
   "items": [
       {
           "id": "ID",
           "creationTimestamp": "2021-04-28T21:34:57.369-07:00",
           "name": "instance-1",
           "description": "",
           "tags": {
               "fingerprint": "VALUE"
           },
           "machineType": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/machineTypes/f1-micro",
           "status": "RUNNING",
           "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
           "canIpForward": false,
           "networkInterfaces": [
               {
                   "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
                   "subnetwork": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-central1/subnetworks/default",
                   "networkIP": "192.0.2.2",
                   "name": "example",
                   "accessConfigs": [
                       {
                           "type": "ONE_TO_ONE_NAT",
                           "name": "External NAT",
                           "natIP": "203.0.113.59",
                           "networkTier": "PREMIUM",
                           "kind": "compute#accessConfig"
                       }
                   ],
                   "fingerprint": "VALUE",
                   "kind": "compute#networkInterface"
               }
           ],
           "disks": [
               {
                   "type": "PERSISTENT",
                   "mode": "READ_WRITE",
                   "source": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/disks/instance-1",
                   "deviceName": "instance-1",
                   "index": 0,
                   "boot": true,
                   "autoDelete": true,
                   "licenses": [
                       "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/licenses/LICENSE"
                   ],
                   "interface": "SCSI",
                   "guestOsFeatures": [
                       {
                           "type": "UEFI_COMPATIBLE"
                       },
                       {
                           "type": "VIRTIO_SCSI_MULTIQUEUE"
                       }
                   ],
                   "diskSizeGb": "10",
                   "kind": "compute#attachedDisk"
               }
           ],
           "metadata": {
               "fingerprint": "VALUE",
               "kind": "compute#metadata"
           },
           "serviceAccounts": [
               {
                   "email": "user@example.com",
                   "scopes": [
                       "https://www.googleapis.com/auth/devstorage.read_only",
                       "https://www.googleapis.com/auth/logging.write",
                       "https://www.googleapis.com/auth/monitoring.write",
                       "https://www.googleapis.com/auth/servicecontrol",
                       "https://www.googleapis.com/auth/service.management.readonly",
                       "https://www.googleapis.com/auth/trace.append"
                   ]
               }
           ],
           "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_IDzones/us-central1-a/instances/instance-1",
           "scheduling": {
               "onHostMaintenance": "MIGRATE",
               "automaticRestart": true,
               "preemptible": false
           },
           "cpuPlatform": "Intel Haswell",
           "labels": {
               "vm_test_tag": "tag1"
           },
           "labelFingerprint": "VALUE",
           "startRestricted": false,
           "deletionProtection": false,
           "reservationAffinity": {
               "consumeReservationType": "ANY_RESERVATION"
           },
           "displayDevice": {
               "enableDisplay": false
           },
           "shieldedInstanceConfig": {
               "enableSecureBoot": false,
               "enableVtpm": true,
               "enableIntegrityMonitoring": true
           },
           "shieldedInstanceIntegrityPolicy": {
               "updateAutoLearnPolicy": true
           },
           "confidentialInstanceConfig": {
               "enableConfidentialCompute": false
           },
           "fingerprint": "VALUE",
           "lastStartTimestamp": "2021-04-28T21:35:07.865-07:00",
           "kind": "compute#instance"
       }
   ]
}
הודעות פלט

הפעולה List Instances יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully fetched Compute Engine instances.

Provided instance zone ZONE_ID is not valid.

No instances were found in Compute Engine.

 הפעולה הסתיימה בהצלחה.
Error executing action "List Instances". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה List Instances:

שם התוצאה של הסקריפט ערך
is_success true או false

פינג

משתמשים בפעולה Ping כדי לבדוק את הקישוריות ל-Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

אין.

פלט של פעולות

הפעולה Ping מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON לא זמין
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
הודעות פלט

הפעולה Ping יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully connected to the Compute Engine service with the provided connection parameters! הפעולה הסתיימה בהצלחה.
Failed to connect to the Compute Engine service! Error is ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט תוצאת הסקריפט כשמשתמשים בפעולה Ping:

שם התוצאה של הסקריפט ערך
is_success true או false

הסרת כתובות IP חיצוניות

משתמשים בפעולה הסרת כתובות IP חיצוניות כדי להסיר כתובות IP חיצוניות במכונה וירטואלית של Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Remove External IP Addresses (הסרת כתובות IP חיצוניות) דורשת את הפרמטרים הבאים:

פרמטרים תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID, Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של המופע שרוצים להפעיל.

אפשר לאחזר את הערך הזה באמצעות הפעולה List Instances.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Network Interfaces

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של ממשקי הרשת הספציפיים שרוצים לשנות.

אם לא מציינים ערך או אם משתמשים בתו כללי *, הפעולה מעדכנת את כל ממשקי הרשת.

ערך ברירת המחדל הוא *.

פלט של פעולות

הפעולה הסרת כתובות IP חיצוניות מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

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

[
    {
        "endTime": "2024-05-21T04:28:05.371-07:00",
        "id": "ID",
        "insertTime": "2024-05-21T04:28:04.176-07:00",
        "kind": "compute#operation",
        "name": "operation-OPERATION_ID",
        "operationType": "updateNetworkInterface",
        "progress": 100,
        "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/operations/operation-OPERATION_ID",
        "startTime": "2024-05-21T04:28:04.190-07:00",
        "status": "DONE",
        "targetId": "TARGET_ID",
        "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/instances/INSTANCE_ID",
        "user": "user@example.com",
        "zone": "us-west1-a",
        "networkInterface": "example"
    },
    {
        "endTime": "2024-05-21T04:28:06.549-07:00",
        "id": "2531200345768541098",
        "insertTime": "2024-05-21T04:28:05.419-07:00",
        "kind": "compute#operation",
        "name": "operation-OPERATION_ID",
        "operationType": "deleteAccessConfig",
        "progress": 100,
        "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/operations/operation-OPERATION_ID",
        "startTime": "2024-05-21T04:28:05.430-07:00",
        "status": "DONE",
        "targetId": "3905740668247239013",
        "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-west1-a/instances/INSTANCE_ID",
        "user": "user@example.com",
        "zone": "us-west1-a",
        "networkInterface": "example"
    }
]
הודעות פלט

הפעולה Remove External IP Addresses יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully removed external IP addresses from RESOURCE_PATH instance in INTEGRATION_NAME.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in INTEGRATION_NAME.

 הפעולה הסתיימה בהצלחה.

Error executing action "Remove External IP Addresses". Reason: ERROR_REASON

Action ran into a timeout during execution. Pending operations: PENDING_OPERATIONS. Please increase the timeout in IDE.

The following network interfaces were not found: INTERFACES on the RESOURCE_PATH in INTEGRATION_NAME. Please check the spelling.

Provided instance zone is not valid.

Provided instance ID is not valid.

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה הסרת כתובות IP חיצוניות:

שם התוצאה של הסקריפט ערך
is_success true או false

הסרת כתובת IP מכלל חומת האש

משתמשים בפעולה Remove IP From Firewall Rule כדי למחוק טווחים ספציפיים של כתובות IP מכלל קיים של חומת אש ב-Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Remove IP From Firewall Rule (הסרת כתובת IP מכלל חומת האש) דורשת את הפרמטרים הבאים:

פרמטר תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /projects/PROJECT_ID/global/ firewallsFIREWALL.

הפרמטר הזה מקבל עדיפות על פני Project ID ו-Firewall Rule.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

השם של כלל חומת האש הספציפי שרוצים לעדכן.
Type

חובה.

כיוון התנועה לטווח כתובות ה-IP שמוסיפים.

הערכים האפשריים הם:

  • Source
  • Destination

ערך ברירת המחדל הוא Source.
IP Ranges

חובה.

רשימה מופרדת בפסיקים של טווחי כתובות IP (סימון CIDR) להוספה לכלל חומת האש.

פלט של פעולות

הפעולה Remove IP From Firewall Rule (הסרת כתובת IP מכלל חומת האש) מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט תוצאת ה-JSON שמתקבל כשמשתמשים בפעולה Remove IP From Firewall Rule:

{
  "kind": "compute#operation",
  "id": "9160761312385876914",
  "name": "operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "operationType": "patch",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name",
  "targetId": "7886634413370691799",
  "status": "DONE",
  "user": "compute-admin@project-id.iam.gserviceaccount.com",
  "progress": 100,
  "insertTime": "2024-05-20T09:42:05.150-07:00",
  "startTime": "2024-05-20T09:42:05.164-07:00",
  "endTime": "2024-05-20T09:42:09.381-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/operations/operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "firewall": {
    "kind": "compute#firewall",
    "id": "6297155974506248217",
    "creationTimestamp": "2023-09-13T07:28:06.690-07:00",
    "name": "firewall-name",
    "description": "",
    "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/vpc-network",
    "priority": 1000,
    "sourceRanges": [
      "0.0.0.0/0"
    ],
    "destinationRanges": [
      "0.0.0.0/21"
    ],
    "allowed": [
      {
        "IPProtocol": "tcp",
        "ports": [
          "22"
        ]
      }
    ],
    "direction": "INGRESS",
    "logConfig": {
      "enable": false
    },
    "disabled": false,
    "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name"
  }
}
הודעות פלט

הפעולה Remove IP From Firewall Rule יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully updated firewall rule in Google Cloud Compute.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Google Cloud Compute.

 הפעולה הסתיימה בהצלחה.
Error executing action "Remove IP From Firewall Rule". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Remove IP From Firewall Rule:

שם התוצאה של הסקריפט ערך
is_success true או false

הסרת תגי רשת

משתמשים בפעולה Remove Network Tags (הסרת תגי רשת) כדי להסיר תגי רשת ממכונת Compute Engine.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Remove Network Tags דורשת את הפרמטרים הבאים:

פרמטר תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID, Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של המופע שרוצים להפעיל.

אפשר לאחזר את הערך הזה באמצעות הפעולה List Instances.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Network Tags

חובה.

רשימה מופרדת בפסיקים של תגי רשת להוספה למופע.

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

פלט של פעולות

הפעולה Remove Network Tags מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מוצג פלט של תוצאת JSON שהתקבל כשמשתמשים בפעולה Example:

{
  "kind": "compute#instance",
  "id": "1459671903146615834",
  "creationTimestamp": "2023-09-13T04:20:21.993-07:00",
  "name": "instance-2",
  "description": "",
  "tags": {
    "items": [
      "another-tag",
      "tag"
    ],
    "fingerprint": "BCeEINC7Ths="
  },
  "machineType": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/machineTypes/e2-micro",
  "status": "RUNNING",
  "zone": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a",
  "canIpForward": false,
  "networkInterfaces": [
    {
      "kind": "compute#networkInterface",
      "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/default",
      "subnetwork": "https://www.googleapis.com/compute/v1/projects/project-id/regions/us-central1/subnetworks/default",
      "networkIP": "10.128.0.3",
      "name": "nic0",
      "fingerprint": "-ZnnV7hiDfs=",
      "stackType": "IPV4_ONLY"
    }
  ],
  "disks": [
    {
      "kind": "compute#attachedDisk",
      "type": "PERSISTENT",
      "mode": "READ_WRITE",
      "source": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/disks/instance-2",
      "deviceName": "instance-2",
      "index": 0,
      "boot": true,
      "autoDelete": true,
      "licenses": [
        "https://www.googleapis.com/compute/v1/projects/centos-cloud/global/licenses/centos-7"
      ],
      "interface": "SCSI",
      "guestOsFeatures": [
        {
          "type": "UEFI_COMPATIBLE"
        },
        {
          "type": "GVNIC"
        }
      ],
      "diskSizeGb": "20",
      "architecture": "X86_64"
    }
  ],
  "metadata": {
    "kind": "compute#metadata",
    "fingerprint": "NBmH4-7Jw9U=",
    "items": []
  },
  "serviceAccounts": [
    {
      "email": "1111111111-compute@developer.gserviceaccount.com",
      "scopes": [
        "https://www.googleapis.com/auth/devstorage.read_only",
        "https://www.googleapis.com/auth/logging.write",
        "https://www.googleapis.com/auth/monitoring.write",
        "https://www.googleapis.com/auth/servicecontrol",
        "https://www.googleapis.com/auth/service.management.readonly",
        "https://www.googleapis.com/auth/trace.append"
      ]
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/zones/us-central1-a/instances/instance-2",
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD"
  },
  "cpuPlatform": "Intel Broadwell",
  "deletionProtection": false,
  "shieldedInstanceConfig": {
    "enableSecureBoot": false,
    "enableVtpm": true,
    "enableIntegrityMonitoring": true
  }
}
הודעות פלט

הפעולה Remove Network Tags יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully removed network tags from the instance RESOURCE_PATH in Compute Engine.

Waiting for the operation to finish execution on the RESOURCE_PATH instance in Compute Engine.

 הפעולה הסתיימה בהצלחה.
Error executing action "Remove Network Tags". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Remove Network Tags:

שם התוצאה של הסקריפט ערך
is_success true או false

הגדרת מדיניות IAM לגבי מכונה

משתמשים בפעולה Set Instance IAM Policy כדי להגדיר את מדיניות בקרת הגישה למשאב שצוין. המדיניות שאתם מספקים בפעולה מחליפה כל מדיניות קיימת.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Set Instance IAM Policy (הגדרת מדיניות IAM לגבי מכונה) דורשת את הפרמטרים הבאים:

פרמטרים תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID, Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של המופע שרוצים להפעיל.

אפשר לאחזר את הערך הזה באמצעות הפעולה List Instances.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Policy

חובה.

מסמך מדיניות IAM להחלה על המופע, שמועבר כאובייקט JSON.

פלט של פעולות

הפעולה Set Instance IAM Policy מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Set Instance IAM Policy:

{
    "version": 1,
    "etag": "BwXBftu99FE=",
    "bindings": [
        {
            "role": "roles/compute.networkViewer",
            "members": [
                "user:user@example.com"
            ]
        }
    ]
}
הודעות פלט

הפעולה Set Instance IAM Policy יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully set new IAM policy for the Compute Engine instance INSTANCE_ID.

Provided instance zone ZONE_ID is not valid.

Provided instance ID INSTANCE_ID is not valid.

Provided policy JSON document POLICY is not valid.

 הפעולה הסתיימה בהצלחה.
Error executing action "Set Instance IAM Policy". Reason: ERROR_REASON

Provided resource RESOURCE is not valid.

Error executing action "Set Instance IAM Policy". Reason: "Resource Name" or "Instance Zone" and "Instance ID" needs to be provided.

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Set Instance IAM Policy:

שם התוצאה של הסקריפט ערך
is_success true או false

הפעלת מכונה

משתמשים בפעולה הפעלת מכונה כדי להפעיל מכונה של Compute Engine שנמצאת במצב מושבת או שהשימוש בה הופסק.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Start Instance דורשת את הפרמטרים הבאים:

פרמטרים תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID, Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של המופע שרוצים להפעיל.

אפשר לאחזר את הערך הזה באמצעות הפעולה List Instances.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.

פלט של פעולות

הפעולה Start Instance מספקת את התוצאות הבאות:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט תוצאת ה-JSON שמתקבל כשמשתמשים בפעולה Start Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "start",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "DONE",
   "user": "user@example.com",
   "progress": 100,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "endTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
הודעות פלט

הפעולה Start Instance יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Compute Engine instance RESOURCE_PATH was started successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 הפעולה הסתיימה בהצלחה.

Error executing action "Start Instance". Reason: ERROR_REASON

Error executing action "Start Instance". Reason: You should provide either "Resource name" or "Instance Zone" and "Instance ID" parameters.

Error executing action "Start Instance". Reason: Given resource name string does not match expected pattern.

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Start Instance:

שם התוצאה של הסקריפט ערך
is_success true או false

הפסקת מכונה

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

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

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Stop Instance (הפסקת מופע) דורשת את הפרמטרים הבאים:

פרמטרים תיאור
Resource Name

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /project/PROJECT_ID/zone/ ZONE_ID/instances/ INSTANCE_ID.

הפרמטר הזה מקבל עדיפות על פני Project ID, Instance Zone ו-Instance ID.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

התחום הספציפי שבו נמצא המופע.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.
Instance ID

זה שינוי אופציונלי.

המזהה הייחודי של המופע שרוצים להפעיל.

אפשר לאחזר את הערך הזה באמצעות הפעולה List Instances.

חובה להשתמש בפרמטר הזה אם מזהים את המופע באמצעות Instance Zone ו-Instance ID.

פלט של פעולות

הפעולה Stop Instance מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

בדוגמה הבאה מתואר פלט של תוצאת JSON שמתקבלת כשמשתמשים בפעולה Stop Instance:

{
   "id": "ID",
   "name": "operation-OPERATION_ID",
   "zone": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a",
   "operationType": "stop",
   "targetLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/instances/INSTANCE_ID",
   "targetId": "INSTANCE_ID",
   "status": "RUNNING",
   "user": "user@example.com",
   "progress": 100,
   "insertTime": "2021-04-28T23:01:29.395-07:00",
   "startTime": "2021-04-28T23:01:29.397-07:00",
   "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/us-central1-a/operations/operation-OPERATION_ID",
   "kind": "compute#operation"
}
הודעות פלט

הפעולה Stop Instance יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Compute Engine instance INSTANCE_ID was stopped successfully.

Provided instance zone ZONE_ID is not valid.

Provided instance ID is not valid.

 הפעולה הסתיימה בהצלחה.
Error executing action "Stop Instance". Reason: ERROR_REASON

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Stop Instance:

שם התוצאה של הסקריפט ערך
is_success true או false

עדכון כלל חומת אש

כדי לשנות את ההגדרה של כלל קיים בחומת האש ב-Compute Engine, משתמשים בפעולה Update Firewall Rule (עדכון כלל בחומת האש). הפעולה הזו מאפשרת לכם לעדכן פרמטרים ספציפיים תוך שמירה על הזהות של הכלל.

הפעולה הזו לא מופעלת בישויות של Google SecOps.

הוספת נתונים לפעולה

הפעולה Update Firewall Rule (עדכון כלל חומת אש) דורשת את הפרמטרים הבאים:

פרמטרים תיאור
Firewall Rule

זה שינוי אופציונלי.

השם של כלל חומת האש הספציפי שרוצים לעדכן.
Project ID

זה שינוי אופציונלי.

מזהה הפרויקט שמשויך למופע של Compute Engine.

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

זה שינוי אופציונלי.

השם המלא של המשאב של מכונת Compute Engine, בפורמט /projects/PROJECT_ID/global/ firewallsFIREWALL.

הפרמטר הזה מקבל עדיפות על פני Project ID ו-Firewall Rule.
Source IP Ranges

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של טווחי כתובות ה-IP של המקור לכלל חומת האש.

אם הערך של none מוגדר, הפעולה מוחקת את כל טווחי כתובות ה-IP הקיימים של המקור מהכלל.

אם לא צוין ערך, הערכים הקיימים לא ישתנו.
Source Tags

זה שינוי אופציונלי.

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

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

אם לא צוין ערך, הערכים הקיימים לא ישתנו.
Source Service Accounts

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של חשבונות שירות של מקורות להחלה על הכלל.

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

אם לא צוין ערך, הערכים הקיימים לא ישתנו.
TCP Ports

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של יציאות TCP או טווחי יציאות שרוצים לאפשר או לחסום.

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

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של יציאות UDP או טווחי יציאות שרוצים לאשר או לחסום.

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

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של פרוטוקולים אחרים מלבד TCP ו-UDP שייכללו בכלל.

אם הערך none מוגדר, הפעולה מעדכנת את רשימת הפרוטוקולים של כלל חומת האש עם הערך הזה.
Destination IP Ranges

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של טווחי כתובות ה-IP של היעד עבור כלל חומת האש.

אם הערך none מוגדר, הפעולה מוחקת את כל טווחי כתובות ה-IP הקיימים של היעד מהכלל.

אם לא מציינים ערך, הערכים הקיימים לא משתנים.

פלט של פעולות

הפעולה Update Firewall Rule מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
קיר המארז לא זמין
קישור לקיר של הפנייה לא זמין
טבלת קיר עם תושבת לא זמין
טבלת העשרה לא זמין
תוצאה בפורמט JSON יש גישה
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאה בפורמט JSON

הדוגמה הבאה מתארת את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Update Firewall Rule (עדכון כלל חומת האש):

{
  "kind": "compute#operation",
  "id": "9160761312385876914",
  "name": "operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "operationType": "patch",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name",
  "targetId": "7886634413370691799",
  "status": "DONE",
  "user": "compute-admin@project-id.iam.gserviceaccount.com",
  "progress": 100,g
  "insertTime": "2024-05-20T09:42:05.150-07:00",
  "startTime": "2024-05-20T09:42:05.164-07:00",
  "endTime": "2024-05-20T09:42:09.381-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/operations/operation-1716223324528-618e5619d1f93-174eac81-6b38200d",
  "firewall": {
    "kind": "compute#firewall",
    "id": "6297155974506248217",
    "creationTimestamp": "2023-09-13T07:28:06.690-07:00",
    "name": "firewall-name",
    "description": "",
    "network": "https://www.googleapis.com/compute/v1/projects/project-id/global/networks/vpc-network",
    "priority": 1000,
    "sourceRanges": [
      "0.0.0.0/0"
    ],
    "destinationRanges": [
      "0.0.0.0/21"
    ],
    "allowed": [
      {
        "IPProtocol": "tcp",
        "ports": [
          "22"
        ]
      }
    ],
    "direction": "INGRESS",
    "logConfig": {
      "enable": false
    },
    "disabled": false,
    "selfLink": "https://www.googleapis.com/compute/v1/projects/project-id/global/firewalls/firewall-name"
  }
}
הודעות פלט

הפעולה Update Firewall Rule יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה
Successfully updated firewall rule in Cloud Compute.

Updating firewall rule in Cloud Compute.

 הפעולה הסתיימה בהצלחה.
Error executing action "Update Firewall Rule". Reason: ERROR_REASON

Provided firewall name is not valid.

Action ran into a timeout during execution. Please increase the timeout in IDE.

You must provide at least some parameter to update the firewall rule with.

הפעולה נכשלה.

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

בטבלה הבאה מפורט הערך של פלט התוצאה של הסקריפט כשמשתמשים בפעולה Update Firewall Rule:

שם התוצאה של הסקריפט ערך
is_success true או false

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.