azure_mgmt_compute 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 27d32c64a143075b94e6cb7285f63a8f6613f345
+  data.tar.gz: dba1136554435d2f9d7846c227afab8f4c37cacc
+SHA512:
+  metadata.gz: 362d22874bd9680de59fe3da344d2aad333b34d867e80ec7ec86a4d4a92730180bd713093a19649053fe9003f75509bb5295635627d167f83d0418020ae93769
+  data.tar.gz: 787ac6d3e0b2f1f41952bdfa0c3af5cd16accdd029e1472a92788232694b88f21f540c028f8ba33f75330d6617179d33b219b204f669e495e9f87b45afc06ba2

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/resource_management/azure_mgmt_compute/spec/reports/
+/tmp/
+/.idea/

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.1.5

data/Gemfile

@@ -0,0 +1,17 @@
+# encoding: utf-8
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'azure_mgmt_resources', path: '../azure_mgmt_resources'
+  gem 'azure_mgmt_storage', path: '../azure_mgmt_storage'
+  gem 'azure_mgmt_network', path: '../azure_mgmt_network'
+end
+
+group :test do
+  gem 'rspec'
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,139 @@
+# Intro
+
+This project provides a Ruby gem for easy access to the Azure ARM Compute API. With this gem you can create/update/list/delete virtual machines, virtual machine images and virtual machine extensions. Usage operations aren't supported yet.
+
+# Supported Ruby Versions
+
+* Ruby 2+
+
+Note: x64 Ruby for Windows is known to have some compatibility issues.
+
+# Getting started
+
+## Setting up the service principal
+
+First of all to start interacting with the ARM compute you will need to setup a service principal. Service principal is an Azure application which allows you to authenticate to Azure and access Azure services. The detailed steps of how to setup a service principal can be found in this article: http://aka.ms/cli-service-principal. In the result of setting up service principal you will get tenant id, client id and client secret data.
+
+## Installation
+
+install the appropriate gem:
+
+```
+gem install azure_mgmt_compute
+```
+
+and reference it in your code:
+
+```Ruby
+require 'azure_mgmt_compute'
+```
+
+After that you should be ready to start using SDK!
+
+## Authentication
+
+```Ruby
+# Create authentication objects
+token_provider = MsRestAzure::ApplicationTokenProvider.new(tenant_id, client_id, secret)
+credentials = MsRest::TokenCredentials.new(token_provider)
+```
+
+To get tenant_id, client_id and secret for your Azure application visit Azure portal or copy them from the powershell script from the article mentioned above.
+
+## Creating new virtual machine
+
+```Ruby
+# Include SDK modules to ease access to compute classes.
+include Azure::ARM::Compute
+include Azure::ARM::Compute::Models
+
+# Create a client - a point of access to the API and set the subscription id
+client = ComputeManagementClient.new(credentials)
+client.subscription_id = subscription_id
+
+# Create a model for new virtual machine
+props = VirtualMachineProperties.new
+
+windows_config = WindowsConfiguration.new
+windows_config.provision_vmagent = true
+windows_config.enable_automatic_updates = true
+
+os_profile = OSProfile.new
+os_profile.computer_name = 'testvm1'
+os_profile.admin_username = 'testvm1'
+os_profile.admin_password = 'P@ssword1'
+os_profile.windows_configuration = windows_config
+os_profile.secrets = []
+props.os_profile = os_profile
+
+hardware_profile = HardwareProfile.new
+hardware_profile.vm_size = 'Standard_A0'
+props.hardware_profile = hardware_profile
+
+# create_storage_profile it is hypotetical helper method which creates storage
+# profile by means of ARM Storage SDK.
+props.storage_profile = create_storage_profile
+
+# create_storage_profile it is hypotetical helper method which creates network
+# profile my means of ARM Network SDK.
+props.network_profile = create_network_profile
+
+params = VirtualMachine.new
+params.type = 'Microsoft.Compute/virtualMachines'
+params.properties = props
+params.location = 'westus'
+
+promise = client.virtual_machines.create_or_update('existing_resource_group_name', 'name_of_new_vm', params)
+```
+
+The SDK method returns a promise which you can utilize depending on your needs. E.g. if you need to get result immediately via sync blocking call - do the following:
+
+```Ruby
+result = promise.value!
+```
+
+If you need to follow async flow - provide a block which will be executed in off main thread:
+
+```Ruby
+promise = promise.then do |result|
+  # Handle the result
+end
+```
+
+In both cases you're returned an instance of MsRestAzure::AzureOperationResponse which contains HTTP requests/response objects and response body. Response body is a deserialized object representing the received information. In case of code above - newly created virtual machine. To get data from it:
+
+```Ruby
+vm = result.body
+
+p vm.name # name of the new vm
+p vm.id # id of the new vm
+```
+
+Congrats, you've create new virtual machine. We encourage you to try more stuff and let us know your feedback!
+For advanced SDK usage please reference to the spec files.
+
+# Running tests
+
+## Adding env variables
+
+To run the tests you would need to set the following environment variables with your real Azure data:
+
+* azure_tenant_id
+* azure_client_id
+* azure_client_secret
+* subscription_id
+
+* run_long_tasks - set this to '1' only if you would like to run time consuming tests like VM creation.
+
+## Starting tests
+
+Just run 'rspec' command from the current gem folder.
+
+# Contribution
+
+All the SDK code was generated by tool 'AutoRest' - https://github.com/Azure/autorest
+So if you have found a bug or have an idea for a new feature - suggest, discuss and contribute it into the AutoRest repository. After that SDK maintainers will update the sources and the gem.
+
+# Provide feedback
+
+Send email to the azsdkteam@microsoft.com or file new issue in this repository.

