Zoho crm Logo

获取数据备份详情

目的

获取有关您的CRM账户最新数据备份计划的信息。

端点

  • GET /备份

Request 详情

Request URL

{api-domain}/crm/bulk/v8/backup

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.bulk.backup.ALL
(or)
ZohoCRM.bulk.backup.READ

可能的操作类型

ALL - 对备份数据的完全访问
READ - 获取有关计划备份的信息

样本请求

Response JSON

  • id字符串

    备份请求的唯一标识符。

  • scheduled_dateDateTime

    下一次备份计划发生的日期和时间,格式为ISO 8601。如果您在计划备份时未指定rrule,此键为空。

  • start_dateDateTime

    备份过程最初设定开始的日期和时间,格式为ISO 8601。这反映了首次安排备份的时间。如果在安排备份时未指定rrule,此键为空。

  • rrule string

    定义备份计划频率的重复规则。

  • 请求者JSON 对象

    启动备份的用户的详细信息。详细信息包括用户的名称,记录ID和用户的ZUID。

  • status string

    表示计划备份的状态。 
    可能的值:
    已停止 -  备份已计划,并将在指定时间进行。
    已计划 - 备份正在处理中。
    进行中 - 备份已成功完成。
    已完成 -  备份过程已被中止。
    失败 - 备份过程遇到错误,无法完成。

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    请求方法不正确。
    解决方案: 使用HTTP GET方法进行此API调用。任何其他请求方法都会导致此错误。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用来进行此API调用的访问令牌没有所需的范围。
    解决方案:生成具有此API所需范围的新访问令牌。请参阅此页面开头的范围部分,以获取所需范围的列表。

  • NO_PERMISSIONHTTP 403

    拒绝读取权限
    解决方案: 用户没有读取数据备份数据的权限。请联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方案:指定一个有效的请求URL。请参考本页开头的请求URL部分以获取更多详细信息。

  • INTERNAL_ERRORHTTP 500

    服务器中出现意外且未处理的异常。 
    解决方案:联系support@zohocrm.com的支持团队。

样本回应