Google Cloud Apigee Registry V1 Client - Class ApiDeployment (0.3.2)

Reference documentation and code samples for the Google Cloud Apigee Registry V1 Client class ApiDeployment.

Describes a service running at particular address that provides a particular version of an API. ApiDeployments have revisions which correspond to different configurations of a single deployment in time.

Revision identifiers should be updated whenever the served API spec or endpoint address changes.

Generated from protobuf message google.cloud.apigeeregistry.v1.ApiDeployment

Namespace

Google \ Cloud \ ApigeeRegistry \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

Resource name.

↳ display_name string

Human-meaningful name.

↳ description string

A detailed description.

↳ revision_id string

Output 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.

↳ create_time Google\Protobuf\Timestamp

Output only. Creation timestamp; when the deployment resource was created.

↳ revision_create_time Google\Protobuf\Timestamp

Output only. Revision creation timestamp; when the represented revision was created.

↳ revision_update_time Google\Protobuf\Timestamp

Output only. Last update timestamp: when the represented revision was last modified.

↳ api_spec_revision string

The 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: apis/{api}/deployments/{deployment}

↳ endpoint_uri string

The address where the deployment is serving. Changes to this value will update the revision.

↳ external_channel_uri string

The address of the external channel of the API (e.g., the Developer Portal). Changes to this value will not affect the revision.

↳ intended_audience string

Text briefly identifying the intended audience of the API. Changes to this value will not affect the revision.

↳ access_guidance string

Text briefly describing how to access the endpoint. Changes to this value will not affect the revision.

↳ labels array|Google\Protobuf\Internal\MapField

Labels 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.

↳ annotations array|Google\Protobuf\Internal\MapField

Annotations 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.

getName

Resource name.

Returns
TypeDescription
string

setName

Resource name.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDisplayName

Human-meaningful name.

Returns
TypeDescription
string

setDisplayName

Human-meaningful name.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDescription

A detailed description.

Returns
TypeDescription
string

setDescription

A detailed description.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getRevisionId

Output 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.

Returns
TypeDescription
string

setRevisionId

Output 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.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getCreateTime

Output only. Creation timestamp; when the deployment resource was created.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Creation timestamp; when the deployment resource was created.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getRevisionCreateTime

Output only. Revision creation timestamp; when the represented revision was created.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasRevisionCreateTime

clearRevisionCreateTime

setRevisionCreateTime

Output only. Revision creation timestamp; when the represented revision was created.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getRevisionUpdateTime

Output only. Last update timestamp: when the represented revision was last modified.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasRevisionUpdateTime

clearRevisionUpdateTime

setRevisionUpdateTime

Output only. Last update timestamp: when the represented revision was last modified.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getApiSpecRevision

The 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: apis/{api}/deployments/{deployment}

Returns
TypeDescription
string

setApiSpecRevision

The 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: apis/{api}/deployments/{deployment}

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getEndpointUri

The address where the deployment is serving. Changes to this value will update the revision.

Returns
TypeDescription
string

setEndpointUri

The address where the deployment is serving. Changes to this value will update the revision.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getExternalChannelUri

The address of the external channel of the API (e.g., the Developer Portal). Changes to this value will not affect the revision.

Returns
TypeDescription
string

setExternalChannelUri

The address of the external channel of the API (e.g., the Developer Portal). Changes to this value will not affect the revision.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getIntendedAudience

Text briefly identifying the intended audience of the API. Changes to this value will not affect the revision.

Returns
TypeDescription
string

setIntendedAudience

Text briefly identifying the intended audience of the API. Changes to this value will not affect the revision.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getAccessGuidance

Text briefly describing how to access the endpoint. Changes to this value will not affect the revision.

Returns
TypeDescription
string

setAccessGuidance

Text briefly describing how to access the endpoint. Changes to this value will not affect the revision.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getLabels

Labels 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.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

Labels 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.

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getAnnotations

Annotations 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.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setAnnotations

Annotations 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.

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this