data/Rakefile

@@ -0,0 +1,5 @@
+# encoding: utf-8
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+
+require "bundler/gem_tasks"

data/azure_mgmt_compute.gemspec

@@ -0,0 +1,39 @@
+# encoding: utf-8
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'azure_mgmt_compute/module_definition'
+require 'azure_mgmt_compute/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'azure_mgmt_compute'
+  spec.version       = Azure::ARM::Compute::VERSION
+  spec.authors       = 'Microsoft Corporation'
+  spec.email         = 'azsdkteam@microsoft.com'
+  spec.description   = 'Microsoft Azure Compute Management Client Library for Ruby'
+  spec.summary       = 'Official ruby client library to consume Microsoft Azure Compute Management services.'
+  spec.homepage      = 'http://github.com/azure/azure-sdk-for-ruby'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'bin'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.9'
+  spec.add_development_dependency 'rake', '~> 10'
+  spec.add_development_dependency 'rspec', '~> 3'
+  spec.add_development_dependency 'dotenv', '~> 2'
+  spec.add_development_dependency 'azure_mgmt_resources', '~> 0.1'
+  spec.add_development_dependency 'azure_mgmt_storage', '~> 0.1'
+  spec.add_development_dependency 'azure_mgmt_network', '~> 0.1'
+
+  spec.add_runtime_dependency 'json', '~> 1.8'
+  spec.add_runtime_dependency 'concurrent-ruby', ['>= 1.0.0.pre1', '<2']
+  spec.add_runtime_dependency 'faraday', '~> 0.9'
+  spec.add_runtime_dependency 'faraday-cookie_jar', '~> 0.0.6'
+  spec.add_runtime_dependency 'ms_rest_azure', '~> 0.1'
+end

data/lib/azure_mgmt_compute.rb

