azure-fix 0.7.0.pre3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c8e53ed9868e24340da35c2918563b62ea290d3a
+  data.tar.gz: cd3cfea5d0e0692d8921489c4abed4f3dad63bf8
+SHA512:
+  metadata.gz: fd0a8116ea8b652bd0b56dbae6e8c9a3821181537adc2d1d7ffd99eed4f7bb556d9d99f15c3552b0ff080f5a1cd7ddb2d17ce994ec1145800d9cd18dfcbfddac
+  data.tar.gz: eefd8140b3ca90e617021503e9ee60714c4e0cf36dd7fa16a4d60a85280fa243c8621feefd4481c72d32f6de213af54488f3a08e903d5bc8f455f6f2bd547fed

data/.env_sample

@@ -0,0 +1,13 @@
+# This is a sample of what your .env file should look like if you wanted to run integration tests.
+# If you move this file to the .env and replace the environment variables with your own values, then the environment
+# will be included when the rake test tasks are executed. Otherwise, you could just export the environment vars
+# yourself.
+
+AZURE_STORAGE_ACCOUNT="your storage account"
+AZURE_STORAGE_ACCESS_KEY="your storage access key"
+AZURE_SERVICEBUS_NAMESPACE="your sb namespace"
+AZURE_SERVICEBUS_ACCESS_KEY="your sb access key"
+AZURE_MANAGEMENT_CERTIFICATE="your management cert path"
+AZURE_SUBSCRIPTION_ID="your subscription id"
+AZURE_SERVICEBUS_SAS_KEY="Service Bus SAS key"
+AZURE_SERVICEBUS_SAS_KEY_NAME="Service Bus SAS key name"

data/.gitignore

