All Products
Search
Document Center

API Gateway:CreatePlugin

Last Updated:Oct 19, 2024

Creates a plug-in.

Operation description

  • This operation is intended for API providers.
  • The number of plug-ins of the same type that each user can create is limited. Different limits apply to different plug-in types.
  • The plug-in definitions for advanced features are restricted.
  • Plug-ins must be bound to APIs to take effect. After a plug-in is bound, it takes effect on that API immediately.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
PluginNamestringYes

The name of the plug-in. The name must be 4 to 50 characters in length and can contain letters, digits, and underscores (_). However, it cannot start with an underscore.

NewCors
PluginTypestringYes

The type of the plug-in. Valid values:

  • ipControl: IP address-based access control
  • trafficControl: throttling
  • backendSignature: backend signature
  • jwtAuth :JWT (OpenId Connect) authentication
  • cors :cross-origin resource sharing (CORS)
  • caching
cors
PluginDatastringYes

The plug-in definition. Supported formats: JSON and YAML.

Plugin definition
DescriptionstringNo

The description of the plug-in. The description can contain a maximum of 200 characters in length.

createPlugin
Tagarray<object>No

The tag of objects that match the rule. You can specify multiple tags.

Key, Value
objectNo
KeystringYes

The key of the tag.

N can be an integer from 1 to 20.``

env
ValuestringYes

The value of the tag.

N can be an integer from 1 to 20.``

' '

Response parameters

ParameterTypeDescriptionExample
object
PluginIdstring

The ID of the plug-in.

1f3bde29b43d4d53989248327ff737f2
TagStatusboolean

Indicates whether the plug-in is successfully marked.

true
RequestIdstring

The ID of the request.

EF924FE4-2EDD-4CD3-89EC-34E4708574E7

Examples

Sample success responses

JSONformat

{
  "PluginId": "1f3bde29b43d4d53989248327ff737f2",
  "TagStatus": true,
  "RequestId": "EF924FE4-2EDD-4CD3-89EC-34E4708574E7"
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history