arrow_back

API Explorer: クラスタを作成して更新する

ログイン 参加
Quick tip: Review the prerequisites before you run the lab
Use an Incognito or private browser window to run this lab. This prevents any conflicts between your personal account and the student account, which may cause extra charges incurred to your personal account.
知識をテストして、コミュニティで共有しましょう
done
700 を超えるハンズオンラボ、スキルバッジ、コースへのアクセス

API Explorer: クラスタを作成して更新する

ラボ 1時間 universal_currency_alt クレジット: 1 show_chart 入門
info このラボでは、学習をサポートする AI ツールが組み込まれている場合があります。
知識をテストして、コミュニティで共有しましょう
done
700 を超えるハンズオンラボ、スキルバッジ、コースへのアクセス

GSP288

概要

Google APIs Explorer は、さまざまな Google API をインタラクティブに試すことができるツールです。API Explorer を使用すると、以下のようなことができます。

  • 利用可能な API とそのバージョンを簡単に確認する。
  • 各 API で使用できるメソッド、メソッドでサポートされるパラメータ、インラインのドキュメントを確認する。
  • メソッドのリクエストを実行して、リアルタイムでレスポンスを確認する。
  • 認証および承認済みの API 呼び出しを行う
  • すべてのサービス、メソッド、最新のリクエストの中から目的のものを迅速に見つける

API Explorer では、リクエストが行われるたびに独自の API キーが使用されます。API Explorer を使用してリクエストを行う際、{YOUR_API_KEY} というラベルのプレースホルダを含むリクエスト構文が表示されますが、このプレースホルダを独自の API キーに置き換えると、アプリケーションで同じリクエストを行うことができます。

このラボでは、インライン Google APIs Explorer テンプレートを使用して Cloud Dataproc API を呼び出し、クラスタを作成します。その後、クラスタ内でシンプルな Spark ジョブを実行します。また、API Explorer テンプレートを使用して Cloud Dataproc API を呼び出し、クラスタを更新する方法についても説明します。

設定と要件

[ラボを開始] ボタンをクリックする前に

こちらの説明をお読みください。ラボには時間制限があり、一時停止することはできません。タイマーは、Google Cloud のリソースを利用できる時間を示しており、[ラボを開始] をクリックするとスタートします。

このハンズオンラボでは、シミュレーションやデモ環境ではなく実際のクラウド環境を使って、ラボのアクティビティを行います。そのため、ラボの受講中に Google Cloud にログインおよびアクセスするための、新しい一時的な認証情報が提供されます。

このラボを完了するためには、下記が必要です。

  • 標準的なインターネット ブラウザ（Chrome を推奨）
注: このラボの実行には、シークレット モード（推奨）またはシークレット ブラウジング ウィンドウを使用してください。これにより、個人アカウントと受講者アカウント間の競合を防ぎ、個人アカウントに追加料金が発生しないようにすることができます。
  • ラボを完了するための時間（開始後は一時停止できません）
注: このラボでは、受講者アカウントのみを使用してください。別の Google Cloud アカウントを使用すると、そのアカウントに料金が発生する可能性があります。

