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

ספריות לקוח של Compute Engine

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

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

התקנת ספריית הלקוח

C++

פועלים לפי Quickstart.

C#

מתקינים את החבילה Google.Cloud.Compute.V1 מ-NuGet.

מידע נוסף זמין במאמר הגדרת סביבת פיתוח ב-C# ‎.

Go

go get cloud.google.com/go/compute/apiv1

מידע נוסף זמין במאמר הגדרת סביבת פיתוח ב-Go.

Java

אם משתמשים ב-Maven, צריך להוסיף את הקוד הבא לקובץ pom.xml. במאמר העוסק בספריות BOM ל-Google Cloud Platform תוכלו לקרוא מידע נוסף על עצי מוצרים (BOM).

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.90.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-compute</artifactId>
  </dependency>
</dependencies>

אם משתמשים ב-Gradle, צריך להוסיף את הקוד הבא ליחסי התלות:

implementation platform('com.google.cloud:libraries-bom:26.90.0')

implementation 'com.google.cloud:google-cloud-compute'

אם משתמשים ב-sbt, צריך להוסיף את הקוד הבא ליחסי התלות:

libraryDependencies += "com.google.cloud" % "google-cloud-compute" % "1.110.0"

הגרסה הישנה יותר של ספריות הלקוח של Java ל-Compute Engine ב-Cloud זמינה כגרסה 0.120.x או גרסה מוקדמת יותר בארטיפקט Maven. גרסאות 0.120.x וגרסאות קודמות של הספרייה הזו לא תואמות לגרסאות מאוחרות יותר.

מידע נוסף זמין במאמר הגדרת סביבת פיתוח ב-Java.

Node.js

npm install @google-cloud/compute

הגרסה הישנה יותר של ספריות הלקוח של Cloud ל-Node.js בשביל Compute Engine זמינה כגרסה 2.5.x או גרסה קודמת בחבילת npm. גרסאות 2.5.x וגרסאות קודמות של הספרייה הזו לא תואמות לגרסאות מאוחרות יותר.

מידע נוסף זמין במאמר הגדרת סביבת פיתוח ב-Node.js.

PHP

composer require google/cloud-compute

מידע נוסף זמין במאמר שימוש ב-PHP ב-Google Cloud.

Python

pip install --upgrade google-cloud-compute

מידע נוסף זמין במאמר הגדרת סביבת פיתוח ב-Python.

Ruby

gem install google-cloud-compute-v1

מידע נוסף זמין במאמר הגדרת סביבת פיתוח ב-Ruby.

Rust

cargo add google-cloud-compute-v1

מידע נוסף זמין במאמר תחילת העבודה עם Rust.

מגדירים אימות

כדי לאמת קריאות לממשקי ה-API של Google Cloud , ספריות הלקוח תומכות ב-Application Default Credentials ‏ (ADC). בספריות מתבצע חיפוש של פרטי כניסה בקבוצה של מיקומים מוגדרים, והמערכת משתמשת בפרטי הכניסה האלה כדי לאמת בקשות ל-API. בעזרת ADC, פרטי הכניסה לאפליקציה יכולים להיות זמינים בסביבות שונות, כמו בפיתוח מקומי או בייצור, בלי שיהיה צריך לשנות את קוד האפליקציה.

בסביבות ייצור, הגדרת ADC משתנה בהתאם לשירות ולהקשר. מידע נוסף זמין במאמר בנושא הגדרה של Application Default Credentials.

בסביבת פיתוח מקומית, אפשר להגדיר ADC עם פרטי הכניסה שמשויכים לחשבון Google:

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

מסך הכניסה יופיע. אחרי שנכנסים, פרטי הכניסה נשמרים בקובץ פרטי הכניסה המקומי שמשמש את ADC.

שימוש בספריית הלקוח

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

C#


using Google.Cloud.Compute.V1;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class ListZoneInstancesAsyncSample
{
    public async Task<IList<Instance>> ListZoneInstancesAsync(
        // TODO(developer): Set your own default values for these parameters or pass different values when calling this method.
        string projectId = "your-project-id", 
        string zone = "us-central1-a")
    {
        // Initialize client that will be used to send requests. This client only needs to be created
        // once, and can be reused for multiple requests.
        InstancesClient client = await InstancesClient.CreateAsync();
        IList<Instance> allInstances = new List<Instance>();

        // Make the request to list all VM instances in the given zone in the specified project.
        await foreach(var instance in client.ListAsync(projectId, zone))
        {
            // The result is an Instance collection.
            Console.WriteLine($"Instance: {instance.Name}");
            allInstances.Add(instance);
        }

        return allInstances;
    }
}

