Marketplace API overview

The Marketplace API uses Kubernetes custom resources and relies on the Kubernetes Resource Model. The APIs are used for the provisioning and administration of the Marketplace services in a given project through actions that include installing, upgrading, and uninstalling. The GDC Marketplace APIs are also used to see available versions, create, modify, or delete objects in your project to install, upgrade, or uninstall instances of a service.

Service endpoint and discovery document

The following URL is the API endpoint for the Marketplace APIs: https://GDC_API_SERVER_ENDPOINT/apis/marketplace.gdc.goog/v1 where GDC_API_SERVER_ENDPOINT is the endpoint of the GDC API server.

Using the kubectl proxy command, you can access that URL in your browser or with a tool such as curl to get the discovery document for the Marketplace API. The kubectl proxy command opens up a proxy to the Kubernetes API server on your local machine. When the command is running, access the document at the following URL:

http://127.0.0.1:8001/apis/marketplace.gdc.goog/v1

Create an object in a project's namespace with kubectl create to install the service you want. To upgrade a service instance, modify it to indicate which version of that service. You can modify the object directly with an HTTP client or by using the kubectl apply, kubectl patch, or kubectl edit commands. To uninstall a service instance, delete the object with kubectl delete.