このページでは、Service Management API と連携するように開発環境を設定する方法について説明します。Service Management API を使用する最も簡単な方法(Google Cloud Consoleウェブ UI を使用する以外の方法)で、ほとんどの運用上のユースケースで推奨される方法は、gcloud
コマンドライン インターフェースを使用することです。Service Management API に対してプログラミングする必要がある場合は、用意されているクライアント ライブラリの 1 つを使用することをおすすめします。API を試してみるには、以下の代替セットアップ手順に沿って curl
コマンドを使用します。これにより、完全なアプリケーション開発環境をセットアップしなくても API を試すことができます。
gcloud を使用したセットアップ
- 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.
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Service Management API を有効にします。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Service Management API を有効にします。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
API を直接呼び出すためのセットアップ
このセクションでは、curl
コマンドを使用して Service Management API を試すためのローカル環境を設定するために必要な基本的な手順について説明します。これは、Service Management API に対してプログラミングする必要のあるデベロッパーを対象としています。
初期設定
- 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.
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
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 プロジェクト名に置き換えます。
-
-
Service Management API を有効にします。
gcloud services enable servicemanagement.googleapis.com
-
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
は、個々のロールに置き換えます。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
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 プロジェクト名に置き換えます。
-
-
Service Management API を有効にします。
gcloud services enable servicemanagement.googleapis.com
-
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
は、個々のロールに置き換えます。
curl によるテスト
Google REST API の呼び出しに便利なシェル エイリアスを定義します。
$ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
一般公開されているサービスの一覧表示を試行します。
$ gcurl https://servicemanagement.googleapis.com/v1/services
サービスのリストが表示されれば設定は成功です。
次のステップ
Cloud Endpoints を使用しておらず、マネージド サービスを作成する場合は、次の手順を行います。
- サービスの作成と削除の手順に沿ってマネージド サービスを作成します。これにより、トップレベルのマネージド サービス リソースが作成されます。
サービス構成のロールアウトの手順に沿ってサービス構成をロールアウトします。