Package google.cloud.apihub.v1

Index

ApiHub

This service provides all methods related to the API hub.

CreateApi

rpc CreateApi(CreateApiRequest) returns (Api)

Create an API resource in the API hub. Once an API resource is created, versions can be added to it.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.apis.create

For more information, see the IAM documentation.

CreateAttribute

rpc CreateAttribute(CreateAttributeRequest) returns (Attribute)

Create a user defined attribute.

Certain pre defined attributes are already created by the API hub. These attributes will have type as SYSTEM_DEFINED and can be listed via ListAttributes method. Allowed values for the same can be updated via UpdateAttribute method.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.attributes.create

For more information, see the IAM documentation.

CreateDeployment

rpc CreateDeployment(CreateDeploymentRequest) returns (Deployment)

Create a deployment resource in the API hub. Once a deployment resource is created, it can be associated with API versions.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.deployments.create

For more information, see the IAM documentation.

CreateExternalApi

rpc CreateExternalApi(CreateExternalApiRequest) returns (ExternalApi)

Create an External API resource in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.externalApis.create

For more information, see the IAM documentation.

CreateSpec

rpc CreateSpec(CreateSpecRequest) returns (Spec)

Add a spec to an API version in the API hub. Multiple specs can be added to an API version. Note, while adding a spec, at least one of contents or source_uri must be provided. If contents is provided, then spec_type must also be provided.

On adding a spec with contents to the version, the operations present in it will be added to the version.Note that the file contents in the spec should be of the same type as defined in the projects/{project}/locations/{location}/attributes/system-spec-type attribute associated with spec resource. Note that specs of various types can be uploaded, however parsing of details is supported for OpenAPI spec currently.

In order to access the information parsed from the spec, use the GetSpec method. In order to access the raw contents for a particular spec, use the GetSpecContents method. In order to access the operations parsed from the spec, use the ListAPIOperations method.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.specs.create

For more information, see the IAM documentation.

CreateVersion

rpc CreateVersion(CreateVersionRequest) returns (Version)

Create an API version for an API resource in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.versions.create

For more information, see the IAM documentation.

DeleteApi

rpc DeleteApi(DeleteApiRequest) returns (Empty)

Delete an API resource in the API hub. API can only be deleted if all underlying versions are deleted.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.apis.delete

For more information, see the IAM documentation.

DeleteAttribute

rpc DeleteAttribute(DeleteAttributeRequest) returns (Empty)

Delete an attribute.

Note: System defined attributes cannot be deleted. All associations of the attribute being deleted with any API hub resource will also get deleted.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.attributes.delete

For more information, see the IAM documentation.

DeleteDeployment

rpc DeleteDeployment(DeleteDeploymentRequest) returns (Empty)

Delete a deployment resource in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.deployments.delete

For more information, see the IAM documentation.

DeleteExternalApi

rpc DeleteExternalApi(DeleteExternalApiRequest) returns (Empty)

Delete an External API resource in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.externalApis.delete

For more information, see the IAM documentation.

DeleteSpec

rpc DeleteSpec(DeleteSpecRequest) returns (Empty)

Delete a spec. Deleting a spec will also delete the associated operations from the version.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.specs.delete

For more information, see the IAM documentation.

DeleteVersion

rpc DeleteVersion(DeleteVersionRequest) returns (Empty)

Delete an API version. Version can only be deleted if all underlying specs, operations, definitions and linked deployments are deleted.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.versions.delete

For more information, see the IAM documentation.

GetApi

rpc GetApi(GetApiRequest) returns (Api)

Get API resource details including the API versions contained in it.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.apis.get

For more information, see the IAM documentation.

GetApiOperation

rpc GetApiOperation(GetApiOperationRequest) returns (ApiOperation)

Get details about a particular operation in API version.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.apiOperations.get

For more information, see the IAM documentation.

GetAttribute

rpc GetAttribute(GetAttributeRequest) returns (Attribute)

Get details about the attribute.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.attributes.get

For more information, see the IAM documentation.

GetDefinition

rpc GetDefinition(GetDefinitionRequest) returns (Definition)

Get details about a definition in an API version.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.definitions.get

For more information, see the IAM documentation.

GetDeployment

rpc GetDeployment(GetDeploymentRequest) returns (Deployment)

Get details about a deployment and the API versions linked to it.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.deployments.get

For more information, see the IAM documentation.

GetExternalApi

rpc GetExternalApi(GetExternalApiRequest) returns (ExternalApi)

Get details about an External API resource in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.externalApis.get

For more information, see the IAM documentation.

GetSpec

rpc GetSpec(GetSpecRequest) returns (Spec)

Get details about the information parsed from a spec. Note that this method does not return the raw spec contents. Use GetSpecContents method to retrieve the same.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.specs.get

For more information, see the IAM documentation.

GetSpecContents

rpc GetSpecContents(GetSpecContentsRequest) returns (SpecContents)

Get spec contents.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.specs.get

For more information, see the IAM documentation.

GetVersion

rpc GetVersion(GetVersionRequest) returns (Version)

Get details about the API version of an API resource. This will include information about the specs and operations present in the API version as well as the deployments linked to it.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.versions.get

For more information, see the IAM documentation.

ListApiOperations

rpc ListApiOperations(ListApiOperationsRequest) returns (ListApiOperationsResponse)

List operations in an API version.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.apiOperations.list

For more information, see the IAM documentation.

ListApis

rpc ListApis(ListApisRequest) returns (ListApisResponse)

List API resources in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.apis.list

For more information, see the IAM documentation.

ListAttributes

rpc ListAttributes(ListAttributesRequest) returns (ListAttributesResponse)

List all attributes.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.attributes.list

For more information, see the IAM documentation.

ListDeployments

rpc ListDeployments(ListDeploymentsRequest) returns (ListDeploymentsResponse)

List deployment resources in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.deployments.list

For more information, see the IAM documentation.

ListExternalApis

rpc ListExternalApis(ListExternalApisRequest) returns (ListExternalApisResponse)

List External API resources in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.externalApis.list

For more information, see the IAM documentation.

ListSpecs

rpc ListSpecs(ListSpecsRequest) returns (ListSpecsResponse)

List specs corresponding to a particular API resource.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.specs.list

For more information, see the IAM documentation.

ListVersions

rpc ListVersions(ListVersionsRequest) returns (ListVersionsResponse)

List API versions of an API resource in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.versions.list

For more information, see the IAM documentation.

SearchResources

rpc SearchResources(SearchResourcesRequest) returns (SearchResourcesResponse)

Search across API-Hub resources.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the location resource:

  • apihub.apis.list

For more information, see the IAM documentation.

UpdateApi

rpc UpdateApi(UpdateApiRequest) returns (Api)

Update an API resource in the API hub. The following fields in the [API][] can be updated:

The update_mask should be used to specify the fields being updated.

Updating the owner field requires complete owner message and updates both owner and email fields.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.apis.update

For more information, see the IAM documentation.

UpdateAttribute

rpc UpdateAttribute(UpdateAttributeRequest) returns (Attribute)

Update the attribute. The following fields in the Attribute resource can be updated:

  • display_name The display name can be updated for user defined attributes only.
  • description The description can be updated for user defined attributes only.
  • allowed_values To update the list of allowed values, clients need to use the fetched list of allowed values and add or remove values to or from the same list. The mutable allowed values can be updated for both user defined and System defined attributes. The immutable allowed values cannot be updated or deleted. The updated list of allowed values cannot be empty. If an allowed value that is already used by some resource's attribute is deleted, then the association between the resource and the attribute value will also be deleted.
  • cardinality The cardinality can be updated for user defined attributes only. Cardinality can only be increased during an update.

The update_mask should be used to specify the fields being updated.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.attributes.update

For more information, see the IAM documentation.

UpdateDeployment

rpc UpdateDeployment(UpdateDeploymentRequest) returns (Deployment)

Update a deployment resource in the API hub. The following fields in the deployment resource can be updated:

The update_mask should be used to specify the fields being updated.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.deployments.update

For more information, see the IAM documentation.

UpdateExternalApi

rpc UpdateExternalApi(UpdateExternalApiRequest) returns (ExternalApi)

Update an External API resource in the API hub. The following fields can be updated:

The update_mask should be used to specify the fields being updated.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.externalApis.update

For more information, see the IAM documentation.

UpdateSpec

rpc UpdateSpec(UpdateSpecRequest) returns (Spec)

Update spec. The following fields in the spec can be updated:

In case of an OAS spec, updating spec contents can lead to: 1. Creation, deletion and update of operations. 2. Creation, deletion and update of definitions. 3. Update of other info parsed out from the new spec.

In case of contents or source_uri being present in update mask, spec_type must also be present. Also, spec_type can not be present in update mask if contents or source_uri is not present.

The update_mask should be used to specify the fields being updated.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.specs.update

For more information, see the IAM documentation.

UpdateVersion

rpc UpdateVersion(UpdateVersionRequest) returns (Version)

Update API version. The following fields in the version can be updated currently:

The update_mask should be used to specify the fields being updated.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.versions.update

For more information, see the IAM documentation.

