クイックスタート
Alibaba Cloud SDK (Software Development Kit) へようこそ。
Alibaba Cloud Node.js SDK (Software Development) を使用すると、 ECS (Elastic Compute Service) 、 SLB (Server Load Balancer) 、 CloudMonitor などの Alibaba Cloud サービスにアクセスできます。 リクエストの署名や作成などの API 関連のタスクを処理することなく、 Alibaba Cloud サービスにアクセスできます。 ここでは、 Alibaba Cloud Node.js SDK を入手して呼び出す方法を紹介します。
環境の準備
- Alibaba Cloud Node.js SDK を使用するには、Alibaba Cloud アカウントと AccessKey が必要です。AccessKey は AcsClient を初期化するときに必要です。Alibaba Cloud コンソールで AccessKey を作成できます。
- Ali cloud SDK を使用してプロダクト API を呼び出す前に、 Alibaba Cloud コンソールでそのプロダクトを既に開いていることを確認してください。
- Alibaba Cloud Node.js SDK には、最新の LTS バージョンの Node.js が必要です。 (Node.js 4.x and Node.js 6.x). node-v を実行して Node.js のバージョンを表示できます。
Node.js SDK のインストール
Node. js SDK をインストールするには、以下の手順を実行してください。
- GitHub からプロダクトの SDK をダウンロードします。
- Node.js SDK のインストール
Node.js 依存関係モジュールをインストールするには、 npm を使用することを推奨します。 Alibaba Cloud Node.js SDK は @alicloud のスコープの配下です。
ダウンロードした Node.js SDK のパスは/path/to/aliyun-openapi-Node.js-sdk
となります。- 開発が SDK コアライブラリに基づいている場合、次のコマンドを実行して
@alicloud/pop-core
モジュールをインストールします。
上記コマンドの--save
オプションは、アプリケーションのpackage.json
ファイルにモジュールを書き込み、依存関係モジュールとして機能します。$ npm install @alicloud/pop-core --save
- 開発が特定のクラウドプロダクト SDK に基づいている場合は、クラウドプロダクトのモジュールをインストールする必要があります。このチュートリアルでは、例として MNS プロダクトのモジュールをインストールします。
$ npm install @alicloud/mns --save
- 開発が SDK コアライブラリに基づいている場合、次のコマンドを実行して
コード例
RPC API の呼び出し
var RPCClient = require('@alicloud/pop-core'). RPCClient;
var client = new RPCClient({
accessKeyId: '
', secretAccessKey: '
', endpoint: '
', apiVersion: '
' // => returns Promise
client.request(action, params, options);
REST API の 呼び出し
var ROAClient = require('@alicloud/pop-core'). ROAClient;
var client = new ROAClient({
Accesskeyid: '
', accessKeySecret: '
', endpoint: '
', apiVersion: '
' // => returns Promise
// request(HTTPMethod, uriPath, queries, body, headers, options);
// options => {timeout}
client.request('GET', '/regions');
以下の例は、サービスを呼び出すための Node.js SDKの使い方を示しています。
// Introduce the SDK
const Client = require('@alicloud/oam');
// Create instance
const client = new Client({
accessKeyId: '
', secretAccessKey: '
', securityToken: '', // Supports STS
endpoint: 'ENDPOINT'
// Call a service
// Detailed API, return the promise
client.addRoleCellToRole({
RoleName: "role1",
Resource: "*:*:*:*",
ActionList: ["Read", "Write"],
GrantOption: 0
}, {timeout: 10000});