Go

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/api/iterator"
)

// listInstances prints a list of instances created in given project in given zone.
func listInstances(w io.Writer, projectID, zone string) error {
	// projectID := "your_project_id"
	// zone := "europe-central2-b"
	ctx := context.Background()
	instancesClient, err := compute.NewInstancesRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %w", err)
	}
	defer instancesClient.Close()

	req := &computepb.ListInstancesRequest{
		Project: projectID,
		Zone:    zone,
	}

	it := instancesClient.List(ctx, req)
	fmt.Fprintf(w, "Instances found in zone %s:\n", zone)
	for {
		instance, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return err
		}
		fmt.Fprintf(w, "- %s %s\n", instance.GetName(), instance.GetMachineType())
	}
	return nil
}

Java


import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import java.io.IOException;

public class ListInstance {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample
    String project = "your-project-id";
    String zone = "zone-name";
    listInstances(project, zone);
  }

  // List all instances in the given zone in the specified project ID.
  public static void listInstances(String project, String zone) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `instancesClient.close()` method on the client to 
    // safely clean up any remaining background resources.
    try (InstancesClient instancesClient = InstancesClient.create()) {
      // Set the project and zone to retrieve instances present in the zone.
      System.out.printf("Listing instances from %s in %s:", project, zone);
      for (Instance zoneInstance : instancesClient.list(project, zone).iterateAll()) {
        System.out.println(zoneInstance.getName());
      }
      System.out.println("####### Listing instances complete #######");
    }
  }
}

Node.js

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const zone = 'europe-central2-b'

const compute = require('@google-cloud/compute');

// List all instances in the given zone in the specified project.
async function listInstances() {
  const instancesClient = new compute.InstancesClient();

  const [instanceList] = await instancesClient.list({
    project: projectId,
    zone,
  });

  console.log(`Instances found in zone ${zone}:`);

  for (const instance of instanceList) {
    console.log(` - ${instance.name} (${instance.machineType})`);
  }
}

listInstances();

PHP

use Google\Cloud\Compute\V1\Client\InstancesClient;
use Google\Cloud\Compute\V1\ListInstancesRequest;

/**
 * List all instances for a particular Cloud project and zone.
 *
 * @param string $projectId Your Google Cloud project ID.
 * @param string $zone Zone to list instances for (like "us-central1-a").
 *
 * @throws \Google\ApiCore\ApiException if the remote call fails.
 */
function list_instances(string $projectId, string $zone)
{
    // List Compute Engine instances using InstancesClient.
    $instancesClient = new InstancesClient();
    $request = (new ListInstancesRequest())
        ->setProject($projectId)
        ->setZone($zone);
    $instancesList = $instancesClient->list($request);

    printf('Instances for %s (%s)' . PHP_EOL, $projectId, $zone);
    foreach ($instancesList as $instance) {
        printf(' - %s' . PHP_EOL, $instance->getName());
    }
}

Python

from __future__ import annotations

from collections.abc import Iterable

from google.cloud import compute_v1


def list_instances(project_id: str, zone: str) -> Iterable[compute_v1.Instance]:
    """
    List all instances in the given zone in the specified project.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        zone: name of the zone you want to use. For example: “us-west3-b”
    Returns:
        An iterable collection of Instance objects.
    """
    instance_client = compute_v1.InstancesClient()
    instance_list = instance_client.list(project=project_id, zone=zone)

    print(f"Instances found in zone {zone}:")
    for instance in instance_list:
        print(f" - {instance.name} ({instance.machine_type})")

    return instance_list

Ruby


require "google/cloud/compute/v1"

# Lists all instances in the given zone in the specified project.
#
# @param [String] project project ID or project number of the Cloud project you want to use.
# @param [String] zone name of the zone you want to use. For example: "us-west3-b"
# @return [Array<::Google::Cloud::Compute::V1::Instance>] Array of instances.
def list_instances project:, zone:
  # Initialize client that will be used to send requests. This client only needs to be created
  # once, and can be reused for multiple requests.
  client = ::Google::Cloud::Compute::V1::Instances::Rest::Client.new

  # Send the request to list all VM instances in the given zone in the specified project.
  instance_list = client.list project: project, zone: zone

  puts "Instances found in zone #{zone}:"
  instances = []
  instance_list.each do |instance|
    puts " - #{instance.name} (#{instance.machine_type})"
    instances << instance
  end
  instances
