文档

CreateExternalStore

更新时间:

调用CreateExternalStore接口创建外部存储数据。

接口说明

目前支持OSS数据源和VPC下的RDS MySQL数据库作为外部存储数据。本文以RDS MySQL为例,OSS数据源作为外部存储数据时其参数配置请参见关联OSS数据源

请求语法

POST /externalstores HTTP/1.1
x-log-bodyrawsize: 0
Content-Type: application/json 
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1 
Host: ProjectName.Endpoint 
Date: GMT Date
Authorization: LOG yourAccessKeyId:yourSignature 
{
    "externalStoreName": "externalStoreName",
    "storeType": "rds-vpc",
    "parameter": {
        "vpc-id": "vpc-id",
        "instance-id": "instance-id",
        "host": "host",
        "port": "port",
        "username": "username",
        "password": "password",
        "db": "db",
        "table": "table",
        "region": "region"
    }
}

其中,Host由Project名称和日志服务Endpoint构成,您需要在Host中指定Project。

请求参数

  • 请求头

    CreateExternalStore接口无特有请求头,关于Log Service API的公共请求头请参见公共请求头

  • 参数列表
    参数名称数据类型是否必填示例值描述
    projectNameStringali-test-projectProject名称。
    externalStoreNameStringrds_store外部存储名称,在同一Project中名称不能重复,且和Logstore名称不能重复。
    storeTypeStringrds-vpc存储类型。固定取值为rds-vpc,表示VPC下的RDS MySQL数据库。
    vpc-idStringvpc-bp1aevy8sofi8mh1q****RDS MySQL实例所属的VPC ID。
    instance-idStringi-bp1b6c719dfa08exf****RDS MySQL实例ID。
    hostString192.168.XX.XXRDS MySQL实例的内网地址或外网地址。
    portString3306RDS MySQL实例的内网或者外网端口。
    usernameStringuserRDS MySQL实例中的账号名称。
    passwordStringsfdsfldsfksfls****RDS MySQL实例中账号对应的密码。
    dbStringmetaRDS MySQL实例的数据库名称。
    tableStringjoin_metaRDS MySQL实例的数据库表名称。
    regionStringcn-qingdaoRDS MySQL实例所在地域,目前仅支持cn-qingdao、cn-beijing、cn-hangzhou。

返回数据

  • 响应头

    CreateExternalStore接口无特有响应头。关于Log Service API的公共响应头,请参见公共响应头

  • 响应元素

    返回HTTP状态码200,则表示请求成功。该接口调用成功后无任何响应元素。

示例

  • 请求示例
    POST /externalstores HTTP/1.1
    Header :
    {
    x-log-bodyrawsize: 0
    Content-Type: application/json
    Content-Length: 307
    Content-MD5: 7C1D14659C0BBBA7C7BFF9E5A1A46705
    x-log-apiversion: 0.6.0
    x-log-signaturemethod: hmac-sha1
    Host: ali-test-project.cn-chengdu.log.aliyuncs.com
    Date: Thu, 19 Apr 2018 02:15:41 GMT
    Authorization: LOG yourAccessKeyId:yourSignature
    }
    Body :
    {
        "externalStoreName": "rds_store",
        "storeType": "rds-vpc",
        "parameter": {
            "vpc-id": "vpc-bp1aevy8sofi8mh1q****",
            "instance-id": "i-bp1b6c719dfa08exf****",
            "host": "192.168.XX.XX",
            "port": "3306",
            "username": "user",
            "password": "sfdsfldsfksfls****",
            "db": "meta",
            "table": "join_meta",
            "region": "cn-qingdao"
        }
    }
  • 正常返回示例
    HTTP/1.1 200 OK
    Header
    {
    date: Mon, 09 Nov 2015 07:45:30 GMT
    connection: close
    x-log-requestid: 56404F1A99248CA26C002180
    content-length: 0
    server: nginx/1.6.1
    }

错误码

HTTP状态码错误码错误信息描述
404ProjectNotExistThe Project does not exist : projectNameProject不存在。
400ParameterInvalidThe body is not valid json string.外部存储配置中存在无效的参数。
500InternalServerErrorSpecified Server Error Message.内部服务调用错误。

更多错误码,请参见错误码

  • 本页导读 (1)
文档反馈