Skip to content

Latest commit

 

History

History
83 lines (57 loc) · 2.36 KB

README.md

File metadata and controls

83 lines (57 loc) · 2.36 KB

Yandex.Cloud SDK (node.js)

npm CircleCI License

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.