SDK-Node.js

概述

本文档基于AWS Node.js SDK 编写。互盟云对象存储兼容AWS S3接口。

开发准备

npm 引入

开发前需先安装环境依赖：npm 地址。

SDK 获取

为 Node.js 安装 SDK 的首选方法是使用 Node.js 程序包管理器 npm。要执行此操作，请在命令行中键入此内容。

npm install aws-sdk

**说明**

如果您在安装中遇到如下错误消息：

npm WARN deprecated node-uuid@1.4.8: Use uuid module instead

请在命令行中输入如下命令：

npm uninstall --save node-uuid
npm install --save uuid

开发环境

使用 SDK 需要您的运行环境包含 nodejs 以及 npm，nodejs 版本建议 7.0 版本以上。在安装完成 npm 后，您还需要安装 npm 依赖包，在 SDK 的解压目录执行npm install。到控制台 Access Key 管理获取您的项目 AccessKeyId 和 AccessKeySecret。

创建client

互盟云OSS 兼容绝大多数 AWS S3 API。

在 Node.js 中使用开发工具包时，您使用 require 将开发工具包添加到应用程序。

1. 引入整个开发工具包

var AWS = require('aws-sdk');

如果您仅使用互盟云 OSS 建议您采用仅引入对象存储服务方式，由此，通过网络传输的代码量以及代码的内存开销都会显著减少。

2.仅引入对象存储服务

如下所示是当只包含开发工具包的对象存储部分。

// Import the AWS SDK 
var AWS = require('aws-sdk'); 
var s3 = new AWS.S3({apiVersion: '2006-03-01'});
s3.endpoint = "https://oss-cn-shenzhen.humengyun.com" 
s3.config.update({ 
    accessKeyId: "your_accessKeyId", 
    secretAccessKey: "your_secretAccessKey", 
    s3ForcePathStyle: true, 
    signatureVersion: "v4" 
})

快速入门

创建存储空间（Bucket）

// Create Client 
var AWS = require('aws-sdk'); 
// Import the AWS SDK only for S3 
var s3 = new AWS.S3({apiVersion: '2006-03-01'});
s3.endpoint = "https://oss-cn-shenzhen.humengyun.com" 
s3.config.update({ 
    accessKeyId: "XXXXXXXXXXXXXXXXXXXXXXXXXX", 
    secretAccessKey: "yyyyyyyyyyyyyyyyyyyyyyyyyyy", 
    s3ForcePathStyle: true, 
    signatureVersion: "v4" 
}) 

// Create Bucket 
var newBuket = { 
    Bucket: 'myAPPname' 
}

s3.createBucket(newBuket, function (err, data) { 
    if (err) console.log(err, err.stack) // an error occurred 
    else { 
        console.log(data)
    }
  }
)

更多例子请参见 API 参考中的Class。

帮助与服务