ApiHubDependencies

This service provides methods for various operations related to a Dependency in the API hub.

CreateDependency

rpc CreateDependency(CreateDependencyRequest) returns (Dependency)

Create a dependency between two entities in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.dependencies.create

For more information, see the IAM documentation.

DeleteDependency

rpc DeleteDependency(DeleteDependencyRequest) returns (Empty)

Delete the dependency resource.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.dependencies.delete

For more information, see the IAM documentation.

GetDependency

rpc GetDependency(GetDependencyRequest) returns (Dependency)

Get details about a dependency resource in the API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.dependencies.get

For more information, see the IAM documentation.

ListDependencies

rpc ListDependencies(ListDependenciesRequest) returns (ListDependenciesResponse)

List dependencies based on the provided filter and pagination parameters.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.dependencies.list

For more information, see the IAM documentation.

UpdateDependency

rpc UpdateDependency(UpdateDependencyRequest) returns (Dependency)

Update a dependency based on the update_mask provided in the request.

The following fields in the dependency can be updated: * description

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.dependencies.update

For more information, see the IAM documentation.

ApiHubPlugin

This service is used for managing plugins inside the API Hub.

DisablePlugin

rpc DisablePlugin(DisablePluginRequest) returns (Plugin)

Disables a plugin. The state of the plugin after disabling is DISABLED

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.plugins.disable

For more information, see the IAM documentation.

EnablePlugin

rpc EnablePlugin(EnablePluginRequest) returns (Plugin)

Enables a plugin. The state of the plugin after enabling is ENABLED

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.plugins.enable

For more information, see the IAM documentation.

GetPlugin

rpc GetPlugin(GetPluginRequest) returns (Plugin)

Get details about an API Hub plugin.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.plugins.get

For more information, see the IAM documentation.

HostProjectRegistrationService

This service is used for managing the host project registrations.

CreateHostProjectRegistration

rpc CreateHostProjectRegistration(CreateHostProjectRegistrationRequest) returns (HostProjectRegistration)

Create a host project registration. A Google cloud project can be registered as a host project if it is not attached as a runtime project to another host project. A project can be registered as a host project only once. Subsequent register calls for the same project will fail.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.runTimeProjectAttachments.create

For more information, see the IAM documentation.

GetHostProjectRegistration

rpc GetHostProjectRegistration(GetHostProjectRegistrationRequest) returns (HostProjectRegistration)

Get a host project registration.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.hostProjectRegistrations.get

For more information, see the IAM documentation.

ListHostProjectRegistrations

rpc ListHostProjectRegistrations(ListHostProjectRegistrationsRequest) returns (ListHostProjectRegistrationsResponse)

Lists host project registrations.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.runTimeProjectAttachments.list

For more information, see the IAM documentation.

LintingService

This service provides all methods related to the 1p Linter.

GetStyleGuide

rpc GetStyleGuide(GetStyleGuideRequest) returns (StyleGuide)

Get the style guide being used for linting.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.styleGuides.get

For more information, see the IAM documentation.

GetStyleGuideContents

rpc GetStyleGuideContents(GetStyleGuideContentsRequest) returns (StyleGuideContents)

Get the contents of the style guide.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.styleGuides.get

For more information, see the IAM documentation.

LintSpec

rpc LintSpec(LintSpecRequest) returns (Empty)

Lints the requested spec and updates the corresponding API Spec with the lint response. This lint response will be available in all subsequent Get and List Spec calls to Core service.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.specs.lint

For more information, see the IAM documentation.

UpdateStyleGuide

rpc UpdateStyleGuide(UpdateStyleGuideRequest) returns (StyleGuide)

Update the styleGuide to be used for liniting in by API hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.styleGuides.update

For more information, see the IAM documentation.

Provisioning

This service is used for managing the data plane provisioning of the API hub.

CreateApiHubInstance

rpc CreateApiHubInstance(CreateApiHubInstanceRequest) returns (Operation)

Provisions instance resources for the API Hub.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.apiHubInstances.create

For more information, see the IAM documentation.

GetApiHubInstance

rpc GetApiHubInstance(GetApiHubInstanceRequest) returns (ApiHubInstance)

Gets details of a single API Hub instance.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.apiHubInstances.get

For more information, see the IAM documentation.

LookupApiHubInstance

rpc LookupApiHubInstance(LookupApiHubInstanceRequest) returns (LookupApiHubInstanceResponse)

Looks up an Api Hub instance in a given Google Cloud project. There will always be only one Api Hub instance for a Google Cloud project across all locations.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.apiHubInstances.list

For more information, see the IAM documentation.

RuntimeProjectAttachmentService

This service is used for managing the runtime project attachments.

CreateRuntimeProjectAttachment

rpc CreateRuntimeProjectAttachment(CreateRuntimeProjectAttachmentRequest) returns (RuntimeProjectAttachment)

Attaches a runtime project to the host project.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the runtimeProject resource:

  • apihub.runTimeProjectAttachments.attach

For more information, see the IAM documentation.

DeleteRuntimeProjectAttachment

rpc DeleteRuntimeProjectAttachment(DeleteRuntimeProjectAttachmentRequest) returns (Empty)

Delete a runtime project attachment in the API Hub. This call will detach the runtime project from the host project.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.runTimeProjectAttachments.delete

For more information, see the IAM documentation.

GetRuntimeProjectAttachment

rpc GetRuntimeProjectAttachment(GetRuntimeProjectAttachmentRequest) returns (RuntimeProjectAttachment)

Gets a runtime project attachment.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.runTimeProjectAttachments.get

For more information, see the IAM documentation.

ListRuntimeProjectAttachments

rpc ListRuntimeProjectAttachments(ListRuntimeProjectAttachmentsRequest) returns (ListRuntimeProjectAttachmentsResponse)

List runtime projects attached to the host project.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.runTimeProjectAttachments.list

For more information, see the IAM documentation.

LookupRuntimeProjectAttachment

rpc LookupRuntimeProjectAttachment(LookupRuntimeProjectAttachmentRequest) returns (LookupRuntimeProjectAttachmentResponse)

Look up a runtime project attachment. This API can be called in the context of any project.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform
IAM Permissions

Requires the following IAM permission on the name resource:

  • apihub.runTimeProjectAttachments.list

For more information, see the IAM documentation.

Api

An API resource in the API Hub.

Fields
name

string

Identifier. The name of the API resource in the API Hub.

Format: projects/{project}/locations/{location}/apis/{api}

display_name

string

Required. The display name of the API resource.

description

string

Optional. The description of the API resource.

documentation

Documentation

Optional. The documentation for the API resource.

owner

Owner

Optional. Owner details for the API resource.

versions[]

string

Output only. The list of versions present in an API resource. Note: An API resource can be associated with more than 1 version. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}

create_time

Timestamp

Output only. The time at which the API resource was created.

update_time

Timestamp

Output only. The time at which the API resource was last updated.

target_user

AttributeValues

Optional. The target users for the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-target-user attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

team

AttributeValues

Optional. The team owning the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-team attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

business_unit

AttributeValues

Optional. The business unit owning the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-business-unit attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

maturity_level

AttributeValues

Optional. The maturity level of the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-maturity-level attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

attributes

map<string, AttributeValues>

Optional. The list of user defined attributes associated with the API resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

api_style

AttributeValues

Optional. The style of the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-api-style attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

selected_version

string

Optional. The selected version for an API resource. This can be used when special handling is needed on client side for particular version of the API. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}

ApiHubInstance

An ApiHubInstance represents the instance resources of the API Hub. Currently, only one ApiHub instance is allowed for each project.

Fields
name

string

Identifier. Format: projects/{project}/locations/{location}/apiHubInstances/{apiHubInstance}.

create_time

Timestamp

Output only. Creation timestamp.

update_time

Timestamp

Output only. Last update timestamp.

state

State

Output only. The current state of the ApiHub instance.

state_message

string

Output only. Extra information about ApiHub instance state. Currently the message would be populated when state is FAILED.

config

Config

Required. Config of the ApiHub instance.

labels

map<string, string>

Optional. Instance labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources

description

string

Optional. Description of the ApiHub instance.

Config

Available configurations to provision an ApiHub Instance.

Fields
cmek_key_name

string

Optional. The Customer Managed Encryption Key (CMEK) used for data encryption. The CMEK name should follow the format of projects/([^/]+)/locations/([^/]+)/keyRings/([^/]+)/cryptoKeys/([^/]+), where the location must match the instance location. If the CMEK is not provided, a GMEK will be created for the instance.

encryption_type

EncryptionType

Optional. Encryption type for the region. If the encryption type is CMEK, the cmek_key_name must be provided. If no encryption type is provided, GMEK will be used.

EncryptionType

Types of data encryption.

Enums
ENCRYPTION_TYPE_UNSPECIFIED Encryption type unspecified.
GMEK Default encryption using Google managed encryption key.
CMEK Encryption using customer managed encryption key.

State

State of the ApiHub Instance.