ラボを開始して Google Cloud コンソールにログインする方法

  1. [ラボを開始] ボタンをクリックします。ラボの料金をお支払いいただく必要がある場合は、表示されるダイアログでお支払い方法を選択してください。 左側の [ラボの詳細] ペインには、以下が表示されます。

    • [Google Cloud コンソールを開く] ボタン
    • 残り時間
    • このラボで使用する必要がある一時的な認証情報
    • このラボを行うために必要なその他の情報（ある場合）

  2. [Google Cloud コンソールを開く] をクリックします（Chrome ブラウザを使用している場合は、右クリックして [シークレット ウィンドウで開く] を選択します）。

    ラボでリソースがスピンアップし、別のタブで [ログイン] ページが表示されます。

    ヒント: タブをそれぞれ別のウィンドウで開き、並べて表示しておきましょう。

    注: [アカウントの選択] ダイアログが表示されたら、[別のアカウントを使用] をクリックします。

  3. 必要に応じて、下のユーザー名をコピーして、[ログイン] ダイアログに貼り付けます。

    {{{user_0.username | "Username"}}}

    [ラボの詳細] ペインでもユーザー名を確認できます。

  4. [次へ] をクリックします。

  5. 以下のパスワードをコピーして、[ようこそ] ダイアログに貼り付けます。

    {{{user_0.password | "Password"}}}

    [ラボの詳細] ペインでもパスワードを確認できます。

  6. [次へ] をクリックします。

    重要: ラボで提供された認証情報を使用する必要があります。Google Cloud アカウントの認証情報は使用しないでください。 注: このラボでご自身の Google Cloud アカウントを使用すると、追加料金が発生する場合があります。

  7. その後次のように進みます。

    • 利用規約に同意してください。
    • 一時的なアカウントなので、復元オプションや 2 要素認証プロセスは設定しないでください。
    • 無料トライアルには登録しないでください。

その後、このタブで Google Cloud コンソールが開きます。

注: Google Cloud のプロダクトやサービスにアクセスするには、ナビゲーション メニューをクリックするか、[検索] フィールドにサービス名またはプロダクト名を入力します。

Cloud Shell をアクティブにする

Cloud Shell は、開発ツールと一緒に読み込まれる仮想マシンです。5 GB の永続ホーム ディレクトリが用意されており、Google Cloud で稼働します。Cloud Shell を使用すると、コマンドラインで Google Cloud リソースにアクセスできます。

  1. Google Cloud コンソールの上部にある「Cloud Shell をアクティブにする」アイコン をクリックします。

接続した時点で認証が完了しており、プロジェクトに各自の PROJECT_ID が設定されます。出力には、このセッションの PROJECT_ID を宣言する次の行が含まれています。

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud は Google Cloud のコマンドライン ツールです。このツールは、Cloud Shell にプリインストールされており、タブ補完がサポートされています。

  1. （省略可）次のコマンドを使用すると、有効なアカウント名を一覧表示できます。
gcloud auth list

  1. [承認] をクリックします。

  2. 出力は次のようになります。

出力:

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. （省略可）次のコマンドを使用すると、プロジェクト ID を一覧表示できます。
gcloud config list project

出力:

[core] project = <project_ID>

出力例:

[core] project = qwiklabs-gcp-44776a13dea667a6 注: Google Cloud における gcloud ドキュメントの全文については、gcloud CLI の概要ガイドをご覧ください。

タスク 1. API Explorer を開く

  1. [ナビゲーション メニュー] > [API とサービス] の順に移動します。

  2. [Cloud Dataproc API] が見つかるまで下にスクロールして、この API をクリックします。

  3. API が有効になっていることを確認します。有効になっていない場合は、[有効にする] をクリックします。

  4. API が有効になっていることを確認できたら、Rest API リファレンスを開きます。Cloud Dataproc API の REST API リファレンス ページが、新しいタブで表示されます。

タスク 2. クラスタを作成する

左側の [API とリファレンス] セクションで [REST リファレンス] > [v1] > [projects.regions.clusters] > [create] を選択して、projects.regions.clusters.create メソッドを開きます。または、メソッド: projects.regions.clusters.create のリファレンスを参照してクラスタを作成します。

次のようにフォームに入力して、以下の API Explorer テンプレートを実行します。

  1. [projectId] フィールドに Qwiklabs プロジェクト ID を入力します。
  2. [region] フィールドを に設定します。
  3. [Request body] で中かっこの内側をクリックし、clusterName プロパティを追加します。clusterName に任意のクラスタ名を入力します。clusterName の値に大文字とスペースを含めることはできません。
  4. [add a property] プルダウン メニューで、config を選択します。
  5. [add a property] プルダウンで、gceClusterConfig を選択します。
  6. この [add a Property] プルダウンで zoneUri フィールドを選択し、以下の URI を追加します。my-project-id はこのラボのプロジェクト ID に置き換えてください。
