Apigee Space で API リソースを管理する

Apigee Edge のドキュメントを表示する。

このトピックでは、Space で API リソースを作成して管理する方法について説明します。API プロキシ、共有フロー、API プロダクトは Space で作成できます。Space で作成されたリソースは、Space と同じ権限を継承します。

Space にリソースを作成する方法は、Apigee 組織にリソースを作成する方法と同じです。ただし、リソースの作成時に Space を選択できます。限定公開一般提供 リリースでは、API リソースを、Apigee API を使用してコマンドラインから作成することも、Cloud コンソールの Apigee を使用して作成することもできます。

このガイドでは、次の手順について説明します。

Apigee Spaces の概要については、Apigee Space をご覧ください。

Apigee API リソースタイプの詳細については、以下をご覧ください。

始める前に

Apigee Space で API リソースの作成を開始する前に、次のタスクが完了していることを確認してください。

  • Apigee サブスクリプションまたは従量課金制の組織をプロビジョニングしている。Apigee のプロビジョニングに必要な手順の詳細については、Apigee を設定するをご覧ください。
  • Apigee 組織に Space を作成している。詳細については、Apigee Space を作成するをご覧ください。
  • Space にメンバーが割り当てられている。詳細については、Space のメンバーとロールを管理するをご覧ください。

必要なロールと権限

Apigee Spaces の導入により、IAM が API リソースに対する一部のオペレーションの実行に必要な権限を確認する方法が変更されました。API リソースが Space に存在する場合、IAM は、Space レベルで、オペレーションを実行する Space メンバーに対して適切な権限があるかどうかを確認します。API リソースが Space にある場合におけるこうしたオペレーションに必要な権限は次のとおりです。

オペレーション 権限が必要 範囲
API プロキシをデプロイする
apigee.deployments.create
AND
apigee.proxyrevisions.deploy
環境
 
API プロキシ
API プロキシのすべてのデプロイを一覧表示する apigee.proxies.get API プロキシ
API プロキシ リビジョンのすべてのデプロイを一覧表示する apigee.proxyrevisions.get API プロキシ リビジョン
環境内の API プロキシのすべてのデプロイを一覧表示する
apigee.deployments.list
または
apigee.proxies.get
環境
 
API プロキシ
API プロキシ リビジョンのデプロイを取得する
apigee.deployments.get
または
apigee.proxyrevisions.get
API プロキシ リビジョン
 
環境
API プロキシ リビジョンを削除する apigee.deployments.delete API プロキシ リビジョンと環境
共有フローをデプロイする
apigee.deployments.create
AND
apigee.sharedflows.deploy
環境
 
共有フロー
共有フローのすべてのデプロイを一覧表示する apigee.sharedflows.get 共有フロー
共有フロー リビジョンのすべてのデプロイを一覧表示する apigee.sharedflowrevisions.get 共有フロー リビジョン
環境内の共有フローのすべてのデプロイを一覧表示する
apigee.deployments.list
または
apigee.sharedflows.get
環境
 
共有フロー
共有フロー リビジョンのデプロイを取得する
apigee.deployments.get
または
apigee.sharedflowrevisions.get
API プロキシ リビジョン
 
共有フロー
共有フローを削除する apigee.deployments.delete 共有フローおよび環境
API プロキシ リビジョンのデバッグ セッションを作成する apigee.tracesessions.create API プロキシ リビジョンと環境
デバッグ セッションを取得する apigee.tracesessions.get API プロキシと環境
デバッグ セッションからデータを削除する apigee.tracesessions.delete API プロキシと環境
API プロキシ リビジョンのアクティブなデバッグ セッションを一覧表示する apigee.tracesessions.list 環境または API プロキシ リビジョン
トランザクションからデバッグデータを取得する apigee.tracesessions.get 環境と API プロキシ リビジョン
デバッグ セッションのトランザクション ID を一覧表示する apigee.tracesessions.get 環境と API プロキシ リビジョン

