gcloud apihub plugins create

NAME: gcloud apihub plugins create - create a Plugin
SYNOPSIS: gcloud apihub plugins create (PLUGIN : --location=LOCATION) --display-name=DISPLAY_NAME [--actions-config=[description=DESCRIPTION],[displayName=DISPLAYNAME],[id=ID],[triggerMode=TRIGGERMODE]] [--description=DESCRIPTION] [--documentation-external-uri=DOCUMENTATION_EXTERNAL_URI] [--gateway-type=GATEWAY_TYPE] [--hosting-service-uri=HOSTING_SERVICE_URI] [--plugin-category=PLUGIN_CATEGORY] [--auth-config-template-supported-types=[AUTH_CONFIG_TEMPLATE_SUPPORTED_TYPES,…] --config-template-additional=[description=DESCRIPTION],[enumOptions=ENUMOPTIONS],[id=ID],[multiSelectOptions=MULTISELECTOPTIONS],[required=REQUIRED],[validationRegex=VALIDATIONREGEX],[valueType=VALUETYPE]] [--enum-values=[description=DESCRIPTION],[displayName=DISPLAYNAME],[id=ID],[immutable=IMMUTABLE] | --json-values=[JSON_VALUES,…] | --string-values=[STRING_VALUES,…] | --uri-values=[URI_VALUES,…]] [GCLOUD_WIDE_FLAG …]
DESCRIPTION: Create a plugin
Note: The positional argument for Plugin ID is currently not supported. Please use the --plugin flag to specify the Plugin ID.
EXAMPLES: To create a plugin with the ID my-plugin, run:
gcloud apihub plugins create --plugin=my-plugin --display-name="My Plugin" --type=apigee --project=my-project --location=us-central1
POSITIONAL ARGUMENTS: Plugin resource - Identifier. The name of the plugin. Format: projects/{project}/locations/{location}/plugins/{plugin} The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.
To set the project attribute:

provide the argument plugin on the command line with a fully specified name;

provide the argument --project on the command line;

set the property core/project.

This must be specified.

PLUGIN

ID of the plugin or fully qualified identifier for the plugin.
To set the plugin attribute:

provide the argument plugin on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION

The location id of the plugin resource.
To set the location attribute:

provide the argument plugin on the command line with a fully specified name;

provide the argument --location on the command line.
REQUIRED FLAGS: --display-name=DISPLAY_NAME

The display name of the plugin. Max length is 50 characters (Unicode code points).
OPTIONAL FLAGS: --actions-config=[description=DESCRIPTION],[displayName=DISPLAYNAME],[id=ID],[triggerMode=TRIGGERMODE]

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.

description

The description of the operation performed by the action.

displayName

The display name of the action.

id

The id of the action.

triggerMode

The trigger mode supported by the action.

Shorthand Example:
--actions-config=description=string,displayName=string,id=string,triggerMode=string --actions-config=description=string,displayName=string,id=string,triggerMode=string

JSON Example:
--actions-config='[{"description": "string", "displayName": "string", "id": "string", "triggerMode": "string"}]'

File Example:
--actions-config=path_to_file.(yaml|json)

--description=DESCRIPTION

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

Documentation details.

--documentation-external-uri=DOCUMENTATION_EXTERNAL_URI

The uri of the externally hosted documentation.

--gateway-type=GATEWAY_TYPE

The type of the gateway. GATEWAY_TYPE must be one of:

api-discovery

The gateway type is API Discovery.

apigee-edge-private-cloud

The gateway type is Apigee Edge Private Cloud.

apigee-edge-public-cloud

The gateway type is Apigee Edge Public Cloud.

apigee-x-and-hybrid

The gateway type is Apigee X and Hybrid.

cloud-api-gateway

The gateway type is Cloud API Gateway.

cloud-endpoints

The gateway type is Cloud Endpoints.

others

The gateway type for any other types of gateways.

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

--hosting-service-uri=HOSTING_SERVICE_URI

The URI of the service implemented by the plugin developer, used to invoke the plugin's functionality. This information is only required for user defined plugins.

