百度MapReduce BMR

    实例组操作接口

    查询实例组列表

    接口描述

    查询指定集群的实例组信息

    权限说明

    请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求,请参考 鉴权认证

    注意事项

    如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

    请求结构

    GET /v{version}/cluster/{clusterId}/instanceGroup HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: {utc-date-string}
    host: bmr.bj.baidubce.com
    connection: keep-alive
    accept: */*
    content-type: application/json
    authorization: {bce-authorization-string}

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名 参数类型 是否必须 参数位置 参数描述
    version String URL参数 API版本号,当前取值1
    clusterId String URL参数 指定的集群ID

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 参数描述
    instanceGroups List\<InstanceGroup> 返回的实例组列表

    请求示例

    GET /v1/cluster/0ce4f730-4af2-4f37-8fa2-b14f2f44e50e/instanceGroup HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: 2015-03-24T13:02:00Z
    host: bmr.bj.baidubce.com
    connection: keep-alive
    accept: */*
    content-type: application/json
    authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:02:00Z/1800/host;x-bce-date/994014d96b0eb26578e039fa053a4f9003425da4bfedf33f4790882fb4c54903

    响应示例

    HTTP/1.1 200 OK
    Transfer-Encoding: chunked
    x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
    Cache-Control: no-cache
    Server: BWS
    Date: Tue, 24 Mar 2015 13:02:01 GMT
    Content-Type: application/json;charset=UTF-8
    {
        "instanceGroups":[
            {
                "id":"4e6ac637-5801-40c1-7d9b-a8543224fd5e",
                "instanceType":"g.small",
                "name":"Master",
                "requestedInstanceCount":1,
                "type":"Master"
            },
            {
                "id":"69610acc-f0b4-4798-440f-2c95c3113fd4",
                "instanceType":"g.small",
                "name":"Core",
                "requestedInstanceCount":3,
                "type":"Core"
            },
            {
                "id":"93ea4b05-b2a4-4f8e-74d0-75d9f2dd8e55",
                "instanceType":"g.small",
                "name":"Task",
                "requestedInstanceCount":0,
                "type":"Task"
            }
        ]
    }

    修改实例组配置

    接口描述

    修改指定集群的实例组配置

    权限说明

    请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求,请参考 鉴权认证

    注意事项

    如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

    请求结构

    PUT /v{version}/cluster/{clusterId}?/instanceGroup&clientToken={clientToken} HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: {utc-date-string}
    host: bmr.bj.baidubce.com
    connection: keep-alive
    accept: */*
    content-type: application/json
    authorization: {bce-authorization-string}
    {
        "instanceGroups": [
            {
                "id": "cefb0a10-6028-467b-8dd5-d71d3cf74fcb",
                "instanceCount": 4
            },
            {
                "id": "0575111f-a702-434c-b463-8991b5fb4552",
                "instanceCount": 2
            }
        ]
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名 参数类型 是否必须 参数位置 参数描述
    version String URL参数 API版本号,当前取值1
    clusterId String URL参数 待修改的集群ID,只有状态为RUNNING或WAITING的集群才能进行该操作
    clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符
    instanceGroups List\<ModifyInstanceGroupConfig> RequestBody参数 待修改实例组配置,可省略无须修改的实例组

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    无参数

    请求示例

    PUT /v1/cluster/f5fa683d-4cf4-46b6-b5ab-bb2c0340c970/instanceGroup&clientToken=bf31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
    accept-encoding: gzip, deflate
    x-bce-date: 2017-03-13T13:02:00Z
    host: bmr.bj.baidubce.com
    connection: keep-alive
    accept: */*
    content-type: application/json
    authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2017-03-13T13:02:00Z/1800/host;x-bce-date/994014d96b0eb26578e039fa053a4f9003425da4bfedf33f4790882fb4c54903
    {
        "instanceGroups": [
            {
                "id": "cefb0a10-6028-467b-8dd5-d71d3cf74fcb",
                "instanceCount": 4
            },
            {
                "id": "0575111f-a702-434c-b463-8991b5fb4552",
                "instanceCount": 2
            }
        ]
    }

    响应示例

    HTTP/1.1 204 NO_CONTENT
    Transfer-Encoding: chunked
    x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
    Cache-Control: no-cache
    Server: BWS
    Date: Mon, 13 Mar 2017 13:02:01 GMT
    Content-Type: application/json;charset=UTF-8
    一篇
    集群操作接口
    一篇
    实例操作接口