end

Rust

pub async fn quickstart(project_id: &str) -> anyhow::Result<()> {
    use google_cloud_compute_v1::client::Instances;
    use google_cloud_gax::paginator::ItemPaginator;

    const ZONE: &str = "us-central1-a";

    let client = Instances::builder().build().await?;
    println!("Listing instances for project {project_id}");
    let mut instances = client
        .list()
        .set_project(project_id)
        .set_zone(ZONE)
        .by_item();
    while let Some(item) = instances.next().await.transpose()? {
        println!("  {:?}", item.name);
    }
    println!("DONE");
    Ok(())
}

מקורות מידע נוספים

C++

ברשימה הבאה יש קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של C++‎:

C#

ברשימה הבאה יש קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של ‎#C:

Go

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

Java

ברשימה הבאה יש קישורים למקורות מידע נוספים שקשורים לספריית הלקוח ל-Java:

Node.js

ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של Node.js:

PHP

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

Python

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

Ruby

ברשימה הבאה יש קישורים למקורות מידע נוספים שקשורים לספריית הלקוח ל-Ruby:

Rust

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

ספריות לקוח ישנות יותר

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

אם אתם לא יכולים להשתמש בספריות הלקוח ב-Cloud, אתם יכולים להשתמש בספריות הלקוח של Google API הבאות:

שפה	ספרייה	משאבים
המשך	ספריית הלקוח של Google API Go	מסמכי תיעוד
Java	ספריית הלקוח של Google API ל-Java	מסמכי תיעוד
JavaScript	ספריית הלקוח של Google API JavaScript	מסמכי תיעוד
‎.NET	ספריית הלקוח של Google API ל-‎ .NET	מסמכי תיעוד
Node.js	ספריית הלקוח של Google API Node.js	מסמכי תיעוד
Objective-C	ספריית הלקוח של Google API Objective-C	מסמכי תיעוד
PHP	ספריית הלקוח של Google API ל-PHP	מסמכי תיעוד
Python	ספריית הלקוח של Google API Python	מסמכי תיעוד
Ruby	ספריית הלקוח של Google API ל-Ruby	מסמכי תיעוד
Dart	ספריית הלקוח של Google API Dart	מסמכי תיעוד

ספריות לקוח של Compute Engine API של צד שלישי

libcloud

‫libcloud היא ספריית Python שמשמשת לאינטראקציה עם כמה ספקי שירותי ענן באמצעות API מאוחד אחד.

פרויקט Apache libcloud API מקבל תמיכה ועדכונים ל-Compute Engine מאז יולי 2013. הוא תומך במגוון רחב של תכונות של Compute Engine, כולל מכונות, דיסקים, רשתות ומאזני עומסים. הדגמת ההתחלה מספקת דוגמה לקוד שמראה איך להשתמש ב-libcloud וב-Compute Engine ביחד.

jclouds

‫jclouds היא ספריית קוד פתוח שמאפשרת להשתמש ב-Java וב-Clojure בכמה ספקי שירותי ענן.

‫Cloud API של jclouds תומך ב-Compute Engine ומאפשר לנהל משאבים כמו מכונות וירטואליות, דיסקים ורשתות. החל מגרסה 1.9, Compute Engine קודם לליבה של jclouds.

fog.io

‫fog.io היא ספריית Ruby בקוד פתוח שמאפשרת לכם להשתמש בכמה שירותי ענן באמצעות API אחד.

ה-API בענן fog.io תומך ב-Compute Engine מאז גרסה 1.11.0 במאי 2013. הוא תומך בפעולות במכונות, כמו יצירה ומחיקה, וגם בפעולות ניהול של משאבים אחרים כמו דיסקים, רשתות ומאזני עומסים.

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

התקנת ספריית הלקוח

C++

C#

Go

Java

Node.js

PHP

Python

Ruby

Rust

מגדירים אימות

שימוש בספריית הלקוח

C#

Go

Java

Node.js

PHP

Python

Ruby

Rust

מקורות מידע נוספים

C++

C#

Go

Java

Node.js

PHP

Python

Ruby

Rust

ספריות לקוח ישנות יותר

ספריות לקוח של Compute Engine API של צד שלישי

libcloud

jclouds

fog.io

ספריות לקוח של Compute Engine