https://www.googleapis.com/compute/v1/projects/my-project-id/zones/{{{ project_0.default_zone | "ZONE" }}}
  1. config の中かっこで softwareConfig を選択します。
  2. softwareConfig の中かっこで imageVersion を選択して、2.0-debian10 に設定します。
  3. softwareConfig の中かっこで optionalComponents を選択します。optionalComponents で [ADD ITEM] をクリックして、プルダウンから JUPYTER を選択します。

以上の操作が終了すると、[Request body] 項目は以下のように表示されます。

  1. [Credentials] の [Google OAuth 2.0] と [API key] のチェックボックスがオンになっていることを確認します。
注: 認証情報に関するよくある質問を表示するには、[Credentials] の横にある疑問符アイコンをクリックします。

  1. 各フィールドに余分なスペースが含まれていないことを確認し、

  2. 下にスクロールして [Execute] をクリックします。

  3. このラボを開始するときに使用した受講者アカウントを選択します。

  4. 次の画面で [許可] をクリックすると、API Explorer にアクセスできます。

  5. リクエストの下に Dataproc API の結果が次のように表示されます。

  1. ナビゲーション メニュー > [Dataproc] > [クラスタ] に移動して、作成したクラスタを確認できます。

完了したタスクをテストする

[進行状況を確認] をクリックして、実行したタスクを確認します。 リージョンに Dataproc クラスタが正常に作成されていれば、評価スコアが表示されます。

Dataproc クラスタを作成する（リージョン: ）

タスク 3. Spark ジョブを実行する

次に、既存の Cloud Dataproc クラスタで、pi のおおよその値を計算するシンプルな Apache Spark ジョブを実行します。

  • 左側の [API とリファレンス] セクションで [REST レファレンス] > [v1] > [projects.regions.jobs] > [submit] を選択して、projects.regions.jobs.submit メソッドを開きます。または、こちらのリンクを参照してクラスタにジョブを送信します。

次のようにフォームに入力して、以下の API Explorer テンプレートを実行します。

  1. [projectId] フィールドにプロジェクト ID を入力します。
  2. [region] フィールドを に設定します。
  3. [Request body] で中かっこの内側をクリックし、job を選択します。
  4. その下にある中かっこをクリックし、placement を選択します。
  5. その下にある中かっこをクリックし、clusterName を選択してからクラスタの名前を入力します。
  6. ジョブの下にある中かっこで、sparkJob を選択します。
  7. 次の 3 つの項目を sparkJob の下に追加します。
  • sparkJob の中かっこで args を選択します。args で [ADD ITEM] をクリックして、「1000」と入力します。
  • [add a property] プルダウンで jarFileUris を選択します。jarFileUris で [ADD ITEM] をクリックして、「file:///usr/lib/spark/examples/jars/spark-examples.jar」と入力します。
  • [add a Property] プルダウンで、mainClass を選択して、「org.apache.spark.examples.SparkPi」と入力します。

以上の操作が終了すると、[Request body] 項目は以下のように表示されます。

  1. [Credentials] の [Google OAuth 2.0] と [API key] のチェックボックスがオンになっていることを確認します。
注: 認証情報に関するよくある質問を表示するには、[Credentials] の横にある疑問符アイコンをクリックします。
  1. 各フィールドに余分なスペースが含まれていないことを確認し、[EXECUTE] をクリックします。

リクエストの下に Dataproc API の処理結果が次のように表示されます。

  1. [Dataproc] > [クラスタ] の順に移動すると、結果を確認できます。クラスタの名前をクリックして、[ジョブ] タブをクリックします。

  2. [ジョブ ID] をクリックして [行の折り返し] をオンにすると、右端を超える行を表示できます。

完了したタスクをテストする

[進行状況を確認] をクリックして、実行したタスクを確認します。Spark ジョブがクラスタに正常に送信されていれば、評価スコアが表示されます。

