-
响应示例 {
"count": 2,
"fpgaimages": [
{
"id": "4010a32c5c7d7711015c81ac714c009d",
"name": "FPGA001",
"description": "fpga test",
"status": "active",
"size": 40,
"createdAt": "2017-06-07 08:29:41",
"protected": false,
"message": null,
"metadata": {
"shell_type": "OCL",
"shell_version": "1.0"
},
"log_directory": "obs-fpga:vu9p/log"
},
{
"id": "4010a32c5c7d7711015c813e69bd002c",
"name": "FPGA002",
"description": "fpga test",
"status": "active",
"size": 43,
"createdAt": "2017-06-07 16:29:30",
"protected": true,
"messgae": null,
"metadata": {
"shell_type": "OCL",
"shell_version": "1.0"
},
"log_directory": "obs-fpga:vu9p/log"
}
]
}
-
响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 count Integer 查询的FPGA镜像数量。 fpgaimages Array of objects 查询的FPGA镜像详情列表。 表3 fpgaimages字段结构说明 参数 参数类型 描述 id String FPGA镜像的ID。 name String FPGA镜像的名称。 description String FPGA镜像的描述信息。 status String FPGA镜像状态。取值如下： initiating：表示创建FPGA镜像任务初始化中。 scheduling：表示FPGA镜像等待调度创建。 creating：表示FPGA镜像正在创建中。 saving：表示FPGA镜像正在上传文件到后端存储。 deleting：表示FPGA镜像正在删除中。 error：表示FPGA镜像创建失败。 active：表示FPGA镜像可以正常使用。 size Integer FPGA镜像的文件大小，单位为MB。 createdAt String FPGA镜像的创建时间。 使用UTC（Coordinated Universal Time）时间。 protected Boolean 该FPGA镜像是否受保护。 受保护是指，该FPGA镜像与创建弹性云服务器使用的镜像关联，此时，不可以执行删除FPGA镜像的操作。 message String FPGA镜像的附加信息。 metadata Object FPGA镜像的元数据信息。 log_directory String FPGA镜像的构建日志文件在OBS中的目录路径，格式为“桶名:目录路径”，例如“obs-fpga:vu9p/log”。
-
URI GET /v1/{project_id}/cloudservers/fpga_image/detail?fpga_image_id={fpga_image_id}&page={page}&size={size} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 fpga_image_id 否 FPGA镜像的ID。 page 否 分页查询的页数。 该参数值需满足如下要求： 十进制整数 取值范围[1, 65535) 不能包含“+” size 否 分页查询时，每页最多展示的记录数。 十进制整数。 取值范围[1, 100]。 不能包含“+” page和size的参数值均存在时，分页查询功能才会生效。如果只存在一个，系统会显示参数非法的错误。 当指定fpga_image_id参数时，page和size参数指定的分页查询功能将不生效。
-
响应示例 {
"count": 2,
"fpgaimages": [
{
"id": "4010a32c5c7d7711015c81ac714c009d",
"name": "FPGA001",
"description": "fpga test",
"status": "active",
"size": 40,
"createdAt": "2017-06-07 08:29:41",
"protected": false,
"message": null,
"metadata": {
"shell_type": "OCL",
"shell_version": "1.0"
},
"log_directory": "obs-fpga:vu9p/log"
},
{
"id": "4010a32c5c7d7711015c813e69bd002c",
"name": "FPGA002",
"description": "fpga test",
"status": "active",
"size": 43,
"createdAt": "2017-06-07 16:29:30",
"protected": true,
"messgae": null,
"metadata": {
"shell_type": "OCL",
"shell_version": "1.0"
},
"log_directory": "obs-fpga:vu9p/log"
}
]
}
-
响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 count Integer 查询的FPGA镜像数量。 fpgaimages Array of objects 查询的FPGA镜像详情列表。 表3 fpgaimages字段结构说明 参数 参数类型 描述 id String FPGA镜像的ID。 name String FPGA镜像的名称。 description String FPGA镜像的描述信息。 status String FPGA镜像状态。取值如下： initialing：表示创建FPGA镜像任务初始化中。 scheduling：表示FPGA镜像等待调度创建。 creating：表示FPGA镜像正在创建中。 saving：表示FPGA镜像正在上传文件到后端存储。 deleting：表示FPGA镜像正在删除中。 error：表示FPGA镜像创建失败。 active：表示FPGA镜像可以正常使用。 size Integer FPGA镜像的文件大小，单位为MB。 createdAt String FPGA镜像的创建时间。 使用UTC（Coordinated Universal Time）时间。 protected Boolean 该FPGA镜像是否受保护。 受保护是指，该FPGA镜像与创建弹性云服务器使用的镜像关联，此时，不可以执行删除FPGA镜像的操作。 message String FPGA镜像的附加信息。 metadata Object FPGA镜像的元数据信息。 log_directory String FPGA镜像的构建日志文件在OBS中的目录路径，格式为“桶名:目录路径”，例如“obs-fpga:vu9p/log”。
-
URI GET /v1/{project_id}/cloudservers/fpga_image/detail?fpga_image_id={fpga_image_id}&page={page}&size={size} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 fpga_image_id 否 FPGA镜像的ID。 page 否 分页查询的页数。 该参数值需满足如下要求： 十进制整数 取值范围[1, 65535) 不能包含“+” size 否 分页查询时，每页最多展示的记录数。 十进制整数。 取值范围[1, 100]。 不能包含“+” page和size的参数值均存在时，分页查询功能才会生效。如果只存在一个，系统会显示参数非法的错误。 当指定fpga_image_id参数时，page和size参数指定的分页查询功能将不生效。
-
响应示例 {
"associations": [
{
"image_id": "89e38a0a-de83-4f3d-83b9-a2df2c605487",
"fpgaimages": [
{
"id": "4010a32b5f231f04015f24259efd0429",
"name": "relate-test",
"description": "relate-test",
"status": "active",
"size": 40,
"createdAt": "2017-10-16 07:46:06",
"protected": true,
"message": null,
"metadata": {
"shell_type": "OCL",
"shell_version": "1.0"
},
"log_directory": "obs-fpga:vu9p/log"
},
{
"id": "4010a32b5f231f04015f23f0c07c041a",
"name": "name123",
"description": "desc123",
"status": "active",
"size": 60,
"createdAt": "2017-10-16 06:48:21",
"protected": true,
"message": null,
"metadata": {
"shell_type": "OCL",
"shell_version": "1.0"
},
"log_directory": "obs-fpga:vu9p/log"
}
]
}
]
}
-
响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 associations Array of objects 查询到的关联映射关系列表。 表3 associations字段结构说明 参数 参数类型 描述 image_id String 弹性云服务器镜像ID。 fpgaimages Array of objects 相关联的FPGA镜像详情列表。 表4 fpgaimages字段结构说明 参数 参数类型 描述 id String FPGA镜像的ID。 name String FPGA镜像的名称。 description String FPGA镜像的描述信息。 status String FPGA镜像的状态。取值如下： active：表示FPGA镜像可以正常使用。 size Integer FPGA镜像的文件大小，单位为MB。 createdAt String FPGA镜像的创建时间。 使用UTC时间。 protected Boolean 该FPGA镜像是否受保护。 受保护是指，该FPGA镜像与创建弹性云服务器使用的镜像关联，此时，不可以执行删除FPGA镜像的操作。 message String FPGA镜像的附加信息。 metadata Object FPGA镜像的元数据信息。 log_directory String FPGA镜像的构建日志文件在OBS中的目录路径，格式为“桶名:目录路径”，例如“obs-fpga:vu9p/log”。
-
URI GET /v1/{project_id}/cloudservers/fpga_image/associations?image_id={image_id}&fpga_image_id={fpga_image_id}&page={page}&size={size} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 image_id 否 E
CS 镜像ID。 fpga_image_id 否 FPGA镜像ID。 page 否 分页查询的页数。 该参数值需满足如下要求： 十进制整数 取值范围[1, 65535) 不能包含“+” size 否 分页查询时，每页最多展示的记录数。 十进制整数。 取值范围[1, 100]。 不能包含“+” 只有至少指定fpga_image_id和image_id参数中的一个时，用户才可能查询到关联关系，否则只会返回一个空列表。 page和size的参数值均存在时，分页查询功能才会生效。如果只存在一个，系统会显示参数非法的错误。当同时指定image_id和fpga_image_id参数时，page和size参数指定的分页查询功能将不生效。
