‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

תזמון או הפעלה של ביקורת

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

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

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

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

כדי לקבל את ההרשאות שדרושות להרצה או לתזמון של ביקורת, צריך לבקש מהאדמין להקצות לכם את אחד מהתפקידים הבאים בממשק לניהול זהויות והרשאות גישה (IAM):
- אדמין של Audit Manager (roles/auditmanager.admin)
- מבקר בכלי לניהול ביקורות (roles/auditmanager.auditor)
רישום הארגון, הפרויקט או התיקייה לביקורת.

תזמון והרצה של ביקורת

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

המסוף

במסוף Google Cloud , נכנסים לדף Run assessment בכלי לניהול ביקורות.

כניסה לכלי לניהול ביקורות
בקטע Choose resource and region:
1. בוחרים את הארגון, התיקייה או הפרויקט שרוצים לבדוק.
2. בוחרים את המיקום שבו רוצים לעבד את הערכת הביקורת. רשימת המיקומים שבהם אפשר להשתמש בכלי לניהול ביקורות
3. לוחצים על הבא.
בקטע Choose regulation, בוחרים את המסגרת שלפיה רוצים לבדוק את המשאב ולוחצים על Next. למידע על מסגרות נתמכות, ראו מסגרות נתמכות.
אופציונלי: אם מופיע הקטע Configure Parameters, מבצעים את הפעולות הבאות:
1. לוחצים על שינוי ההגדרות.
2. בחלון Configure parameters, מוסיפים את הפרמטרים הנדרשים לבקרות הענן. מידע נוסף על הפרמטרים זמין במאמרים הפניית בקרת ענן של Compliance Manager ובקרות ענן של Assured Workloads.
3. לוחצים על Save.
אופציונלי: בקטע View Assessment Plan, אתם יכולים להוריד קובץ ODS שמכיל מידע על היקף הביקורת, על סמך המסגרת שבחרתם. כדי להוריד את הקובץ, לוחצים על הקישור ואז על הבא.
בקטע Choose storage bucket, בוחרים את קטגוריית האחסון שבה רוצים לשמור את דוח הביקורת וההוכחות, ולוחצים על Done. אם הקטגוריה לא מופיעה ברשימה, בקשו מהאדמין לרשום את המשאב בקטגוריית האחסון.
אופציונלי: בקטע לוח זמנים, מגדירים את האפשרויות הבאות:
- תדירות החזרה על הביקורת (מדי יום, מדי שבוע, מדי חודש, מדי רבעון או מדי שנה).
- התקופה שתיכלל בביקורת. אם בוחרים באפשרות ללא הגבלת זמן, הביקורת תמשיך לפעול מתאריך ההתחלה שציינתם עד שתפסיקו אותה באופן ידני.
כדי להתחיל את הביקורת, לוחצים על הפעלת ביקורת או על הפעלת ביקורת מתוזמנת.

אתם יכולים לראות את הסטטוס של ביקורת לפי דרישה בדף View assessments, או לראות את הביקורות המתוזמנות בכרטיסייה Schedules בדף Audit management.

gcloud

אופציונלי: יצירת הערכת ביקורת

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

הפקודה gcloud audit-manager audit-scopes generate יוצרת היקף ביקורת.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organization,‏ folder ו-project.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה: builtin-cis-v8. כדי למצוא את המזהה של מסגרת, עיינו בדף View assessments במסוף Google Cloud .
‫AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר. יש תמיכה רק בפורמט ODF: ‏AUDIT_REPORT_FORMAT_ODF.
‫OUTPUT_DIRECTORY: הספרייה שבה צריך לשמור את הפלט. לדוגמה: reports.
‫OUTPUT_FILENAME: השם של קובץ הפלט. אל תכללו את סיומת הקובץ בשם הקובץ. לדוגמה: scopeReport.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud audit-manager audit-scopes generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --output-directory=OUTPUT_DIRECTORY \
    --output-file-name=OUTPUT_FILENAME

‏Windows (PowerShell)

