All Products
Search
Document Center

Microservices Engine:GetPluginConfig

Last Updated:Aug 12, 2024

Obtains plug-in configurations.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
mse:GetPluginConfigget
  • Gateway
    acs:mse:{#regionId}:{#accountId}:instance/{#GatewayUniqueId}
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
GatewayUniqueIdstringYes

The unique ID of the gateway.

gw-ubuwqygbq4783gqb2y3f87q****
PluginIdlongYes

The ID of the gateway plug-in.

123
AcceptLanguagestringNo

The language of the response. Valid values:

zh: Chinese en: English

zh

Response parameters

ParameterTypeDescriptionExample
object

RestResult

RequestIdstring

The ID of the request.

03A3E2F4-6804-5663-9D5D-2EC47A1*****
Successboolean

Indicates whether the request is successful.

true
Codeinteger

The status code returned.

200
ErrorCodestring

The error code returned if the request failed.

500
HttpStatusCodeinteger

The HTTP status code returned.

200
Messagestring

The message returned.

success
DynamicCodestring

The dynamic error code.

code
DynamicMessagestring

The dynamic error message.

message
Dataobject

The returned data.

Idlong

The ID of the plug-in.

1
PrimaryUserstring

The ID of the creator.

123
Typeinteger

The type.

0
Categoryinteger

The category of the plug-in. Valid values:

0: user-defined

1: permission authentication

2: security protection

3: transmission protocol

4: traffic control

5: traffic observation

0
Namestring

The name of the plug-in.

name
Versionstring

The version of the plug-in.

v1
Summarystring

The summary of the plug-in.

This is a plug-in.
Readmestring

The description of the README file.

read me
ReadmeEnstring

The description of the README file that is edited in English.

read me
Phaseinteger

The execution stage of the plug-in. Valid values:

0: default stage

1: authorization stage

2: authentication stage

3: statistics stage

0
Priorityinteger

The execution priority of the plug-in. A larger value indicates a higher priority.

1
ConfigCheckstring

The information about the plug-in configuration used for checking.

\# The configuration includes the fields required for checking, such as name, age, and friends. Sample configuration: name: John age: 18 friends: - David - Anne
Modeinteger

The mode.

0
WasmLanginteger

The WebAssembly language. Valid values:

0: C++

1: TinyGo

2: Rust

3: AssemblyScript

4: Zig

0
ImageNamestring

The name of the image.

name
PublishStateinteger

The publish status.

1
Statusstring

Indicates whether the plug-in is enabled. Valid values:

0: disabled

1: enabled

1
GatewayConfigListarray<object>

The list of gateway plug-in configurations.

object

The data object.

Idlong

The ID of the plug-in configuration.

1
GatewayIdlong

The ID of the gateway.

1
GatewayUniqueIdstring

The unique ID of the gateway.

gw-ubuwqygbq4783gqb2y3f87q****
PluginIdlong

The ID of the gateway plug-in.

1
Enableboolean

Indicates whether the plug-in is enabled.

true
Configstring

The plug-in configuration.

\# Configure a check for the required fields of the plug-in, such as name, age, and friends. Sample configuration: name: John age: 18 friends: - David - Anne
ConfigLevelinteger

The application scope of the plug-in. Valid values:

0: global

1: domain names

2: routes

0
GmtCreatestring

The creation time.

1667309705000
GmtModifiedstring

The update time.

1667309705000

Examples

Sample success responses

JSONformat

{
  "RequestId": "03A3E2F4-6804-5663-9D5D-2EC47A1*****",
  "Success": true,
  "Code": 200,
  "ErrorCode": "500",
  "HttpStatusCode": 200,
  "Message": "success",
  "DynamicCode": "code",
  "DynamicMessage": "message",
  "Data": {
    "Id": 1,
    "PrimaryUser": "123",
    "Type": 0,
    "Category": 0,
    "Name": "name",
    "Version": "v1",
    "Summary": "This is a plug-in.\n",
    "Readme": "read me",
    "ReadmeEn": "read me",
    "Phase": 0,
    "Priority": 1,
    "ConfigCheck": "\\# The configuration includes the fields required for checking, such as name, age, and friends. Sample configuration: name: John age: 18 friends: - David - Anne\n",
    "Mode": 0,
    "WasmLang": 0,
    "ImageName": "name",
    "PublishState": 1,
    "Status": "1",
    "GatewayConfigList": [
      {
        "Id": 1,
        "GatewayId": 1,
        "GatewayUniqueId": "gw-ubuwqygbq4783gqb2y3f87q****",
        "PluginId": 1,
        "Enable": true,
        "Config": "\\# Configure a check for the required fields of the plug-in, such as name, age, and friends. Sample configuration: name: John age: 18 friends: - David - Anne\n",
        "ConfigLevel": 0,
        "GmtCreate": "1667309705000",
        "GmtModified": "1667309705000"
      }
    ],
    "VersionJson": ""
  }
}

Error codes

HTTP status codeError codeError messageDescription
400duplicatedClusterAliasNameduplicated cluster alias nameThe instance name is duplicate. User another name.
400illegalRequestillegal request:%sInvalid request: %s
403NoPermissionYou are not authorized to perform this operation:%sYou do not have the permission to use this interface:%s
404clusterNotFoundcluster not foundThe cluster is not found.
500systemErrorsystem errorAn error occurred on the system. Try again later.

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

Change history

Change timeSummary of changesOperation
2024-06-03The response structure of the API has changedView Change Details
2023-05-18The internal configuration of the API is changed, but the call is not affectedView Change Details