Skip to main content

deployments

Overview

Namedeployments
TypeResource
Idgoogle.apigeeregistry.deployments

Fields

NameDatatypeDescription
namestringResource name.
descriptionstringA detailed description.
labelsobjectLabels attach identifying metadata to resources. Identifying metadata can be used to filter list operations. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one resource (System labels are excluded). See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with apigeeregistry.googleapis.com/ and cannot be changed.
accessGuidancestringText briefly describing how to access the endpoint. Changes to this value will not affect the revision.
intendedAudiencestringText briefly identifying the intended audience of the API. Changes to this value will not affect the revision.
endpointUristringThe address where the deployment is serving. Changes to this value will update the revision.
revisionIdstringOutput only. Immutable. The revision ID of the deployment. A new revision is committed whenever the deployment contents are changed. The format is an 8-character hexadecimal string.
displayNamestringHuman-meaningful name.
externalChannelUristringThe address of the external channel of the API (e.g., the Developer Portal). Changes to this value will not affect the revision.
annotationsobjectAnnotations attach non-identifying metadata to resources. Annotation keys and values are less restricted than those of labels, but should be generally used for small values of broad interest. Larger, topic- specific metadata should be stored in Artifacts.
revisionCreateTimestringOutput only. Revision creation timestamp; when the represented revision was created.
createTimestringOutput only. Creation timestamp; when the deployment resource was created.
revisionUpdateTimestringOutput only. Last update timestamp: when the represented revision was last modified.
apiSpecRevisionstringThe full resource name (including revision ID) of the spec of the API being served by the deployment. Changes to this value will update the revision. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec@revision}

Methods

NameAccessible byRequired ParamsDescription
projects_locations_apis_deployments_getSELECTapisId, deploymentsId, locationsId, projectsIdReturns a specified deployment.
projects_locations_apis_deployments_listSELECTapisId, locationsId, projectsIdReturns matching deployments.
projects_locations_apis_deployments_createINSERTapisId, locationsId, projectsIdCreates a specified deployment.
projects_locations_apis_deployments_deleteDELETEapisId, deploymentsId, locationsId, projectsIdRemoves a specified deployment, all revisions, and all child resources (e.g., artifacts).
_projects_locations_apis_deployments_listEXECapisId, locationsId, projectsIdReturns matching deployments.
projects_locations_apis_deployments_patchEXECapisId, deploymentsId, locationsId, projectsIdUsed to modify a specified deployment.
projects_locations_apis_deployments_rollbackEXECapisId, deploymentsId, locationsId, projectsIdSets the current revision to a specified prior revision. Note that this creates a new revision with a new revision ID.
projects_locations_apis_deployments_tag_revisionEXECapisId, deploymentsId, locationsId, projectsIdAdds a tag to a specified revision of a deployment.