Space のメンバーにロールと権限を割り当てる

説明したさまざまな権限は、apigee.apiAdminV2 ロールまたは apigee.environmentAdmin ロールのいずれかに含まれています。詳細については、Apigee のロールをご覧ください。

これらのロールとその権限を Space メンバーに割り当てるには、次のいずれかを行います。

  • API を使用して Space に roles/apiAdminV2 ロールを追加し、API を使用してターゲット環境に roles/environmentAdmin ロールを追加します。
  • IAM ユーザー インターフェースを使用して、ロールをプロジェクトに追加します。

ロールを確認する

  1. Google Cloud コンソールの [IAM] ページに移動します。

    IAM に移動
  2. プロジェクトを選択します。
  3. [プリンシパル] 列で、自分または自分が所属するグループの行をすべて確認します。所属するグループについては、管理者にお問い合わせください。

  4. 自分のメールアドレスを含む行の [ロール] 列で、ロールのリストに必要なロールが含まれているかどうか確認します。

ロールを付与する

  1. Google Cloud コンソールの [IAM] ページに移動します。

    IAM に移動
  2. プロジェクトを選択します。
  3. [アクセスを許可] をクリックします。
  4. [新しいプリンシパル] フィールドに、ユーザー ID を入力します。 これは通常、Google アカウントのメールアドレスです。

  5. [ロールを選択] リストでロールを選択します。
  6. 追加のロールを付与するには、[ 別のロールを追加] をクリックしてロールを追加します。
  7. [保存] をクリックします。

Google Cloud コンソールで API リソースにアクセスするために必要なロール

Space チームのメンバーとして Cloud コンソールの Apigee UI にアクセスするには、ApigeeSpaceUser ロールが付与されている必要があります。詳細については、権限とロールをご覧ください。

Space で API プロキシを管理する

Space に割り当てられた Apigee 組織のメンバーは、API プロキシを Space のリソースとして作成、デプロイ、デプロイ解除できます。他の Space にのみ割り当てられているメンバーは、これらのプロキシにアクセスしたり、管理することはできません。

Space のリソースとして API プロキシを作成する

API プロキシは、以降のセクションで説明するように、Cloud コンソールの Apigee または API を使用して、Space のリソースとして作成します。

Cloud コンソールの Apigee

Cloud コンソールの Apigee を使用して、Space のリソースとして API プロキシを作成するには:

  1. API プロキシを作成するの手順に沿って操作します。
  2. ステップ 5 では、[Proxy details] の下に追加のフィールドが表示されます。ここでは、API プロキシの Space を選択できます。リストボックスから Space を選択します。API プロキシをスペースに割り当てない場合は、このフィールドをスキップできます。
  3. [次へ] をクリックして、プロキシの作成のオプションのデプロイ手順に進むか、[作成] をクリックして、デプロイせずにプロキシを作成します。

Apigee API

Apigee API を使用して API プロキシを Space のリソースとして作成するには、次のコマンドを使用します。

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/apis?name=PROXY_NAME&space=SPACE_NAME&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data" \
    -F "file=@PROXY_BUNDLE"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • PROXY_NAME は、作成する API プロキシの名前です。名前は、Space 内だけでなく、グローバルに一意である必要があります。
  • SPACE_NAME は、API プロキシを作成する Space の名前です。
  • PROXY_BUNDLE は API プロキシ バンドル ファイルの名前です。

たとえば、red チームのメンバーが proxy-bundle.zip ファイルを使用して、acme 組織の red Space のリソースとして proxy-1 という名前の API プロキシを作成する場合は、次のコマンドを実行します。

curl "https://apigee.googleapis.com/v1/organizations/acme/apis?name=proxy-1&space=red&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data \
    -F "file=@proxy-bundle.zip"

次の例では、このコマンドに対するレスポンスを示します。