@@ -0,0 +1,103 @@
+# encoding: utf-8
+# Code generated by Microsoft (R) AutoRest Code Generator 0.11.0.0
+# Changes may cause incorrect behavior and will be lost if the code is
+# regenerated.
+
+
+require 'uri'
+require 'cgi'
+require 'date'
+require 'json'
+require 'base64'
+require 'erb'
+require 'securerandom'
+require 'time'
+require 'timeliness'
+require 'faraday'
+require 'faraday-cookie_jar'
+require 'concurrent'
+require 'ms_rest'
+require 'ms_rest_azure'
+
+require 'azure_mgmt_compute/module_definition'
+require 'azure_mgmt_compute/version'
+
+module Azure::ARM::Compute
+  autoload :AvailabilitySets,                                   'azure_mgmt_compute/availability_sets.rb'
+  autoload :VirtualMachineImages,                               'azure_mgmt_compute/virtual_machine_images.rb'
+  autoload :VirtualMachineExtensionImages,                      'azure_mgmt_compute/virtual_machine_extension_images.rb'
+  autoload :VirtualMachineExtensions,                           'azure_mgmt_compute/virtual_machine_extensions.rb'
+  autoload :UsageOperations,                                    'azure_mgmt_compute/usage_operations.rb'
+  autoload :VirtualMachineSizes,                                'azure_mgmt_compute/virtual_machine_sizes.rb'
+  autoload :VirtualMachines,                                    'azure_mgmt_compute/virtual_machines.rb'
+  autoload :ComputeManagementClient,                            'azure_mgmt_compute/compute_management_client.rb'
+
+  module Models
+    autoload :InstanceViewStatus,                                 'azure_mgmt_compute/models/instance_view_status.rb'
+    autoload :AvailabilitySetProperties,                          'azure_mgmt_compute/models/availability_set_properties.rb'
+    autoload :AvailabilitySetListResult,                          'azure_mgmt_compute/models/availability_set_list_result.rb'
+    autoload :VirtualMachineSize,                                 'azure_mgmt_compute/models/virtual_machine_size.rb'
+    autoload :VirtualMachineSizeListResult,                       'azure_mgmt_compute/models/virtual_machine_size_list_result.rb'
+    autoload :PurchasePlan,                                       'azure_mgmt_compute/models/purchase_plan.rb'
+    autoload :OSDiskImage,                                        'azure_mgmt_compute/models/osdisk_image.rb'
+    autoload :DataDiskImage,                                      'azure_mgmt_compute/models/data_disk_image.rb'
+    autoload :VirtualMachineImageProperties,                      'azure_mgmt_compute/models/virtual_machine_image_properties.rb'
+    autoload :VirtualMachineExtensionImageProperties,             'azure_mgmt_compute/models/virtual_machine_extension_image_properties.rb'
+    autoload :VirtualMachineExtensionInstanceView,                'azure_mgmt_compute/models/virtual_machine_extension_instance_view.rb'
+    autoload :VirtualMachineExtensionProperties,                  'azure_mgmt_compute/models/virtual_machine_extension_properties.rb'
+    autoload :UsageName,                                          'azure_mgmt_compute/models/usage_name.rb'
+    autoload :Usage,                                              'azure_mgmt_compute/models/usage.rb'
+    autoload :ListUsagesResult,                                   'azure_mgmt_compute/models/list_usages_result.rb'
+    autoload :VirtualMachineCaptureParameters,                    'azure_mgmt_compute/models/virtual_machine_capture_parameters.rb'
+    autoload :ComputeLongRunningOperationProperties,              'azure_mgmt_compute/models/compute_long_running_operation_properties.rb'
+    autoload :ApiErrorBase,                                       'azure_mgmt_compute/models/api_error_base.rb'
+    autoload :InnerError,                                         'azure_mgmt_compute/models/inner_error.rb'
+    autoload :ApiError,                                           'azure_mgmt_compute/models/api_error.rb'
+    autoload :ComputeLongRunningOperationResult,                  'azure_mgmt_compute/models/compute_long_running_operation_result.rb'
+    autoload :Plan,                                               'azure_mgmt_compute/models/plan.rb'
+    autoload :HardwareProfile,                                    'azure_mgmt_compute/models/hardware_profile.rb'
+    autoload :ImageReference,                                     'azure_mgmt_compute/models/image_reference.rb'
+    autoload :VirtualHardDisk,                                    'azure_mgmt_compute/models/virtual_hard_disk.rb'
+    autoload :OSDisk,                                             'azure_mgmt_compute/models/osdisk.rb'
+    autoload :DataDisk,                                           'azure_mgmt_compute/models/data_disk.rb'
+    autoload :StorageProfile,                                     'azure_mgmt_compute/models/storage_profile.rb'
+    autoload :AdditionalUnattendContent,                          'azure_mgmt_compute/models/additional_unattend_content.rb'
+    autoload :WinRMListener,                                      'azure_mgmt_compute/models/win_rmlistener.rb'
+    autoload :WinRMConfiguration,                                 'azure_mgmt_compute/models/win_rmconfiguration.rb'
+    autoload :WindowsConfiguration,                               'azure_mgmt_compute/models/windows_configuration.rb'
+    autoload :SshPublicKey,                                       'azure_mgmt_compute/models/ssh_public_key.rb'
+    autoload :SshConfiguration,                                   'azure_mgmt_compute/models/ssh_configuration.rb'
+    autoload :LinuxConfiguration,                                 'azure_mgmt_compute/models/linux_configuration.rb'
+    autoload :VaultCertificate,                                   'azure_mgmt_compute/models/vault_certificate.rb'
+    autoload :VaultSecretGroup,                                   'azure_mgmt_compute/models/vault_secret_group.rb'
+    autoload :OSProfile,                                          'azure_mgmt_compute/models/osprofile.rb'
+    autoload :NetworkInterfaceReferenceProperties,                'azure_mgmt_compute/models/network_interface_reference_properties.rb'
+    autoload :NetworkProfile,                                     'azure_mgmt_compute/models/network_profile.rb'
+    autoload :VirtualMachineExtensionHandlerInstanceView,         'azure_mgmt_compute/models/virtual_machine_extension_handler_instance_view.rb'
+    autoload :VirtualMachineAgentInstanceView,                    'azure_mgmt_compute/models/virtual_machine_agent_instance_view.rb'
+    autoload :DiskInstanceView,                                   'azure_mgmt_compute/models/disk_instance_view.rb'
+    autoload :VirtualMachineInstanceView,                         'azure_mgmt_compute/models/virtual_machine_instance_view.rb'
+    autoload :VirtualMachineProperties,                           'azure_mgmt_compute/models/virtual_machine_properties.rb'
+    autoload :VirtualMachineListResult,                           'azure_mgmt_compute/models/virtual_machine_list_result.rb'
+    autoload :DeleteOperationResult,                              'azure_mgmt_compute/models/delete_operation_result.rb'
+    autoload :AvailabilitySet,                                    'azure_mgmt_compute/models/availability_set.rb'
+    autoload :VirtualMachineImage,                                'azure_mgmt_compute/models/virtual_machine_image.rb'
+    autoload :VirtualMachineImageResource,                        'azure_mgmt_compute/models/virtual_machine_image_resource.rb'
+    autoload :VirtualMachineExtensionImage,                       'azure_mgmt_compute/models/virtual_machine_extension_image.rb'
+    autoload :VirtualMachineExtension,                            'azure_mgmt_compute/models/virtual_machine_extension.rb'
+    autoload :NetworkInterfaceReference,                          'azure_mgmt_compute/models/network_interface_reference.rb'
+    autoload :VirtualMachine,                                     'azure_mgmt_compute/models/virtual_machine.rb'
+    autoload :StatusLevelTypes,                                   'azure_mgmt_compute/models/status_level_types.rb'
+    autoload :OperatingSystemTypes,                               'azure_mgmt_compute/models/operating_system_types.rb'
+    autoload :UsageUnit,                                          'azure_mgmt_compute/models/usage_unit.rb'
+    autoload :ComputeOperationStatus,                             'azure_mgmt_compute/models/compute_operation_status.rb'
+    autoload :VirtualMachineSizeTypes,                            'azure_mgmt_compute/models/virtual_machine_size_types.rb'
+    autoload :CachingTypes,                                       'azure_mgmt_compute/models/caching_types.rb'
+    autoload :DiskCreateOptionTypes,                              'azure_mgmt_compute/models/disk_create_option_types.rb'
+    autoload :PassNames,                                          'azure_mgmt_compute/models/pass_names.rb'
+    autoload :ComponentNames,                                     'azure_mgmt_compute/models/component_names.rb'
+    autoload :SettingNames,                                       'azure_mgmt_compute/models/setting_names.rb'
+    autoload :ProtocolTypes,                                      'azure_mgmt_compute/models/protocol_types.rb'
+    autoload :OperationStatus,                                    'azure_mgmt_compute/models/operation_status.rb'
+  end
+end

