软件工程一期server接口.pdfVIP

服务器源接口文档

服务器的接口总共分为四类：创建(create)，查询(find)，修改(update)，删除(delete)

以上四个功能简称为CFUD

1)创建服务器资源

defcreate_server(server_list):

函数功能：

创建服务器

函数返回值：

创建成功返回新服务器组成的list，失败则抛出异常

函数参数：

server_list是一个元素为dict的list，形如[dict1,dict2…..]

每个dict里的内容都是一个新的服务器的信息，包含的key:value对如下

“status”:服务器所处的状态(string)

“descripton”:服务器的描述(string)

“name”:服务器的名字(string)

“configuration”:服务器的配置(string)

KeyError:key关键字不正确或

1.上述key-value对必须全部包含，否则会抛出异常

2)查询服务器

deffind_server(filt,exclude):

函数功能：

查询符合条件的服务器

函数返回值：

满足filter里的条件且不包含exclude条件的服务器组成的list，list可以为空

函数参数：

filt：服务器需要包含的性质

exclude:服务器不能包含的性质

filt和exclude的格式要求完全一致，下面统一说明

参数是一个dict，可能包含的key：value对如下

“status”:服务器所处的状态(string)

“descripton”:服务器的描述(string)

“name”:服务器的名字(string)

“configuration”:服务器的配置(string)

KeyError:key关键字错误

1.如果查找不到符合要求的服务器，则返回空list，既[]

3)更新服务器

defupdate_server(server_id,update_content)

函数功能：

修改服务器的信息

函数返回值：

修改成功则返回修改后的对象，失败则抛出异常

函数参数：

server_id:待修改计算资源的id

update_content：更新信息的内容，类型为dict，可能包含的key-value对如下

“status”:服务器所处的状态(string)

“descripton”:服务器的描述(string)

“name”:服务器的名字(string)

“configuration”:服务器的配置(string)

ServerDoseNotExistError:server_id不存在

KeyError:key关键字不正确或

1.上述key-value对部分包含，如果有上述以外的key值，则会抛出异常

2.ServerDoesNotExistError定义在computing.interface.py里

4)删除服务器

defdelete_server(server_id)

函数功能：

删除服务器函

数返回值：

删除成功则返回True，否则返回False

函数参数：

server_id:待删除的服务器的id

ServerDoesNotExistError:server_id对应的用户不存在

1.ServerDoesNotExistError定义在computing.interfac.py