Enums
STATE_UNSPECIFIED The default value. This value is used if the state is omitted.
INACTIVE The ApiHub instance has not been initialized or has been deleted.
CREATING The ApiHub instance is being created.
ACTIVE The ApiHub instance has been created and is ready for use.
UPDATING The ApiHub instance is being updated.
DELETING The ApiHub instance is being deleted.
FAILED The ApiHub instance encountered an error during a state change.

ApiHubResource

ApiHubResource is one of the resources such as Api, Operation, Deployment, Definition, Spec and Version resources stored in API-Hub.

Fields

Union field resource.

resource can be only one of the following:

api

Api

This represents Api resource in search results. Only name, display_name, description and owner fields are populated in search results.

operation

ApiOperation

This represents ApiOperation resource in search results. Only name, description, spec and details fields are populated in search results.

deployment

Deployment

This represents Deployment resource in search results. Only name, display_name, description, deployment_type and api_versions fields are populated in search results.

spec

Spec

This represents Spec resource in search results. Only name, display_name, description, spec_type and documentation fields are populated in search results.

definition

Definition

This represents Definition resource in search results. Only name field is populated in search results.

version

Version

This represents Version resource in search results. Only name, display_name, description, lifecycle, compliance and accreditation fields are populated in search results.

ApiOperation

Represents an operation contained in an API version in the API Hub. An operation is added/updated/deleted in an API version when a new spec is added or an existing spec is updated/deleted in a version. Currently, an operation will be created only corresponding to OpenAPI spec as parsing is supported for OpenAPI spec.

Fields
name

string

Identifier. The name of the operation.

Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/operations/{operation}

spec

string

Output only. The name of the spec from where the operation was parsed. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

details

OperationDetails

Output only. Operation details.

create_time

Timestamp

Output only. The time at which the operation was created.

update_time

Timestamp

Output only. The time at which the operation was last updated.

attributes

map<string, AttributeValues>

Optional. The list of user defined attributes associated with the API operation resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

Attribute

An attribute in the API Hub. An attribute is a name value pair which can be attached to different resources in the API hub based on the scope of the attribute. Attributes can either be pre-defined by the API Hub or created by users.

Fields
name

string

Identifier. The name of the attribute in the API Hub.

Format: projects/{project}/locations/{location}/attributes/{attribute}

display_name

string

Required. The display name of the attribute.

description

string

Optional. The description of the attribute.

definition_type

DefinitionType

Output only. The definition type of the attribute.

scope

Scope

Required. The scope of the attribute. It represents the resource in the API Hub to which the attribute can be linked.

data_type

DataType

Required. The type of the data of the attribute.

allowed_values[]

AllowedValue

Optional. The list of allowed values when the attribute value is of type enum. This is required when the data_type of the attribute is ENUM. The maximum number of allowed values of an attribute will be 1000.

cardinality

int32

Optional. The maximum number of values that the attribute can have when associated with an API Hub resource. Cardinality 1 would represent a single-valued attribute. It must not be less than 1 or greater than 20. If not specified, the cardinality would be set to 1 by default and represent a single-valued attribute.

mandatory

bool

Output only. When mandatory is true, the attribute is mandatory for the resource specified in the scope. Only System defined attributes can be mandatory.

create_time

Timestamp

Output only. The time at which the attribute was created.

update_time

Timestamp

Output only. The time at which the attribute was last updated.

AllowedValue

The value that can be assigned to the attribute when the data type is enum.

Fields
id

string

Required. The ID of the allowed value. * If provided, the same will be used. The service will throw an error if the specified id is already used by another allowed value in the same attribute resource. * If not provided, a system generated id derived from the display name will be used. In this case, the service will handle conflict resolution by adding a system generated suffix in case of duplicates.

This value should be 4-63 characters, and valid characters are /[a-z][0-9]-/.

display_name

string

Required. The display name of the allowed value.

description

string

Optional. The detailed description of the allowed value.

immutable

bool

Optional. When set to true, the allowed value cannot be updated or deleted by the user. It can only be true for System defined attributes.

DataType

Enumeration of attribute's data type.

Enums
DATA_TYPE_UNSPECIFIED Attribute data type unspecified.
ENUM Attribute's value is of type enum.
JSON Attribute's value is of type json.
STRING Attribute's value is of type string.

DefinitionType

Enumeration of attribute definition types.

Enums
DEFINITION_TYPE_UNSPECIFIED Attribute definition type unspecified.
SYSTEM_DEFINED The attribute is predefined by the API Hub. Note that only the list of allowed values can be updated in this case via UpdateAttribute method.
USER_DEFINED The attribute is defined by the user.

Scope

Enumeration for the scope of the attribute representing the resource in the API Hub to which the attribute can be linked.

Enums
SCOPE_UNSPECIFIED Scope Unspecified.
API Attribute can be linked to an API.
VERSION Attribute can be linked to an API version.
SPEC Attribute can be linked to a Spec.
API_OPERATION Attribute can be linked to an API Operation.
DEPLOYMENT Attribute can be linked to a Deployment.
DEPENDENCY Attribute can be linked to a Dependency.
DEFINITION Attribute can be linked to a definition.
EXTERNAL_API Attribute can be linked to a ExternalAPI.
PLUGIN Attribute can be linked to a Plugin.

AttributeValues

The attribute values associated with resource.

Fields
attribute

string

Output only. The name of the attribute. Format: projects/{project}/locations/{location}/attributes/{attribute}

Union field Value. The attribute values associated with the resource. Value can be only one of the following:
enum_values

EnumAttributeValues

The attribute values associated with a resource in case attribute data type is enum.

string_values

StringAttributeValues

The attribute values associated with a resource in case attribute data type is string.

json_values

StringAttributeValues

The attribute values associated with a resource in case attribute data type is JSON.

EnumAttributeValues

The attribute values of data type enum.

Fields
values[]

AllowedValue

Required. The attribute values in case attribute data type is enum.

StringAttributeValues

The attribute values of data type string or JSON.

Fields
values[]

string

Required. The attribute values in case attribute data type is string or JSON.

CreateApiHubInstanceRequest

The CreateApiHubInstance method's request.

Fields
parent

string

Required. The parent resource for the Api Hub instance resource. Format: projects/{project}/locations/{location}

api_hub_instance_id

string

Optional. Identifier to assign to the Api Hub instance. Must be unique within scope of the parent resource. If the field is not provided, system generated id will be used.

This value should be 4-40 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

api_hub_instance

ApiHubInstance

Required. The ApiHub instance.

CreateApiRequest

The CreateApi method's request.

Fields
parent

string

Required. The parent resource for the API resource. Format: projects/{project}/locations/{location}

api_id

string

Optional. The ID to use for the API resource, which will become the final component of the API's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another API resource in the API hub.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

api

Api

Required. The API resource to create.

CreateAttributeRequest

The CreateAttribute method's request.

Fields
parent

string

Required. The parent resource for Attribute. Format: projects/{project}/locations/{location}

attribute_id

string

Optional. The ID to use for the attribute, which will become the final component of the attribute's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another attribute resource in the API hub.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

attribute

Attribute

Required. The attribute to create.

CreateDependencyRequest

The CreateDependency method's request.

Fields
parent

string

Required. The parent resource for the dependency resource. Format: projects/{project}/locations/{location}

dependency_id

string

Optional. The ID to use for the dependency resource, which will become the final component of the dependency's resource name. This field is optional. * If provided, the same will be used. The service will throw an error if duplicate id is provided by the client. * If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are [a-z][A-Z][0-9]-_.

dependency

Dependency

Required. The dependency resource to create.

CreateDeploymentRequest

The CreateDeployment method's request.

Fields
parent

string

Required. The parent resource for the deployment resource. Format: projects/{project}/locations/{location}

deployment_id

string

Optional. The ID to use for the deployment resource, which will become the final component of the deployment's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another deployment resource in the API hub.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

deployment

Deployment

Required. The deployment resource to create.

CreateExternalApiRequest

The CreateExternalApi method's request.

Fields
parent

string

Required. The parent resource for the External API resource. Format: projects/{project}/locations/{location}

external_api_id

string

Optional. The ID to use for the External API resource, which will become the final component of the External API's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another External API resource in the API hub.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

external_api

ExternalApi

Required. The External API resource to create.

CreateHostProjectRegistrationRequest

The CreateHostProjectRegistration method's request.

Fields
parent

string

Required. The parent resource for the host project. Format: projects/{project}/locations/{location}

host_project_registration_id

string

Required. The ID to use for the Host Project Registration, which will become the final component of the host project registration's resource name. The ID must be the same as the Google cloud project specified in the host_project_registration.gcp_project field.

host_project_registration

HostProjectRegistration

Required. The host project registration to register.

CreateRuntimeProjectAttachmentRequest

The CreateRuntimeProjectAttachment method's request.

Fields
parent

string

Required. The parent resource for the Runtime Project Attachment. Format: projects/{project}/locations/{location}

runtime_project_attachment_id

string

Required. The ID to use for the Runtime Project Attachment, which will become the final component of the Runtime Project Attachment's name. The ID must be the same as the project ID of the Google cloud project specified in the runtime_project_attachment.runtime_project field.