data/lib/azure_mgmt_compute/Models/additional_unattend_content.rb

@@ -0,0 +1,108 @@
+# encoding: utf-8
+# Code generated by Microsoft (R) AutoRest Code Generator 0.11.0.0
+# Changes may cause incorrect behavior and will be lost if the code is
+# regenerated.
+
+module Azure::ARM::Compute
+  module Models
+    #
+    # Gets or sets additional XML formatted information that can be included
+    # in the Unattend.xml file, which is used by Windows Setup. Contents are
+    # defined by setting name, component name, and the pass in which the
+    # content is a applied.
+    #
+    class AdditionalUnattendContent
+
+      include MsRestAzure
+
+      # @return [PassNames] Gets or sets the pass name. Currently, the only
+      # allowable value is oobeSystem. Possible values for this property
+      # include: 'oobeSystem'.
+      attr_accessor :pass_name
+
+      # @return [ComponentNames] Gets or sets the component name. Currently,
+      # the only allowable value is Microsoft-Windows-Shell-Setup. Possible
+      # values for this property include: 'Microsoft-Windows-Shell-Setup'.
+      attr_accessor :component_name
+
+      # @return [SettingNames] Gets or sets setting name (e.g.
+      # FirstLogonCommands, AutoLogon ). Possible values for this property
+      # include: 'AutoLogon', 'FirstLogonCommands'.
+      attr_accessor :setting_name
+
+      # @return [String] Gets or sets XML formatted content that is added to
+      # the unattend.xml file in the specified pass and component.The XML
+      # must be less than 4 KB and must include the root element for the
+      # setting or feature that is being inserted.
+      attr_accessor :content
+
+      #
+      # Validate the object. Throws ValidationError if validation fails.
+      #
+      def validate
+      end
+
+      #
+      # Serializes given Model object into Ruby Hash.
+      # @param object Model object to serialize.
+      # @return [Hash] Serialized object in form of Ruby Hash.
+      #
+      def self.serialize_object(object)
+        object.validate
+        output_object = {}
+
+        serialized_property = object.pass_name
+        output_object['passName'] = serialized_property unless serialized_property.nil?
+
+        serialized_property = object.component_name
+        output_object['componentName'] = serialized_property unless serialized_property.nil?
+
+        serialized_property = object.setting_name
+        output_object['settingName'] = serialized_property unless serialized_property.nil?
+
+        serialized_property = object.content
+        output_object['content'] = serialized_property unless serialized_property.nil?
+
+        output_object
+      end
+
+      #
+      # Deserializes given Ruby Hash into Model object.
+      # @param object [Hash] Ruby Hash object to deserialize.
+      # @return [AdditionalUnattendContent] Deserialized object.
+      #
+      def self.deserialize_object(object)
+        return if object.nil?
+        output_object = AdditionalUnattendContent.new
+
+        deserialized_property = object['passName']
+        if (!deserialized_property.nil? && !deserialized_property.empty?)
+          enum_is_valid = PassNames.constants.any? { |e| PassNames.const_get(e).to_s.downcase == deserialized_property.downcase }
+          fail MsRest::DeserializationError.new('Error occured while deserializing the enum', nil, nil, nil) unless enum_is_valid
+        end
+        output_object.pass_name = deserialized_property
+
+        deserialized_property = object['componentName']
+        if (!deserialized_property.nil? && !deserialized_property.empty?)
+          enum_is_valid = ComponentNames.constants.any? { |e| ComponentNames.const_get(e).to_s.downcase == deserialized_property.downcase }
+          fail MsRest::DeserializationError.new('Error occured while deserializing the enum', nil, nil, nil) unless enum_is_valid
+        end
+        output_object.component_name = deserialized_property
+
+        deserialized_property = object['settingName']
+        if (!deserialized_property.nil? && !deserialized_property.empty?)
+          enum_is_valid = SettingNames.constants.any? { |e| SettingNames.const_get(e).to_s.downcase == deserialized_property.downcase }
+          fail MsRest::DeserializationError.new('Error occured while deserializing the enum', nil, nil, nil) unless enum_is_valid
+        end
+        output_object.setting_name = deserialized_property
+
+        deserialized_property = object['content']
+        output_object.content = deserialized_property
+
+        output_object.validate
+
+        output_object
+      end
+    end
+  end
+end