Console

To add a new API operation to an API version, do the following:

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

   Go to API hub
2. ClickAPIs.
3. Locate the API you wish to add an operation to. UseFilter to specify keywords to filter the list of APIs. If needed, useSearch to locate an API.
4. Click the API to view its details.
5. Click theVersions tab and select the version you wish to add from theSelect a version drop-down list.
6. Go to theOperations section, clickAdd operation.
7. Specify operation details in theAdd operation form.
   • Operation ID: ClickSpecify Unique ID to optionally provide a unique ID for the operation. If you omit the ID, API hub creates one for you.Note: The ID must be 4-500 characters long and can contain only uppercase letters (A-Z), lowercase letters (a-z), numbers (0-9), and hyphens (-). The ID forms the last part of the API resource name:projects/PROJECT/locations/LOCATION/apis/API_ID/versions/VERSION_ID/operations/OPERATION_ID. The full resource name is limited to 700 characters.
   • Documentation: Enter the URL to documentation for the API operation.
   • Description: Add a description of the operation.
   • Operation type: This field is automatically set asHTTP.
   • Deprecated: Select if the operation is deprecated.
   • Path: Enter the path of the operation.
   • Path description: Enter the description of the path of the operation.
   • Method: Enter the method of the operation.
   • Additional attributes: Add user-defined attributes based on your organizational or team needs. SeeUser attributes.
8. ClickCreate.

REST

To add a new API operation using theCreate operations API, use the following command:

  curl --location --request POST   'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID/versions/VERSION_ID/operations?api_operation_id=OPERATION_ID' \--header 'Authorization: Bearer $(gcloud auth print-access-token)' \--header 'Content-Type: application/json' \--data '{    "details":{         "description":"DESCRIPTION",         "deprecated":false,        "documentation":{                "external_uri":"EXTERNAL_URI"            },        "http_operation":{            "method":"METHOD",            "path":{                "path":"PATH",                "description":"DESCRIPTION"            }        }    }}'

Replace the following:

• HUB_PROJECT: The project ID of the API hub project.
• HUB_LOCATION: The location of the API hub project.
• API_ID: The ID of the API.
• VERSION_ID: The ID of the API version.
• OPERATION_ID: The ID of the API operation.
• DESCRIPTION: The description of the API operation.
• EXTERNAL_URI: The external URI of the API operation.
• METHOD: The method of the API operation.
• PATH: The path of the API operation.

Example:

  curl --location --request POST   'https://apihub.googleapis.com/v1/projects/test-project/locations/us-central1/apis/test-api/versions/version-id/operations?api_operation_id=test-operation' \  --header 'Authorization: Bearer $(gcloud auth print-access-token)' \  --header 'Content-Type: application/json' \  --data '{      "details":{           "description":"api to create root level entity api in apihub",           "deprecated":false,          "documentation":{                  "external_uri":"https://google.com"              },          "http_operation":{              "method":"POST",              "path":{                  "path":"/apis",                  "description":"It is ccfe managed resource"              }          }      }  }'

Console

To edit an API operation, do the following:

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

   Go to API hub
2. ClickAPIs.
3. Locate the API with the version that contains the operation you wish to edit. UseFilter to specify keywords to filter the list of APIs. If needed, useSearch to locate an API.
4. Click the API to view its details.
5. Click theVersions tab and select the version that contains the operation you wish to edit.
6. Go to theOperations section and locate the operation you wish to edit.
7. SelectEdit from theActions menu in the row of the operation you wish to edit.
8. In theEdit operation form, make the required changes to the operation details.
9. ClickSave.

REST

To edit or update an API operation using thePatch operations API, use the following command:

  curl --location --request PATCH 'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID/versions/VERSION_ID/operations/OPERATION_ID?update_mask=UPDATE_MASK' \  --header 'Authorization: Bearer $(gcloud auth print-access-token)' \  --data '{      "details":{           "description":"DESCRIPTION",           "deprecated":false,          "documentation":{                  "external_uri":"EXTERNAL_URI"              },          "http_operation":{              "method":"METHOD",              "path":{                  "path":"PATH",                  "description":"DESCRIPTION"              }          }      }  }'