runtime_project_attachment

RuntimeProjectAttachment

Required. The Runtime Project Attachment to create.

CreateSpecRequest

The CreateSpec method's request.

Fields
parent

string

Required. The parent resource for Spec. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}

spec_id

string

Optional. The ID to use for the spec, which will become the final component of the spec's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another spec in the API resource.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

spec

Spec

Required. The spec to create.

CreateVersionRequest

The CreateVersion method's request.

Fields
parent

string

Required. The parent resource for API version. Format: projects/{project}/locations/{location}/apis/{api}

version_id

string

Optional. The ID to use for the API version, which will become the final component of the version's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another version in the API resource.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

version

Version

Required. The version to create.

Definition

Represents a definition for example schema, request, response definitions contained in an API version. A definition is added/updated/deleted in an API version when a new spec is added or an existing spec is updated/deleted in a version. Currently, definition will be created only corresponding to OpenAPI spec as parsing is supported for OpenAPI spec. Also, within OpenAPI spec, only schema object is supported.

Fields
name

string

Identifier. The name of the definition.

Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/definitions/{definition}

spec

string

Output only. The name of the spec from where the definition was parsed. Format is projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

type

Type

Output only. The type of the definition.

create_time

Timestamp

Output only. The time at which the definition was created.

update_time

Timestamp

Output only. The time at which the definition was last updated.

attributes

map<string, AttributeValues>

Optional. The list of user defined attributes associated with the definition resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

Union field value.

value can be only one of the following:

schema

Schema

Output only. The value of a schema definition.

Type

Enumeration of definition types.

Enums
TYPE_UNSPECIFIED Definition type unspecified.
SCHEMA Definition type schema.

DeleteApiRequest

The DeleteApi method's request.

Fields
name

string

Required. The name of the API resource to delete. Format: projects/{project}/locations/{location}/apis/{api}

force

bool

Optional. If set to true, any versions from this API will also be deleted. Otherwise, the request will only work if the API has no versions.

DeleteAttributeRequest

The DeleteAttribute method's request.

Fields
name

string

Required. The name of the attribute to delete. Format: projects/{project}/locations/{location}/attributes/{attribute}

DeleteDependencyRequest

The DeleteDependency method's request.

Fields
name

string

Required. The name of the dependency resource to delete. Format: projects/{project}/locations/{location}/dependencies/{dependency}

DeleteDeploymentRequest

The DeleteDeployment method's request.

Fields
name

string

Required. The name of the deployment resource to delete. Format: projects/{project}/locations/{location}/deployments/{deployment}

DeleteExternalApiRequest

The DeleteExternalApi method's request.

Fields
name

string

Required. The name of the External API resource to delete. Format: projects/{project}/locations/{location}/externalApis/{externalApi}

DeleteRuntimeProjectAttachmentRequest

The DeleteRuntimeProjectAttachment method's request.

Fields
name

string

Required. The name of the Runtime Project Attachment to delete. Format: projects/{project}/locations/{location}/runtimeProjectAttachments/{runtime_project_attachment}

DeleteSpecRequest

The DeleteSpec method's request.

Fields
name

string

Required. The name of the spec to delete. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

DeleteVersionRequest

The DeleteVersion method's request.

Fields
name

string

Required. The name of the version to delete. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}

force

bool

Optional. If set to true, any specs from this version will also be deleted. Otherwise, the request will only work if the version has no specs.

Dependency

A dependency resource defined in the API hub describes a dependency directed from a consumer to a supplier entity. A dependency can be defined between two [Operations][google.cloud.apihub.v1.Operation] or between an [Operation][google.cloud.apihub.v1.Operation] and External API.

Fields
name

string

Identifier. The name of the dependency in the API Hub.

Format: projects/{project}/locations/{location}/dependencies/{dependency}

consumer

DependencyEntityReference

Required. Immutable. The entity acting as the consumer in the dependency.

supplier

DependencyEntityReference

Required. Immutable. The entity acting as the supplier in the dependency.

state

State

Output only. State of the dependency.

description

string

Optional. Human readable description corresponding of the dependency.

discovery_mode

DiscoveryMode

Output only. Discovery mode of the dependency.

error_detail

DependencyErrorDetail

Output only. Error details of a dependency if the system has detected it internally.

create_time

Timestamp

Output only. The time at which the dependency was created.

update_time

Timestamp

Output only. The time at which the dependency was last updated.

attributes

map<string, AttributeValues>

Optional. The list of user defined attributes associated with the dependency resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

DiscoveryMode

Possible modes of discovering the dependency.

Enums
DISCOVERY_MODE_UNSPECIFIED Default value. This value is unused.
MANUAL Manual mode of discovery when the dependency is defined by the user.

State

Possible states for a dependency.

Enums
STATE_UNSPECIFIED Default value. This value is unused.
PROPOSED Dependency will be in a proposed state when it is newly identified by the API hub on its own.
VALIDATED Dependency will be in a validated state when it is validated by the admin or manually created in the API hub.

DependencyEntityReference

Reference to an entity participating in a dependency.

Fields
display_name

string

Output only. Display name of the entity.

Union field identifier. Required. Unique identifier for the participating entity. identifier can be only one of the following:
operation_resource_name

string

The resource name of an operation in the API Hub.

Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/operations/{operation}

external_api_resource_name

string

The resource name of an external API in the API Hub.

Format: projects/{project}/locations/{location}/externalApis/{external_api}

DependencyErrorDetail

Details describing error condition of a dependency.

Fields
error

Error

Optional. Error in the dependency.

error_time

Timestamp

Optional. Timestamp at which the error was found.

Error

Possible values representing an error in the dependency.

Enums
ERROR_UNSPECIFIED Default value used for no error in the dependency.
SUPPLIER_NOT_FOUND Supplier entity has been deleted.
SUPPLIER_RECREATED Supplier entity has been recreated.

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.

Fields
name

string

Identifier. The name of the deployment.

Format: projects/{project}/locations/{location}/deployments/{deployment}

display_name

string

Required. The display name of the deployment.

description

string

Optional. The description of the deployment.

documentation

Documentation

Optional. The documentation of the deployment.

deployment_type

AttributeValues

Required. The type of deployment. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-deployment-type attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

resource_uri

string

Required. A URI to the runtime resource. This URI can be used to manage the resource. For example, if the runtime resource is of type APIGEE_PROXY, then this field will contain the URI to the management UI of the proxy.

endpoints[]

string

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.

api_versions[]

string

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

create_time

Timestamp

Output only. The time at which the deployment was created.

update_time

Timestamp

Output only. The time at which the deployment was last updated.

slo

AttributeValues

Optional. The SLO for this deployment. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-slo attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

environment

AttributeValues

Optional. The environment mapping to this deployment. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-environment attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

attributes

map<string, AttributeValues>

Optional. The list of user defined attributes associated with the deployment resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

DisablePluginRequest

The DisablePlugin method's request.

Fields
name

string

Required. The name of the plugin to disable. Format: projects/{project}/locations/{location}/plugins/{plugin}.

Documentation

Documentation details.

Fields
external_uri

string

Optional. The uri of the externally hosted documentation.

EnablePluginRequest

The EnablePlugin method's request.

Fields
name

string

Required. The name of the plugin to enable. Format: projects/{project}/locations/{location}/plugins/{plugin}.

ExternalApi

An external API represents an API being provided by external sources. This can be used to model third-party APIs and can be used to define dependencies.

Fields
name

string

Identifier. Format: projects/{project}/locations/{location}/externalApi/{externalApi}.

display_name

string

Required. Display name of the external API. Max length is 63 characters (Unicode Code Points).

description

string

Optional. Description of the external API. Max length is 2000 characters (Unicode Code Points).

endpoints[]

string

Optional. List of endpoints on which this API is accessible.

paths[]

string

Optional. List of paths served by this API.

documentation

Documentation

Optional. Documentation of the external API.

attributes

map<string, AttributeValues>

Optional. The list of user defined attributes associated with the Version resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

create_time

Timestamp

Output only. Creation timestamp.

update_time

Timestamp

Output only. Last update timestamp.

GetApiHubInstanceRequest

The GetApiHubInstance method's request.

Fields
name

string

Required. The name of the Api Hub instance to retrieve. Format: projects/{project}/locations/{location}/apiHubInstances/{apiHubInstance}.

GetApiOperationRequest

The GetApiOperation method's request.

Fields
name

string

Required. The name of the operation to retrieve. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/operations/{operation}

GetApiRequest

The GetApi method's request.

Fields
name

string

Required. The name of the API resource to retrieve. Format: projects/{project}/locations/{location}/apis/{api}

GetAttributeRequest

The GetAttribute method's request.

Fields
name

string

Required. The name of the attribute to retrieve. Format: projects/{project}/locations/{location}/attributes/{attribute}

GetDefinitionRequest

The GetDefinition method's request.

Fields
name

string

Required. The name of the definition to retrieve. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/definitions/{definition}

GetDependencyRequest

The [GetDependency][.ApiHubDependencies.GetDependency] method's request.

Fields
name

string

