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

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

A top-level description of an API.

Produced by producers and are commitments to provide services.

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

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.

↳ create_time Google\Protobuf\Timestamp

Output only. Creation timestamp.

↳ update_time Google\Protobuf\Timestamp

Output only. Last update timestamp.

↳ availability string

A user-definable description of the availability of this service. Format: free-form, but we expect single words that describe availability, e.g., "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN".

↳ recommended_version string

The recommended version of the API. Format: apis/{api}/versions/{version}

↳ recommended_deployment string

The recommended deployment of the API. Format: apis/{api}/deployments/{deployment}

↳ 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

getCreateTime

Output only. Creation timestamp.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. Creation timestamp.

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

getUpdateTime

Output only. Last update timestamp.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. Last update timestamp.

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

getAvailability

A user-definable description of the availability of this service.

Format: free-form, but we expect single words that describe availability, e.g., "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN".

Returns
TypeDescription
string

setAvailability

A user-definable description of the availability of this service.

Format: free-form, but we expect single words that describe availability, e.g., "NONE", "TESTING", "PREVIEW", "GENERAL", "DEPRECATED", "SHUTDOWN".

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getRecommendedVersion

The recommended version of the API.

Format: apis/{api}/versions/{version}

Returns
TypeDescription
string

setRecommendedVersion

The recommended version of the API.

Format: apis/{api}/versions/{version}

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getRecommendedDeployment

The recommended deployment of the API.

Format: apis/{api}/deployments/{deployment}

Returns
TypeDescription
string

setRecommendedDeployment

The recommended deployment of the API.

Format: apis/{api}/deployments/{deployment}

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