[PB] DeleteRecord2.0

Supported version: 3.50.0

Brief Introduction

Delete a record by using the specified primary key. If the record does not exist, an error message will be returned.

POST http://{Tcaplus_REST_URL}

Request Syntax

Http Request

#Tencent Cloud Console RESTful Endpoint, ip: 80, port: 80 by default
http://172.17.0.22
#TcaplusDB Local docker RESTful Endpoint, ip: 31001, port: 31001 by default
http://9.135.8.93:31001

Http Head

Name	Required or not	Limitations	Description
x-tcaplus-target	Yes	None	Tcaplus.DeleteRecord
x-tcaplus-version	Yes	None	Tcaplus3.50.0
x-tcaplus-app-id	Yes	None	Correspond to the app id number(aka, cluster access id)
x-tcaplus-zone-id	Yes	None	Correspond to the zone number (aka, table group id)
x-tcaplus-protocol-version	Yes	None	Correspond to the protocol version number, default 2.0
x-tcaplus-table-name	Yes	None	Correspond to the table name
x-tcaplus-pwd-md5	Yes	None	App password (aka, cluster access password), that is, the md5 value after the calculation
x-tcaplus-idl-type	Yes	None	protobuf
x-tcaplus-result-flag	No	None	0: No data will be returned after successful operation; 1: After the operation is successful, the data that is consistent with the request will be returned; 2: After the operation is successful, the data after this update operation will be returned; 3: After the operation is successful, the data before the tcapsvr operation will be returned
x-tcaplus-data-version-check	No		1: Detect the record version number. Only when the version number is the same as the server version number, the version number will automatically increase; 2: Do not detect the record version number, but force the client record version number to be written to the server; 3: Do not detect the record version number, and automatically increase the server version number
x-tcaplus-data-version	No		Version number

Example:

x-tcaplus-target:Tcaplus.DeleteRecord
x-tcaplus-app-id:3
x-tcaplus-zone-id:1
x-tcaplus-protocol-version:2.0
x-tcaplus-table-name:game_players
x-tcaplus-pwd-md5:4e81984efccfb4982333aeb1ff7968d5
x-tcaplus-result-flag:3
x-tcaplus-version:Tcaplus3.50.0
x-tcaplus-data-version-check: 3
x-tcaplus-idl-type:protobuf

Data

Use json format to represent the record related information. Parameter description:

Record: Required. It specifies the record data, including all primary key fields

Example:

{
    "Record": {
        "player_id":4,
        "player_name":"4",
        "player_email":"4"
    }
}

Complete Request Example

curl -i -XPOST -H 'x-tcaplus-target: Tcaplus.DeleteRecord' -H 'x-tcaplus-app-id: 70' -H 'x-tcaplus-zone-id: 1' -H 'x-tcaplus-protocol-version: 2.0' -H 'x-tcaplus-table-name: game_players' -H 'x-tcaplus-pwd-md5: 0972ad76decf4d11a69e2e0d9af335da' -H 'x-tcaplus-result-flag: 2' -H 'x-tcaplus-version: Tcaplus3.50.0' -H 'x-tcaplus-data-version-check: 2' -H 'x-tcaplus-idl-type: protobuf' http://172.17.32.17 -d '{

    "Record": {
        "player_id":4,
        "player_name":"4",
        "player_email":"4"
    }
}'

Return Syntax

Return Parameter Description

Parameter name	Description
Parameter name	Description
ErrorCode	Return code
ErrorMsg	Return message
Record	Number of successful records

Return Example

Successful Return Example

{
    "ErrorCode": 0,
    "ErrorMsg": "Succeed",
    "RecordVersion": 1,
    "Record": {
        "player_id": 4,
        "player_name": "4",
        "player_email": "4",
        "game_server_id": 4,
        "login_timestamp": [],
        "logout_timestamp": [],
        "is_online": false,
        "pay": {
            "pay_id": 4,
            "amount": 4,
            "method": 4
        }
    }
}

Failed Return Example

{
    "ErrorCode": 261,
    "ErrorMsg": "Record does not exist"
}

Error code

Refer to Common Error Codes

[Generic Table] Delete a Record