@@ -0,0 +1,30 @@
+.rvmrc
+*.gem
+*.rbc
+*.swp
+*.tmproj
+*~
+.\#*
+tags
+/pkg
+/doc
+Gemfile.lock
+nbproject/*
+*.gem
+.idea/*
+.project
+.bundle
+.config
+.yardoc
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+
+
+.DS_Store
+.ruby-version
+.env
+*.pem

data/.travis.yml

@@ -0,0 +1,13 @@
+---
+language: ruby
+
+rvm:
+- 1.9.3
+- 2.0.0
+- 2.1.5
+- 2.2.0
+
+script:
+- bundle exec rake test:unit
+- if [ "$TRAVIS_SECURE_ENV_VARS" == "true" ] ; then rake test:integration ; fi
+

data/ChangeLog.txt

@@ -0,0 +1,56 @@
+2015.05.06 - version 0.7.0.pre
+* Upgraded ASM versioning to 2014-06-01
+* Added the ability to use personal vm images not just gallery images
+* Namespaced all of the things so there is no leakage
+* Added proper support for .pfx
+* Added bin to transform .publishsettings files to .pfx files
+* Added support for Azure.config.management_certificate as string
+* Added ms-blob-content-disposition support, bump blob `x-ms-version` header to `2013-08-15`
+* Fixed KeepAlive and timeout for blobs
+* VM sizes are available -- we just warn if they are not in our list
+* Support for nokogiri on windows
+* Ability to delete a staging deployment of a cloud service
+* Peek_lock fixed for service bus
+* Support for creating shared access signatures
+
+
+2014.05.06 - version 0.6.4
+* Upgraded Service Management Versioning to 2014-04-01
+* Created separate API for add role
+* Logical Unit Number(lun) is optional argument in API add_data_disk
+* Cloud service should delete only if there are no other VMs/Deployments in the cloud service
+* Added more sizes(Basic_A0, Basic_A1, Basic_A2, Basic_A3, Basic_A4) options for Virtual Machine and Cloud Service.
+
+2014.03.28 - version 0.6.3
+* Added get_cloud_service_properties method, which returns all cloud service properties (embed-detail=true), including info about all VMs
+* Added winrm_http_port and winrm_https_port to get_virtual_machine method to allow the users to configure custom ports for winrm-http and winrm-https
+* Checks if any ports are in use before adding a role in the existing cloud service
+* Auto generate public port for add role.
+* Fix issue https://github.com/Azure/azure-sdk-for-ruby/issues/130
+
+2014.03.15 - version 0.6.2
+* Restart Virtual Machine
+* Add disk to Virtual Machine
+* Add/Update Virtual Machine endpoints
+* Delete Virtual Machine endpoint
+
+2014.02.18 - version 0.6.1
+* Fixed http redirection error
+* Add a new role to existing deployment
+* Add support for including VMs in availability sets
+
+2013.12.02 - version 0.6.0
+* Add the following service management API
+  * Virtual Machine
+  * Virtual Machine Image
+  * Virtual Network
+  * Cloud Service
+  * Storage
+  * Sql Database
+  * Location and Affinity Group
+
+2013.04.25 - version 0.5.0
+* First release
+* Ruby 1.9.3 and 2.0 support
+* Storage support: Blob, Table and Queue
+* Service Bus support: Queue, Topic/Subscription

data/Gemfile

@@ -0,0 +1,16 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2015 Microsoft Corporation
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,702 @@
+
+# Microsoft Azure SDK for Ruby
+[![Build Status](https://travis-ci.org/Azure/azure-sdk-for-ruby.png?branch=dev)](https://travis-ci.org/Azure/azure-sdk-for-ruby) [![Code Climate](https://codeclimate.com/github/Azure/azure-sdk-for-ruby/badges/gpa.svg)](https://codeclimate.com/github/Azure/azure-sdk-for-ruby)
+
+
+This project provides a Ruby package that makes it easy to access and manage Microsoft Azure Services like Storage, Service Bus and Virtual Machines.
+
+# Library Features
+
+* [Storage](#storage)
+    * [Blobs](#blobs)
+    * [Tables](#tables)
+    * [Queues](#queues)
+* Storage Account Management
+* [Service Bus](#service-bus)
+    * [relays](#relays)
+    * [Queues](#sb-queues)
+    * [Topics](#topics)
+* [Base Management](#base-mgmt)
+    * [Locations](#locations)
+    * [Affinity Groups](#affinity)
+* [Virtual Machine Management](#vms)
+    * list, delete Disks
+    * manage virtual machines
+    * [list images](#images)
+* Cloud Service Management
+* [SQL Database Server Management](#sql)
+* [Virtual Network Management](#vnets)
+    * List VNet
+    * Create VNet via parameters or xml file
+
+# Supported Ruby Versions
+
+* Ruby 1.9.3
+* Ruby 2.0
+* Ruby 2.1
+* Ruby 2.2
+
+Note: x64 Ruby for Windows is known to have some compatibility issues.
+
+# Getting Started
+
+## Install the rubygem package
+
+You can install the azure rubygem package directly.
+
+```bash
+gem install azure
+```
+
+## Setup Connection
+
+You can use this SDK against the Microsoft Azure Services in the cloud, or against the local Storage Emulator if you are on Windows. Service Bus and Microsoft Azure Service Management emulation are not supported. Of course, to use the Microsoft Azure Services in the cloud, you need to first [create a Microsoft Azure account](http://www.azure.com/en-us/pricing/free-trial/). After that, you can get the information you need to configure Storage and Service Bus from the [Microsoft Azure Portal](https://manage.azure.com).
+
+There are two ways you can set up the connections:
+
+1. [via code](#via-code)
+2. [via environment variables](#via-environment-variables)
+
+<a name="via-code"></a>
+### Via Code
+* Against Microsoft Azure Services in the cloud
+
+```ruby
+
+  require "azure"
+
+  Azure.storage_account_name = "<your azure storage account name>"
+  Azure.storage_access_key   = "<your azure storage access key>"
+
+  # Configure these 3 properties to use Service Bus
+  Azure.sb_namespace         = "<your azure service bus namespace>"
+  Azure.sb_access_key        = "<your azure service bus access key>"
+  Azure.sb_issuer            = "<your azure service bus issuer>"
+
+  # Configure these 3 properties to use Service Management. We support passwordless pfx & pem cert formats.
+  Azure.management_certificate = "<path to your *.pem or *.pfx>"
+  Azure.subscription_id        = "<your Subscriptionid>"
+
+  # Configure a ca_cert.pem file if you are having issues with ssl peer verification
+  Azure.ca_file = "./ca_file.pem"
+
+  # Or create a specific instance of an Azure.client, which will inherit your default configuration settings.
+  client = Azure.client(storage_account_name: "your account name", storage_access_key: "your access key")
+
+```
+
+* Against local Emulator (Windows Only)
+
+```ruby
+
+  require "azure"
+
+  # Configure these 2 properties to use local Storage Emulator
+  Azure.storage_account_name = "devstoreaccount1"
+  Azure.storage_access_key   = "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw=="
+
+  Azure.storage_blob_host    = "http://127.0.0.1:10000/devstoreaccount1"
+  Azure.storage_queue_host   = "http://127.0.0.1:10001/devstoreaccount1"
+  Azure.storage_table_host   = "http://127.0.0.1:10002/devstoreaccount1"
+
+  # Local Service Bus Emulator is not supported
+  # Local Service Management emulation is not supported
+
+```
+
+<a name="via-environment-variables"></a>
+### Via Environment Variables
+
+* Against Microsoft Azure Services in the cloud
+
+    * Storage
+
+    ```bash
+    AZURE_STORAGE_ACCOUNT = <your azure storage account name>
+    AZURE_STORAGE_ACCESS_KEY = <your azure storage access key>
+    ```
+    * Service Bus
+
+    ```bash
+    AZURE_SERVICEBUS_NAMESPACE = <your azure service bus namespace>
+    AZURE_SERVICEBUS_ACCESS_KEY = <your azure service bus access key>
+    AZURE_SERVICEBUS_ISSUER = <your azure service bus issuer>
+    ```
+    * Service Management
+
+    ```bash
+    AZURE_MANAGEMENT_CERTIFICATE = <path to *.pem or *.pfx>
+    AZURE_SUBSCRIPTION_ID = <your subscription ID>
+    AZURE_MANAGEMENT_ENDPOINT = <The endpoint URL of Microsoft Azure management service>
+    AZURE_SQL_DATABASE_MANAGEMENT_ENDPOINT = <SQL Database Management Endpoint>
+    AZURE_SQL_DATABASE_AUTHENTICATION_MODE = <:management_certificate or :sql_server>
+    ```
+    * [SSL Certificate File](https://gist.github.com/fnichol/867550)
+    
+    ```bash
+    SSL_CERT_FILE=<path to *.pem>
+    ```
+* Against local Emulator (Windows Only)
+
+    * Storage
+
+    ```bash
+    AZURE_STORAGE_ACCOUNT = devstoreaccount1
+    AZURE_STORAGE_ACCESS_KEY = Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==
+    AZURE_STORAGE_BLOB_HOST = http://127.0.0.1:10000/devstoreaccount1
+    AZURE_STORAGE_QUEUE_HOST = http://127.0.0.1:10001/devstoreaccount1
+    AZURE_STORAGE_TABLE_HOST = http://127.0.0.1:10002/devstoreaccount1
+    ```
+    * Service Bus: not supported
+
+    * Service Management: not supported
+
+# Usage
+
+<a name="storage"></a>
+## Storage
+
+### Setup your Storage Credentials
+
+```ruby
+
+# Require the azure rubygem
+require "azure"
+
+# Add your default storage credentials
+Azure.storage_account_name = "your account name"
+Azure.storage_access_key = "your access key"
+
+# Or create a specific instance of an Azure.client
+client = Azure.client(storage_account_name: "your account name", storage_access_key: "your access key")
+
+default_blobs = Azure.blobs     # uses the Azure.storage_account_name and Azure.storage_access_key
+
+blobs = client.blobs            # uses the client.storage_account_name and client.storage_access_key
+
+```
+<a name="blobs"></a>
+### Blobs
+
+```ruby
+
+# Create an azure storage blob service object
+blobs = Azure.blobs
+
+# Create a container
+container = blobs.create_container("test-container")
+
+# Upload a Blob
+content = File.open('test.jpg', 'rb') { |file| file.read }
+blobs.create_block_blob(container.name, "image-blob", content)
+
+# List containers
+blobs.list_containers()
+
+# List Blobs
+blobs.list_blobs(container.name)
+
+# Download a Blob
+blob, content = blobs.get_blob(container.name, "image-blob")
+File.open("download.png", "wb") {|f| f.write(content)}
+
+# Delete a Blob
+blobs.delete_blob(container.name, "image-blob")
+
+```
+<a name="tables"></a>
+### Tables
+
+```ruby
+
+# Require the azure rubygem
+require "azure"
+
+# Create an azure storage table service object
+tables = Azure.tables
+
+# Create a table
+tables.create_table("testtable")
+
+# Insert an entity
+entity = { "content" => "test entity", :partition_key => "test-partition-key", :row_key => "1" }
+tables.insert_entity("testtable", entity)
+
+# Get an entity
+result = tables.get_entity("testtable", "test-partition-key", "1")
+
+# Update an entity
+result.properties["content"] = "test entity with updated content"
+tables.update_entity(result.table, result.properties)
+
+# Query entities
+query = { :filter => "content eq 'test entity'" }
+result, token = tables.query_entities("testtable", query)
+
+# Delete an entity
+tables.delete_entity("testtable", "test-partition-key", "1")
+
+# delete a table
+tables.delete_table("testtable")
+
+```
+
+<a name="queues"></a>
+### Queues
+
+```ruby
+
+# Require the azure rubygem
+require "azure"
+
+# Create an azure storage queue service object
+queues = Azure.queues
+
+# Create a queue
+queues.create_queue("test-queue")
+
+# Create a message
+queues.create_message("test-queue", "test message")
+
+# Get one or more messages with setting the visibility timeout
+result = queues.list_messages("test-queue", 30, {:number_of_messages => 10})
+
+# Get one or more messages without setting the visibility timeout
+result = queues.peek_messages("test-queue", {:number_of_messages => 10})
+
+# Update a message
+message = queues.list_messages("test-queue", 30)
+pop_receipt, time_next_visible = queues.update_message("test-queue", message.id, message.pop_receipt, "updated test message", 30)
+
+# Delete a message
+message = queues.list_messages("test-queue", 30)
+queues.delete_message("test-queue", message.id, message.pop_receipt)
+
+# Delete a queue
+queues.delete_queue("test-queue")
+
+```
+
+<a name="service-bus"></a>
+## Service Bus
+
+<a name="relays"></a>
+### Relay
+
+```ruby
+
+# Require the azure rubygem
+require "azure"
+
+# Create an azure service bus object
+service_bus = Azure.service_bus
+
+# Create a relay endpoint with just the endpoint name
+relay1 = service_bus.create_relay("test-relay-1", { :relay_type => "Http" })
+
+# Create a relay endpoint with a relay object
+relay2 = Azure::ServiceBus::Relay.new("test-relay-2")
+relay2.requires_client_authorization = false
+relay2 = service_bus.create_relay(relay2)
+
+# Delete a relay endpoint
+service_bus.delete_relay("test-relay2")
+
+```
+
+<a name="sb-queues"></a>
+### Queues
+
+```ruby
+
+# Require the azure rubygem
+require "azure"
+
+# Create an azure service bus object
+service_bus = Azure.service_bus
+
+# Create a queue with just the queue name
+queue1 = service_bus.create_queue("test-queue-1")
+
+# Create a queue with a queue object
+queue2 = Azure::ServiceBus::Queue.new("test-queue-2")
+queue2.max_size_in_megabytes = 2048
+queue2 = service_bus.create_queue(queue2)
+
+# Send a queue message with just the message body
+service_bus.send_queue_message("test-queue-1", "test queue message")
+
+# Send a queue message with a brokered message object
+message = Azure::ServiceBus::BrokeredMessage.new("another test queue message")
+message.correlation_id = "test-correlation-id-1"
+service_bus.send_queue_message("test-queue-1", message)
+
+# Receive a queue message
+message = service_bus.receive_queue_message("test-queue-1")
+
+# Delete a queue message
+service_bus.delete_queue_message(message)
+
+# Delete a queue
+service_bus.delete_queue("test-queue-1")
+
+```
+
+<a name="topics"></a>
+### Topics
+
+```ruby
+
+# Require the azure rubygem
+require "azure"
+
+# Create an azure service bus object
+service_bus = Azure.service_bus
+
+# Create a topic with just the topic name
+topic1 = service_bus.create_topic("test-topic-1")
+
+# Create a topic with a topic object
+topic2 = Azure::ServiceBus::Topic.new("test-topic-2")
+topic2.max_size_in_megabytes = 2048
+topic2 = service_bus.create_topic(topic2)
+
+# Create a subscription
+subscription = Azure::ServiceBus::Subscription.new("test-subscription-1")
+subscription.topic = topic1.name
+subscription = service_bus.create_subscription(subscription)
+
+# Send a topic message with just the message body
+azure_service_bus.send_topic_message(topic1, "test topic message")
+
+# Send a topic message with a brokered message object
+message = Azure::ServiceBus::BrokeredMessage.new("another test topic message")
+message.correlation_id = "test-correlation-id-1"
+service_bus.send_topic_message(topic1, message)
+
+# Receive a subscription message
+message = service_bus.receive_subscription_message(topic1.name, subscription.name)
+
+# Delete a subscription message
+service_bus.delete_subscription_message(message)
+
+# Delete a subscription
+service_bus.delete_subscription(subscription)
+
+# Delete a topic
+service_bus.delete_topic(topic1)
+
+```
+
+<a name="vms"></a>
+## Virtual Machine Management
+
+```ruby
+
+# Require the azure rubygem
+require 'azure'
+
+# Configure these properties
+Azure.management_certificate = "path to *.pem or *.pfx file"
+Azure.subscription_id        = "your subscription id"
+
+# Create a virtual machine service object
+vm_management = Azure.vm_management
+
+# Get a list of existing virtual machines in your subscription
+vm_management.list_virtual_machines
+
+# API to shutdown Virtual Machine
+vm_management.shutdown_virtual_machine('vm_name', 'cloud_service_name')
+
+# API to start Virtual Machine
+vm_management.start_virtual_machine('vm_name', 'cloud_service_name')
+
+# API to restart Virtual Machine
+vm_management.restart_virtual_machine('vm_name', 'cloud_service_name')
+
+# API for add disk to Virtual Machine
+options = {
+  :disk_label => 'disk-label',
+  :disk_size => 100, #In GB
+  :import => false,
+  :disk_name => 'Disk name' #Required when import is true
+}
+vm_management.add_data_disk('vm_name', 'cloud_service_name', options)
+
+# API to add/update Virtual Machine endpoints
+endpoint1 = {
+    :name => 'ep-1',
+    :public_port => 996,
+    :local_port => 998,
+    :protocol => 'TCP',
+  }
+endpoint2 = {
+    :name => 'ep-2',
+    :public_port => 997,
+    :local_port => 997,
+    :protocol => 'TCP',
+    :load_balancer_name => ‘lb-ep2’,
+    :load_balancer => {:protocol => 'http', :path => 'hello'}
+  }
+vm_management.update_endpoints('vm_name', 'cloud_service_name', endpoint1, endpoint2)
+
+# API to delete Virtual Machine endpoint
+vm_management.delete_endpoint('vm_name', 'cloud_service_name', 'endpoint_name')
+
+# API to delete Virtual Machine
+vm_management.delete_virtual_machine('vm_name', 'cloud_service_name')
+
+# API to start deployment
+params = {
+  :vm_name => 'vm_name',
+  :vm_user => 'azureuser',
+  :image => '5112500ae3b842c8b9c604889f8753c3__OpenLogic-CentOS-63APR20130415',
+  :password => 'Password',
+  :location => 'West US'
+}
+options = {
+  :storage_account_name => 'storage_suse',
+  :cloud_service_name => 'cloud_service_name',
+  :deployment_name =>'vm_name',
+  :tcp_endpoints => '80,3389:3390',
+  :private_key_file => './private_key.key',     # required for ssh
+  :ssh_port => 2222,
+  :vm_size => 'Small',                          # Use any Azure VM size
+  :affinity_group_name => 'affinity1',
+  :virtual_network_name => 'xplattestvnet',
+  :subnet_name => 'subnet1',
+  :availability_set_name => 'availabiltyset1',
+  :reserved_ip_name => 'reservedipname'
+}
+vm_management.create_virtual_machine(params,options)
+
+# API usage to add new roles under cloud service creating VM
+# API add_role create multiple roles under the same cloud service. Atleast a single deployment should be created under a hosted service.
+params = {
+  :vm_name => 'vm_name',
+  :cloud_service_name => 'cloud_service_name',
+  :vm_user => 'azureuser',
+  :image => 'a699494373c04fc0bc8f2bb1389d6106__Win2K8R2SP1-Datacenter-201305.01-en.us-127GB.vhd',
+  :password => 'ComplexPassword',
+}
+options = {
+  :storage_account_name => 'storage_suse',
+  :winrm_transport => ['https','http'],         # Currently http(s) is supported.
+  :tcp_endpoints => '80,3389:3390',
+  :private_key_file => './private_key.key',     # Required for winrm(https) certificate.
+  :winrm_https_port => 5999,
+  :winrm_http_port => 6999,                     # Used to open different powershell port
+  :vm_size => 'Small',                          # Use any Azure VM size
+  :availability_set_name => 'availabiltyset'
+}
+vm_management.add_role(params, options)
+
+```
+
+<a name="images"></a>
+## List Images
+
+```ruby
+
+# Get a list of available virtual machine images
+vm_image_management = Azure.vm_image_management
+vm_image_management.list_virtual_machine_images
+
+```
+
+<a name="base-mgmt"></a>
+## Base Management
+
+<a name="locations"></a>
+```ruby
+
+# Get a list of available regional data center locations
+base_management = Azure.base_management
+base_management.list_locations
+
+```
+
+<a name="affinity"></a>
+### Affinity Group Management
+
+```ruby
+
+# Require the azure rubygem
+require 'azure'
+
+# Create a affinity group service object
+base_management = Azure.base_management
+
+# Get a list of affinity group that are provisioned for a subscription.
+base_management.list_affinity_groups
+
+# API to delete affinity group
+base_management.delete_affinity_group('affinity-group-name')
+
+# API to add a new affinity group to a subscription
+options = {:description => 'Some Description'}
+base_management.create_affinity_group('affinity-group-name', 'West US', 'Label Name', options)
+
+# API to update affinity group
+options = {:description => 'Some Description'}
+base_management.update_affinity_group('affinity-group-name', 'Label Name', options)
+
+# API to list properties associated with the specified affinity group
+base_management.get_affinity_group('affinity-group-name')
+
+```
+
+<a name="sql"></a>
+## SQL Database Server Management
+
+```ruby
+
+# Require the azure rubygem
+require 'azure'
+
+# Configure these properties
+Azure.management_certificate = "path to *.pem or *.pfx file"
+Azure.subscription_id        = "your subscription id"
+
+# Create a database server service object
+sql_db_service = Azure.sql_database_management
+
+# Get a list of SQL Database servers that are provisioned for a subscription.
+sql_db_service.list_servers
+
+# API to delete SQL Database server
+sql_db_service.delete_server('server_name')
+
+# API to adds a new SQL Database server to a subscription
+sql_db_service.create_server('admin-login', 'ComplexPassword', 'West US')
+
+# API to sets the administrative password of a SQL Database server for a subscription
+sql_db_service.reset_password('server-name', 'NewPassword')
+
+# Get a list of all the server-level firewall rules for a SQL Database server that belongs to a subscription
+sql_db_service.list_sql_server_firewall_rules("server-name")
+
+# API to adds a new server-level firewall rule or updates an existing server-level firewall rule for a SQL Database server with requester’s IP address.
+sql_db_service.delete_sql_server_firewall_rule("server-name", "rule-name")
+
+# API to add/updates server-level firewall rule for a SQL Database server that belongs to a subscription
+ip_range = {:start_ip_address => "0.0.0.1", :end_ip_address => "0.0.0.5"}
+sql_db_service.set_sql_server_firewall_rule("server-name", "rule-name", ip_range)
+
+# If ip_range was not specified in the above api then the IP of the machine from where the api is being called would be set as the rule.
+# To toggle between the option to allow Microsoft Azure services to access db server similar to azure portal just set the fire wall rule
+# with iprange to be 0.0.0.0 as start and end.Remove the rule to unset this option.
+
+```
+
+<a name="vnets"></a>
+## Virtual Network Management
+
+```ruby
+
+# Require the azure rubygem
+require 'azure'
+
+# Create a virtual network service object
+vnet = Azure.network_management
+
+# API to get a list of virtual networks created for a subscription.
+vnet.list_virtual_networks
+
+# API to configure virtual network with required and optional parameters
+address_space = ['172.16.0.0/12',  '10.0.0.0/8',  '192.168.0.0/24']
+subnets = [{:name => 'subnet-1',  :ip_address=>'172.16.0.0',  :cidr=>12},  {:name => 'subnet-2',  :ip_address=>'10.0.0.0',  :cidr=>8}]
+dns_servers = [{:name => 'dns-1',  :ip_address=>'1.2.3.4'},  {:name => 'dns-2',  :ip_address=>'8.7.6.5'}]
+options = {:subnet => subnets, :dns => dns_servers}
+vnet.set_network_configuration('virtual-network-name', 'location_name', address_space, options)
+
+# API to configure virtual network from xml file that can be exported from management portal and customized to add or delete vnet
+vnetxml = './customnetwork.xml'
+vnet.set_network_configuration(vnetxml)
+
+```
+
+# Getting Started with Certificates
+
+Currently the sdk supports *.pem or *.pfx (passwordless pfx) for service management operations. Following are the steps discussed on various cert operations.
+
+## Get Started with Publish Settings
+
+* To create a pfx from the publishsettings, simply download the publishsettings file for your subscription 
+[https://manage.windowsazure.com/publishsettings](https://manage.windowsazure.com/publishsettings/index?client=powershell). Make sure you have this gem installed and
+ run `pfxer --in [path to your .publishsettings file]`. This will create a .pfx from your publish settings file which can 
+ be supplied as a cert parameter for Service Management Commands.
+ 
+## Get Started with OpenSSL
+
+* Using the following openssl commands to create a cert and upload to Azure Management
+  * Generate public and private `openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout cert.pem -out cert.pem`
+  * Generate public .cer for Azure upload `openssl x509 -inform pem -in cert.pem -outform der -out mgmt.cer`
+  * Upload the `mgmt.cer` to Azure Management through [https://management.azure.com](https://management.azure.com)
+  * Use cert.pem as your cert parameter for Service Management Commands.
+
+# Contribute Code or Provide Feedback
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+## Development Environment Setup
+
+### Download Source Code
+
+To get the source code of the SDK via **git** just type:
+
+```bash
+git clone https://github.com/Azure/azure-sdk-for-ruby.git
+cd ./azure-sdk-for-ruby
+```
+
+Then, run bundler to install all the gem dependencies:
+
+```bash
+bundle install
+```
+
+### Setup the Environment for Integration Tests
+
+If you would like to run the integration test suite, you will need to setup environment variables which will be used
+during the integration tests. These tests will use these credentials to run live tests against Azure with the provided
+credentials (you will be charged for usage, so verify the clean up scripts did their job at the end of a test run).
+
+The root of the project contains a .env_sample file. This dot file is a sample of the actual environment vars needed to
+run the integration tests.
+
+Do the following to prepare your environment for integration tests:
+
+* Copy .env_sample to .env **relative to root of the project dir**
+* Update .env with your credentials **.env is in the .gitignore, so should only reside locally**
+
+### Run Tests
+
+You can use the following commands to run:
+
+* All the tests: ``rake test``. **This will run integration tests if you have .env file or env vars setup**
+* A specific suite of tests: ``rake test:unit``, ``rake test:integration``, ``rake test:integration:blob``, etc.
+* one particular test file: ``ruby -I"lib:test" "<path of the test file>"``
+
+### Generate Documentation
+
+Running the command ``yard`` will generate the API documentation in the `./doc` directory.
+
+## Provide Feedback
+
+If you encounter any bugs with the library please file an issue in the [Issues](https://github.com/Azure/azure-sdk-for-ruby/issues) section of the project.
+
+# Maintainers
+
+* [David Justice](https://github.com/devigned)
+
+# Azure CLI Tooling
+
+For documentation on [Azure PowerShell](http://github.com/azure/azure-powershell).
+For documentation on [Azure CLI](http://github.com/azure/azure-xplat-cli).