Required. The name of the dependency resource to retrieve. Format: projects/{project}/locations/{location}/dependencies/{dependency}

GetDeploymentRequest

The GetDeployment method's request.

Fields
name

string

Required. The name of the deployment resource to retrieve. Format: projects/{project}/locations/{location}/deployments/{deployment}

GetExternalApiRequest

The GetExternalApi method's request.

Fields
name

string

Required. The name of the External API resource to retrieve. Format: projects/{project}/locations/{location}/externalApis/{externalApi}

GetHostProjectRegistrationRequest

The GetHostProjectRegistration method's request.

Fields
name

string

Required. Host project registration resource name. projects/{project}/locations/{location}/hostProjectRegistrations/{host_project_registration_id}

GetPluginRequest

The GetPlugin method's request.

Fields
name

string

Required. The name of the plugin to retrieve. Format: projects/{project}/locations/{location}/plugins/{plugin}.

GetRuntimeProjectAttachmentRequest

The GetRuntimeProjectAttachment method's request.

Fields
name

string

Required. The name of the API resource to retrieve. Format: projects/{project}/locations/{location}/runtimeProjectAttachments/{runtime_project_attachment}

GetSpecContentsRequest

The GetSpecContents method's request.

Fields
name

string

Required. The name of the spec whose contents need to be retrieved. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

GetSpecRequest

The GetSpec method's request.

Fields
name

string

Required. The name of the spec to retrieve. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

GetStyleGuideContentsRequest

The [GetStyleGuideContents][ApiHub.GetStyleGuideContents] method's request.

Fields
name

string

Required. The name of the StyleGuide whose contents need to be retrieved. There is exactly one style guide resource per project per location. The expected format is projects/{project}/locations/{location}/plugins/{plugin}/styleGuide.

GetStyleGuideRequest

The [GetStyleGuide][ApiHub.GetStyleGuide] method's request.

Fields
name

string

Required. The name of the spec to retrieve. Format: projects/{project}/locations/{location}/plugins/{plugin}/styleGuide.

GetVersionRequest

The GetVersion method's request.

Fields
name

string

Required. The name of the API version to retrieve. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}

HostProjectRegistration

Host project registration refers to the registration of a Google cloud project with Api Hub as a host project. This is the project where Api Hub is provisioned. It acts as the consumer project for the Api Hub instance provisioned. Multiple runtime projects can be attached to the host project and these attachments define the scope of Api Hub.

Fields
name

string

Identifier. The name of the host project registration. Format: "projects/{project}/locations/{location}/hostProjectRegistrations/{host_project_registration}".

gcp_project

string

Required. Immutable. Google cloud project name in the format: "projects/abc" or "projects/123". As input, project name with either project id or number are accepted. As output, this field will contain project number.

create_time

Timestamp

Output only. The time at which the host project registration was created.

HttpOperation

The HTTP Operation.

Fields
path

Path

Output only. The path details for the Operation.

method

Method

Output only. Operation method

Method

Enumeration of Method types.

Enums
METHOD_UNSPECIFIED Method unspecified.
GET Get Operation type.
PUT Put Operation type.
POST Post Operation type.
DELETE Delete Operation type.
OPTIONS Options Operation type.
HEAD Head Operation type.
PATCH Patch Operation type.
TRACE Trace Operation type.

Issue

Issue contains the details of a single issue found by the linter.

Fields
code

string

Required. Rule code unique to each rule defined in linter.

path[]

string

Required. An array of strings indicating the location in the analyzed document where the rule was triggered.

message

string

Required. Human-readable message describing the issue found by the linter.

severity

Severity

Required. Severity level of the rule violation.

range

Range

Required. Object describing where in the file the issue was found.

LintResponse

LintResponse contains the response from the linter.

Fields
issues[]

Issue

Optional. Array of issues found in the analyzed document.

summary[]

SummaryEntry

Optional. Summary of all issue types and counts for each severity level.

state

LintState

Required. Lint state represents success or failure for linting.

source

string

Required. Name of the linting application.

linter

Linter

Required. Name of the linter used.

create_time

Timestamp

Required. Timestamp when the linting response was generated.

SummaryEntry

Count of issues with a given severity.

Fields
severity

Severity

Required. Severity of the issue.

count

int32

Required. Count of issues with the given severity.

LintSpecRequest

The [LintSpec][ApiHub.LintSpec] method's request.

Fields
name

string

Required. The name of the spec to be linted. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

LintState

Lint state represents success or failure for linting.

Enums
LINT_STATE_UNSPECIFIED Lint state unspecified.
LINT_STATE_SUCCESS Linting was completed successfully.
LINT_STATE_ERROR Linting encountered errors.

Linter

Enumeration of linter types.

Enums
LINTER_UNSPECIFIED Linter type unspecified.
SPECTRAL Linter type spectral.
OTHER Linter type other.

ListApiOperationsRequest

The ListApiOperations method's request.

Fields
parent

string

Required. The parent which owns this collection of operations i.e., the API version. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}

filter

string

Optional. An expression that filters the list of ApiOperations.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string or a boolean. The comparison operator must be one of: <, > or =. Filters are not case sensitive.

The following fields in the ApiOperation are eligible for filtering: * name - The ApiOperation resource name. Allowed comparison operators: =. * details.http_operation.path.path - The http operation's complete path relative to server endpoint. Allowed comparison operators: =. * details.http_operation.method - The http operation method type. Allowed comparison operators: =. * details.deprecated - Indicates if the ApiOperation is deprecated. Allowed values are True / False indicating the deprycation status of the ApiOperation. Allowed comparison operators: =. * create_time - The time at which the ApiOperation was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format. Allowed comparison operators: > and <.

Expressions are combined with either AND logic operator or OR logical operator but not both of them together i.e. only one of the AND or OR operator can be used throughout the filter string and both the operators cannot be used together. No other logical operators are supported. At most three filter fields are allowed in the filter string and if provided more than that then INVALID_ARGUMENT error is returned by the API.

Here are a few examples:

  • details.deprecated = True - The ApiOperation is deprecated.
  • details.http_operation.method = GET AND create_time < \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\" - The method of the http operation of the ApiOperation is GET and the spec was created before 2021-08-15 14:50:00 UTC and after 2021-08-10 12:00:00 UTC.
  • details.http_operation.method = GET OR details.http_operation.method = POST. - The http operation of the method of ApiOperation is GET or POST.
page_size

int32

Optional. The maximum number of operations to return. The service may return fewer than this value. If unspecified, at most 50 operations will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListApiOperations call. Provide this to retrieve the subsequent page.

When paginating, all other parameters (except page_size) provided to ListApiOperations must match the call that provided the page token.

ListApiOperationsResponse

The ListApiOperations method's response.

Fields
api_operations[]

ApiOperation

The operations corresponding to an API version.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListApisRequest

The ListApis method's request.

Fields
parent

string

Required. The parent, which owns this collection of API resources. Format: projects/{project}/locations/{location}

filter

string

Optional. An expression that filters the list of ApiResources.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string. The comparison operator must be one of: <, >, : or =. Filters are not case sensitive.

The following fields in the ApiResource are eligible for filtering:

  • owner.email - The email of the team which owns the ApiResource. Allowed comparison operators: =.
  • create_time - The time at which the ApiResource was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format. Allowed comparison operators: > and <.
  • display_name - The display name of the ApiResource. Allowed comparison operators: =.
  • target_user.enum_values.values.id - The allowed value id of the target users attribute associated with the ApiResource. Allowed comparison operator is :.
  • target_user.enum_values.values.display_name - The allowed value display name of the target users attribute associated with the ApiResource. Allowed comparison operator is :.
  • team.enum_values.values.id - The allowed value id of the team attribute associated with the ApiResource. Allowed comparison operator is :.
  • team.enum_values.values.display_name - The allowed value display name of the team attribute associated with the ApiResource. Allowed comparison operator is :.
  • business_unit.enum_values.values.id - The allowed value id of the business unit attribute associated with the ApiResource. Allowed comparison operator is :.
  • business_unit.enum_values.values.display_name - The allowed value display name of the business unit attribute associated with the ApiResource. Allowed comparison operator is :.
  • maturity_level.enum_values.values.id - The allowed value id of the maturity level attribute associated with the ApiResource. Allowed comparison operator is :.
  • maturity_level.enum_values.values.display_name - The allowed value display name of the maturity level attribute associated with the ApiResource. Allowed comparison operator is :.
  • api_style.enum_values.values.id - The allowed value id of the api style attribute associated with the ApiResource. Allowed comparison operator is :.
  • api_style.enum_values.values.display_name - The allowed value display name of the api style attribute associated with the ApiResource. Allowed comparison operator is :.

Expressions are combined with either AND logic operator or OR logical operator but not both of them together i.e. only one of the AND or OR operator can be used throughout the filter string and both the operators cannot be used together. No other logical operators are supported. At most three filter fields are allowed in the filter string and if provided more than that then INVALID_ARGUMENT error is returned by the API.