Spark ジョブを送信する

タスク 4. クラスタを更新する

  • 左側の [API とリファレンス] セクションで [REST レファレンス] > [v1] > [projects.regions.clusters] > [patch] を選択して、projects.regions.clusters.patch メソッドを開きます。または、こちらのリンクを参照してクラスタを更新します。

次のようにフォームに入力して、以下の API Explorer テンプレートを実行します。

  1. projectID = プロジェクト ID
  2. region =
  3. clusterName = クラスタ名
  4. updateMask = config.worker_config.num_instances
  5. [Patch body] に以下を入力します。
  • 最初の中かっこ = config
  • その下の中かっこで workerConfig を選択します。
  • その下の中かっこで numInstances を選択し、「3」と入力します。

フォームが次のように表示されます。

  1. [Credentials] の [Google OAuth 2.0] と [API key] のチェックボックスがオンになっていることを確認します。
注: 認証情報に関するよくある質問を表示するには、[Credentials] の横にある疑問符アイコンをクリックします。
  1. 各フィールドに余分なスペースが含まれていないことを確認し、[EXECUTE] をクリックします。

リクエストの下に Dataproc API の処理結果が次のように表示されます。

  1. この更新を確認するには、[Dataproc クラスタ] ページに戻ります。合計 3 つのワーカーノードがあることを確認できます。

完了したタスクをテストする

[進行状況を確認] をクリックして、実行したタスクを確認します。ワーカー構成が 3 つのワーカーノードに正常に更新されていれば、評価スコアが表示されます。

3 つのワーカーノードでクラスタを更新する

タスク 5. 理解度を確認する

今回のラボで学習した内容の理解を深めていただくため、以下の選択式問題を用意しました。正解を目指して頑張ってください。

お疲れさまでした

API Explorer で Cloud Dataproc API を使用してクラスタを作成し、Spark ジョブの実行とクラスタの更新を行いました。

クエストを完了する

このセルフペース ラボは、「Exploring APIs」クエストの一部です。クエストとは学習プログラムを構成する一連のラボのことで、完了すると成果が認められてバッジが贈られます。バッジは公開して、オンライン レジュメやソーシャル メディア アカウントにリンクできます。このラボの修了後、こちらのクエストに登録すれば、すぐにクレジットを受け取ることができます。受講可能な全クエストについては、Google Cloud Skills Boost カタログをご覧ください。

次のステップと詳細情報

Google Cloud トレーニングと認定資格

Google Cloud トレーニングと認定資格を通して、Google Cloud 技術を最大限に活用できるようになります。必要な技術スキルとベスト プラクティスについて取り扱うクラスでは、学習を継続的に進めることができます。トレーニングは基礎レベルから上級レベルまであり、オンデマンド、ライブ、バーチャル参加など、多忙なスケジュールにも対応できるオプションが用意されています。認定資格を取得することで、Google Cloud テクノロジーに関するスキルと知識を証明できます。

マニュアルの最終更新日: 2023 年 10 月 18 日

ラボの最終テスト日: 2023 年 10 月 20 日

Copyright 2025 Google LLC All rights reserved. Google および Google のロゴは Google LLC の商標です。その他すべての企業名および商品名はそれぞれ各社の商標または登録商標です。

Before you begin

  1. Labs create a Google Cloud project and resources for a fixed time
  2. Labs have a time limit and no pause feature. If you end the lab, you'll have to restart from the beginning.
  3. On the top left of your screen, click Start lab to begin

このコンテンツは現在ご利用いただけません

利用可能になりましたら、メールでお知らせいたします

ありがとうございます。

利用可能になりましたら、メールでご連絡いたします

One lab at a time

Confirm to end all existing labs and start this one

Use private browsing to run the lab

Use an Incognito or private browser window to run this lab. This prevents any conflicts between your personal account and the Student account, which may cause extra charges incurred to your personal account.