[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({3ba1b4af-4e570b8c})
# SLA 对象

以下对象与 `sla` （服务水平协议） API 直接相关。

[comment]: # ({/3ba1b4af-4e570b8c})

[comment]: # ({c491bbae-8451803c})
### SLA

SLA 对象具有以下属性.

|属性|[类型](/manual/api/reference_commentary#数据类型)|描述|
|--|--|------|
|slaid|ID|SLA 的 ID。<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *只读*<br>- *必填* 更新操作|
|name|字符串|SLA 的名称.<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填* 创建操作|
|period|整型|SLA 的报告周期。<br><br>可能的值:<br>0 - 每天;<br>1 - 每周;<br>2 - 每月;<br>3 - 每季度;<br>4 - 每年.<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填* 创建操作|
|slo|浮点数|使用百分比表示可接受的最低服务水平目标。如果服务水平指标（SLI）降至更低的水平，则认为 SLA 处于问题/未满足状态。<br><br>可能的值: 0-100 (最多4位小数).<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填* 创建操作|
|effective_date|整型|SLA 的生效时间。<br><br>可能的值:  UTC日期时间戳。|
|timezone|字符串|报告时区, 比如: `Europe/London`， `UTC`。<br><br>时区的完整支持列表请参考 [PHP 时区文档](https://www.php.net/manual/en/timezones.php).<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填* 对于创建操作|
|status|整型|SLA 的状态。<br><br>可能的值:<br>0 - *(默认值)* 关闭 SLA;<br>1 - 打开 SLA。|
|description|字符串|SLA 的描述。|

[comment]: # ({/c491bbae-8451803c})

[comment]: # ({e5b9974b-632f7fa7})
### SLA 时间表

SLA 调度对象定义了被调度的处于连接状态的服务（如果有的话）在正常运行期间的时间段。
它具有以下属性。

[comment]: # ({/e5b9974b-632f7fa7})

[comment]: # ({5124412f-db954c0c})

|属性|[类型](/manual/api/reference_commentary#数据类型)|描述|
|--|--|------|
|period\_from|整型|每周重复周期的开始时间（包含）。<br><br>可能的值: 以秒为单位的数值（从星期日开始计算）。<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填*|
|period\_to|整型|每周重复周期的结束时间（不包含）。<br><br>可能的值: 以秒为单位的数值（从星期日开始计算）。<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填*|

[comment]: # ({/5124412f-db954c0c})

[comment]: # ({79292401-5bbe7eb6})
### SLA 排除停机时间

排除的停机对象定义了计划内停机时间，这些时间不会影响 SLI 的计算，比如正在进行的计划内维护。
它具有如下属性。

[comment]: # ({/79292401-5bbe7eb6})

[comment]: # ({c6429487-fa71231c})


|属性|[类型](/manual/api/reference_commentary#数据类型)|描述|
|--|--|------|
|name|字符串|排除的停机时间的名称.<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填*|
|period\_from|整型|排除的停机时间的开始时刻 (包含)。<br><br>可能的值: timestamp.<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填*|
|period\_to|整型|排除的停机时间的结束时刻 (不包含).<br><br>可能的值: timestamp.<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填*|

[comment]: # ({/c6429487-fa71231c})

[comment]: # ({23d825be-9f9ccbfd})
### SLA 服务标签

SLA 服务标签对象将服务与 SLA 计算关联起来。 它具有如下属性。

[comment]: # ({/23d825be-9f9ccbfd})

[comment]: # ({236649ca-e4881380})

|属性|[类型](/manual/api/reference_commentary#数据类型)|描述|
|--|--|------|
|tag|字符串|SLA 服务标签名称.<br><br>[属性行为](/manual/api/reference_commentary#属性行为):<br>- *必填*|
|operator|整型|SLA 服务标签操作.<br><br>可能的值:<br>0 - *(默认)* 等于;<br>2 - 包含。|
|value|字符串|SLA 服务标签的值。|

[comment]: # ({/236649ca-e4881380})