הפעלה והשבתה של שירותים

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

רוב המשתמשים יכולים להפעיל ולהשבית שירותים באמצעות מסוף Google Cloud . לסקריפטים, משתמשים ב-Google Cloud CLI. כדי לגשת אל Service Usage API באופן פרוגרמטי, מומלץ להשתמש בספריית לקוח. כדי להתנסות ב-API, אתם יכולים לשלוח בקשה בלי להגדיר סביבת פיתוח מלאה.

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

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

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

המסוף

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

gcloud

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

התקינו את ה-CLI של Google Cloud.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

יוצרים או בוחרים Google Cloud פרויקט.

תפקידים שנדרשים כדי לבחור או ליצור פרויקט

• Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים

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

• יוצרים Google Cloud פרויקט:

  gcloud projects create PROJECT_ID

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

• בוחרים את הפרויקט שיצרתם: Google Cloud

  gcloud config set project PROJECT_ID

  מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

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

מוודאים שהחיוב מופעל בפרויקט Google Cloud .

מפעילים את Service Usage API:

תפקידים שנדרשים להפעלת ממשקי API

כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של שימוש בשירות' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

gcloud services enable serviceusage.googleapis.com

התקינו את ה-CLI של Google Cloud.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

יוצרים או בוחרים Google Cloud פרויקט.

תפקידים שנדרשים כדי לבחור או ליצור פרויקט

• Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים

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

• יוצרים Google Cloud פרויקט:

  gcloud projects create PROJECT_ID

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

• בוחרים את הפרויקט שיצרתם: Google Cloud

  gcloud config set project PROJECT_ID

  מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

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

מוודאים שהחיוב מופעל בפרויקט Google Cloud .

מפעילים את Service Usage API:

תפקידים שנדרשים להפעלת ממשקי API

כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של שימוש בשירות' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

gcloud services enable serviceusage.googleapis.com

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות להפעלה ולהשבתה של שירותים, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Service Usage Admin (roles/serviceusage.serviceUsageAdmin) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

הפעלת שירות

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

המסוף

1. במסוף Google Cloud , נכנסים לדף APIs & Services > API Library.

   לדף API Library

2. בוחרים פרויקט מהרשימה של הפרויקטים האחרונים או משתמשים בכלי לבחירת משאבים בסרגל הכלים של המסוף כדי לבחור את Google Cloud הפרויקט שבו רוצים להפעיל API.

3. לוחצים על ה-API שרוצים להפעיל או מחפשים אותו בתיבה Search for APIs & Services.

4. לוחצים על Enable.

gcloud

הפקודה gcloud services enable מפעילה שירות עם השם שצוין לפרויקט הנוכחי.

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

• ‫SERVICE: השם של השירות שרוצים להפעיל.

מריצים את הפקודה gcloud services enable:

‫Linux,‏ macOS או Cloud Shell

gcloud services enable SERVICE

‏Windows (PowerShell)

gcloud services enable SERVICE

Windows‏ (cmd.exe)

gcloud services enable SERVICE

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

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

כדי להפעיל כמה שירותים, משתמשים בשמות שירותים מופרדים ברווחים – לדוגמה, הפקודה הבאה מפעילה את השירותים BigQuery ו-Pub/Sub:

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

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

gcloud services operations describe operations/OPERATION_ID

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

‫API בארכיטקטורת REST

הפעלת שירות יחיד

כדי להפעיל שירות יחיד, משתמשים בשיטה services.enable.

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

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud.
• ‫SERVICE: השם של השירות שרוצים להפעיל.

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

‫Curl (Linux,‏ macOS או Cloud Shell)

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

‎PowerShell (Windows)

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

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

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

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

{
  "name": "operations/OPERATION_ID"
}

הפעלת כמה שירותים

כדי להפעיל עד 20 שירותים בפעולה אחת, משתמשים בשיטה services.batchEnable.

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

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud.
• ‫SERVICE1: השם של השירות שרוצים להפעיל.
• ‫SERVICE2: השם של שירות אחר שרוצים להפעיל.

תוכן בקשת JSON:

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

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

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

‎PowerShell (Windows)

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

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

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

$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://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

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

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

השבתת שירות

אפשר להשבית API בפרויקט בכל שלב. עם זאת, עדיין תחויבו על עמלות ממתינות ועל שימוש בממשקי API שניתן לחייב בפרויקטים שלכם. מידע נוסף זמין במדריך תחילת השימוש ב-Cloud APIs.

שירותים רבים, כמו Cloud Storage ו-BigQuery, מחייבים על אחסון נתונים. השבתה של API של שירות לא מוחקת את הנתונים שלכם, ותמשיכו לשלם עליו. כדי להפסיק את החיובים העתידיים ולהפסיק את השימוש בשירות, צריך למחוק את כל הנתונים שמשויכים אליו לפני שמשביתים את ה-API שלו.

אם משביתים את Kubernetes Engine API, האשכולות שפועלים בפרויקט מושעים. אחרי 30 יום, האשכולות המושעים האלה נמחקים. כדי להפעיל מחדש את האשכולות, צריך להפעיל מחדש את GKE API. יכולות לחלוף עד 24 שעות עד שהאשכולות יוחזרו. מידע נוסף זמין במאמר בנושא מחזור החיים של אשכול.

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

המסוף

1. במסוף Google Cloud , נכנסים לדף APIs & Services > API Library.

   לדף API Library

2. בוחרים פרויקט מהרשימה של הפרויקטים האחרונים או משתמשים בכלי לבחירת משאבים בסרגל הכלים של המסוף כדי לבחור את Google Cloud הפרויקט שבו רוצים להשבית API.

3. לוחצים על ה-API שרוצים להשבית או מחפשים אותו בתיבה Search for APIs & Services.

4. לוחצים על השבתת ה-API.

gcloud

הפקודה gcloud services disable משביתה שירות עם השם שצוין לפרויקט הנוכחי.

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

• ‫SERVICE: השם של השירות שרוצים להשבית.

מריצים את הפקודה gcloud services disable:

‫Linux,‏ macOS או Cloud Shell

gcloud services disable SERVICE

‏Windows (PowerShell)

gcloud services disable SERVICE

Windows‏ (cmd.exe)

gcloud services disable SERVICE

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

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

כדי להשבית כמה שירותים, משתמשים בשמות שירותים מופרדים ברווחים – לדוגמה, הפקודה הבאה משביתה את השירותים BigQuery ו-Pub/Sub:

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

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

gcloud services operations describe operations/OPERATION_ID

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

‫API בארכיטקטורת REST

כדי להשבית שירות, משתמשים בשיטה services.disable.

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

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud.
• ‫SERVICE: השם של השירות שרוצים להשבית.

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

‫Curl (Linux,‏ macOS או Cloud Shell)

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

‎PowerShell (Windows)

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

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

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

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

{
  "name": "operations/OPERATION_ID"
}

בדיקת הסטטוס של פעולה ממושכת

השימוש בשיטת ההפעלה או ההשבתה מחזיר פעולה ממושכת (LRO). ה-LRO עוקב אחרי הסטטוס של הבקשה ומציין אם השינוי בשירות הושלם.

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

‫OPERATION_ID: מזהה הפעולה. המזהה הזה מופיע בתגובה לבקשה המקורית.

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

‫Curl (Linux,‏ macOS או Cloud Shell)

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

‎PowerShell (Windows)

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

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

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

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

כשהערך של השדה done מוגדר בתור true, הפעולה הושלמה.