שילוב של 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. לוחצים על addCreate custom role.

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

  4. מגדירים את Role Launch Stage ל-General Availability.

  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 ליד Test ומחפשים את כתובת האימייל של הזהות שמתחילה ב-gke-init-python@... או ב-soar-python@....

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

אישור זהות המכונה ב- Google Cloud

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

    לדף Service accounts

  2. בוחרים את חשבון השירות הרצוי ועוברים אל Permissions > Grant Access.

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

הגדרת מפתח JSON

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

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

    לדף Service accounts

  2. עוברים לכרטיסייה Keys ולוחצים על Add key > Create new key.

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

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

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

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

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

  • thought ‫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

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

פעולות

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

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

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

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

קלט של הפעולה

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

פרמטר תיאור
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) שצריך להוסיף לכלל של חומת האש.

ערכי פלט של פעולות

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

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת 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

הוספת תוויות למכונה

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

הפעולה הזו לא פועלת על ישויות של 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

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

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

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

שם תוצאת הסקריפט ערך
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

מחיקת מכונה

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

הפעולה הזו לא פועלת על ישויות של 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

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

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

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

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

העשרת ישויות

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

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

  • IP Address

קלט של הפעולה

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

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

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

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

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

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

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

ערכי פלט של פעולות

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

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

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

שם הטבלה: טבלת העשרה של ENTITY

עמודות:

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

הפעולה 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

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

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

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

שם תוצאת הסקריפט ערך
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 של מכונה

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

הפעולה הזו לא פועלת על ישויות של 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

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

  • שם המכונה
  • מזהה המכונה
  • מועד יצירת המכונה
  • תיאור המופע
  • סוג המכונה
  • סטטוס המכונה
  • תוויות של מכונות
תוצאת 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.

קלט של הפעולה

אין.

ערכי פלט של פעולות

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

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת 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

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

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

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

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

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

כדי להסיר כתובות IP חיצוניות במכונה של Compute Engine, משתמשים בפעולה Remove External IP Addresses.

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

קלט של הפעולה

כדי להשתמש בפעולה Remove External IP Addresses, צריך להגדיר את הפרמטרים הבאים:

פרמטרים תיאור
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 שמתקבל כשמשתמשים בפעולה Remove External IP Addresses:

[
    {
        "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.

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

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

בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה Remove External IP Addresses:

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

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

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

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

קלט של הפעולה

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

פרמטר תיאור
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 מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור לקיר של המארז לא זמין
קישור ללוח הפניות לא זמין
שולחן קונסולה צמוד לקיר לא זמין
טבלת העשרה לא זמין
תוצאת 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.

קלט של הפעולה

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

פרמטר תיאור
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, צריך להגדיר את הפרמטרים הבאים:

פרמטרים תיאור
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

הפעלת המכונה

הפעולה Start Instance משמשת להפעלת מכונה של 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, משתמשים בפעולה Stop Instance. אפשר להפעיל מחדש מכונה שהופסקה בכל שלב.

כשעוצרים מכונה, מפסיקים את חיובי השימוש במכונה הווירטואלית, אבל ממשיכים לחול חיובים על משאבים משויכים כמו דיסקים קבועים וכתובות 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"
  }
}
הודעות פלט

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

הודעת פלט תיאור ההודעה
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.