Here are a few examples:

  • owner.email = \"apihub@google.com\" - - The owner team email is _apihub@google.com_.
  • owner.email = \"apihub@google.com\" AND create_time < \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\" - The owner team email is _apihub@google.com_ and the api was created before 2021-08-15 14:50:00 UTC and after 2021-08-10 12:00:00 UTC.
  • owner.email = \"apihub@google.com\" OR team.enum_values.values.id: apihub-team-id - The filter string specifies the APIs where the owner team email is _apihub@google.com_ or the id of the allowed value associated with the team attribute is apihub-team-id.
  • owner.email = \"apihub@google.com\" OR team.enum_values.values.display_name: ApiHub Team - The filter string specifies the APIs where the owner team email is _apihub@google.com_ or the display name of the allowed value associated with the team attribute is ApiHub Team.
page_size

int32

Optional. The maximum number of API resources to return. The service may return fewer than this value. If unspecified, at most 50 Apis will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListApis call. Provide this to retrieve the subsequent page.

When paginating, all other parameters (except page_size) provided to ListApis must match the call that provided the page token.

ListApisResponse

The ListApis method's response.

Fields
apis[]

Api

The API resources present in the API hub.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListAttributesRequest

The ListAttributes method's request.

Fields
parent

string

Required. The parent resource for Attribute. Format: projects/{project}/locations/{location}

filter

string

Optional. An expression that filters the list of Attributes.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string or a boolean. The comparison operator must be one of: <, > or =. Filters are not case sensitive.

The following fields in the Attribute are eligible for filtering:

  • display_name - The display name of the Attribute. Allowed comparison operators: =.
  • definition_type - The definition type of the attribute. Allowed comparison operators: =.
  • scope - The scope of the attribute. Allowed comparison operators: =.
  • data_type - The type of the data of the attribute. Allowed comparison operators: =.
  • mandatory - Denotes whether the attribute is mandatory or not. Allowed comparison operators: =.
  • create_time - The time at which the Attribute was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format. Allowed comparison operators: > and <.

Expressions are combined with either AND logic operator or OR logical operator but not both of them together i.e. only one of the AND or OR operator can be used throughout the filter string and both the operators cannot be used together. No other logical operators are supported. At most three filter fields are allowed in the filter string and if provided more than that then INVALID_ARGUMENT error is returned by the API.

