הצגה של מטא-נתונים של מכונות וירטואליות והרצת שאילתות לגביהם

Linux

1. מתחברים למופע Linux.

2. ממופע Linux, משתמשים בכלי curl כדי לשלוח שאילתה. כדי לשלוח שאילתה לגבי מכונת Compute או רשומה של מטא-נתונים של פרויקט, מריצים את הפקודה הבאה:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY" -H "Metadata-Flavor: Google"
   

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

   • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
   • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
   • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.

   לדוגמה, כדי לשלוח שאילתה לגבי אימג' האתחול של מופע Compute, מריצים את השאילתה הבאה:

   user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/image" -H "Metadata-Flavor: Google"
   

   הפלט אמור להיראות כך:

   projects/rhel-cloud/global/images/rhel-8-v20210122

Windows

1. מתחברים למופע של Windows Compute.

2. ממכונת Windows, משתמשים בפקודה Invoke-RestMethod כדי לבצע שאילתה. כדי לשלוח שאילתה לגבי רשומה של מטא-נתונים של פרויקט או של מכונת חישוב, מריצים את הפקודה הבאה:

   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY")
   $value
   

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

   • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
   • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
   • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.

   לדוגמה, כדי לשלוח שאילתה לגבי אימג' האתחול של מופע Compute, מריצים את השאילתה הבאה:

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/image")
   $value
   

   הפלט אמור להיראות כך:

   projects/windows-cloud/global/images/windows-server-2019-dc-v20210112

Linux

1. מתחברים למופע של מחשוב Linux.

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

     curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/" -H "Metadata-Flavor: Google"
     

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

   • כדי להציג את רשומת ספריית המטא-נתונים של הפרויקט attributes, הנתיב שצריך לציין הוא project/attributes/.
   • כדי לראות את רשומת ספריית המטא-נתונים של מופע המכונה הווירטואלית disks, הנתיב שצריך לציין הוא instance/disks/.

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

   1. מריצים את הפקודה curl של הכלי בספריית הדיסקים.

      user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/" -H "Metadata-Flavor: Google"
      

      הפלט אמור להיראות כך:

      0/
      1/
      2/
      

   2. אם רוצים לקבל מידע נוסף על ספריית 0/ בדיסק, אפשר לשלוח שאילתה לכתובת ה-URL הספציפית של הספרייה הזו:

      user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/" -H "Metadata-Flavor: Google"
      

      הפלט אמור להיראות כך:

      device-name
      index
      mode
      type
      

   3. כדי לשלוח שאילתה לגבי סוג הדיסק (type) של דיסקים 0/, אפשר להריץ את הפקודה הבאה:

      user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/type" -H "Metadata-Flavor: Google"
      

      הפלט אמור להיראות כך:

      PERSISTENT
      

Windows

הערך disks/ הוא ספרייה של דיסקים שמצורפים למופע של Compute. כדי לשלוח שאילתה לרשומה של הדיסקים:

1. מתחברים למופע של Windows Compute.