gcloud audit-manager audit-scopes generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --output-directory=OUTPUT_DIRECTORY `
    --output-file-name=OUTPUT_FILENAME

Windows‏ (cmd.exe)

gcloud audit-manager audit-scopes generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --output-directory=OUTPUT_DIRECTORY ^
    --output-file-name=OUTPUT_FILENAME

הרצת ביקורת על פי דרישה

הפקודה gcloud audit-manager audit-reports generate מריצה ביקורת.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organization,‏ folder ו-project.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה: builtin-cis-v8. כדי למצוא את המזהה של מסגרת, עיינו בדף View assessments במסוף Google Cloud .
‫BUCKET_URI: ה-URI של הקטגוריה ב-Cloud Storage. לדוגמה: gs://testbucketauditmanager.
‫AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר. יש תמיכה רק בפורמט ODF: ‏AUDIT_REPORT_FORMAT_ODF.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud audit-manager audit-reports generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI

‏Windows (PowerShell)

gcloud audit-manager audit-reports generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI

Windows‏ (cmd.exe)

gcloud audit-manager audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

אמורים לקבל תגובה שדומה לזו:

done: false
name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24

תזמון ביקורת

הפקודה gcloud audit-manager audit-schedules create יוצרת לוח זמנים לביקורת.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organization,‏ folder ו-project.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. רשימת המיקומים של Audit Manager כוללת את נקודות הקצה הזמינות. לדוגמה: us-central1.
‫AUDIT_SCHEDULE_ID: המזהה של לוח הזמנים לביקורת. לדוגמה: my-schedule-id. כדי למצוא את המזהה של תזמון קיים, נכנסים לדף Audit management במסוף Google Cloud .
‫FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה: builtin-cis-v8. כדי למצוא את המזהה של מסגרת, עיינו בדף View assessments במסוף Google Cloud .
‫AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר. יש תמיכה רק בפורמט OpenDocument ‏ (ODF): odf.
‫BUCKET_URI: ה-URI של הקטגוריה ב-Cloud Storage. לדוגמה: gs://testbucketauditmanager.
‫FREQUENCY: התדירות של הרצות הביקורת המתוזמנות. הערכים התקינים הם daily,‏ weekly,‏ monthly,‏ quarterly ו-annually. לדוגמה: weekly.
‫SCHEDULE_START_TIME: התאריך והשעה שבהם מתחילה הפעלת הביקורת הראשונה, בפורמט RFC 3339. לדוגמה: 2026-10-25T10:00:00Z.
‫DISPLAY_NAME: אופציונלי. שם לתצוגה של לוח הזמנים לביקורת. לדוגמה: NIST 800-53 Weekly Audit.
‫SCHEDULE_END_TIME: אופציונלי. התאריך והשעה שבהם לוח הזמנים של הביקורת מסתיים, בפורמט RFC 3339. לדוגמה: 2027-10-25T10:00:00Z.
‫TIME_ZONE: אופציונלי. אזור הזמן של לוח הזמנים של הביקורת בפורמט IANA. הכלי לניהול ביקורות משתמש בערך הזה כדי לפרש את שעת ההתחלה ושעת הסיום. אם לא מציינים ערך, ברירת המחדל היא UTC. לדוגמה: America/New_York.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud audit-manager audit-schedules create \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --audit-schedule-id=AUDIT_SCHEDULE_ID \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI \
    --start-time=SCHEDULE_START_TIME \
    --frequency=FREQUENCY \
    --display-name="DISPLAY_NAME" \
    --end-time=SCHEDULE_END_TIME \
    --time-zone=TIME_ZONE

‏Windows (PowerShell)

gcloud audit-manager audit-schedules create `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --audit-schedule-id=AUDIT_SCHEDULE_ID `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI `
    --start-time=SCHEDULE_START_TIME `
    --frequency=FREQUENCY `
    --display-name="DISPLAY_NAME" `
    --end-time=SCHEDULE_END_TIME `
    --time-zone=TIME_ZONE

Windows‏ (cmd.exe)

gcloud audit-manager audit-schedules create ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --audit-schedule-id=AUDIT_SCHEDULE_ID ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI ^
    --start-time=SCHEDULE_START_TIME ^
    --frequency=FREQUENCY ^
    --display-name="DISPLAY_NAME" ^
    --end-time=SCHEDULE_END_TIME ^
    --time-zone=TIME_ZONE

אמורים לקבל תגובה שדומה לזו:

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

אופציונלי: יצירת הערכת ביקורת

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה: builtin-cis-v8. כדי למצוא את המזהה של מסגרת, עיינו בדף View assessments במסוף Google Cloud .
‫AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר. יש תמיכה רק בפורמט ODF: ‏AUDIT_REPORT_FORMAT_ODF.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate

גוף בקשת JSON:


{
  "compliance_framework" : "FRAMEWORK",
  "report_format" : "AUDIT_REPORT_FORMAT"
}

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

curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate"

PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{

  "scope_report_contents": "980u43nrf090834uhbkfehf......",
  "name" : "folders/8767234/locations/us-west"
}

התשובה כוללת את הפרטים הבאים:

‫scope_report_contents: פורמט הבייטים של תוכן הדוח, שצריך להמיר לפורמט OpenDocument‏ (ODF) לפני הבדיקה.
‫name: מזהה מחרוזת ייחודי של המשאב הרלוונטי.

הרצת ביקורת על פי דרישה

כדי להריץ ביקורת על פי דרישה, שולחים בקשת POST לנקודת הקצה (endpoint) של auditReport:generate.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה: builtin-cis-v8. כדי למצוא את המזהה של מסגרת, עיינו בדף View assessments במסוף Google Cloud .
‫BUCKET_URI: ה-URI של הקטגוריה ב-Cloud Storage. לדוגמה: gs://testbucketauditmanager.
‫AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר. יש תמיכה רק בפורמט ODF: ‏AUDIT_REPORT_FORMAT_ODF.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate

גוף בקשת JSON:


{
  "destination" : {
    "gcs_uri" : "BUCKET_URI"
  },
  "compliance_framework" : "FRAMEWORK",
  "report_format" : "AUDIT_REPORT_FORMAT"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "organizations/834/projects/10398413/locations/987234/operations/098234",
  "done": false
}

התשובה כוללת את הפרטים הבאים:

‫name: מזהה מחרוזת ייחודי לבקשת הפעולה של הערכת הביקורת. אפשר להשתמש במזהה הזה כדי לעקוב אחרי ההתקדמות של הערכת הביקורת. לדוגמה: projects/PROJECT_ID/locations/LOCATION/operations/098234UNIQUE_ID.
‫done: דגל בוליאני שמציין אם הערכת הביקורת הושלמה. הדגל הזה מוגדר כ-false כשהתהליך מתחיל, ומשתנה ל-true כשהערכת הביקורת מסתיימת.

תזמון ביקורת

כדי לתזמן ביקורת חוזרת, שולחים בקשת POST לנקודת הקצה auditSchedules.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫AUDIT_SCHEDULE_ID: המזהה של לוח הזמנים לביקורת. לדוגמה: my-schedule-id. כדי למצוא את המזהה של תזמון קיים, נכנסים לדף Audit management במסוף Google Cloud .
‫FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה: builtin-cis-v8. כדי למצוא את המזהה של מסגרת, עיינו בדף View assessments במסוף Google Cloud .
‫BUCKET_URI: ה-URI של הקטגוריה ב-Cloud Storage. לדוגמה: gs://testbucketauditmanager.
‫AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר. יש תמיכה רק בפורמט ODF: ‏AUDIT_REPORT_FORMAT_ODF.
‫FREQUENCY: התדירות של הרצות הביקורת המתוזמנות. הערכים התקינים הם DAILY,‏ WEEKLY,‏ MONTHLY,‏ QUARTERLY ו-ANNUALLY. לדוגמה: WEEKLY.
‫SCHEDULE_START_TIME: התאריך והשעה שבהם מתחילה הרצת הביקורת הראשונה, בפורמט RFC 3339. לדוגמה: 2026-10-25T10:00:00Z.
‫DISPLAY_NAME: אופציונלי. שם לתצוגה של לוח הזמנים לביקורת. לדוגמה: NIST 800-53 Weekly Audit.
‫SCHEDULE_END_TIME: אופציונלי. התאריך והשעה שבהם לוח הזמנים של הביקורת מסתיים, בפורמט RFC 3339. לדוגמה: 2027-10-25T10:00:00Z.
‫TIME_ZONE: אופציונלי. אזור הזמן של לוח הזמנים של הביקורת בפורמט IANA. הכלי לניהול ביקורות משתמש בערך הזה כדי לפרש את שעת ההתחלה ושעת הסיום. אם לא מציינים ערך, ברירת המחדל היא UTC. לדוגמה: America/New_York.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID

גוף בקשת JSON:

