Class Plugin (0.2.7)

Plugin(mapping=None, *, ignore_unknown_fields=False, **kwargs)

A plugin resource in the API Hub.

Attributes

Name Description
name str
Identifier. The name of the plugin. Format: projects/{project}/locations/{location}/plugins/{plugin}
display_name str
Required. The display name of the plugin. Max length is 50 characters (Unicode code points).
type_ google.cloud.apihub_v1.types.AttributeValues
Optional. 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. Note this field is not required for plugins developed via plugin framework.
description str
Optional. The plugin description. Max length is 2000 characters (Unicode code points).
state google.cloud.apihub_v1.types.Plugin.State
Output only. Represents the state of the plugin. Note this field will not be set for plugins developed via plugin framework as the state will be managed at plugin instance level.
ownership_type google.cloud.apihub_v1.types.Plugin.OwnershipType
Output only. The type of the plugin, indicating whether it is 'SYSTEM_OWNED' or 'USER_OWNED'.
hosting_service google.cloud.apihub_v1.types.Plugin.HostingService
Optional. This field is optional. It is used to notify the plugin hosting service for any lifecycle changes of the plugin instance and trigger execution of plugin instance actions in case of API hub managed actions. This field should be provided if the plugin instance lifecycle of the developed plugin needs to be managed from API hub. Also, in this case the plugin hosting service interface needs to be implemented. This field should not be provided if the plugin wants to manage plugin instance lifecycle events outside of hub interface and use plugin framework for only registering of plugin and plugin instances to capture the source of data into hub. Note, in this case the plugin hosting service interface is not required to be implemented. Also, the plugin instance lifecycle actions will be disabled from API hub's UI.
actions_config MutableSequence[google.cloud.apihub_v1.types.PluginActionConfig]
Optional. The configuration of actions supported by the plugin. **REQUIRED**: This field must be provided when creating or updating a Plugin. The server will reject requests if this field is missing.
documentation google.cloud.apihub_v1.types.Documentation
Optional. The documentation of the plugin, that explains how to set up and use the plugin.
plugin_category google.cloud.apihub_v1.types.PluginCategory
Optional. The category of the plugin, identifying its primary category or purpose. This field is required for all plugins.
config_template google.cloud.apihub_v1.types.Plugin.ConfigTemplate
Optional. The configuration template for the plugin.
create_time google.protobuf.timestamp_pb2.Timestamp
Output only. Timestamp indicating when the plugin was created.
update_time google.protobuf.timestamp_pb2.Timestamp
Output only. Timestamp indicating when the plugin was last updated.
gateway_type google.cloud.apihub_v1.types.GatewayType
Optional. The type of the gateway.

Classes

ConfigTemplate

ConfigTemplate(mapping=None, *, ignore_unknown_fields=False, **kwargs)

ConfigTemplate represents the configuration template for a plugin.

HostingService

HostingService(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The information related to the service implemented by the plugin developer, used to invoke the plugin's functionality.

OwnershipType

OwnershipType(value)

Ownership type of the plugin.

State

State(value)

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.