Replace the following:

• HUB_PROJECT: The project ID of the API hub project.
• HUB_LOCATION: The location of the API hub project.
• API_ID: The ID of the API.
• VERSION_ID: The ID of the API version.
• OPERATION_ID: The ID of the API operation.
• UPDATE_MASK: The update mask of the API operation.
• DESCRIPTION: The description of the API operation.
• EXTERNAL_URI: The external URI of the API operation.
• PATH: The path of the API operation.

Example:

  curl --location --request PATCH   'https://apihub.googleapis.com/v1/projects/test-project/locations/us-central1/apis/test-api/versions/version-id/operations/test-operation?update_mask=details.http_operation.path' \--header 'Authorization: Bearer $(gcloud auth print-access-token)' \--data '{    "details":{         "description":"api to create root level entity api in apihub update",         "deprecated":false,        "documentation":{                "external_uri":"https://google.com"            },        "http_operation":{            "method":"POST",            "path":{                "path":"/apiss",                "description":"It is ccfe managed api"            }        }    }}'

Console

To delete an API operation, do the following:

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

   Go to API hub
2. ClickAPIs.
3. Locate the API with the version that contains the operation you wish to delete. UseFilter to specify keywords to filter the list of APIs. If needed, useSearch to locate an API.
4. Click the API to view its details.
5. Click theVersions tab and select the version that contains the operation you wish to delete.
6. Go to theOperations section and locate the operation you wish to delete.
7. SelectDelete from theActions menu in the row of the operation you wish to delete.
8. ClickDelete in the confirmation dialog.

REST

To delete an API operation using theDelete operations API, use the following command:

  curl --location --request DELETE 'https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID/versions/VERSION_ID/operations/OPERATION_ID' \  --header 'Authorization: Bearer $(gcloud auth print-access-token)'

Replace the following:

• HUB_PROJECT: The project ID of the API hub project.
• HUB_LOCATION: The location of the API hub project.
• API_ID: The ID of the API.
• VERSION_ID: The ID of the API version.
• OPERATION_ID: The ID of the API operation.

Example:

  curl --location --request DELETE 'https://apihub.googleapis.com/v1/projects/test-project/locations/us-central1/apis/test-api/versions/version-id/operations/test-operation' \  --header 'Authorization: Bearer $(gcloud auth print-access-token)'

Console

To view the API operations of an API version, do the following:

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

   Go to API hub
2. ClickAPIs.
3. Locate the API you wish to inspect. UseFilter to specify keywords to filter the list of APIs. If needed, useSearch to locate an API.
4. Select an API.
5. Go to theVersions tables in theAPI details page.
6. Select an API version.
7. The API operations for the selected API version are listed in theOperations table on the page.

REST

To list the API operations of an API version, use the following command:

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)"  -X GET    https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID/versions/VERSION_ID/operations

Replace the following:

• HUB_PROJECT: The project ID of the API hub project.
• HUB_LOCATION: The location of the API hub project.
• API_ID: The ID of the API.
• VERSION_ID: The ID of the API version.

Example:

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)"  -X GET    https://apihub.googleapis.com/v1/projects/test-project/locations/us-central1/apis/test-api/versions/version-id/operations

REST

To get the details of an API operation, use the following command:

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)"  -X GET  https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_ID/versions/VERSION_ID/operations/OPERATION_ID

Replace the following:

• HUB_PROJECT: The project ID of the API hub project.
• HUB_LOCATION: The location of the API hub project.
• API_ID: The ID of the API.
• VERSION_ID: The ID of the API version.
• OPERATION_ID: The ID of the API operation.

Example:

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)"  -X GET  https://apihub.googleapis.com/v1/projects/test-project/locations/us-central1/apis/test-api/versions/version-id/operations/test-operation