yandex-cloud

Yandex.Cloud SDK (node.js)

Need to automate your infrastructure or use services provided by Yandex.Cloud? We've got you covered.

Installation:

npm install yandex-cloud

Library requires at least node.js 10 and provides TypeScript declarations.

Getting started

There are two options for authorization your requests - OAuth Token and Metadata Service (if you're executing code inside VMs or Functions running in Yandex.Cloud)

OAuth Token

const {Session}      = require('yandex-cloud');
const {CloudService} = require('yandex-cloud/api/resourcemanager/v1');

// Initialize SDK with your token
const session = new Session({ oauthToken: 'YOUR_TOKEN' });

// Create service client
const cloudService = new CloudService(session);

// Issue request (returns Promise)
let response = await cloudService.list({});

Metadata Service

Don't forget to assign Service Account for your Instance or Function.

const {CloudService} = require('yandex-cloud/api/resourcemanager/v1');

// Create service client (auth token will be fetched from metadata service
const cloudService = new CloudService();

// Issue request (returns Promise)
let response = await cloudService.list({});

IAM Token

const {Session}      = require('yandex-cloud');
const {CloudService} = require('yandex-cloud/api/resourcemanager/v1');

// Initialize SDK with your token
const session = new Session({ iamToken: 'YOUR_TOKEN' });

// Create service client
const cloudService = new CloudService(session);

// Issue request (returns Promise)
let response = await cloudService.list({});

Check examples directory for more examples.

Services

• Resource Manager;
• Identity and Access Management (IAM);
• Compute Cloud;
• Container Registry;
• Managed Services for Kubernetes;
• Key Management Service (KMS);
• Load Balancer;
• Cloud Functions;
• Virtual Private Cloud (VPC);
• AI Translate;
• AI Vision.

If you need generated client for other Yandex.Cloud services, just open an issue.