{
  "displayName": "DISPLAY_NAME",
  "gcsUri": "BUCKET_URI",
  "complianceFramework": "FRAMEWORK",
  "reportFormat": "AUDIT_REPORT_FORMAT",
  "scheduleConfig": {
    "startTime": "SCHEDULE_START_TIME",
    "endTime": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "timeZone": "TIME_ZONE"
  }
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?auditScheduleId=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

צפייה בביקורות מתוזמנות

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

המסוף

במסוף Google Cloud , נכנסים לדף Audit management בכלי לניהול ביקורות.

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

gcloud

הצגת רשימה של ביקורות מתוזמנות

כדי לראות רשימה של הביקורות המתוזמנות, מריצים את הפקודה gcloud audit-manager audit-schedules list.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organization,‏ folder ו-project.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud audit-manager audit-schedules list \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

‏Windows (PowerShell)

gcloud audit-manager audit-schedules list `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows‏ (cmd.exe)

gcloud audit-manager audit-schedules list ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

אמורים לקבל תגובה שדומה לזו:

┌────────────┬────────────┬──────────────┬────────────┬────────────┬───────────────┬─────────────────┬─────────────┬─────────────┬───────────────┬───────────────────┬───────────────┐
│     ID     │ FRAMEWORK  │ DISPLAY_NAME │   STATE    │  GCS_URI   │ REPORT_FORMAT │ SCHEDULE_CONFIG │ CREATE_TIME │ UPDATE_TIME │ NEXT_RUN_TIME │ LAST_TRIGGER_TIME │ ERROR_MESSAGE │
├────────────┼────────────┼──────────────┼────────────┼────────────┼───────────────┼─────────────────┼─────────────┼─────────────┼───────────────┼───────────────────┼───────────────┤
│ my-schedul │ builtin-ci │ My first aud │ SCHEDULE_S │ gs://my-bu │ AUDIT_REPORT_ │ {'frequency':   │ 2026-10-25T │ 2026-10-25T │               │                   │               │
│ e-id       │ s-v8       │ it schedule  │ TATE_ACTIV │ cket       │ FORMAT_ODF    │ 'weekly',       │ 13:27:00Z   │ 13:27:00Z   │               │                   │               │
│            │            │              │ E          │            │               │ 'startTime':    │             │             │               │                   │               │
│            │            │              │            │            │               │ '2026-10-25T10: │             │             │               │                   │               │
│            │            │              │            │            │               │ 00:00Z'}        │             │             │               │                   │               │
└────────────┴────────────┴──────────────┴────────────┴────────────┴───────────────┴─────────────────┴─────────────┴─────────────┴───────────────┴───────────────────┴───────────────┘

הצגת פרטים על ביקורת מתוזמנת

כדי לראות פרטים על ביקורת מתוזמנת ספציפית, מריצים את הפקודה gcloud audit-manager audit-schedules describe.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫AUDIT_SCHEDULE_ID: המזהה של לוח הזמנים לביקורת. לדוגמה: my-schedule-id. כדי למצוא את המזהה של תזמון קיים, נכנסים לדף Audit management במסוף Google Cloud .

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud audit-manager audit-schedules describe \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

‏Windows (PowerShell)

gcloud audit-manager audit-schedules describe `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

Windows‏ (cmd.exe)

gcloud audit-manager audit-schedules describe ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

אמורים לקבל תגובה שדומה לזו:

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: weekly
  startTime: '2026-10-25T10:00:00Z'
state: SCHEDULE_STATE_ACTIVE

REST

הצגת רשימה של ביקורות מתוזמנות

כדי לראות רשימה של ביקורות מתוזמנות, שולחים בקשת GET לנקודת הקצה auditSchedules.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules

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

curl

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "auditSchedules": [
    {
      "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
      "displayName": "My first audit schedule",
      "gcsUri": "gs://my-bucket",
      "complianceFramework": "builtin-cis-v8",
      "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
      "scheduleConfig": {
        "startTime": "2026-10-25T10:00:00Z",
        "endTime": "2027-10-25T10:00:00Z",
        "frequency": "WEEKLY",
        "timeZone": "America/New_York"
      },
      "state": "SCHEDULE_STATE_ACTIVE",
      "createTime": "2026-10-25T13:27:00Z",
      "updateTime": "2026-10-25T13:27:00Z"
    }
  ]
}

הצגת פרטים על ביקורת מתוזמנת

כדי לראות פרטים על ביקורת ספציפית שתוזמנה, שולחים בקשת GET לנקודת הקצה (endpoint) של auditSchedules ומציינים את מזהה התזמון.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫AUDIT_SCHEDULE_ID: המזהה של לוח הזמנים לביקורת. לדוגמה: my-schedule-id. כדי למצוא את המזהה של תזמון קיים, נכנסים לדף Audit management במסוף Google Cloud .

