更新时间:2022-02-22 GMT+08:00

查询作业二进制列表

功能介绍

查询所有的二进制对象列表。该接口兼容Sahara。

URI

  • URI格式

    GET /v1.1/{project_id}/job-binaries

  • 参数说明
    表1 URI参数说明

    名称

    是否必选

    说明

    project_id

    项目编号。获取方法,请参见获取项目ID

    limit

    返回数据中最大对象个数。

    取值范围:1~1073741822

    marker

    作业二进制对象ID

    查询作业二进制对象列表,选择一个作业二进制对象ID作为Marker,这个ID为列表中最后一个元素的ID,该元素不会出现在返回数据中。

    sort_by

    排序字段,-号表示降序排列。例如:

    • sort_by=name表示按name升序排序
    • sort_by=-name表示按name降序排序

请求消息

请求参数

无。

响应消息

表2 响应参数说明

名称

参数类型

说明

markers

Object

markers对象。参数说明,请参见表3

binaries

Array

二进制对象列表。参数说明,请参见表4

表3 markers参数说明

名称

参数类型

说明

prev

String

上一页的marker。

next

String

下一页的marker。

表4 binaries参数说明

名称

参数类型

说明

name

String

二进制对象名称。

url

String

二进制对象URL。

description

String

二进制对象描述信息。

created_at

String

二进制对象创建时间。

updated_at

String

二进制对象更新时间。

id

String

二进制对象ID。

tenant_id

String

项目编号。获取方法,请参见获取项目ID

is_public

Bool

二进制对象是否公开。

  • true
  • false

当前版本不支持该功能。

is_protected

Bool

二进制对象是否受保护。

  • true
  • false

当前版本不支持该功能。

示例

  • 请求示例
    GET /v1.1/{project_id}/job-binaries?limit=1&sort_by=name&marker= eadfb8ec-760b-499f-b8df-00a6def854f8
  • 响应示例
    {
        "markers": {
            "prev": "ddf13f9d-93e8-4999-b860-0dc0c01c517d",
            "next": null
        },
        "binaries": [
            {
                "name": "my-job-binary-update",
                "url": "/simple/mapreduce/program",
                "description": "this is the job binary template",
                "created_at": "2017-06-22T09:04:53",
                "updated_at": "2017-06-22T09:06:50",
                "id": "da37b581-042f-4d7a-9378-f628f32bd9ae",
                "tenant_id": "5a3314075bfa49b9ae360f4ecd333695",
                "is_public": false,
                "is_protected": false
            }
        ]
    }

状态码

状态码如表5所示。

表5 状态码

状态码

描述

200

查询二进制对象列表成功。

异常状态码请参见状态码