阿里云 SDK for JavaScript

原来阿里云 SDK 还可以这样用 https://github.com/aliyun-UED/open5

在浏览器端使用

现在 aliyun sdk 支持在浏览器端调用, 只需要引入 dist/aliyun-sdk.js 即可, 使用参考 sample/browser/browser.html

目前支持在浏览器端调用除了 sls, ocs 以外的所有服务, 不过目前只有 oss 支持 sts 和 cors , 非 oss 服务只能使用根 accessKey 和 accessSecret 进行初始化, 存在泄露风险.

使用 aliyun sdk js 将文件上传到 oss, 请点击 oss-js-upload

如何 build

考虑到文件大小, 目前 dist/aliyun-sdk.js 中仅包含 oss 服务, 如果需要 build 其他服务, 请按照以下步骤操作:

• git clone [email protected]:aliyun-UED/aliyun-sdk-js.git
• cd aliyun-sdk-js
• npm install
• bower install
• npm install -g browserify
• 构建仅包含 oss 的 aliyun-sdk.js

browserify -r oss-2013-10-15.json browser.js > dist/aliyun-sdk.js

• 如果需要编译多个服务, 如 oss, batchCompute

browserify -r oss-2013-10-15.json -r batchcompute-2015-06-30.json browser.js > dist/aliyun-sdk.js

目前在浏览器端运行的 sdk 还在测试阶段, 如果有问题请随时提出.

初始化

var oss = new ALY.OSS({
  accessKeyId: "在阿里云OSS申请的 accessKeyId",
  secretAccessKey: "在阿里云OSS申请的 secretAccessKey",
  securityToken: "",
  endpoint: 'http://oss-cn-hangzhou.aliyuncs.com',
  apiVersion: '2013-10-15'
});

可以使用 STS token 初始化 OSS, 后续 sts 会支持其他服务

var oss = new ALY.OSS({
  accessKeyId: "sts token 中的 accessKeyId",
  secretAccessKey: "sts token 中的 secretAccessKey",
  securityToken: "sts token 中的 securityToken",
  endpoint: 'http://oss-cn-hangzhou.aliyuncs.com',
  apiVersion: '2013-10-15'
});

安装

Node.js 安装

npm install aliyun-sdk

使用方法及代码示例

OSS

在 samples/oss 目录下的代码示例，使用方法：

• 将 sample/oss/oss.js 中需要的参数修改
• 打开需要执行的某个实例文件，如 GetBucket.js，将其中的参数改成你自己的 oss 实例参数
• 执行示例文件即可, 如:

cd samples/oss
node GetBucket.js

oss 支持 stream 请使用 https://github.com/berwin/aliyun-oss-upload-stream

SLS

在 samples/sls 目录下的代码示例，使用方法：

• 将 samples/sls/sls.js 中需要的参数修改
• 打开需要执行的某个实例文件，如 ListLogStores.js，将其中的参数改成你自己的 sls 实例参数
• 执行示例文件即可, 如:

cd samples/sls
node ListLogStores.js

ECS, RDS, SLB, CDN

在 samples 对应目录下的有代码示例，使用方法：

• 将 samples/ecs/test.js 中需要的参数修改
• 执行示例文件即可, 如:

cd samples/ecs
node test.js

OpenSearch

在 samples/opensearch 目录下的代码示例，使用方法：

• 修改 samples/opensearch/opensearch.js，填入代码中所需参数
• 执行示例文件即可

MEMCACHED

在 samples/memcached 目录下的代码示例，使用方法：

• 修改 samples/memcached/memcached.js，填入代码中所需参数
• 执行示例文件即可

更多帮助参考 https://github.com/chylvina/node_memcached

目前支持的服务

SDK 目前支持下列服务:

| 服务名 | 类名 | API 版本 | API 文档 | :------------ |:---------------:| -----:| -----:| | Aliyun ECS | ALY.ECS | 2014-05-26 | ECS API手册 | | Aliyun RDS | ALY.RDS | 2014-08-15 | RDS API手册 | | Aliyun SLB | ALY.SLB | 2014-05-15 | SLB API手册 | | Aliyun OSS | ALY.OSS | 2013-10-15 | OSS API手册 | | Aliyun OTS | ALY.OTS | 2014-08-08 | OTS API手册 | | Aliyun CDN | ALY.CDN | 2014-11-11 | CDN API手册 | | Aliyun CMS | ALY.CMS | 2015-10-20 | CMS API手册 | | Aliyun SLS | ALY.SLS | 2014-11-18 | SLS API手册 | | Aliyun RAM | ALY.RAM | 2015-05-15 | RAM API手册 | | Aliyun STS | ALY.STS | 2015-04-01 | STS API手册 | | Aliyun MTS | ALY.MTS | 2014-06-18 | MTS API手册 | | Aliyun PUSH | ALY.PUSH | 2015-08-27 | PUSH API手册 | | Aliyun OpenSearch | ALY.OpenSearch | 2015-01-01 | OpenSearch API手册 | | Aliyun BatchCompute | ALY.BatchCompute | 2015-06-30 | BatchCompute API手册 | | Aliyun OCS memcached | ALY.MEMCACHED | | BinaryProtocolRevamped |

我们在代码中参考了 AWS SDK，在此声明。

License

This SDK is distributed under the Apache License, Version 2.0.