The documentation you are viewing is for Dapr v1.15 which is an older version of Dapr. For up-to-date documentation, see the latest version.

分布式锁 API 参考

关于分布式锁 API 的详细文档

锁

通过此端点，您可以通过提供锁所有者的名称和要锁定的资源 ID 来获取锁。

HTTP 请求

POST http://localhost:<daprPort>/v1.0-alpha1/lock/<storename>

URL 参数

参数 描述
daprPort Dapr 端口
storename metadata.name 字段的组件文件。请参阅组件模式

查询参数

无

HTTP 响应代码

代码 描述
200 请求成功
204 空响应
400 请求格式错误
500 请求失败

HTTP 请求体

锁端点需要接收以下 JSON 负载：

{
    "resourceId": "",
    "lockOwner": "",
    "expiryInSeconds": 0
}
字段 描述
resourceId 要锁定的资源 ID。可以是任何值
lockOwner 锁所有者的名称。每次请求都应设置为唯一值
expiryInSeconds 锁定在过期前保持的时间（秒）

HTTP 响应体

锁端点会返回以下负载：

{
    "success": true
}

示例

curl -X POST http://localhost:3500/v1.0-alpha/lock/redisStore \
  -H "Content-Type: application/json" \
  -d '{
        "resourceId": "lock1",
        "lockOwner": "vader",
        "expiryInSeconds": 60
      }'

{
    "success": "true"
}

解锁

通过此端点，您可以根据锁所有者和资源 ID 解锁现有锁。

HTTP 请求

POST http://localhost:<daprPort>/v1.0-alpha1/unlock/<storename>

URL 参数

参数 描述
daprPort Dapr 端口
storename metadata.name 字段的组件文件。请参阅组件模式

查询参数

无

HTTP 响应代码

代码 描述
200 请求成功
204 空响应
400 请求格式错误
500 请求失败

HTTP 请求体

解锁端点需要接收以下 JSON 负载：

{
    "resourceId": "",
    "lockOwner": ""
}

HTTP 响应体

解锁端点会返回以下负载：

{
    "status": 0
}

status 字段包含以下响应代码：

代码 描述
0 成功
1 锁未找到
2 锁属于其他所有者
3 内部错误

示例

curl -X POST http://localhost:3500/v1.0-alpha/unlock/redisStore \
  -H "Content-Type: application/json" \
  -d '{
        "resourceId": "lock1",
        "lockOwner": "vader"
      }'

{
    "status": 0
}