--plugin-category=PLUGIN_CATEGORY

The category of the plugin, identifying its primary category or purpose. This field is required for all plugins. PLUGIN_CATEGORY must be one of:

api-gateway

API_GATEWAY plugins represent plugins built for API Gateways like Apigee.

api-producer

API_PRODUCER plugins represent plugins built for API Producers like Cloud Run, Application Integration etc.

ConfigTemplate represents the configuration template for a plugin.

AuthConfigTemplate represents the authentication template for a plugin.

--auth-config-template-supported-types=[AUTH_CONFIG_TEMPLATE_SUPPORTED_TYPES,…]

The list of authentication types supported by the plugin. AUTH_CONFIG_TEMPLATE_SUPPORTED_TYPES must be one of:

api-key

API Key authentication.

google-service-account

Google service account authentication.

no-auth

No authentication.

oauth2-client-credentials

Oauth 2.0 client credentials grant authentication.

user-password

Username and password authentication.

--config-template-additional=[description=DESCRIPTION],[enumOptions=ENUMOPTIONS],[id=ID],[multiSelectOptions=MULTISELECTOPTIONS],[required=REQUIRED],[validationRegex=VALIDATIONREGEX],[valueType=VALUETYPE]

The list of additional configuration variables for the plugin's configuration.

description

Description.

enumOptions

Enum options. To be populated if ValueType is ENUM.

description

Description of the option.

displayName

Display name of the option.

id

Id of the option.

id

ID of the config variable. Must be unique within the configuration.

multiSelectOptions

Multi select options. To be populated if ValueType is MULTI_SELECT.

description

Description of the option.

displayName

Display name of the option.

id

Id of the option.

required

Flag represents that this ConfigVariable must be provided for a PluginInstance.

validationRegex

Regular expression in RE2 syntax used for validating the value of a ConfigVariable.

valueType

Type of the parameter: string, int, bool etc.

Shorthand Example:
--config-template-additional=description=string,enumOptions=[{description=string,displayName=string,id=string}],id=string,multiSelectOptions=[{description=string,displayName=string,id=string}],required=boolean,validationRegex=string,valueType=string --config-template-additional=description=string,enumOptions=[{description=string,displayName=string,id=string}],id=string,multiSelectOptions=[{description=string,displayName=string,id=string}],required=boolean,validationRegex=string,valueType=string

JSON Example:
--config-template-additional='[{"description": "string", "enumOptions": [{"description": "string", "displayName": "string", "id": "string"}], "id": "string", "multiSelectOptions": [{"description": "string", "displayName": "string", "id": "string"}], "required": boolean, "validationRegex": "string", "valueType": "string"}]'

File Example:
--config-template-additional=path_to_file.(yaml|json)

The attribute values associated with resource.

Arguments for the Value.
At most one of these can be specified:

The attribute values of data type enum.

--enum-values=[description=DESCRIPTION],[displayName=DISPLAYNAME],[id=ID],[immutable=IMMUTABLE]

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

description

The detailed description of the allowed value.

displayName

The display name of the allowed value.

id

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]-/.

immutable

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

Shorthand Example:
--enum-values=description=string,displayName=string,id=string,immutable=boolean --enum-values=description=string,displayName=string,id=string,immutable=boolean

JSON Example:
--enum-values='[{"description": "string", "displayName": "string", "id": "string", "immutable": boolean}]'

File Example:
--enum-values=path_to_file.(yaml|json)

The attribute values of data type string or JSON.

--json-values=[JSON_VALUES,…]

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

The attribute values of data type string or JSON.

--string-values=[STRING_VALUES,…]

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

The attribute values of data type string or JSON.

--uri-values=[URI_VALUES,…]

The attribute values in case attribute data type is string or JSON.
GCLOUD WIDE FLAGS: These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE: This command uses the apihub/v1 API. The full documentation for this API can be found at: https://cloud.google.com/apigee/docs/api-hub/what-is-api-hub
NOTES: This variant is also available:
gcloud alpha apihub plugins create

gcloud apihub plugins create Stay organized with collections Save and categorize content based on your preferences.

gcloud apihub plugins create