azure

Azure SDK for Node.js

This project provides a Node.js package that makes it easy to consume and manage Microsoft Azure Services.

Usage

This module includes all of the individual Azure Node.js modules in a single place. If your application only needs access to specific management modules, see the list of individual modules below.

$ npm install azure

This will allow you access to some helper methods as well as all of the individual modules. For example, by installing the azure module, you can directly require and use the ms-rest-azure common module. This organization method allows for submodules (and peer dependant modules) to always be in sync with each other.

Note: we haven't provided fine-grained modules for every supported Microsoft Azure services yet. This will come soon. If there is a module that you find is missing, open an issue so that we may prioritize it in the backlog.

Authenticating

There are three ways to authenticate using this module, use this guide to determine which method to use.

AzureNodeEssentials VSCode extension

The AzureNodeEssentials extension helps you easily interact with Azure. It helps you:

• create a project scaffolding
• install correct dependencies
• ready to use snippets for authentication and deploying templates to azure

Please feel free to provide feedback for the extension by opening github issues over here.

Install individual modules

Azure Service (Data plane)	Install Command
Gallery	npm install azure-gallery
Graph	npm install azure-graph
Key Vault	npm install azure-keyvault
Monitoring	npm install azure-monitoring
Scheduler	npm install azure-scheduler
Service Fabric	npm install azure-servicefabric
Service Bus	npm install azure-sb
Storage	npm install azure-storage
Batch	npm install azure-batch
Azure Resource Management (ARM) (Constrol plane)
Advisor	npm install azure-arm-advisor
Automation	npm install azure-arm-automation
Authorization	npm install azure-arm-authorization
Batch	npm install azure-arm-batch
Billing	npm install azure-arm-billing
CDN	npm install azure-arm-cdn
CognitiveServices	npm install azure-arm-cognitiveservices
Commerce/Usage	npm install azure-arm-commerce
Container Registry	npm install azure-arm-containerregistry
CustomerInsights	npm install azure-arm-customerinsights
Compute	npm install azure-arm-compute
Datalake Analytics	azure-arm-datalake-analytics
Datalake Storage	azure-arm-datalake-storage
DevTest Labs	npm install azure-arm-devtestlabs
DNS	npm install azure-arm-dns
DocumentDB	npm install azure-arm-documentdb
EventHubs	azure-arm-eventhub
HDInsight	npm install azure-arm-hdinsight
HDInsightJobs	azure-arm-hdinsight-jobs
Insights	npm install azure-arm-insights
IotHub	npm install azure-arm-iothub
Key Vault	npm install azure-arm-keyvault
Logic Apps	npm install azure-arm-logic
Machine Learning	npm install azure-arm-machinelearning
Media Services	npm install azure-arm-mediaservices
Notification Hubs	azure-arm-notificationhubs
Operational Insights	npm install azure-arm-operationalinsights
PowerBi Embedded	azure-arm-powerbiembedded
RecoveryServices	npm install azure-arm-recoveryservices
RecoveryServices Backup	npm install azure-arm-recoveryservicesbackup
Redis Cache	npm install azure-arm-rediscache
Relay	npm install azure-arm-relay
Resource Manager	npm install azure-arm-resource
Scheduler	azure-arm-scheduler
Search	azure-arm-search
ServerManagement	azure-arm-servermanagement
Servicebus	azure-arm-sb
Service Fabric	azure-arm-servicefabric
Storage	npm install azure-arm-storage
Storage Import-Export	npm install azure-arm-storageimportexport
Sql	npm install azure-arm-sql
Traffic Manager	npm install azure-arm-trafficManager
Virtual Networks	npm install azure-arm-network
WebApps (WebSites)	npm install azure-arm-website
Azure Service Management (ASM) (Constrol plane)
Compute	npm install azure-asm-compute
HDInsight	npm install azure-asm-hdinsight
Service Bus	npm install azure-asm-sb
Service Manager	npm install azure-asm-mgmt
Store	npm install azure-asm-store
Scheduler	npm install azure-asm-scheduler
SQL Database	npm install azure-asm-sql
Storage	npm install azure-asm-storage
Subscriptions	npm install azure-asm-subscription
Traffic Manager	npm install azure-asm-trafficManager
Virtual Networks	npm install azure-asm-network
WebSites	npm install azure-asm-website
Base Libraries
Common Functionality (for ASM & ARM clients)	npm install azure-common
Common Functionality for ARM clients generated from Autorest (Generic)	npm install ms-rest
Common Functionality for ARM clients generated from Autorest (Azure)	npm install ms-rest-azure

