Skip to main content

凭证端点

凭证端点和参数

要详细了解对象关系以及如何在 API 中使用对象关系,请转至 对象关系 部分。

如需详细了解凭证,请访问 凭证 帮助页面。

注意

我们不允许通过 API 创建凭证。要以管理员身份创建凭证,请使用 Server UI

检索所有凭证记录

要检索所有可访问的凭证记录,请使用 GET {baseURL}/v3/credentials 端点。

注意

如果您不是管理员,则结果仅限于您可以访问和查看的凭证,userId 和 userGroupId 参数将被忽略。

参数

  • view (string):可选。可以保留此参数但不为其提供值。您可以从以下值中选择:“默认值”和“全部”。如果此参数设置为“Default”,则将返回一个减小的视图对象。未指定时,将使用“默认值(Default)”。

  • userId (string):可选。要按 userId 筛选结果,请输入用户的 ID。

  • userGroupId (string):可选。要按 userGroupId 筛选结果,请输入用户组的 ID。

检索一条凭证记录

要检索有关现有凭证的详细信息,请使用 GET {baseURL}/v3/credentials/{credentialId} 端点。

参数

  • credentialId (string):必填。输入集合 ID 以获取有关特定凭证的信息。

与用户共享凭证

要与现有用户共享现有凭证,请使用 POST {baseURL} /v3/credentials/{credentialId}/users 端点。

注意

只有管理员可以使用此 API 端点。

参数

  • credentialId (string):必填。输入要共享的集合 ID。

  • contract (body):必填。指定以下参数以与用户共享凭证:

    • userId (string):必填。指定要与其共享凭证的用户的 ID。

与用户组共享凭证

要与现有用户组共享现有凭证,请使用 POST {baseURL} /v3/credentials/{credentialId}/userGroups 端点。

注意

只有管理员可以使用此 API 端点。

参数

  • credentialId (string):必填。输入要共享的凭证 ID。

  • contract (body):必填。指定以下参数以与用户组共享凭证:

    • userGroupId (string):必填。指定要与其共享凭证的用户组的 ID。

移除用户使用凭证的权限

要移除用户使用现有凭证的权限,请使用 DELETE {baseURL}/v3/credentials/{credentialId}/users/{userId} 端点。

注意

只有管理员可以使用此 API 端点。

参数

  • credentialId (string):必填。输入要从中移除用户的凭证 ID。

  • userId (string):必填。输入要从凭证中移除的用户 ID。

移除用户组使用凭证的权限

要移除用户组使用现有凭证的权限,请使用 DELETE {baseURL}/v3/credentials/{credentialId}/userGroups/{userGroupId} 端点。

注意

只有管理员可以使用此 API 端点。

参数

  • credentialId (string):必填。输入要从中移除用户组的凭证 ID。

  • userGroupId (string):必填。输入要从凭证中移除的用户组 ID。

删除凭证

要删除现有凭证,请使用 DELETE {baseURL}/v3/credentials/{credentialId} 端点。

注意

只有管理员可以使用此 API 端点。

参数

  • credentialId (string):必填。输入要删除的凭证 ID。

  • force (boolean):可选。选择是否要在存在任何共享的情况下强制删除凭证。如果您想要删除凭证并清除所有共享,请将 force 参数设置为 true。如果未选择,则默认值为 false。这是为了防范错误调用。

对象关系

要获取有关现有凭证 ID 的信息,请使用 GET /v3/credentials 端点。您获得的 credentialId 可以在以下情况下使用: