Google Cloud アカウントとプロジェクトを作成し、API を有効にしました。これで、組織を作成できる状態になりました。
前提条件
組織を作成するには、次のいずれかの条件を満たしている必要があります。
- 評価アカウントを持っている。評価アカウントは 60 日後に有効期限が切れます。期限を迎えた時点で削除されます。
- 有料アカウントを保有している
どちらにも該当しない場合は、続行する前に Apigee の販売担当者にお問い合わせください。
新しい組織を作成してプロビジョニングするには:
-
次の例のように、コマンドラインで
gcloud
認証情報を取得します。TOKEN=$(gcloud auth print-access-token)
トークンにデータが入力されていることを確認するには、次の例のように
echo
を使用します。echo $TOKEN
エンコードされた文字列としてトークンが表示されるはずです。
詳細については、gcloud コマンドライン ツールの概要をご覧ください。
- 認証された
POST
リクエストを Create Organizations API に送信します。次の例は、組織を作成するリクエストの構造を示しています。
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "name":"proposed_org_ID", "displayName":"display_name", "description":"organization_description", "runtimeType":"runtime_type", "analyticsRegion":"analytics_region" }' \ "https://apigee.googleapis.com/v1/organizations?parent=projects/project_ID"
ここで
- (必須)proposed_org_ID は、ハイブリッド対応組織に必要なプログラマティック ID です。例:
my-hybrid-org
。ステップ 2: Google Cloud プロジェクトを作成するで作成した Google Cloud プロジェクト ID と同じ ID を使用することをおすすめします。ただし、別の ID を使用することもできます。
- (必須)runtime_typeは、Apigee 組織のランタイム タイプです。ここで、HYBRID はユーザーが管理する Apigee ハイブリッド ランタイムです。
- (必須)analytics_region は、分析データ ストレージのプライマリ リージョンです。次のいずれかを選択します。
asia-northeast1
australia-southeast1
us-west1
us-central1
us-east1
europe-west1
europe-west2
このオプションを使用すると、地理的に近いリージョンを選択できます。また、組織に別のストレージ要件がある場合にも、このオプションを使用できます。
- (必須)project_ID は、新しいハイブリッド対応組織にバインドする Google Cloud プロジェクトです。これは、ステップ 2: Google Cloud プロジェクトを作成するで生成された ID です。
- (省略可)display_name は、ユーザーにわかりやすい組織の名前です。この値は一意である必要はなく、スペースと特殊文字の使用が可能です。たとえば、「My Hybrid Organization」とします。
- (省略可)organization_description は、目的のリマインダーとして使用する組織に関する情報です。たとえば、「My first organization」とします。
作成リクエストが成功すると、Organizations API から次のようなメッセージが返されます。
{ "name": "organizations/organization_ID/operations/long_running_operation_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "INSERT", "targetResourceName": "organizations/organization_ID", "state": "IN_PROGRESS" } }
各要素の意味は次のとおりです。
- long_running_operation_ID は、非同期の長時間実行オペレーションの UUID です。この ID を使用して、組織作成リクエストのステータスを確認できます(後に説明)。
- organization_ID は、現在作成している新しい組織の ID です。
レスポンスの
state
プロパティが示すように、Apigee は新しい組織の作成を開始したので、状態がIN_PROGRESS
になっています。この処理には数分かかることがあります。エラーが発生した場合は、組織作成のトラブルシューティングをご覧ください。
- (必須)proposed_org_ID は、ハイブリッド対応組織に必要なプログラマティック ID です。例:
- 最初の作成リクエストで Apigee によって返された ID の長時間実行オペレーションのステータスを確認できます。この操作を行うには、次の例のように Operations API を使用します。
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/organization_ID/operations/long_running_operation_ID"
次の例は、このリクエストに対して考えられるレスポンスを示しています。
FINISHED
組織がプロビジョニングされている場合、次の例のように、長時間実行オペレーションの状態は
FINISHED
になります。{ "operations": [ { "name": "organizations/organization_ID/operations/long_running_operation_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "INSERT", "targetResourceName": "organizations/organization_ID", "state": "FINISHED" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.apigee.v1.Organization", "name": "organization_ID", "createdAt": "1572550611", "lastModifiedAt": "1572550611", "displayName": "display_name" "description": "description" "properties": { "property": [ { "name": "features.hybrid.enabled", "value": "true" } ] }, "analyticsRegion": "us-east1" "runtimeType": "HYBRID", } } ] }
説明を入力しなかった場合、このフィールドはレスポンスに表示されません。
これで完了です。新しい組織が作成され、使用できるようになりました。ステップ 5: 環境を追加するに進みます。
IN_PROGRESS
Apigee がまだ組織を作成している場合、次の例のように、Apigee は
IN_PROGRESS
のステータスを返します。{ "name": "organizations/organization_ID/operations/long_running_operation_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata", "operationType": "INSERT", "targetResourceName": "organizations/organization_ID", "state": "IN_PROGRESS" } }
少し待ってから、作成プロセスが完了しているかどうか確認します。
組織作成のトラブルシューティング
Create Organizations API で組織を作成するときに、エラー レスポンスが返されることがあります。レスポンスは、次のような形式です。
{ "error": { "code": HTTP_error_code, "message": "short_error_message", "status": "high_level_error_type", "details": [ { "@type": "specific_error_type", "detail": "expanded_error_description" } ] } }
次の例は、組織 ID に無効な文字が含まれている場合に返される一般的なエラー レスポンスを示しています(組織 ID には大文字を使用できません)。
{ "error": { "code": 400, "message": "invalid Organization ID \"MY-ORG\": \"MY-ORG\" is an invalid Organization ID", "status": "INVALID_ARGUMENT", "details": [ { "@type": "type.googleapis.com/google.rpc.DebugInfo", "detail": "[ORIGINAL ERROR] generic::invalid_argument: invalid Organization ID \"MY-ORG\": \"My-ORG\" is an invalid Organization ID [google.rpc.error_details_ext] { message: \"invalid Organization ID \\\"MY-ORG\\\": \\\"MY-ORG\\\" is an invalid Organization ID\" }" } ] } }
この場合、組織の名前を小文字に変更してリクエストを再送信できます。
次の表に、新しい組織の作成時に表示される可能性のあるエラーとその解決方法を示します。
HTTP エラーコード | HTTP エラー | 説明 |
---|---|---|
400 |
Invalid JSON payload received |
リクエスト内のデータ構造に構文エラーがあります。あるいは、エンドポイントのパスが正しくありません。 |
400 |
Invalid organization ID |
リクエストする組織 ID に大文字は使用できません。また、ハイフン以外の特殊文字も使用できません。小文字、数字、ハイフンのみで構成される必要があります。長さは 32 文字以下にする必要があります。 |
400 |
Unsupported analytics region |
リクエストの本文で analyticsRegion の値が指定されていないか、指定された値が有効なオプションではありません。 |
400 |
Does not have an Apigee entitlement |
ステップ 2: Google Cloud プロジェクトの作成で作成した Google Cloud プロジェクトが、まだハイブリッド対応になっていません。請求に関する問題や、Google Cloud アカウントに関連するその他のエラーが発生している可能性があります。詳しくは、Apigee 販売担当者までお問い合わせください。 |
401 |
Request had invalid authentication credentials |
gcloud 認証トークンが無効か、古くなっています。あるいは、リクエストに含まれていません。新しいトークンを生成し、アドレスを再送信します。 |
403 |
Permission denied on resource project project_ID |
無効なプロジェクト ID またはパスが含まれるリクエストが送信された可能性があります。 |
403 |
Unable to retrieve project information |
組織が作成されていないか、プロビジョニングされていません。Operations API にリクエストを送信すると、長時間実行オペレーションのステータスを確認できます。 |
409 |
Organization already exists |
Google Cloud プロジェクトに複数の組織を作成しようとしました。1 つのプロジェクトに作成できる組織は 1 つのみです。 |
409 |
Org proposed_organization_ID already exists |
既存の ID と同じ ID で組織を作成しようとしました。組織 ID はすべてのハイブリッド ユーザーの間で一意にする必要があります。提案された新しい組織 ID で再送信します。たとえば、前に試した ID の末尾に数値を追加します。 |
組織情報を取得する
アカウントでアクセスできるすべての組織のリストを取得することも、特定の組織に関する詳細を ID で取得することもできます。これらのアクションを行うには、Organizations API を使用します。
組織を一覧表示する
すべての組織のリストを取得するには:
GET
リクエスト(本文なし)を次の List organizations API エンドポイントに送信します。
https://apigee.googleapis.com/v1/organizations
次に例を示します。
curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations"
リクエストのレスポンスでは、アクセス可能なハイブリッド対応組織の配列が JSON 形式で返されます。
次の例は、「my-org-42」という組織を含むレスポンスです。
{ "organizations": [ { "organization": "my-org-42", "projectIds": [ "my-project" ] } ] }
詳細を取得する
1 つの組織に関する詳細情報を取得するには:
GET
リクエスト(本文なし)を次の Get Organizations API エンドポイントに送信します。
https://apigee.googleapis.com/v1/organizations/organization_ID
次の例では、「my-org-42」という組織に関する詳細を取得します。
curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/my-org-42"
リクエストのレスポンスでは、指定した組織に関する詳細情報が JSON 形式で返されます。
次の例は、「my-org-42」という組織に関する詳細を含むレスポンスを示しています。
{ "name": "my-org-42", "createdAt": "1572550611", "lastModifiedAt": "1572550611", "environments": [ "my-environment" ], "analyticsRegion": "us-east1" }