可以创建持久性和非持久性 REST 登录令牌、查看令牌的属性以及删除令牌。创建令牌后，REST 登录令牌的属性为只读。可以通过返回的令牌值或令牌 ID 访问令牌。
示例 3 创建 REST 登录令牌创建 REST 登录令牌时需要用户名和密码。
设置令牌 name。默认情况下，preserve 的值为 false，expiration 的值为 900。如果将 preserve 设置为 true，则必须将 expiration 设置为秒数。
请务必保存结果中的 X-Auth-Session 值。有关更多信息，请参见REST 登录令牌。
请求示例：
POST /api/user/v2/users/test_user/preferences/tokens HTTP/1.1
Host: zfs-storage.example.com:215
X-Auth-User: test_user
X-Auth-Key: password-xxx
Content-Type: application/json
{"name": "Test Token"}
结果示例：
HTTP/1.1 201 Created
...
X-Auth-Session: JjZJsZrVQfbZULyAuvSJjTftnBHCcQT
{
"token": {
"href":
"/api/user/v2/users/test_user/preferences/tokens/fb65a127-a04c-4f58-bc52-efa884447efb",
"name": "Test Token",
"token_username": "test_user",
"preserve": false,
"expiration": "2020-04-30T02:33:44Z",
"id": "fb65a127-a04c-4f58-bc52-efa884447efb"
}
}
请求示例：
POST /api/user/v2/users/test_user/preferences/tokens HTTP/1.1
Host: zfs-storage.example.com:215
X-Auth-User: test_user
X-Auth-Key: password-xxx
Content-Type: application/json
{"name": "Another Token", "preserve": true, "expiration": 3600}
结果示例：
HTTP/1.1 201 Created
...
X-Auth-Session: pviHrthBGQhGZHoPuqxFQrDcCPZgwEK
{
"token": {
"href":
"/api/user/v2/users/test_user/preferences/tokens/21f981ad-6221-4fb4-a7d1-dd5560256dfb",
"name": "Another Token",
"token_username": "test_user",
"preserve": true,
"expiration": "2020-04-30T03:20:31Z",
"id": "21f981ad-6221-4fb4-a7d1-dd5560256dfb"
}
}
示例 4 列出指定用户的所有令牌
请求示例：
GET /api/user/v2/users/test_user/preferences/tokens HTTP/1.1 X-Auth-Session: pviHrthBGQhGZHoPuqxFQrDcCPZgwEK
结果示例：
{
"tokens": [{
"name": "Another Token",
"token_username": "test_user",
"preserve": true,
"expiration": "2020-04-30T03:20:31Z",
"id": "21f981ad-6221-4fb4-a7d1-dd5560256dfb",
"href": "/api/user/v2/users/testuser1/preferences/tokens/21f981ad-6221-4fb4-a7d1-dd5560256dfb"
},{
"name": "Test Token",
"token_username": "test_user",
"preserve": false,
"expiration": "2020-04-30T02:33:44Z",
"id": "fb65a127-a04c-4f58-bc52-efa884447efb",
"href": "/api/user/v2/users/testuser1/preferences/tokens/fb65a127-a04c-4f58-bc52-efa884447efb"
}]
}
示例 5 按令牌值列出特定令牌
请求示例：
GET /api/user/v2/users/test_user/preferences/tokens?token=pviHrthBGQhGZHoPuqxFQrDcCPZgwEK HTTP/1.1 X-Auth-Session: pviHrthBGQhGZHoPuqxFQrDcCPZgwEK
结果示例：
{
"token": {
"href":
"/api/user/v2/users/test_user/preferences/tokens/21f981ad-6221-4fb4-a7d1-dd5560256dfb",
"name": "Another Token",
"token_username": "test_user",
"preserve": true,
"expiration": "2020-04-30T03:20:31Z",
"id": "21f981ad-6221-4fb4-a7d1-dd5560256dfb"
}
}
示例 6 按令牌 ID 列出特定令牌
GET /api/user/v2/users/test_user/preferences/tokens/21f981ad-6221-4fb4-a7d1-dd5560256dfb HTTP/1.1 X-Auth-Session: pviHrthBGQhGZHoPuqxFQrDcCPZgwEK
结果同上。
示例 7 按令牌值删除令牌请求示例：
DELETE /api/user/v2/users/test_user/preferences/tokens?token=pviHrthBGQhGZHoPuqxFQrDcCPZgwEK HTTP/1.1 X-Auth-Session: pviHrthBGQhGZHoPuqxFQrDcCPZgwEK
结果示例：
HTTP/1.1 204 No Content示例 8 按令牌 ID 删除令牌
DELETE /api/user/v2/users/test_user/preferences/tokens/21f981ad-6221-4fb4-a7d1-dd5560256dfb HTTP/1.1 X-Auth-Session: pviHrthBGQhGZHoPuqxFQrDcCPZgwEK