资源属性类别
资源可以包含许多属性,并且它们被组织成以下类别以实现更有效的管理:
- 配置属性
-
配置属性代表用户拥有的数据。尽管必须在配置类别中进行属性要修改的配置类别,但在创建资源实例后,并非可以修改配置类别中的所有属性。在创建资源后无法更改的配置属性称为调用不变属性。使用PUT请求时,这种区别很重要,因为不可变的属性不能包含在请求正文中。
例如,VLAN ID是一个不变的属性。创建VLAN后,您无法更改VLAN的ID。相反,VLAN名称是一个可变((可写) 属性。您可以在创建VLAN之后更改VLAN名称。
- 可写的属性
-
可写的属性是配置属性的子集可变。创建资源后,用户可以修改可写的属性。当使用PUT方法修改资源时,请求主体只能包含可写的属性。
在REST V10.04及以后的版本中,GET方法
选择器
参数包括一个值可写
,这使您只能获得资源的可变配置属性。 - 状态属性
-
状态属性包含系统拥有的数据,例如管理员帐户和各种状态字段。您不能在此类别中创建或修改属性实例。
- 统计属性
-
统计属性包含系统拥有的数据,例如计数器。您不能在此类别中创建或修改属性实例。
属性类别可能会有所不同
给定的属性不一定在资源到资源,甚至资源实例之间的同一类别中。如果系统拥有资源的实例,则该资源的属性(如果用户拥有资源实例,则可能是配置属性)将成为状态属性,用户无法修改。
例如,用户可以创建VLAN。但是,系统也可以创建VLAN。系统拥有的VLAN具有许多被认为是状态类别而不是配置类别的属性。当数据拥有并不能被用户覆盖时,使用状态类别。
通常,资源具有单个属性,该属性指示资源是系统还是用户所有。例如,对于Vlan,类型
属性指示VLAN是否是由用户创建的。
当此指标属性指示资源归系统所有时,可能已在配置类别中的其他属性将其分类为状态属性。同样,当指示器属性指示资源由用户所有时,其他配置属性仍可用于用户修改。换句话说,资源上其他属性的类别遵循指标属性。