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

Linux

1. מתחברים ל-VM של Linux.

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

   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 בהתאם לתרחיש השימוש.

   לדוגמה, כדי לשלוח שאילתה לגבי תמונת האתחול של מכונת ה-VM, מריצים את השאילתה הבאה:

   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. מתחברים ל-VM של Windows.

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 בהתאם לתרחיש השימוש.

   לדוגמה, כדי לשלוח שאילתה לגבי תמונת האתחול של מכונת ה-VM, מריצים את השאילתה הבאה:

   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. מתחברים ל-VM של Linux.

2. כדי לשלוח שאילתה לספריית מטא-נתונים של מכונה וירטואלית או פרויקט, מריצים את הפקודה הבאה ממכונת ה-VM של 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/, שהיא ספרייה של דיסקים שמצורפים ל-VM. כדי לשלוח שאילתה לרשומה 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/ הוא ספרייה של דיסקים שמצורפים ל-VM. כדי לשלוח שאילתה לרשומה של הדיסקים:

1. מתחברים ל-VM של Windows.

2. כדי לשלוח שאילתה לספריית מטא-נתונים של מכונת VM או פרויקט, מריצים את הפקודה הבאה ממכונת ה-VM של 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/, שהיא ספרייה של דיסקים שמצורפים ל-VM. כדי לשלוח שאילתה לרשומה 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. מתחברים ל-VM של Linux.

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

   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. מתחברים ל-VM של Windows.

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

     $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. מתחברים ל-VM של Linux.

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

   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. מתחברים ל-VM של Windows.

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. מתחברים ל-VM של Linux.

2. במכונת ה-Linux הווירטואלית, משתמשים בכלי 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. מתחברים ל-VM של Windows.

2. במכונה הווירטואלית של 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. מתחברים ל-VM של Linux.

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

   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. מתחברים ל-VM של Windows.

2. במכונה הווירטואלית של Windows, משתמשים בפקודה Invoke-RestMethod כדי לבצע שאילתה. כדי לבצע בקשת 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")
   $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. מתחברים ל-VM של Linux.

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

   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. מתחברים ל-VM של Windows.

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

     $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. מתחברים ל-VM של Linux.

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

     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. מתחברים ל-VM של Windows.

2. במכונה הווירטואלית של Windows, משתמשים בפקודה Invoke-RestMethod כדי לבצע שאילתה. כדי לבצע בקשת 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&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. מתחברים ל-VM של Linux.

2. ממכונת ה-VM של 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. צריך לציין את הערך הזה אם אישור הבסיס לא נוסף למאגר האישורים של מערכת ההפעלה.

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

   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. מתחברים ל-VM של Windows.

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. ממכונת ה-VM של 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: הנתיב אל אישור הזהות של הלקוח במכונה הווירטואלית. זהו המשתנה $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. לוחצים על שם המכונה הווירטואלית שרוצים להציג את המטא-נתונים שלה.

   • מפתחות 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 VM_NAME --flatten="metadata[]"

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

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

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

REST

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

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

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

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

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

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