Here are a few examples:

  • display_name = production - - The display name of the attribute is production.
  • (display_name = production) AND (create_time < \"2021-08-15T14:50:00Z\") AND (create_time > \"2021-08-10T12:00:00Z\") - The display name of the attribute is production and the attribute was created before 2021-08-15 14:50:00 UTC and after 2021-08-10 12:00:00 UTC.
  • display_name = production OR scope = api - The attribute where the display name is production or the scope is api.
page_size

int32

Optional. The maximum number of attribute resources to return. The service may return fewer than this value. If unspecified, at most 50 attributes will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListAttributes call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListAttributes must match the call that provided the page token.

ListAttributesResponse

The ListAttributes method's response.

Fields
attributes[]

Attribute

The list of all attributes.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListDependenciesRequest

The ListDependencies method's request.

Fields
parent

string

Required. The parent which owns this collection of dependency resources. Format: projects/{project}/locations/{location}

filter

string

Optional. An expression that filters the list of Dependencies.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string. Allowed comparison operator is =. Filters are not case sensitive.

The following fields in the Dependency are eligible for filtering:

  • consumer.operation_resource_name - The operation resource name for the consumer entity involved in a dependency. Allowed comparison operators: =.
  • consumer.external_api_resource_name - The external api resource name for the consumer entity involved in a dependency. Allowed comparison operators: =.
  • supplier.operation_resource_name - The operation resource name for the supplier entity involved in a dependency. Allowed comparison operators: =.
  • supplier.external_api_resource_name - The external api resource name for the supplier entity involved in a dependency. Allowed comparison operators: =.

Expressions are combined with either AND logic operator or OR logical operator but not both of them together i.e. only one of the AND or OR operator can be used throughout the filter string and both the operators cannot be used together. No other logical operators are supported. At most three filter fields are allowed in the filter string and if provided more than that then INVALID_ARGUMENT error is returned by the API.

For example, consumer.operation_resource_name = \"projects/p1/locations/global/apis/a1/versions/v1/operations/o1\" OR supplier.operation_resource_name = \"projects/p1/locations/global/apis/a1/versions/v1/operations/o1\" - The dependencies with either consumer or supplier operation resource name as projects/p1/locations/global/apis/a1/versions/v1/operations/o1.

page_size

int32

Optional. The maximum number of dependency resources to return. The service may return fewer than this value. If unspecified, at most 50 dependencies will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListDependencies call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListDependencies must match the call that provided the page token.

ListDependenciesResponse

The ListDependencies method's response.

Fields
dependencies[]

Dependency

The dependency resources present in the API hub.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListDeploymentsRequest

The ListDeployments method's request.

Fields
parent

string

Required. The parent, which owns this collection of deployment resources. Format: projects/{project}/locations/{location}

filter

string

Optional. An expression that filters the list of Deployments.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string. The comparison operator must be one of: <, > or =. Filters are not case sensitive.

The following fields in the Deployments are eligible for filtering:

  • display_name - The display name of the Deployment. Allowed comparison operators: =.
  • create_time - The time at which the Deployment was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format. Allowed comparison operators: > and <.
  • resource_uri - A URI to the deployment resource. Allowed comparison operators: =.
  • api_versions - The API versions linked to this deployment. Allowed comparison operators: :.
  • deployment_type.enum_values.values.id - The allowed value id of the deployment_type attribute associated with the Deployment. Allowed comparison operators: :.
  • deployment_type.enum_values.values.display_name - The allowed value display name of the deployment_type attribute associated with the Deployment. Allowed comparison operators: :.
  • slo.string_values.values -The allowed string value of the slo attribute associated with the deployment. Allowed comparison operators: :.
  • environment.enum_values.values.id - The allowed value id of the environment attribute associated with the deployment. Allowed comparison operators: :.
  • environment.enum_values.values.display_name - The allowed value display name of the environment attribute associated with the deployment. Allowed comparison operators: :.

Expressions are combined with either AND logic operator or OR logical operator but not both of them together i.e. only one of the AND or OR operator can be used throughout the filter string and both the operators cannot be used together. No other logical operators are supported. At most three filter fields are allowed in the filter string and if provided more than that then INVALID_ARGUMENT error is returned by the API.

Here are a few examples:

  • environment.enum_values.values.id: staging-id - The allowed value id of the environment attribute associated with the Deployment is staging-id.
  • environment.enum_values.values.display_name: \"Staging Deployment\" - The allowed value display name of the environment attribute associated with the Deployment is Staging Deployment.
  • environment.enum_values.values.id: production-id AND create_time < \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\" - The allowed value id of the environment attribute associated with the Deployment is production-id and Deployment was created before 2021-08-15 14:50:00 UTC and after 2021-08-10 12:00:00 UTC.
  • environment.enum_values.values.id: production-id OR slo.string_values.values: \"99.99%\"
  • The allowed value id of the environment attribute Deployment is production-id or string value of the slo attribute is 99.99%.
page_size

int32

Optional. The maximum number of deployment resources to return. The service may return fewer than this value. If unspecified, at most 50 deployments will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListDeployments call. Provide this to retrieve the subsequent page.

When paginating, all other parameters (except page_size) provided to ListDeployments must match the call that provided the page token.

ListDeploymentsResponse

The ListDeployments method's response.

Fields
deployments[]

Deployment

The deployment resources present in the API hub.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListExternalApisRequest

The ListExternalApis method's request.

Fields
parent

string

Required. The parent, which owns this collection of External API resources. Format: projects/{project}/locations/{location}

page_size

int32

Optional. The maximum number of External API resources to return. The service may return fewer than this value. If unspecified, at most 50 ExternalApis will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListExternalApis call. Provide this to retrieve the subsequent page.

When paginating, all other parameters (except page_size) provided to ListExternalApis must match the call that provided the page token.

ListExternalApisResponse

The ListExternalApis method's response.

Fields
external_apis[]

ExternalApi

The External API resources present in the API hub.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListHostProjectRegistrationsRequest

The ListHostProjectRegistrations method's request.

Fields
parent

string

Required. The parent, which owns this collection of host projects. Format: projects/*/locations/*

page_size

int32

Optional. The maximum number of host project registrations to return. The service may return fewer than this value. If unspecified, at most 50 host project registrations will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListHostProjectRegistrations call. Provide this to retrieve the subsequent page.

When paginating, all other parameters (except page_size) provided to ListHostProjectRegistrations must match the call that provided the page token.

filter

string

Optional. An expression that filters the list of HostProjectRegistrations.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string. All standard operators as documented at https://google.aip.dev/160 are supported.

The following fields in the HostProjectRegistration are eligible for filtering:

  • name - The name of the HostProjectRegistration.
  • create_time - The time at which the HostProjectRegistration was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format.
  • gcp_project - The Google cloud project associated with the HostProjectRegistration.
order_by

string

Optional. Hint for how to order the results.

ListHostProjectRegistrationsResponse

The ListHostProjectRegistrations method's response.

Fields
host_project_registrations[]

HostProjectRegistration

The list of host project registrations.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListRuntimeProjectAttachmentsRequest

The ListRuntimeProjectAttachments method's request.

Fields
parent

string

Required. The parent, which owns this collection of runtime project attachments. Format: projects/{project}/locations/{location}

page_size

int32

Optional. The maximum number of runtime project attachments to return. The service may return fewer than this value. If unspecified, at most 50 runtime project attachments will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListRuntimeProjectAttachments call. Provide this to retrieve the subsequent page.

When paginating, all other parameters (except page_size) provided to ListRuntimeProjectAttachments must match the call that provided the page token.

filter

string

Optional. An expression that filters the list of RuntimeProjectAttachments.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string. All standard operators as documented at https://google.aip.dev/160 are supported.

The following fields in the RuntimeProjectAttachment are eligible for filtering:

  • name - The name of the RuntimeProjectAttachment.
  • create_time - The time at which the RuntimeProjectAttachment was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format.
  • runtime_project - The Google cloud project associated with the RuntimeProjectAttachment.
order_by

string

Optional. Hint for how to order the results.

ListRuntimeProjectAttachmentsResponse

The ListRuntimeProjectAttachments method's response.

Fields
runtime_project_attachments[]

RuntimeProjectAttachment

List of runtime project attachments.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListSpecsRequest

The [ListSpecs][ListSpecs] method's request.

Fields
parent

string

Required. The parent, which owns this collection of specs. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}

filter

string

Optional. An expression that filters the list of Specs.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string. The comparison operator must be one of: <, >, : or =. Filters are not case sensitive.

The following fields in the Spec are eligible for filtering:

  • display_name - The display name of the Spec. Allowed comparison operators: =.
  • create_time - The time at which the Spec was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format. Allowed comparison operators: > and <.
  • spec_type.enum_values.values.id - The allowed value id of the spec_type attribute associated with the Spec. Allowed comparison operators: :.
  • spec_type.enum_values.values.display_name - The allowed value display name of the spec_type attribute associated with the Spec. Allowed comparison operators: :.
  • lint_response.json_values.values - The json value of the lint_response attribute associated with the Spec. Allowed comparison operators: :.
  • mime_type - The MIME type of the Spec. Allowed comparison operators: =.

Expressions are combined with either AND logic operator or OR logical operator but not both of them together i.e. only one of the AND or OR operator can be used throughout the filter string and both the operators cannot be used together. No other logical operators are supported. At most three filter fields are allowed in the filter string and if provided more than that then INVALID_ARGUMENT error is returned by the API.

Here are a few examples:

  • spec_type.enum_values.values.id: rest-id - The filter string specifies that the id of the allowed value associated with the spec_type attribute is rest-id.
  • spec_type.enum_values.values.display_name: \"Rest Display Name\" - The filter string specifies that the display name of the allowed value associated with the spec_type attribute is Rest Display Name.
  • spec_type.enum_values.values.id: grpc-id AND create_time < \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\" - The id of the allowed value associated with the spec_type attribute is grpc-id and the spec was created before 2021-08-15 14:50:00 UTC and after 2021-08-10 12:00:00 UTC.
  • spec_type.enum_values.values.id: rest-id OR spec_type.enum_values.values.id: grpc-id
  • The id of the allowed value associated with the spec_type attribute is rest-id or grpc-id.
page_size

int32

Optional. The maximum number of specs to return. The service may return fewer than this value. If unspecified, at most 50 specs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListSpecs call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListSpecs must match the call that provided the page token.

ListSpecsResponse

The ListSpecs method's response.

Fields
specs[]

Spec

The specs corresponding to an API Version.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListVersionsRequest

The ListVersions method's request.

Fields
parent

string

Required. The parent which owns this collection of API versions i.e., the API resource Format: projects/{project}/locations/{location}/apis/{api}

filter

string

Optional. An expression that filters the list of Versions.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: <, > or =. Filters are not case sensitive.

The following fields in the Version are eligible for filtering:

  • display_name - The display name of the Version. Allowed comparison operators: =.
  • create_time - The time at which the Version was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format. Allowed comparison operators: > and <.
  • lifecycle.enum_values.values.id - The allowed value id of the lifecycle attribute associated with the Version. Allowed comparison operators: :.
  • lifecycle.enum_values.values.display_name - The allowed value display name of the lifecycle attribute associated with the Version. Allowed comparison operators: :.
  • compliance.enum_values.values.id - The allowed value id of the compliances attribute associated with the Version. Allowed comparison operators: :.
  • compliance.enum_values.values.display_name - The allowed value display name of the compliances attribute associated with the Version. Allowed comparison operators: :.
  • accreditation.enum_values.values.id - The allowed value id of the accreditations attribute associated with the Version. Allowed comparison operators: :.
  • accreditation.enum_values.values.display_name - The allowed value display name of the accreditations attribute associated with the Version. Allowed comparison operators: :.

Expressions are combined with either AND logic operator or OR logical operator but not both of them together i.e. only one of the AND or OR operator can be used throughout the filter string and both the operators cannot be used together. No other logical operators are supported. At most three filter fields are allowed in the filter string and if provided more than that then INVALID_ARGUMENT error is returned by the API.

Here are a few examples:

  • lifecycle.enum_values.values.id: preview-id - The filter string specifies that the id of the allowed value associated with the lifecycle attribute of the Version is preview-id.
  • lifecycle.enum_values.values.display_name: \"Preview Display Name\" - The filter string specifies that the display name of the allowed value associated with the lifecycle attribute of the Version is Preview Display Name.
  • lifecycle.enum_values.values.id: preview-id AND create_time < \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\" - The id of the allowed value associated with the lifecycle attribute of the Version is preview-id and it was created before 2021-08-15 14:50:00 UTC and after 2021-08-10 12:00:00 UTC.
  • compliance.enum_values.values.id: gdpr-id OR compliance.enum_values.values.id: pci-dss-id
  • The id of the allowed value associated with the compliance attribute is gdpr-id or pci-dss-id.
page_size

int32

Optional. The maximum number of versions to return. The service may return fewer than this value. If unspecified, at most 50 versions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

page_token

string

Optional. A page token, received from a previous ListVersions call. Provide this to retrieve the subsequent page.

When paginating, all other parameters (except page_size) provided to ListVersions must match the call that provided the page token.

ListVersionsResponse

The ListVersions method's response.

Fields
versions[]

Version

The versions corresponding to an API.

next_page_token

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

LookupApiHubInstanceRequest

The LookupApiHubInstance method's request.

Fields
parent

string

Required. There will always be only one Api Hub instance for a Google Cloud project across all locations. The parent resource for the Api Hub instance resource. Format: projects/{project}/locations/{location}

LookupApiHubInstanceResponse

The LookupApiHubInstance method's response.`

Fields
api_hub_instance

ApiHubInstance

API Hub instance for a project if it exists, empty otherwise.

LookupRuntimeProjectAttachmentRequest

The LookupRuntimeProjectAttachment method's request.

Fields
name

string

Required. Runtime project ID to look up runtime project attachment for. Lookup happens across all regions. Expected format: projects/{project}/locations/{location}.

LookupRuntimeProjectAttachmentResponse

The ListRuntimeProjectAttachments method's response.

Fields
runtime_project_attachment

RuntimeProjectAttachment

Runtime project attachment for a project if exists, empty otherwise.

OpenApiSpecDetails

OpenApiSpecDetails contains the details parsed from an OpenAPI spec in addition to the fields mentioned in SpecDetails.

Fields
format

Format

Output only. The format of the spec.

version

string

Output only. The version in the spec. This maps to info.version in OpenAPI spec.

owner

Owner

Output only. Owner details for the spec. This maps to info.contact in OpenAPI spec.

Format

Enumeration of spec formats.

Enums
FORMAT_UNSPECIFIED SpecFile type unspecified.
OPEN_API_SPEC_2_0 OpenAPI Spec v2.0.
OPEN_API_SPEC_3_0 OpenAPI Spec v3.0.
OPEN_API_SPEC_3_1 OpenAPI Spec v3.1.

OperationDetails

The operation details parsed from the spec.

Fields
description

string

Output only. Description of the operation behavior. For OpenAPI spec, this will map to operation.description in the spec, in case description is empty, operation.summary will be used.

documentation

Documentation

Output only. Additional external documentation for this operation. For OpenAPI spec, this will map to operation.documentation in the spec.

deprecated

bool

Output only. For OpenAPI spec, this will be set if operation.deprecatedis marked as true in the spec.

Union field operation.

operation can be only one of the following:

http_operation

HttpOperation

The HTTP Operation.

OperationMetadata

Represents the metadata of the long-running operation.

Fields
create_time

Timestamp

Output only. The time the operation was created.

end_time

Timestamp

Output only. The time the operation finished running.

target

string

Output only. Server-defined resource path for the target of the operation.

verb

string

Output only. Name of the verb executed by the operation.

status_message

string

Output only. Human-readable status of the operation, if any.

requested_cancellation

bool

Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have [Operation.error][] value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED.

api_version

string

Output only. API version used to start the operation.

Owner

Owner details.

Fields
display_name

string

Optional. The name of the owner.

email

string

Required. The email of the owner.

Path

The path details derived from the spec.

Fields
path

string

Output only. Complete path relative to server endpoint.

description

string

Output only. A short description for the path applicable to all operations.

Plugin

A plugin resource in the API Hub.

Fields
name

string

Identifier. The name of the plugin. Format: projects/{project}/locations/{location}/plugins/{plugin}

display_name

string

Required. The display name of the plugin. Max length is 50 characters (Unicode code points).

type

AttributeValues

Required. The type of the API. This maps to the following system defined attribute: projects/{project}/locations/{location}/attributes/system-plugin-type attribute. The number of allowed values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API. All values should be from the list of allowed values defined for the attribute.

description

string

Optional. The plugin description. Max length is 2000 characters (Unicode code points).

state

State

Output only. Represents the state of the plugin.

State

Possible states a plugin can have. Note that this enum may receive new values in the future. Consumers are advised to always code against the enum values expecting new states can be added later on.

Enums
STATE_UNSPECIFIED The default value. This value is used if the state is omitted.
ENABLED The plugin is enabled.
DISABLED The plugin is disabled.

Point

Point within the file (line and character).

Fields
line

int32

Required. Line number (zero-indexed).

character

int32

Required. Character position within the line (zero-indexed).

Range

Object describing where in the file the issue was found.

Fields
start

Point

Required. Start of the issue.

end

Point

Required. End of the issue.

RuntimeProjectAttachment

Runtime project attachment represents an attachment from the runtime project to the host project. Api Hub looks for deployments in the attached runtime projects and creates corresponding resources in Api Hub for the discovered deployments.

Fields
name

string

Identifier. The resource name of a runtime project attachment. Format: "projects/{project}/locations/{location}/runtimeProjectAttachments/{runtime_project_attachment}".

runtime_project

string

Required. Immutable. Google cloud project name in the format: "projects/abc" or "projects/123". As input, project name with either project id or number are accepted. As output, this field will contain project number.

create_time

Timestamp

Output only. Create time.

Schema

The schema details derived from the spec. Currently, this entity is supported for OpenAPI spec only. For OpenAPI spec, this maps to the schema defined in the definitions section for OpenAPI 2.0 version and in components.schemas section for OpenAPI 3.0 and 3.1 version.

Fields
display_name

string

Output only. The display name of the schema. This will map to the name of the schema in the spec.

raw_value

bytes

Output only. The raw value of the schema definition corresponding to the schema name in the spec.

SearchResourcesRequest

The SearchResources method's request.

Fields
location

string

Required. The resource name of the location which will be of the type projects/{project_id}/locations/{location_id}. This field is used to identify the instance of API-Hub in which resources should be searched.

query

string

Required. The free text search query. This query can contain keywords which could be related to any detail of the API-Hub resources such display names, descriptions, attributes etc.

filter

string

Optional. An expression that filters the list of search results.

A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be =. Filters are not case sensitive.

The following field names are eligible for filtering: * resource_type - The type of resource in the search results. Must be one of the following: Api, ApiOperation, Deployment, Definition, Spec or Version. This field can only be specified once in the filter.

Here are is an example:

  • resource_type = Api - The resource_type is Api.
page_size

int32

Optional. The maximum number of search results to return. The service may return fewer than this value. If unspecified at most 10 search results will be returned. If value is negative then INVALID_ARGUMENT error is returned. The maximum value is 25; values above 25 will be coerced to 25. While paginating, you can specify a new page size parameter for each page of search results to be listed.

page_token

string

Optional. A page token, received from a previous [SearchResources][SearchResources] call. Specify this parameter to retrieve the next page of transactions.

When paginating, you must specify the page_token parameter and all the other parameters except page_size should be specified with the same value which was used in the previous call. If the other fields are set with a different value than the previous call then INVALID_ARGUMENT error is returned.

SearchResourcesResponse

Response for the SearchResources method.

Fields
search_results[]

SearchResult

List of search results according to the filter and search query specified. The order of search results represents the ranking.

next_page_token

string

Pass this token in the SearchResourcesRequest to continue to list results. If all results have been returned, this field is an empty string or not present in the response.

SearchResult

Represents the search results.

Fields
resource

ApiHubResource

This represents the ApiHubResource. Note: Only selected fields of the resources are populated in response.

Severity

Severity of the issue.

Enums
SEVERITY_UNSPECIFIED Severity unspecified.
SEVERITY_ERROR Severity error.
SEVERITY_WARNING Severity warning.
SEVERITY_INFO Severity info.
SEVERITY_HINT Severity hint.

Spec

Represents a spec associated with an API version in the API Hub. Note that specs of various types can be uploaded, however parsing of details is supported for OpenAPI spec currently.

Fields
name

string

Identifier. The name of the spec.

Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}

display_name

string

Required. The display name of the spec. This can contain the file name of the spec.

spec_type

AttributeValues

Required. The type of spec. The value should be one of the allowed values defined for projects/{project}/locations/{location}/attributes/system-spec-type attribute. The number of values for this attribute will be based on the cardinality of the attribute. The same can be retrieved via GetAttribute API.

Note, this field is mandatory if content is provided.

contents

SpecContents

Optional. Input only. The contents of the uploaded spec.

details

SpecDetails

Output only. Details parsed from the spec.

source_uri

string

Optional. The URI of the spec source in case file is uploaded from an external version control system.

create_time

Timestamp

Output only. The time at which the spec was created.

update_time

Timestamp

Output only. The time at which the spec was last updated.

lint_response

LintResponse

Optional. The lint response for the spec.

attributes

map<string, AttributeValues>

Optional. The list of user defined attributes associated with the spec. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

documentation

Documentation

Optional. The documentation of the spec. For OpenAPI spec, this will be populated from externalDocs in OpenAPI spec.

parsing_mode

ParsingMode

Optional. Input only. Enum specifying the parsing mode for OpenAPI Specification (OAS) parsing.

ParsingMode

Specifies the parsing mode for API specifications during creation and update. - RELAXED: Parsing errors in the specification content do not fail the API call. - STRICT: Parsing errors in the specification content result in failure of the API call. If not specified, defaults to RELAXED.

Enums
PARSING_MODE_UNSPECIFIED Defaults to RELAXED.
RELAXED Parsing of the Spec on create and update is relaxed, meaning that parsing errors the spec contents will not fail the API call.
STRICT Parsing of the Spec on create and update is strict, meaning that parsing errors in the spec contents will fail the API call.

SpecContents

The spec contents.

Fields
contents

bytes

Required. The contents of the spec.

mime_type

string

Required. The mime type of the content for example application/json, application/yaml, application/wsdl etc.

SpecDetails

SpecDetails contains the details parsed from supported spec types.

Fields
description

string

Output only. The description of the spec.

Union field details.

details can be only one of the following:

open_api_spec_details

OpenApiSpecDetails

Output only. Additional details apart from OperationDetails parsed from an OpenAPI spec. The OperationDetails parsed from the spec can be obtained by using ListAPIOperations method.

StyleGuide

Represents a singleton style guide resource to be used for linting Open API specs.

Fields
name

string

Identifier. The name of the style guide.

Format: projects/{project}/locations/{location}/plugins/{plugin}/styleGuide

linter

Linter

Required. Target linter for the style guide.

contents

StyleGuideContents

Required. Input only. The contents of the uploaded style guide.

StyleGuideContents

The style guide contents.

Fields
contents

bytes

Required. The contents of the style guide.

mime_type

string

Required. The mime type of the content.

UpdateApiRequest

The UpdateApi method's request.

Fields
api

Api

Required. The API resource to update.

The API resource's name field is used to identify the API resource to update. Format: projects/{project}/locations/{location}/apis/{api}

update_mask

FieldMask

Required. The list of fields to update.

UpdateAttributeRequest

The UpdateAttribute method's request.

Fields
attribute

Attribute

Required. The attribute to update.

The attribute's name field is used to identify the attribute to update. Format: projects/{project}/locations/{location}/attributes/{attribute}

update_mask

FieldMask

Required. The list of fields to update.

UpdateDependencyRequest

The UpdateDependency method's request.

Fields
dependency

Dependency

Required. The dependency resource to update.

The dependency's name field is used to identify the dependency to update. Format: projects/{project}/locations/{location}/dependencies/{dependency}

update_mask

FieldMask

Required. The list of fields to update.

UpdateDeploymentRequest

The UpdateDeployment method's request.

Fields
deployment

Deployment

Required. The deployment resource to update.

The deployment resource's name field is used to identify the deployment resource to update. Format: projects/{project}/locations/{location}/deployments/{deployment}

update_mask

FieldMask

Required. The list of fields to update.

UpdateExternalApiRequest

The UpdateExternalApi method's request.

Fields
external_api

ExternalApi

Required. The External API resource to update.

The External API resource's name field is used to identify the External API resource to update. Format: projects/{project}/locations/{location}/externalApis/{externalApi}

update_mask