REST Resource: projects.locations.deployments Stay organized with collections Save and categorize content based on your preferences.
Resource: Deployment
Details of the deployment where APIs are hosted. A deployment could represent an Apigee proxy, API gateway, other Google Cloud services or non-Google Cloud services as well. A deployment entity is a root level entity in the API hub and exists independent of any API.
| JSON representation |
|---|
{"name":string,"displayName":string,"description":string,"documentation":{object ( |
| Fields | |
|---|---|
name |
Identifier. The name of the deployment. Format: |
displayName |
Required. The display name of the deployment. |
description |
Optional. The description of the deployment. |
documentation |
Optional. The documentation of the deployment. |
deploymentType |
Required. The type of deployment. This maps to the following system defined attribute: |
resourceUri |
Required. The resource URI identifies the deployment within its gateway. For Apigee gateways, its recommended to use the format: organizations/{org}/environments/{env}/apis/{api}. For ex: if a proxy with name |
endpoints[] |
Required. The endpoints at which this deployment resource is listening for API requests. This could be a list of complete URIs, hostnames or an IP addresses. |
apiVersions[] |
Output only. The API versions linked to this deployment. Note: A particular deployment could be linked to multiple different API versions (of same or different APIs). |
createTime |
Output only. The time at which the deployment was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
updateTime |
Output only. The time at which the deployment was last updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
slo |
Optional. The SLO for this deployment. This maps to the following system defined attribute: |
environment |
Optional. The environment mapping to this deployment. This maps to the following system defined attribute: |
attributes |
Optional. The list of user defined attributes associated with the deployment resource. The key is the attribute name. It will be of the format: An object containing a list of |
sourceMetadata[] |
Output only. The list of sources and metadata from the sources of the deployment. |
managementUrl |
Optional. The uri where users can navigate to for the management of the deployment. This maps to the following system defined attribute: |
sourceUri |
Optional. The uri where additional source specific information for this deployment can be found. This maps to the following system defined attribute: |
sourceProject |
Optional. The project to which the deployment belongs. For GCP gateways, this will refer to the project identifier. For others like Edge/OPDK, this will refer to the org identifier. |
sourceEnvironment |
Optional. The environment at source for the deployment. For example: prod, dev, staging, etc. |
Methods | |
|---|---|
| Create a deployment resource in the API hub. |
| Delete a deployment resource in the API hub. |
| Get details about a deployment and the API versions linked to it. |
| List deployment resources in the API hub. |
| Update a deployment resource in the API hub. |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-11 UTC.