Need Help?

• Read the docs
• Open an issue in GitHub
• Microsoft Azure Forums on MSDN and Stack Overflow

Related Projects

• Azure CLI

License

This project is licensed under MIT and Apache-2.0.

• "MIT" license is usually used for the client libraries generated using Autorest that are targeting ARM (V2 version of Azure REST API). The license can be found in "LICENSE.MIT.txt" file in this repository.
• "Apache-2.0" license is usually used for the client libraries generated using an internal code generator that are targeting ASM (V1 version of Azure REST API). The license can be found in "LICENSE.Apache.txt" file in this repository.

Contribute

• If you would like to become an active contributor to this project please follow the instructions provided in Microsoft Azure Projects Contribution Guidelines.

Getting Started Developing

Want to get started hacking on the code, super! Follow the following instructions to get up and running. These instructions expect you have Git and a supported version of Node installed.

1. Fork it
2. Git Clone your fork (git clone {your repo})
3. Move into sdk directory (cd azure-sdk-for-node)
4. Install all dependencies (npm install)
5. Run the tests (npm test). You should see all tests passing.

Contributing Code to the Project

You found something you'd like to change, great! Please submit a pull request and we'll do our best to work with you to get your code included into the project.

1. Commit your changes (git commit -am 'Add some feature')
2. Push to the branch (git push origin my-new-feature)
3. Create new Pull Request

Changelog

2017.04.03 version 2.0.0-preview

• Updated type definition (.d.ts) files for all the packages and improved typescript support.
• Added Promise support for all the APIs. For each callback based API, we now have an overloaded method that returns a Promise.
• Moved Javascript code to ES6 syntax.
• Minimum required node.js version is 6.10
• Added a new vscode extension named Azure Node Essentials to help you easily interact with Azure.
• Improved the loading time of rollup azure package
• Added client libraries for following ARM services
  • Advisor Management (azure-arm-advisor)
  • Automation Management (azure-arm-automation)
  • Billing Management (azure-arm-billing)
  • Cognitive Services Management (azure-arm-cognitiveservices)
  • Container Registry Management (azure-arm-containerregistry)
  • Customer Insights Management (azure-arm-customerinsights)
  • DocumentDB Management (azure-arm-documentdb)
  • Logic Management (azure-arm-logic)
  • Machine Learning Management (azure-arm-machinelearning)
  • Media Services Management (azure-arm-mediaservices)
  • Operational Insights Management (azure-arm-operationalinsights)
  • Recovery Services Backup Management (azure-arm-recoveryservicesbackup)
  • Recovery Services Management (azure-arm-recoveryservices)
  • Relay Management (azure-arm-relay)
  • Scheduler Management (azure-arm-scheduler)
  • Search Management (azure-arm-search)
  • ServiceFabric Management (azure-arm-servicefabric)
  • ServiceMap Management (azure-arm-servicemap)
  • SQL Management (azure-arm-sql)
  • Storage Import Export Management (azure-arm-storageimportexport)
• Runtime (ms-rest and ms-rest-azure)
  • Updated d.ts files for ms-rest and ms-rest-azure
  • All the login methods (interactiveLogin, loginWithServicePrincipalSecret, loginWithUsernamePassword) now support callbacks as well as Promises.
  • Added support to send (a generic request, or a generic long running request (that polls)) using the authenticated base client in the runtime