资源属性类别

资源可以包含许多属性,并且它们被组织成以下类别以实现更有效的管理:

配置属性

配置属性代表用户拥有的数据。尽管必须在配置类别中进行属性要修改的配置类别,但在创建资源实例后,并非可以修改配置类别中的所有属性。在创建资源后无法更改的配置属性称为调用不变属性。使用PUT请求时,这种区别很重要,因为不可变的属性不能包含在请求正文中。

例如,VLAN ID是一个不变的属性。创建VLAN后,您无法更改VLAN的ID。相反,VLAN名称是一个可变((可写) 属性。您可以在创建VLAN之后更改VLAN名称。

可写的属性

可写的属性是配置属性的子集可变。创建资源后,用户可以修改可写的属性。当使用PUT方法修改资源时,请求主体只能包含可写的属性。

在REST V10.04及以后的版本中,GET方法选择器参数包括一个值可写,这使您只能获得资源的可变配置属性。

状态属性

状态属性包含系统拥有的数据,例如管理员帐户和各种状态字段。您不能在此类别中创建或修改属性实例。

统计属性

统计属性包含系统拥有的数据,例如计数器。您不能在此类别中创建或修改属性实例。

属性类别可能会有所不同

给定的属性不一定在资源到资源,甚至资源实例之间的同一类别中。如果系统拥有资源的实例,则该资源的属性(如果用户拥有资源实例,则可能是配置属性)将成为状态属性,用户无法修改。

例如,用户可以创建VLAN。但是,系统也可以创建VLAN。系统拥有的VLAN具有许多被认为是状态类别而不是配置类别的属性。当数据拥有并不能被用户覆盖时,使用状态类别。

通常,资源具有单个属性,该属性指示资源是系统还是用户所有。例如,对于Vlan,类型属性指示VLAN是否是由用户创建的。

当此指标属性指示资源归系统所有时,可能已在配置类别中的其他属性将其分类为状态属性。同样,当指示器属性指示资源由用户所有时,其他配置属性仍可用于用户修改。换句话说,资源上其他属性的类别遵循指标属性。