Manage Google Cloud plugins

Apigee/Apigee hybrid

To attach an Apigee or Apigee hybrid runtime project to API hub, ensure the following:

• Ensure that the data residency status (enabled or disabled) of the attached Apigee runtime project matches the data residency status of the Apigee organization associated with your API hub instance.
• Grant the Cloud API hub Runtime Project Attachment Editor ( roles/apihub.runTimeProjectAttachmentsEditor ) IAM role to your principal account.
• Ensure that the API proxy is deployed to an environment in the Apigee runtime project.
• Ensure that the OpenAPI specification is included as a resource in the API proxy.

API Gateway

To attach an API Gateway runtime project to API hub, ensure the following:

• Ensure that the APIs are active and deployed in the API Gateway runtime project.
• Grant the Cloud API hub Runtime Project Attachment Editor ( roles/apihub.runTimeProjectAttachmentsEditor ) IAM role to your principal account.
• Grant the Browser ( roles/browser ) role to your principal account.

Console

To attach an runtime project to API hub, do the following steps:

1. In the Google Cloud console, go to the API hub page.

   Go to API hub

2. Click settings Settings from the left navigation menu to open the Settings page.
3. Go to the Project associations tab and click Attach runtime project . This displays the Select a resource pane.
4. Click the Google Cloud project where your runtime is provisioned.
5. In the Project association settings pane, do the following:
   • To ingest Apigee or Apigee hybrid API data, select Apigee X and Hybrid .
   • To ingest Application Integration API data, select Application Integration .
   • To ingest API Gateway API data, select API Gateway .
   • To attach the runtime project to API hub without importing assets, clear all of the Assets to automatically import checkboxes.
6. Click Attach .

REST

To attach a runtime project to API hub, use the create method.

curl -X POST   
-H "Authorization: Bearer $(gcloud auth print-access-token)"   
-H "Content-Type: application/json"
  -d '{
    "runtime_project": " RUNTIME_PROJECT_ID 
"
  }'   "https://apihub.googleapis.com/v1/projects/ HUB_PROJECT_ID 
/locations/ LOCATION 
/runtimeProjectAttachments?runtime_project_attachment_id= RUNTIME_PROJECT_ID 
"

Replace the following:

• HUB_PROJECT_ID : The project ID of your API hub host project.
• LOCATION : The location of your API hub host project.
• RUNTIME_PROJECT_ID : The Google Cloud project name or ID that you want to attach to API hub.

Console

To edit the project association settings, do the following steps:

1. In the Google Cloud console, go to the API hub page.

   Go to API hub

2. Click settings Settings from the left navigation menu to open the Settings page.
3. Go to the Project associations tab to view the list of attached projects.
4. Click Edit settings for the desired project.
5. In the Project association settings pane, edit the API assets to automatically import checkbox selection.
6. Click Save to apply your changes.

Console

To detach a runtime project from API hub, do the following steps:

1. In the Google Cloud console, go to the API hub page.

   Go to API hub

2. Click settings Settings from the left navigation menu to open the Settings page.
3. Go to the Project associations tab to view the list of attached projects.
4. Click Detach project for the project you want to detach.

REST

To detach a runtime project from API hub, use the delete method.

curl -X DELETE   -H "Authorization: Bearer $(gcloud auth print-access-token)"
"https://apihub.googleapis.com/v1/projects/ HUB_PROJECT_ID 
/locations/ LOCATION 
/runtimeProjectAttachments/ RUNTIME_PROJECT_ID 
"

Replace the following:

• HUB_PROJECT_ID : The project ID of your API hub host project.
• LOCATION : The location of your API hub host project.
• RUNTIME_PROJECT_ID : The Google Cloud project name or ID that you want to detach from API hub.