{
  "basepaths": ["/proxy-1"],
  "revision": 1,
  "apiProxyId": "proxy-1",
  "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
  "space": "red",
  "createTime": ...,
  "updateTime": ...
}

API プロキシを Space のリソースとしてデプロイする

以降のセクションで説明するように、API プロキシは、Cloud コンソールの Apigee または API を使用して、Space のリソースとしてデプロイします。

Cloud コンソールの Apigee

Cloud コンソールの Apigee を使用して API プロキシを Space のリソースとしてデプロイするには、API プロキシのデプロイで説明されている手順に沿って操作します。追加の手順やフィールドは必要ありません。

Apigee API

Apigee API を使用して API プロキシを Space のリソースとしてデプロイするには、次のコマンドを使用します。

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/apis/PROXY_NAME/revisions/REVISION_NUMBER/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • ENV_NAME は、API プロキシをデプロイする環境の名前です。
  • PROXY_NAME は、デプロイする API プロキシの名前です。
  • REVISION_NUMBER は、デプロイする API プロキシのリビジョン番号です。

たとえば、red チームのメンバーが acme 組織の API プロキシ proxy-1、リビジョン 1 を prod 環境にデプロイする場合は、次のコマンドを実行します。

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/apis/proxy-1/revisions/1/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

次の例では、このコマンドに対するレスポンスを示します。

      {
        "environment": "prod",
        "revision": "1",
        "apiProxy": "proxy-1",
        ...
      }
      

Space に関連付けられた API プロキシのデプロイを解除する

Space に関連付けられている API プロキシのデプロイは、以降のセクションで説明するように、Cloud コンソールの Apigee または API を使用して解除します。

Cloud コンソールの Apigee

Cloud コンソールの Apigee を使用して Space に関連付けられた API プロキシのデプロイを解除するには、API プロキシのデプロイ解除の手順に沿って操作します。追加の手順やフィールドは必要ありません。

Apigee API

Apigee API を使用して Space に関連付けられた API プロキシのデプロイを解除するには、次のコマンドを使用します。

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/apis/PROXY_NAME/revisions/REVISION_NUMBER/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • ENV_NAME は、API プロキシのデプロイを解除する環境の名前です。
  • PROXY_NAME は、デプロイ解除する API プロキシの名前です。
  • REVISION_NUMBER は、デプロイ解除する API プロキシのリビジョン番号です。

たとえば、red チームのメンバーが acme 組織の API プロキシ proxy-1 リビジョン 1 を prod 環境からデプロイ解除する場合は、次のコマンドを実行します。

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/apis/proxy-1/revisions/1/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

共有フローを Space のリソースとして管理する

Space に割り当てられたメンバーは、Space のリソースとして共有フローの作成、デプロイ、デプロイ解除することもできます。他の Space のメンバーは、これらの共有フローにアクセスできず、管理することもできません。

Space のリソースとして共有フローを作成する

以降のセクションで説明するように、Apigee in Cloud コンソールまたは API を使用して、共有フローを Space のリソースとして作成します。

Cloud コンソールの Apigee

Cloud コンソールの Apigee を使用し、共有フローを Space のリソースとして作成するには:
  1. 共有フローは、Apigee UI で共有フローを作成するの手順に沿ってゼロから新規に作成するか、既存のフローバンドルをアップロードします。
  2. ステップ 4 では、[Create a shared flow] ダイアログに追加のフィールドが表示され、API プロキシの Space を選択できます。リストボックスから Space を選択します。API プロキシをスペースに割り当てない場合は、このフィールドをスキップできます。
  3. [作成] をクリックして共有フローを作成します。

Apigee API

Apigee API を使用して共有フローを Space リソースとして作成するには、次のコマンドを使用します。

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/sharedflows?name=FLOW_NAME&space=SPACE_NAME&action=import" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: multipart/form-data" \
          -F "file=@SHARED_FLOW_BUNDLE"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • FLOW_NAME は、作成する共有フローの名前です。名前は、Space 内だけでなく、グローバルに一意である必要があります。
  • SPACE_NAME は、共有フローを作成する Space の名前です。
  • SHARED_FLOW_BUNDLE は、共有フロー バンドル ファイルの名前です。

たとえば、red チームのメンバーが acme 組織の red Space に関連付けられた flow-1 という名前の共有フローを作成する場合は、次のコマンドを実行します。

curl "https://apigee.googleapis.com/v1/organizations/acme/sharedflows?name=flow-1&space=red&action=import" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: multipart/form-data" \
          -F "file=@sharedflow-bundle.zip"

次の例では、このコマンドに対するレスポンスを示します。

      {
        "name": "organizations/acme/sharedflows/flow-1",
        "revision": 1,
        "sharedFlowId": "flow-1",
        "space": "red",
        "createTime": ...,
        "updateTime": ...
      }
      

共有フローを Space のリソースとしてデプロイする

共有フローは、以降のセクションで説明するように、Apigee in Cloud コンソールまたは API を使用して Space のリソースとしてデプロイします。

Cloud コンソールの Apigee

Cloud コンソールの Apigee を使用し、共有フローを Space のリソースとしてデプロイするには:

  1. Cloud コンソールの Apigee UI にログインします。
  2. 共有フローがある組織を選択します。組織の切り替えをご覧ください。
  3. 左側のナビゲーション バーで [プロキシ開発] > [共有フロー] を選択します。
  4. [共有フロー] の概要ページで、デプロイする共有フローの名前をクリックします。共有フローの詳細ページが表示されます。
  5. [デプロイ] をクリックして、デプロイ ダイアログを開きます。
  6. 次の情報を入力します。
    • リビジョン: デプロイする共有フローのリビジョン番号。
    • 環境: 共有フローをデプロイする環境。
    • サービス アカウント(省略可): 共有フロー用のサービス アカウント
  7. [デプロイ] をクリックします。

Apigee API

Apigee API を使用して共有フローを Space のリソースとしてデプロイするには、次のコマンドを使用します。

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/sharedflows/FLOW_NAME/revisions/REVISION_NUMBER/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • ENV_NAME は、共有フローをデプロイする環境の名前です。
  • FLOW_NAME は、デプロイする共有フローの名前です。
  • REVISION_NUMBER は、デプロイする共有フローのリビジョン番号です。

たとえば、red チームのメンバーが、acme 組織の共有フロー flow-1、リビジョン番号 1prod 環境にデプロイする場合は、次のコマンドを実行します。

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/sharedflows/flow-1/revisions/1/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

次の例では、このコマンドに対するレスポンスを示します。

      {
        "environment": "prod",
        "revision": "1",
        "sharedFlow": "flow-1",
        ...
      }
      

Space に関連付けられた共有フローのデプロイを解除する

Space に関連付けられている共有フローのデプロイは、以降のセクションで説明するように、Apigee in Cloud コンソールまたは API を使用して解除します。

Cloud コンソールの Apigee

Cloud コンソールの Apigee で Space に関連付けられた共有フローをデプロイ解除するには:

  1. Cloud コンソールの Apigee UI にログインします。
  2. 共有フローがある組織を選択します。組織の切り替えをご覧ください。
  3. 左側のナビゲーション バーで [プロキシ開発] > [共有フロー] を選択します。
  4. [共有フロー] の概要ページで、デプロイ解除する共有フローの名前をクリックします。共有フローの詳細ページが表示されます。
  5. [デプロイ] で [デプロイ解除] をクリックします。

Apigee API

Apigee API を使用して Space に関連付けられた共有フローをデプロイ解除するには、次のコマンドを使用します。

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/sharedflows/FLOW_NAME/revisions/REVISION_NUMBER/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • ENV_NAME は、共有フローをデプロイ解除する環境の名前です。
  • FLOW_NAME は、デプロイ解除する共有フローの名前です。
  • REVISION_NUMBER は、デプロイ解除する共有フローのリビジョン番号です。

