Service Management API を使ってみる

このページでは、Service Management API と連携するように開発環境を設定する方法について説明します。Service Management API を使用する最も簡単な方法（Google Cloud Consoleウェブ UI を使用する以外の方法）で、ほとんどの運用上のユースケースで推奨される方法は、gcloud コマンドライン インターフェースを使用することです。Service Management API に対してプログラミングする必要がある場合は、用意されているクライアント ライブラリの 1 つを使用することをおすすめします。API を試してみるには、以下の代替セットアップ手順に沿って curl コマンドを使用します。これにより、完全なアプリケーション開発環境をセットアップしなくても API を試すことができます。

gcloud を使用したセットアップ

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  3. Service Management API を有効にします。

    API を有効にする

  4. Google Cloud CLI をインストールします。

  5. gcloud CLI を初期化するには:

    gcloud init
    6.

  6. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタに移動

  7. Service Management API を有効にします。

    API を有効にする

  8. Google Cloud CLI をインストールします。

  9. gcloud CLI を初期化するには:

    gcloud init
    10.

API を直接呼び出すためのセットアップ

このセクションでは、curl コマンドを使用して Service Management API を試すためのローカル環境を設定するために必要な基本的な手順について説明します。これは、Service Management API に対してプログラミングする必要のあるデベロッパーを対象としています。

初期設定

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Google Cloud CLI をインストールします。

  3. gcloud CLI を初期化するには:

    gcloud init

  4. Google Cloud プロジェクトを作成または選択します。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、実際の Google Cloud プロジェクト名に置き換えます。

  5. Service Management API を有効にします。 

    gcloud services enable servicemanagement.googleapis.com

  6. Google アカウントにロールを付与します。次の IAM ロールごとに次のコマンドを 1 回実行します。 roles/servicemanagement.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • PROJECT_ID は、実際のプロジェクト ID に置き換えます。
    • EMAIL_ADDRESS は実際のメールアドレスに置き換えます。
    • ROLE は、個々のロールに置き換えます。
    7.
  7. Google Cloud CLI をインストールします。

  8. gcloud CLI を初期化するには:

    gcloud init

  9. Google Cloud プロジェクトを作成または選択します。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、実際の Google Cloud プロジェクト名に置き換えます。

  10. Service Management API を有効にします。 

    gcloud services enable servicemanagement.googleapis.com

  11. Google アカウントにロールを付与します。次の IAM ロールごとに次のコマンドを 1 回実行します。 roles/servicemanagement.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • PROJECT_ID は、実際のプロジェクト ID に置き換えます。
    • EMAIL_ADDRESS は実際のメールアドレスに置き換えます。
    • ROLE は、個々のロールに置き換えます。
    12.

curl によるテスト

  1. Google REST API の呼び出しに便利なシェル エイリアスを定義します。

    $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

  2. 一般公開されているサービスの一覧表示を試行します。

    $ gcurl https://servicemanagement.googleapis.com/v1/services

    サービスのリストが表示されれば設定は成功です。

次のステップ

Cloud Endpoints を使用しておらず、マネージド サービスを作成する場合は、次の手順を行います。

  1. サービスの作成と削除の手順に沿ってマネージド サービスを作成します。これにより、トップレベルのマネージド サービス リソースが作成されます。

  2. サービス構成の管理の手順に沿って、サービスによって使用される機能を記述したサービス構成を送信します。

  3. サービス構成のロールアウトの手順に沿ってサービス構成をロールアウトします。