跳转到主要内容
资源中心/网络服务/网络服务相关接口/安全策略定时计划相关接口

创建安全策略定时计划

创建安全策略定时计划

POST/zstack/v1/network-security-policy-schedules

操作 ID

CreateNetworkSecurityPolicySchedule

起始版本

5.5.38

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

请求体字段

  • params
    Object必填

    请求体参数结构

    • name
      String必填

      名称

    • description
      String

      描述

    • resourceType
      String必填

      所属资源类型

    • resourceUuid
      String必填

      所属资源UUID

    • timeType
      String必填

      时间类型,Local 或 UTC

    • repeatType
      String必填

      计划类型

    • startDate
      String必填

      开始日期,格式yyyy-MM-dd

    • endDate
      String必填

      结束日期,格式yyyy-MM-dd

    • startTime
      String必填

      开始时间,格式HH:mm

    • endTime
      String必填

      结束时间,格式HH:mm;Weekly使用00:00至00:00表示全天

    • weekDays
      List

      Weekly生效星期,1表示周一,7表示周日

  • systemTags
    List

    系统标签

  • userTags
    List

    用户标签

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • success
    boolean必填

    操作是否成功

  • error
    ErrorCode必填

    详情参考error

    • code
      String必填

      错误码号,错误的全局唯一标识,例如 SYS.1000、HOST.1001

    • description
      String必填

      错误的概要描述

    • details
      String必填

      错误的详细信息

    • elaboration
      String必填

      保留字段,默认为null

    • opaque
      LinkedHashMap必填

      保留字段,默认为null

    • cause
      ErrorCode必填

      根错误,引发当前错误的源错误,若无原错误,该字段为null

  • inventory
    NetworkSecurityPolicyScheduleInventory必填

    详情参考inventory

    • uuid
      String必填

      定时计划UUID

    • name
      String必填

      名称

    • description
      String必填

      描述

    • resourceType
      String必填

      所属资源类型

    • resourceUuid
      String必填

      所属资源UUID

    • timeType
      String必填

      时间类型,Local 或 UTC

    • repeatType
      String必填

      Once 或 Weekly

    • startDate
      String必填

      开始日期,格式yyyy-MM-dd

    • endDate
      String必填

      结束日期,格式yyyy-MM-dd

    • startTime
      String必填

      开始时间,格式HH:mm

    • endTime
      String必填

      结束时间,格式HH:mm

    • weekDays
      List必填

      Weekly生效星期

    • expiring
      boolean必填

      距离最后一个有效窗口结束大于0且不足24小时

    • createDate
      Timestamp必填

      创建时间

    • lastOpDate
      Timestamp必填

      最后修改时间

    • timeStatus
      NetworkSecurityPolicyScheduleTimeStatus必填

      详情参考timeStatus

      • NotStarted
        NetworkSecurityPolicyScheduleTimeStatus必填

        尚未到整体开始边界

      • InWindow
        NetworkSecurityPolicyScheduleTimeStatus必填

        当前分钟处于有效时间窗口

      • OutOfWindow
        NetworkSecurityPolicyScheduleTimeStatus必填

        当前不在有效时间窗口,但仍存在后续有效窗口

      • Ended
        NetworkSecurityPolicyScheduleTimeStatus必填

        已不存在后续有效窗口