API プロダクトを Space のリソースとして管理する

Space に割り当てられたメンバーは、API プロキシをバンドルする API プロダクトを作成できます。API プロダクトを作成するときに、Space のメンバーは、組織の直下に作成されたプロキシや、メンバーシップを持つ Space でリソースとして作成された API プロキシなど、アクセス可能な API プロキシを選択できます。他の Space のメンバーは、これらの API プロダクトにアクセスしたり、管理することはできません。

API プロダクトは、以降のセクションで説明するように、Cloud コンソールの Apigee または API を使用して、Space のリソースとして作成します。

Cloud コンソールの Apigee

Cloud コンソールの Apigee を使用して、Space のリソースとして API プロダクトを作成するには:

  1. API プロダクトを作成するの手順に沿って操作します。
  2. ステップ 4 では、[プロダクトの詳細] ページに追加のフィールドが表示されます。このフィールドで、API プロダクトの Space を選択できます。リストボックスから Space を選択します。API プロダクトをスペースに割り当てない場合、このフィールドはスキップできます。
  3. 残りの構成情報を入力し、[保存] をクリックします。

Apigee API

API プロダクトを Space のリソースとして作成するには、次のコマンドを使用します。

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/apiproducts" \
            -X POST -H "Authorization: Bearer $TOKEN" \
            -H "Content-type: application/json" \
            -d  \
              `{
                "name": "PRODUCT_NAME",
                "displayName": "DISPLAY_NAME",
                "description": "PRODUCT_DESCRIPTION",
                "approvalType": "auto",
                "apiResources": [
                  {
                    "apiproduct": "PRODUCT_NAME",
                    "apiResource": "PROXY_NAME",
                    "operations": [
                      {
                        "method": "GET",
                        "path": "/"
                      }
                    ]
                  }
                ],
                "space": "SPACE_NAME"
              }`

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • PRODUCT_NAME は、作成する API プロダクトの名前です。名前は、Space 内だけでなく、グローバルに一意である必要があります。
  • DISPLAY_NAME は、作成する API プロダクトの名前(UI に表示される名前)です。
  • PRODUCT_DESCRIPTION は、作成する API プロダクトの説明です。
  • SPACE_NAME は、API プロダクトを作成する Space の名前です。
  • PROXY_NAME は、API プロダクトに追加する API プロキシの名前です。

たとえば、red チームのメンバーが acme 組織の red Space に関連付けられた product-1 という名前の API プロダクトを作成する場合は、次のコマンドを実行します。

curl "https://apigee.googleapis.com/v1/organizations/acme/apiproducts?name=product-1&space=red&action=import" \
            -X POST -H "Authorization: Bearer $TOKEN" \
            -X "Content-type: application/json" \
            -d  \
              `{
                "name": "product-1",
                "displayName": "product-1",
                "description": "Product 1",
                "apiResources": [
                  {
                    "apiproduct": "product-1",
                    "apiResource": "proxy-1",
                    "operations": [
                      {
                        "method": "GET",
                        "path": "/"
                      }
                    ]
                  }
                ],
                "space": "red"
              }`

次の例では、このコマンドに対するレスポンスを示します。

        {
          "name": "organizations/acme/apiproducts/product-1",
          "displayName": "product-1",
          "description": "Product 1",
          "apiResources": [
            {
              "apiproduct": "product-1",
              "apiResource": "proxy-1",
              "operations": [
                {
                  "method": "GET",
                  "path": "/"
                }
              ]
            }
          ],
          "space": "red",
          "createTime": ...,
          "updateTime": ...
        }

Space に関連付けられているすべての API リソースを一覧表示する

ListApiProxiesListSharedFlowsListApiProducts などのすべてのリスト オペレーションで、Space 名を指定すると、その Space に関連付けられたすべてのリソースを一覧表示できます。Space 名を指定しない場合、リスト オペレーションは、Space に関連付けられているかどうかにかかわらず、アクセス権を持つ組織内のすべてのリソースを返します。

このタスクを実行するには、apigee.apiResources.list 権限が必要です。この権限は、Apigee > Apigee Organization Admin のロールに含まれています。

特定の Space に関連付けられた API リソースを一覧表示する

特定の Space に関連付けられているすべての API リソースを一覧表示するには、Google Cloud コンソールの Apigee または API を使用します。詳細については、以降のセクションをご覧ください。

Cloud コンソールの Apigee

Cloud コンソールの Apigee で特定の Space に関連付けられているすべての API リソースを一覧表示するには、関連するリソースタイプ(API プロキシ、共有フロー、API プロダクト)の概要ページを開きます。[フィルタ] ボックスで、リストから [Space] オプションを選択し、Space の名前を入力します。そのスペースに割り当てられたリソースのリストが表示されます。ユーザーがメンバーであるスペースに関連付けられているリソースのみが表示されます。

Apigee API

指定した Space に関連付けられているすべての API リソースを一覧表示するには、次のコマンドを使用します。

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE?space=SPACE_NAME"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • RESOURCE_TYPE は、一覧表示するリソースの種類です。有効な値は次のとおりです。
    • apis
    • sharedFlows
    • apiProducts
  • SPACE_NAME は、リソースを一覧表示する Space の名前です。

たとえば、red チームのメンバーが acme 組織の red Space に関連付けられたすべての API プロキシを一覧表示する場合は、次のコマンドを実行します。

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis?space=red"

次の例では、このコマンドに対するレスポンスを示します。

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          }
        ]
      }

Space を指定せずに API リソースを一覧表示する

すべての API リソースは、以降のセクションで説明するように、Google Cloud コンソールの Apigee または API を使用して Space を指定せずに一覧表示します。

Cloud コンソールの Apigee

Cloud コンソールの Apigee で、Space の関連付けに関係なく、特定のタイプのすべての API リソースのリストを表示するには、関連するリソースタイプ(API プロキシ、共有フロー、API プロダクト)の概要ページを開きます。使用可能なすべてのリソースのリストが表示されます。なお、表示されリソースは、ユーザーに表示権限があるものに限られます。これには、ユーザーがメンバーである Space に関連付けられたリソースや、Space に関連付けられていないリソースが含まれます。

Apigee API

API リソースは、次のコマンドを使用して、Space を指定せずに一覧表示することもできます。

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE"

ここで

  • ORG_NAME は実際の Apigee 組織の名前です。
  • RESOURCE_TYPE は、一覧表示するリソースの種類です。有効な値は次のとおりです。
    • apis
    • sharedFlows
    • apiProducts

たとえば、組織内のすべてのリソースに対する Organization Admin 権限をユーザーは、次のコマンドを使用して acme 組織内のすべての API プロキシを一覧表示できます。

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis"

acme 組織に 3 つのプロキシがある場合、このコマンドは 3 つのプロキシに関する詳細情報をすべて返します。次に例を示します。

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          },
          {
            "basepaths": "/proxy-2",
            "revision": "1",
            "apiProxyId": "proxy-2",
            "resourceName": "organizations/acme/apis/proxy-2/revisions/1",
            "space": "blue",
            "createTime": ...,
            ....
          },
          {
            "basepaths": "/proxy-3",
            "revision": "1",
            "apiProxyId": "proxy-3",
            "resourceName": "organizations/acme/apis/proxy-3/revisions/1",
            "space": "green",
            "createTime": ...,
            ....
          }
        ]
      }

Space red 内のリソースへの apiAdmin 権限のみを持つ別のユーザーが同じコマンドを使用すると、コマンドは proxy-1 の詳細のみを返します。レスポンスは次のようになります。

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          }
        ]
      }

次のステップ