阿里云 SDK for Javascript,支持在浏览器和 Nodejs 环境使用,支持大部分阿里云服务。
JavaScript
Pull request Compare This branch is 121 commits behind aliyun-UED:master.
Latest commit 06513f5 Dec 22, 2015 @xiong-liang xiong-liang bump version
Permalink
Failed to load latest commit information.
apis drop Extend & Filter Dec 18, 2015
dist bump version Dec 22, 2015
lib cms first version Dec 17, 2015
samples drop Extend & Filter Dec 18, 2015
test drop Extend & Filter Dec 18, 2015
tools ecs, rds, slb sdk ready Jan 6, 2015
.gitignore 修改InstanceStatusList为InstanceList Aug 11, 2015
.jshintrc clear Jan 30, 2015
.npmignore aliyun sdk for browser works Jul 27, 2015
README.md release v1.7.5 Dec 21, 2015
bower.json bump version Dec 22, 2015
browser.js clear Jul 28, 2015
index.js clear Jan 30, 2015
package.json release v1.7.5 Dec 21, 2015

README.md

阿里云 SDK for JavaScript

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

技术支持

请加旺旺群:1489391962

在浏览器端使用

现在 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 git@github.com: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

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 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 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.