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的公共请求头请参见公共请求头。

• 参数列表

  参数名称	数据类型	是否必填	示例值	描述
  projectName	String	是	ali-test-project	Project名称。
  externalStoreName	String	是	rds_store	外部存储名称，在同一Project中名称不能重复，且和Logstore名称不能重复。
  storeType	String	是	rds-vpc	存储类型。固定取值为rds-vpc，表示VPC下的RDS MySQL数据库。
  vpc-id	String	否	vpc-bp1aevy8sofi8mh1q****	RDS MySQL实例所属的VPC ID。
  instance-id	String	否	i-bp1b6c719dfa08exf****	RDS MySQL实例ID。
  host	String	否	192.168.XX.XX	RDS MySQL实例的内网地址或外网地址。
  port	String	是	3306	RDS MySQL实例的内网或者外网端口。
  username	String	是	root	RDS MySQL实例中的账号名称。
  password	String	是	sfdsfldsfksfls****	RDS MySQL实例中账号对应的密码。
  db	String	是	meta	RDS MySQL实例的数据库名称。
  table	String	是	join_meta	RDS MySQL实例的数据库表名称。
  region	String	是	cn-qingdao	RDS 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": "root",
  		"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
  }

错误码

更多错误码，请参见通用错误码。