ה-method של ה-HTTP וכתובת ה-URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID

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

curl

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-10-25T10:00:00Z",
    "endTime": "2027-10-25T10:00:00Z",
    "frequency": "WEEKLY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "createTime": "2026-10-25T13:27:00Z",
  "updateTime": "2026-10-25T13:27:00Z"
}

עדכון ביקורות מתוזמנות

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

המסוף

במסוף Google Cloud , נכנסים לדף Audit management בכלי לניהול ביקורות.

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

gcloud

כדי להשהות, להמשיך או למחוק לוח זמנים לביקורת, מריצים את הפקודה gcloud audit-manager audit-schedules update כדי לעדכן את מצב לוח הזמנים.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫AUDIT_SCHEDULE_ID: המזהה של לוח הזמנים לביקורת. לדוגמה: my-schedule-id. כדי למצוא את המזהה של תזמון קיים, נכנסים לדף Audit management במסוף Google Cloud .
‫SCHEDULE_STATE: מצב היעד של לוח הזמנים לביקורת. מגדירים אחת מהאפשרויות הבאות:
- ‫paused: כדי להשהות לוח זמנים פעיל.
- ‫active: כדי להמשיך לוח זמנים שהושהה.
- ‫deleted: כדי להפסיק ולמחוק לוח זמנים.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud audit-manager audit-schedules update \
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID \
    --state=SCHEDULE_STATE

‏Windows (PowerShell)

gcloud audit-manager audit-schedules update `
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID `
    --state=SCHEDULE_STATE

Windows‏ (cmd.exe)

gcloud audit-manager audit-schedules update ^
    RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID ^
    --state=SCHEDULE_STATE

אמורים לקבל תגובה שדומה לזו:

complianceFramework: builtin-cis-v8
gcsUri: gs://my-bucket
name: projects/834/locations/us-central1/auditSchedules/my-schedule-id
reportFormat: AUDIT_REPORT_FORMAT_ODF
scheduleConfig:
  frequency: daily
  startTime: '2026-02-25T10:00:00Z'
state: SCHEDULE_STATE_PAUSED

REST

כדי להשהות, להמשיך או למחוק לוח זמנים לביקורת, שולחים בקשת PATCH לעדכון השדה state של לוח הזמנים לביקורת.

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

‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
‫AUDIT_SCHEDULE_ID: המזהה של לוח הזמנים לביקורת. לדוגמה: my-schedule-id. כדי למצוא את המזהה של תזמון קיים, נכנסים לדף Audit management במסוף Google Cloud .
‫SCHEDULE_STATE: מצב היעד של לוח הזמנים לביקורת. מגדירים אחת מהאפשרויות הבאות:
- ‫SCHEDULE_STATE_PAUSED: כדי להשהות לוח זמנים פעיל.
- ‫SCHEDULE_STATE_ACTIVE: כדי להמשיך לוח זמנים שהושהה.
- ‫SCHEDULE_STATE_DELETED: כדי להפסיק ולמחוק לוח זמנים.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state

גוף בקשת JSON:

{
  "state": "SCHEDULE_STATE"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "displayName": "My first audit schedule",
  "gcsUri": "gs://my-bucket",
  "complianceFramework": "builtin-cis-v8",
  "reportFormat": "AUDIT_REPORT_FORMAT_ODF",
  "scheduleConfig": {
    "startTime": "2026-02-25T10:00:00Z",
    "endTime": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "timeZone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "createTime": "2026-02-25T13:27:00Z",
  "updateTime": "2026-09-11T18:15:00Z"
}

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

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

תזמון והרצה של ביקורת

המסוף

gcloud

אופציונלי: יצירת הערכת ביקורת

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

הרצת ביקורת על פי דרישה

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

תזמון ביקורת

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

REST

אופציונלי: יצירת הערכת ביקורת

curl

PowerShell

הרצת ביקורת על פי דרישה

curl

PowerShell

תזמון ביקורת

curl

PowerShell

צפייה בביקורות מתוזמנות

המסוף

gcloud

הצגת רשימה של ביקורות מתוזמנות

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

הצגת פרטים על ביקורת מתוזמנת

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

REST

הצגת רשימה של ביקורות מתוזמנות

curl

PowerShell

הצגת פרטים על ביקורת מתוזמנת

curl

PowerShell

עדכון ביקורות מתוזמנות

המסוף

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

REST

curl

PowerShell

המאמרים הבאים

תזמון או הפעלה של ביקורת