All Products
Search
Document Center

ApsaraMQ for MQTT:AddCustomAuthConnectBlack

Last Updated:Aug 22, 2024

Adds a device to the connection blacklist to disable connections from the device.

Debugging

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

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdstringYes

The ID of the ApsaraMQ for MQTT instance.

mqtt-cn-i7m26mf****
ClientIdstringYes

The client ID of the device whose connections you want to disable.

GID_test@@@test

Response parameters

ParameterTypeDescriptionExample
object

The schema object.

RequestIdstring

The request ID.

82B9E503-F4A1-4F30-976F-C6999FF9****
Codeinteger

The HTTP status code. The value 200 indicates that the request is successful.

200
Successboolean

Indicates whether the operation is successful. Valid values: true and false.

True
Messagestring

The message returned.

operation success.

Examples

Sample success responses

JSONformat

{
  "RequestId": "82B9E503-F4A1-4F30-976F-C6999FF9****",
  "Code": 200,
  "Success": true,
  "Message": "operation success."
}

Error codes

HTTP status codeError codeError messageDescription
400InstancePermissionCheckFailedAn error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.-
400InvalidParameter.%sAn error occurred while validating the parameter. The parameter may be missing or invalid.-
400Customauth.over.capacityOver custom auth capacity.User-defined permission quantity capacity exceeds the limit
404ApiNotSupportThe specified API is not supported.-

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