2. כדי לבצע שאילתה לגבי ספריית מטא-נתונים של פרויקט או של מכונת Compute, מריצים את הפקודה הבאה ממכונת ה-Compute של Windows:

   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/")
   $value
   

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

   • כדי להציג את רשומת ספריית המטא-נתונים של הפרויקט attributes, הנתיב שצריך לציין הוא project/attributes/.
   • כדי לראות את רשומת ספריית המטא-נתונים של מופע המכונה הווירטואלית disks, הנתיב שצריך לציין הוא instance/disks/.

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

   1. משתמשים בפקודה Invoke-RestMethod בספריית הדיסקים.

      PS C:\> 
      $value = (Invoke-RestMethod `
                -Headers @{'Metadata-Flavor' = 'Google'} `
                -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/")
      $value
      

      הפלט אמור להיראות כך:

      0/
      1/
      2/
      

   2. אם רוצים לקבל מידע נוסף על ספריית 0/ בדיסק, אפשר לשלוח שאילתה לכתובת ה-URL הספציפית של הספרייה:

      PS C:\> 
      $value = (Invoke-RestMethod `
                -Headers @{'Metadata-Flavor' = 'Google'} `
                -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/")
      $value
      

      הפלט אמור להיראות כך:

      device-name
      index
      mode
      type
      

   3. כדי לשלוח שאילתה לגבי סוג הדיסק (type) של דיסקים 0/, אפשר להריץ את הפקודה הבאה:

      PS C:\> 
      $value = (Invoke-RestMethod `
                -Headers @{'Metadata-Flavor' = 'Google'} `
                -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/type")
      $value
      

      הפלט אמור להיראות כך:

      PERSISTENT
      

Linux

1. מתחברים למופע של מחשוב Linux.

2. מתוך מכונת ה-Compute של Linux, משתמשים בכלי curl כדי להריץ שאילתה. כדי לבצע שאילתה באופן רקורסיבי על הרישומים של מכונת Compute או של ספריית מטא-נתונים של פרויקט, מריצים את הפקודה הבאה:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/?recursive=true" -H "Metadata-Flavor: Google"
   

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

   • כדי להציג את רשומת ספריית המטא-נתונים של הפרויקט attributes, הנתיב שצריך לציין הוא project/attributes/.
   • כדי לראות את רשומת ספריית המטא-נתונים של מופע המכונה הווירטואלית disks, הנתיב שצריך לציין הוא instance/disks/.

   לדוגמה, הפקודה הבאה שולחת שאילתה באופן רקורסיבי לרשימות של מטא-נתונים של מופע עבור הספרייה disks/.

     user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true" -H "Metadata-Flavor: Google"
     

   הפלט אמור להיראות כך:

     [{"deviceName":"boot","index":0,"mode":"READ_WRITE","type":"PERSISTENT"},
     {"deviceName":"persistent-disk-1","index":1,"mode":"READ_WRITE","type":"PERSISTENT"},
     {"deviceName":"persistent-disk-2","index":2,"mode":"READ_ONLY","type":"PERSISTENT"}]
     

   כברירת מחדל, התוכן הרקורסיבי מוחזר בפורמט JSON. אם רוצים להחזיר את התוכן הזה בפורמט טקסט, מוסיפים את פרמטר השאילתה alt=text:

     user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true&alt=text" -H "Metadata-Flavor: Google"
     

   הפלט אמור להיראות כך:

     0/device-name boot
     0/index 0
     0/mode READ_WRITE
     0/type PERSISTENT
     1/device-name persistent-disk-1
     1/index 1
     1/mode READ_WRITE
     1/type PERSISTENT
     2/device-name persistent-disk-1
     2/index 2
     2/mode READ_ONLY
     2/type PERSISTENT
     

Windows

1. מתחברים למופע של Windows Compute.

2. ממכונת החישוב של Windows, משתמשים בפקודה Invoke-RestMethod כדי לבצע שאילתה. כדי לבצע שאילתה באופן רקורסיבי על הרישומים של מכונת Compute או של ספריית המטא-נתונים של הפרויקט, מריצים את הפקודה הבאה:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
               -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/?recursive=true")
     $value
     

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

   • כדי להציג את רשומת ספריית המטא-נתונים של הפרויקט attributes, הנתיב שצריך לציין הוא project/attributes/.
   • כדי לראות את רשומת ספריית המטא-נתונים של מופע המכונה הווירטואלית disks, הנתיב שצריך לציין הוא instance/disks/.

   לדוגמה, הפקודה הבאה שולחת שאילתה באופן רקורסיבי לרשימות של מטא-נתונים של מופע עבור הספרייה disks/.

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true")
   $value
   

   הפלט אמור להיראות כך:

   [{"deviceName":"boot","index":0,"mode":"READ_WRITE","type":"PERSISTENT"},
   {"deviceName":"persistent-disk-1","index":1,"mode":"READ_WRITE","type":"PERSISTENT"},
   {"deviceName":"persistent-disk-2","index":2,"mode":"READ_ONLY","type":"PERSISTENT"}]
   

   כברירת מחדל, התוכן הרקורסיבי מוחזר בפורמט JSON. אם רוצים להחזיר את התוכן הזה בפורמט טקסט, מוסיפים את פרמטר השאילתה alt=text:

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true&alt=text")
   $value
   

   הפלט אמור להיראות כך:

   0/device-name boot
   0/index 0
   0/mode READ_WRITE
   0/type PERSISTENT
   1/device-name persistent-disk-1
   1/index 1
   1/mode READ_WRITE
   1/type PERSISTENT
   2/device-name persistent-disk-1
   2/index 2
   2/mode READ_ONLY
   2/type PERSISTENT
   

Linux

1. מתחברים למופע של מחשוב Linux.

2. מתוך מכונת ה-Compute של Linux, משתמשים בכלי curl כדי להריץ שאילתה. כדי לשנות את פורמט הנתונים של תגובת השאילתה עבור מטא-נתונים של פרויקט או של מופע Compute, מריצים את הפקודה הבאה:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?alt=DATA_FORMAT" -H "Metadata-Flavor: Google"
   

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

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.
   • ‫DATA_FORMAT: הפורמט שבו רוצים לקבל את נתוני התגובה לשאילתה. לדוגמה, text או json.

דוגמה

לדוגמה, המפתח tags מחזיר נתונים בפורמט JSON באופן אוטומטי. אפשר להחזיר את הנתונים בפורמט טקסט במקום זאת, על ידי ציון פרמטר השאילתה alt=text.

שאילתת ברירת מחדל

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags" -H "Metadata-Flavor: Google"
  

הפלט אמור להיראות כך:

  ["http-server", "db-client", "app-server", "mysql-server"]
  

שאילתה עם עיצוב

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?alt=text" -H "Metadata-Flavor: Google"
  

הפלט אמור להיראות כך:

  http-server
  db-client
  app-server
  mysql-server

Windows

1. מתחברים למופע של Windows Compute.

2. ממכונת החישוב של Windows, משתמשים בפקודה Invoke-RestMethod כדי לבצע שאילתה. כדי לשנות את פורמט הנתונים של תגובת השאילתה עבור מכונת חישוב או רשומת מטא-נתונים של פרויקט, מריצים את הפקודה הבאה:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
               -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?alt=DATA_FORMAT")
     $value
     

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

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.
   • ‫DATA_FORMAT: הפורמט שבו רוצים לקבל את נתוני התגובה לשאילתה. לדוגמה, text או json.

דוגמה

לדוגמה, מפתח tags מחזיר נתונים בפורמט JSON באופן אוטומטי. אפשר להחזיר את הנתונים בפורמט טקסט במקום זאת, על ידי ציון פרמטר השאילתה alt=text.

שאילתת ברירת מחדל

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags")
  $value
  

הפלט אמור להיראות כך:

  ["http-server", "db-client", "app-server", "mysql-server"]
  

שאילתה עם עיצוב

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?alt=text")
  $value
  

הפלט אמור להיראות כך:

  http-server
  db-client
  app-server
  mysql-server

Linux

1. מתחברים למופע של מחשוב Linux.

2. ממכונת ה-Linux שלכם ב-Compute, משתמשים בכלי curl כדי לבקש אסימון עם היקפי הרשאות מוגבלים:

   curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token?enforce_scopes=true&scopes=SCOPE_1,SCOPE_2,..." -H "Metadata-Flavor: Google"
   

   מחליפים את SCOPE_1,SCOPE_2,... ברשימה מופרדת בפסיקים של היקפי הרשאות של OAuth2.

   לדוגמה, כדי לבקש אסימון עם היקף מצומצם לגישה לקריאה בלבד ל-Cloud Storage:

   user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token?enforce_scopes=true&scopes=https://www.googleapis.com/auth/devstorage.read_only" -H "Metadata-Flavor: Google"
   

   הפלט אמור להיראות כך:

   {
     "access_token": "ya29.c....",
     "expires_in": 3599,
     "token_type": "Bearer"
   }
   

Windows

1. מתחברים למופע של Windows Compute.

2. ממכונת ה-Compute של Windows, משתמשים בפקודה Invoke-RestMethod כדי לבקש אסימון עם היקפי הרשאות מוגבלים:

   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token?enforce_scopes=true&scopes=SCOPE_1,SCOPE_2,...")
   $value
   

   מחליפים את SCOPE_1,SCOPE_2,... ברשימה מופרדת בפסיקים של היקפי הרשאות של OAuth2.

   לדוגמה, כדי לבקש אסימון עם היקף מצומצם לגישה לקריאה בלבד ל-Cloud Storage:

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token?enforce_scopes=true&scopes=https://www.googleapis.com/auth/devstorage.read_only")
   $value
   

   הפלט אמור להיראות כך:

   access_token    : ya29.c....
   expires_in      : 3599
   token_type      : Bearer
   

Linux

1. מתחברים למופע של מחשוב Linux.

2. מתוך מכונת ה-Compute של Linux, משתמשים בכלי curl כדי להריץ שאילתה. כדי לבצע בקשת wait-for-change עבור מטא-נתונים של מכונת Compute או של פרויקט, מריצים את הפקודה הבאה:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true" -H "Metadata-Flavor: Google"
   

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

   • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
   • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
   • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.

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

דוגמאות

בדוגמה הזו, אם מתבצעת בקשה אל setInstanceTags method, הבקשה חוזרת עם הערכים החדשים:

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true" -H "Metadata-Flavor: Google"
  

הפלט אמור להיראות כך:

  http-server
  db-client
  

אפשר גם לבצע wait-for-change בקשה באופן רקורסיבי על התוכן של ספרייה:

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/attributes/?recursive=true&wait_for_change=true" -H "Metadata-Flavor: Google"
  

אם יש שינוי, שרת המטא-נתונים מחזיר את התוכן החדש:

  {"foo":"bar","baz":"bat"}
  

Windows

1. מתחברים למופע של Windows Compute.

2. ממכונת החישוב של Windows, משתמשים בפקודה Invoke-RestMethod כדי לבצע שאילתה. כדי לבצע בקשת wait-for-change של רשומה במטא-נתונים של פרויקט או של מופע Compute, מריצים את הפקודה הבאה:

   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true")
   $value
   

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

   • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
   • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
   • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.

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

דוגמאות

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

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true")
  $value
  

הפלט אמור להיראות כך:

  http-server
  db-client
  

אפשר גם לבצע בקשת wait-for-change באופן רקורסיבי על התוכן של ספרייה:

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes?recursive=true&wait_for_change=true")
  $value
  

אם יש שינוי, שרת המטא-נתונים מחזיר את התוכן החדש:

  {"foo":"bar","baz":"bat"}
  

Linux

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

1. מתחברים למופע של מחשוב Linux.

2. שולחים בקשה למפתח ומדפיסים את הכותרות. כדי לעשות את זה, משתמשים בכלי curl עם הדגל -v. כדי לקבל את ה-ETag הנוכחי של מכונת Compute או של רשומה במטא-נתונים של פרויקט, מריצים את הפקודה הבאה:

   curl -v "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY" -H "Metadata-Flavor: Google"
   

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

   • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
   • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
   • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש לדוגמה.

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

     user@myinst:~$ curl -v "http://metadata.google.internal/computeMetadata/v1/instance/tags" -H "Metadata-Flavor: Google"
     

   הפלט אמור להיראות כך:

   * About to connect() to metadata port 80 (#0)
   * Trying 169.254.169.254... connected
   * Connected to metadata (169.254.169.254) port 80 (#0)
   > GET /computeMetadata/v1/instance/tags HTTP/1.1
   > User-Agent: curl/7.19.7 (x86_64-pc-linux-gnu) libcurl/7.19.7 OpenSSL/0.9.8k zlib/1.2.3.3 libidn/1.15
   > Host: metadata
   > Accept: */*
   >
   < HTTP/1.1 200 OK
   < Content-Type: application/text
   < ETag: 411261ca6c9e654e
   < Date: Wed, 13 Feb 2013 22:43:45 GMT
   < Server: Metadata Server for VM
   < Content-Length: 26
   < X-XSS-Protection: 1; mode=block
   < X-Frame-Options: SAMEORIGIN
   <
   http-server
   db-client

3. אחר כך אפשר להשתמש בערך ה-ETag הזה עם הפקודה curl של הכלי בבקשת wait-for-change. כדי להשתמש בערך ה-ETag בבקשת wait-for-change של מטא-נתונים של מופע או פרויקט, מריצים את הפקודה הבאה:

     curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&last_etag=ETAG" -H "Metadata-Flavor: Google"
     

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

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.
   • ‫ETAG: ערך ה-ETag של מפתח המטא-נתונים.

   בדוגמה הזו, הפקודה הבאה משתמשת בערך ETag של המפתח tags ושולחת שאילתה לגבי רשומת המטא-נתונים של המופע.

     user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&last_etag=411261ca6c9e654e" -H "Metadata-Flavor: Google"
     

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

Windows

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

1. מתחברים למופע של Windows Compute.

2. שולחים בקשה למפתח הזה ומדפיסים את הכותרות. ב-Windows, משתמשים בפקודה Invoke-WebRequest. כדי לקבל את ה-ETag הנוכחי של מכונת Compute או של רשומה במטא-נתונים של פרויקט, מריצים את הפקודה הבאה:

     $value = (Invoke-WebRequest -Headers @{'Metadata-Flavor' = 'Google'} `
     -Uri http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY)
   
   
   $value.Headers.ETag
     

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

   • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
   • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
   • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש לדוגמה.

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

     PS C:> 
     $value = (Invoke-WebRequest -Headers @{'Metadata-Flavor' = 'Google'} `
     -Uri http://metadata.google.internal/computeMetadata/v1/instance/tags)
   
   
   $value.Headers.ETag
     

   הפלט אמור להיראות כך:

     * About to connect() to metadata port 80 (#0)
     * Trying 169.254.169.254... connected
     * Connected to metadata (169.254.169.254) port 80 (#0)
     > GET /computeMetadata/v1/instance/tags HTTP/1.1
     > User-Agent: curl/7.19.7 (x86_64-pc-linux-gnu) libcurl/7.19.7 OpenSSL/0.9.8k zlib/1.2.3.3 libidn/1.15
     > Host: metadata
     > Accept: /
     >
     < HTTP/1.1 200 OK
     < Content-Type: application/text
     < ETag: 411261ca6c9e654e
     < Date: Wed, 13 Feb 2013 22:43:45 GMT
     < Server: Metadata Server for VM
     < Content-Length: 26
     < X-XSS-Protection: 1; mode=block
     < X-Frame-Options: SAMEORIGIN
     <
     http-server
     db-client

3. אחר כך אפשר להשתמש בערך ה-ETag הזה בבקשת wait-for-change. כדי להשתמש בערך ה-ETag לבקשת wait-for-change של מטא-נתונים של מופע או פרויקט, מריצים את הפקודה הבאה:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&last_etag=ETAG")
     $value
     

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

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.
   • ‫ETAG: ערך ה-ETag של מפתח המטא-נתונים.

   בדוגמה הזו, הפקודה הבאה משתמשת בערך ETag של המפתח tags ושולחת שאילתה לגבי רשומת המטא-נתונים של המופע.

     PS C:> 
     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
               -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&last_etag=411261ca6c9e654e")
     $value
     

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

Python

בדוגמה הבאה של Python אפשר לראות איך לעקוב אחרי שינויים בשרת המטא-נתונים באופן פרוגרמטי.

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

last_etag = "0"

while True:
    r = requests.get(
        url,
        params={"last_etag": last_etag, "wait_for_change": True},
        headers=METADATA_HEADERS,
    )

    # During maintenance the service can return a 503, so these should
    # be retried.
    if r.status_code == 503:
        time.sleep(1)
        continue
    r.raise_for_status()

    last_etag = r.headers["etag"]

Linux

1. מתחברים למופע של מחשוב Linux.

2. מתוך מכונת ה-Compute של Linux, משתמשים בכלי curl כדי להריץ שאילתה. כדי לבצע בקשת wait-for-change עם ערך של פסק זמן עבור מכונת Compute או רשומה במטא-נתונים של פרויקט, מריצים את הפקודה הבאה:

     curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&timeout_sec=TIMEOUT" -H "Metadata-Flavor: Google"
     

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

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.
   • ‫TIMEOUT: ערך הזמן הקצוב לתפוגה.

לדוגמה, הפקודה הבאה מבצעת בקשת wait-for-change שמוגדרת להפסקת פעולה אחרי 360 שניות:

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&timeout_sec=360" -H "Metadata-Flavor: Google"
  

Windows

1. מתחברים למופע של מחשוב Windows.

2. ממכונת Compute ב-Windows, משתמשים בפקודה Invoke-RestMethod כדי לבצע שאילתה. כדי לבצע בקשת wait-for-change עם ערך פסק זמן עבור מופע של Compute או ערך מטא-נתונים של פרויקט, מריצים את הפקודה הבאה:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&timeout_sec=TIMEOUT")
     $value
     

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

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.
   • ‫TIMEOUT: ערך הזמן הקצוב לתפוגה.

לדוגמה, הפקודה הבאה מבצעת בקשת wait-for-change שמוגדרת להפסקת פעולה אחרי 360 שניות:

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&timeout_sec=360")
  $value
  

Linux

1. מתחברים למופע של מחשוב Linux.

2. ממכונת ה-Compute שלכם ב-Linux, משתמשים בכלי curl כדי לשלוח שאילתה ולציין את אישור הזהות של הלקוח. אפשר גם לציין את אישור הבסיס.

   curl "https://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY" \
     -E CLIENT_CERTIFICATE \
     [--cacert ROOT_CERTIFICATE] \
     -H "Metadata-Flavor: Google"
   

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

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש לדוגמה.
   • ‫CLIENT_CERTIFICATE: הנתיב לאישור הזהות של הלקוח: /run/google-mds-mtls/client.key.
   • אופציונלי: ROOT_CERTIFICATE: הנתיב אל אישור הבסיס: /run/google-mds-mtls/root.crt. צריך לציין את הערך הזה אם אישור הבסיס לא נוסף למאגר האישורים של מערכת ההפעלה.

   לדוגמה, כדי לשלוח שאילתה לגבי קובץ אימג' לאתחול של מכונת Compute, מריצים את השאילתה הבאה:

   user@myinst:~$ 
   curl "https://metadata.google.internal/computeMetadata/v1/instance/image" \
     -E /run/google-mds-mtls/client.key \
     -H "Metadata-Flavor: Google"
   

   הפלט אמור להיראות כך:

   projects/rhel-cloud/global/images/rhel-8-v20210122

   אם מופיעה הודעת שגיאה, אפשר לעיין במאמרי העזרה לפתרון בעיות.

Windows

1. מתחברים למופע של Windows Compute.

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

   • $cert = Get-PfxCertificate -FilePath "C:\ProgramData\Google\Compute Engine\mds-mtls-client.key.pfx"
     

   • $cert = Get-ChildItem Cert:\LocalMachine\My | Where-Object { $_.Issuer -like "google.internal" }
     

3. ממכונת ה-Compute של Windows, משתמשים בפקודה Invoke-RestMethod ומציינים את אישור הזהות של הלקוח כדי לבצע שאילתה.

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} -Certificate CLIENT_CERTIFICATE `
             -Uri "https://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY")
   $value
   

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

   • ‫CLIENT_CERTIFICATE: הנתיב אל אישור הזהות של הלקוח במופע של Compute. זהו המשתנה $cert שהוגדר בשלב הקודם.

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

     • כדי להציג את מפתח המטא-נתונים project-id, שמאוחסן במטא-נתונים של הפרויקט, מציינים project/project-id.
     • כדי להציג את מפתח המטא-נתונים image, שמאוחסן במטא-נתונים של המכונה הווירטואלית, מציינים את הערך instance/image.
     • כדי לראות את enable-oslogin שאפשר לאחסן בספריית המשנה attributes של מטא-נתונים של פרויקט או של מכונה וירטואלית, מציינים את project/attributes/enable-oslogin או את instance/attributes/enable-oslogin בהתאם לתרחיש השימוש.

   לדוגמה, כדי לשלוח שאילתה לגבי קובץ אימג' לאתחול של מכונת Windows Server 2019, מריצים את השאילתה הבאה:

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} -Certificate $cert `
             -Uri "https://metadata.google.internal/computeMetadata/v1/instance/image")
   $value
   

   הפלט אמור להיראות כך:

   projects/windows-cloud/global/images/windows-server-2019-dc-v20210112

המסוף

1. נכנסים לדף Metadata במסוף Cloud de Confiance .

   כניסה לדף Metadata

   בדף Metadata מוצגת רשימה של כל רשומות המטא-נתונים של הפרויקט בהתאמה אישית.

gcloud

משתמשים בפקודה gcloud compute project-info describe כדי להריץ שאילתות על מטא-נתונים של פרויקט:

gcloud compute project-info describe --flatten="commonInstanceMetadata[]"

הפלט אמור להיראות כך:

---
fingerprint: HcSFdS_1_1I=
items:
- key: ssh-keys
  value: USERNAME:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDWZ...
kind: compute#metadata

REST

כדי לשלוח שאילתה למטא-נתונים של פרויקט, יוצרים בקשת GET אל ה-method‏ project.get.

מחליפים את PROJECT_ID במזהה הפרויקט.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID

הפלט אמור להיראות כך:

"kind": "compute#project",
"id": "XXXXXXX",
"creationTimestamp": "2018-12-10T08:34:33.616-08:00",
"name": "YOUR_PROJECT",
"commonInstanceMetadata": {
  "kind": "compute#metadata",
  "fingerprint": "XXXXXCdg=",
  "items": [
    {
      "key": "enable-guest-attributes",
      "value": "TRUE"
    },
    {
      "key": "enable-os-inventory",
      "value": "true"
    },
    {
      "key": "enable-osconfig",
      "value": "TRUE"
    },
    {
      "key": "enable-oslogin",
      "value": "TRUE"
    },
    {
      "key": "sshKeys",
      "value": "XXXXX"
    }
  ]
}, ...

gcloud

כדי לבצע שאילתה על מטא-נתונים מותאמים אישית ברמת האזור, משתמשים בפקודה gcloud compute project-zonal-metadata describe.

gcloud compute project-zonal-metadata describe \
    --zone=ZONE \
    --project=PROJECT_ID

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

• ‫PROJECT_ID: מזהה הפרויקט
• ‫ZONE: האזור שעבורו רוצים להציג את המטא-נתונים האזוריים.

הפלט אמור להיראות כך:

{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
    items: {
      "key-1": "value-1",
      "key-2": "value-2"
    }
  }
}

REST

כדי לשלוח שאילתה למטא-נתונים מותאמים אישית של אזור, שולחים בקשת GET אל ה-method‏ instanceSettings().get

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceSettings

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

• ‫PROJECT_ID: מזהה הפרויקט
• ‫ZONE: האזור שעבורו רוצים להציג את המטא-נתונים האזוריים.

הפלט אמור להיראות כך:

{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
    items: {
      "key-1": "value-1",
      "key-2": "value-2"
    }
  }
}

המסוף

1. נכנסים לדף VM instances במסוף Cloud de Confiance .

   כניסה לדף VM instances

2. לוחצים על השם של מופע Compute שרוצים לראות את המטא-נתונים שלו.

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

     • הערך None מציין שאין מפתחות SSH שמאוחסנים במטא-נתונים של המופע.

     • כל ערך אחר מציין שיש מפתחות SSH שמאוחסנים במטא-נתונים של המופע.

   • מפתחות SSH לפרויקט. בקטע אבטחה וגישה, בודקים את השדה חסימת מפתחות SSH ברמת הפרויקט.

     • הערך On מציין שהערך של מפתח המטא-נתונים block-project-ssh-keys הוא TRUE במטא-נתונים של המופע.

     • הערך Off מציין שהערך של מפתח המטא-נתונים block-project-ssh-keys הוא FALSE, או שהמפתח לא מוגדר.

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

gcloud

משתמשים בפקודה gcloud compute instances describe כדי לבצע שאילתה על המטא-נתונים של המופע:

gcloud compute instances describe INSTANCE_NAME --flatten="metadata[]"

מחליפים את INSTANCE_NAME בשם של מכונת ה-Compute שרוצים למצוא את המטא-נתונים שלה.

הפלט אמור להיראות כך:

---
fingerprint: MTgTJ5m-Cjs=
items:
- key: enable-oslogin
  value: 'true'
kind: compute#metadata

REST

כדי לשלוח שאילתה למטא-נתונים של מכונת חישוב ספציפית, שולחים בקשת GET אל ה-method‏ instances.get.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

הפלט אמור להיראות כך:

......
"metadata": {
"kind": "compute#metadata",
"fingerprint": "XXXXXXVo=",
"items": [
  {
    "key": "enable-oslogin",
    "value": "true"
  }
]
},....

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

• ‫PROJECT_ID: מזהה הפרויקט
• ‫ZONE: האזור שבו נמצאת מכונת ה-Compute
• ‫INSTANCE_NAME: השם של מכונת ה-Compute