ms_rest_azure2 0.12.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d021a2b4acb7e92e648a99bf817a1558520364b6e142fcf58dec00ced50e2bf9
+  data.tar.gz: 66fd41214e8964f9f156d42cab47ed6252f9e28b14b278957fd11c0d70557957
+SHA512:
+  metadata.gz: 985e2adade2c212e1455a51881eb1a180720c7a11533dca7d22ff7049d06c4658b343a0136d39d87a7125b671e9b08f6408605d096112f72ff8d2d16ea69efd7
+  data.tar.gz: 87be1c67067b433cf1da6a44458bb91221b46e53268f6e94d4b43ca9fdd5c9bdae9ca58027cb94500eaa13230d4b8dc6ea75df0c9c320722d3121d2ec9c1c951

data/CHANGELOG.md

@@ -0,0 +1,95 @@
+##2020.05.21 ms_rest_azure version 0.12.0
+* Unpin unf_ext dependency version.
+* Update active_directory_endpoint_url in US Cloud.
+
+##2020.03.05 ms_rest_azure version 0.11.2
+* Added Azure CLI Token provider.
+* Update faraday version to allow 1.0.0.
+* Expose token expires properties to users.
+
+##2019.05.14 ms_rest_azure version 0.11.1
+* Set unf_ext dependency version to 0.0.7.2. This change has been done to accommodate the changes made to unf_ext. Refer [Issue #604](https://github.com/meew0/discordrb/issues/604) for further details.
+* Added correlation_request_id & client_request_id to AzureOperationResponse.
+
+##2018.07.31 ms_rest_azure version 0.11.0
+* Added USER_DEFINED_IMDS_MAX_RETRY_TIME to msi_token_provider. Refer [PR #1539](https://github.com/Azure/azure-sdk-for-ruby/pull/1539) and [Issue #1344](https://github.com/Azure/azure-sdk-for-ruby/issues/1344) for further details.
+* Modified Long Running Operation Logic to make final calls based on Final State Via value. Refer [PR #1537](https://github.com/Azure/azure-sdk-for-ruby/pull/1537) for further details.
+
+##2018.06.08 ms_rest_azure version 0.10.8
+* Added case insensitive comparison to Operation status.
+
+##2018.05.16 ms_rest_azure version 0.10.7
+* Added new error code 410 for IMDS Support for MSI Token Provider class.
+
+##2018.04.16 ms_rest_azure version 0.10.6
+* Added encoding of client id, object id and msi_id in the MSI Token provider class. Refer[PR #1288](https://github.com/Azure/azure-sdk-for-ruby/pull/1288) for further details.
+
+##2018.04.16 ms_rest_azure version 0.10.5
+* Added new error codes for IMDS Support for MSI Token Provider class. Refer [PR #1286](https://github.com/Azure/azure-sdk-for-ruby/pull/1286) and [Issue #1285](https://github.com/Azure/azure-sdk-for-ruby/issues/1285) for further details.
+
+##2018.04.04 ms_rest_azure version 0.10.4
+* Added IMDS Support for MSI Token Provider class. Refer [PR #1282](https://github.com/Azure/azure-sdk-for-ruby/pull/1282) for further details. 
+
+##2018.02.06 ms_rest_azure version 0.10.3
+* Removed subscription_id check from configurable. Refer [PR# 1261](https://github.com/Azure/azure-sdk-for-ruby/pull/1261) for further details.
+
+##2018.01.30 ms_rest_azure version 0.10.2
+* Added CognitiveServicesCredentials class for the cognitive services data plane SDK. Refer [PR #1257](https://github.com/Azure/azure-sdk-for-ruby/pull/1257) for further details.
+* Added TopicCredentials class for the event grid data plane SDK. Refer [PR #1257](https://github.com/Azure/azure-sdk-for-ruby/pull/1257) for further details.
+
+##2017.12.19 ms_rest_azure version 0.10.1
+* Added support for user assigned identity to MSITokenProvider Modified portal URLs for Azure cloud environments. Refer [Issue #1175](https://github.com/Azure/azure-sdk-for-ruby/issues/1175) for further details.
+
+##2017.11.10 ms_rest_azure version 0.10.0
+* Modified portal URLs for Azure cloud environments. Refer [PR #1106](https://github.com/Azure/azure-sdk-for-ruby/pull/1106) for further details.
+* [Breaking Change] Removed Resource and SubResource classes. Refer [PR #1106](https://github.com/Azure/azure-sdk-for-ruby/pull/1106) for further details.
+* Added Configurable and Default classes to be used by the profile gems. Refer [PR #1111](https://github.com/Azure/azure-sdk-for-ruby/pull/1111) for further details.
+
+##2017.09.11 ms_rest_azure version 0.9.0
+* [Breaking Change] Managed Service Identity authentication to acquire token does not require `tenant_id`.[Issue #930](https://github.com/Azure/azure-sdk-for-ruby/issues/930) [PR #931](https://github.com/Azure/azure-sdk-for-ruby/pull/931)
+
+##2017.08.28 ms_rest_azure version 0.8.2
+* Enable Managed Service Identity authentication features into ms_rest_azure runtime for azure_mgmt_* sdks.[Issue #884](https://github.com/Azure/azure-sdk-for-ruby/issues/884) [PR #889](https://github.com/Azure/azure-sdk-for-ruby/pull/889)
+
+##2017.07.10 ms_rest_azure version 0.8.1
+* [Bug Fix] Fixed the issue with the polling status object to handle the response code and provisioning status correctly.[Issue #817](https://github.com/Azure/azure-sdk-for-ruby/issues/817) [PR #828](https://github.com/Azure/azure-sdk-for-ruby/pull/828)
+
+##2017.06.30 ms_rest_azure version 0.8.0
+* [Breaking Change] Changed the name of the azure environments from 'Azure' to 'AzureCloud' and 'AzureChina' to 'AzureChinaCloud'.[Issue #600](https://github.com/Azure/azure-sdk-for-ruby/issues/600) [PR #711](https://github.com/Azure/azure-sdk-for-ruby/pull/711)
+* Added 'Accept' header with the value 'application/json'.[Issue #701](https://github.com/Azure/azure-sdk-for-ruby/issues/701) [PR #710](https://github.com/Azure/azure-sdk-for-ruby/pull/710)
+
+##2017.02.06 ms_rest_azure version 0.7.0
+* [Breaking Change] Correcting typo in `storage_endpoint_suffix` key for azure environments [Issue #603](https://github.com/Azure/azure-sdk-for-ruby/issues/603) [PR #604](https://github.com/Azure/azure-sdk-for-ruby/pull/604)
+* [Breaking Change] Handling custom deserialization block in `MsRestAzure::AzureServiceClient.update_state_from_azure_async_operation_header` [PR #656](https://github.com/Azure/azure-sdk-for-ruby/pull/656)
+* Adding `resource_group` property on MsRestAzure::Resource to be populated with Azure resource group name when available from `id` [Issue 340](https://github.com/Azure/azure-sdk-for-ruby/issues/340) [PR #620](https://github.com/Azure/azure-sdk-for-ruby/pull/620)
+* Deriving `MsREstAzure::Resource` from `MsRestAzure::SubResource` to share `id` property [PR #663](https://github.com/Azure/azure-sdk-for-ruby/pull/663)
+
+##2016.11.14 ms_rest_azure version 0.6.2
+* Update to ms_rest v0.6.2 due to fix for missing default ca-cert for providing ssl options [#580](https://github.com/Azure/azure-sdk-for-ruby/issues/580)
+
+##2016.11.11 ms_rest_azure version 0.6.1
+* Adding telemetry extension point into AzureServiceClient [#543](https://github.com/Azure/azure-sdk-for-ruby/pull/543)
+* Removing explicit json dependency [#523](https://github.com/Azure/azure-sdk-for-ruby/pull/523)
+
+##2016.10.05 ms_rest_azure version 0.6.0
+* Minimum supported Ruby version is 2.0.0 [#1463](https://github.com/Azure/autorest/pull/1463)
+* Implemented generic request method for AzureServiceClient [#1447](https://github.com/Azure/autorest/pull/1447)
+* Improved AzureOperationError class to expose error_message and error_code properties [#1450](https://github.com/Azure/autorest/pull/1450)
+
+##2016.09.15 ms_rest_azure version 0.5.0
+* Updating ms_rest dependency to version 0.5.0
+* Adding known Azure Environments in ruby runtime for easy discovery
+* Default Azure active directory url is updated from `https://login.windows.net/` to `https://login.microsoftonline.com/` (Breaking Change)
+* Using bundled default ca-cert from ms_rest
+
+##2016.08.10 ms_rest_azure version 0.4.0
+* Adding & inheriting serialization class from ms_rest generic serializer
+
+##2016.07.21 ms_rest_azure version 0.3.1
+* [Bug fixes](https://github.com/Azure/autorest/commit/ede944a1fa30a7453aa30e6fa79154dc43393cdf)
+
+##2016.07.14 ms_rest_azure version 0.3.0
+* Embracing latest ms_rest version [0.3.0](https://rubygems.org/gems/ms_rest)
+
+##2016.05.19 ms_rest_azure version 0.2.3
+* Support patch for long running operations. See [#1011](https://github.com/Azure/autorest/pull/1011), [#1056](https://github.com/Azure/autorest/pull/1056)

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,71 @@
+# Intro
+
+MsRestAzure is a library which supports the Azure clients (SDKs) generated with Autorest tool. It contains core logic and helper classes for error handling and authentication. Also it includes azure specific logic like long polling functionality and Azure application authentication. Usually it is not supposed to be used as a standalone gem but only as a dependency for generated client gems.
+
+# Supported Ruby Versions
+
+* Ruby 2.0
+* Ruby 2.1
+* Ruby 2.2
+
+Note: x64 Ruby for Windows is known to have some compatibility issues.
+
+# Installation
+
+install the appropriate gem:
+
+```
+gem install ms_rest_azure
+```
+
+and reference it in your code:
+
+```Ruby
+require 'ms_rest_azure'
+```
+
+# Running tests
+
+MsRestAzure has only unit tests which doesn't require any preparation, just run 'rspec' command from the gem directory.
+
+# Contribution
+
+To start working on the gem the only additional dev dependecy is required - rspec. After you've added a new feature and all specs pass - you're good to go with PR. But before starting any bug/feature - please make sure you've thoroughly discussed it with repository maintainers. This gem already powers a few SDKs and backward compatibility should taken in account.
+
+# Adding gem to you generated SDK
+
+Reference it in the gemfile and also add this line to your client's gemspec file:
+
+```ruby
+spec.add_runtime_dependency 'ms_rest_azure', '~> 0.12.0'
+```
+Don't forget to correct the version.
+
+# Utilizing MSI(Managed Service Identity) Token Provider 
+
+MSI support has been enabled in `ms_rest_azure` version `0.9.0`. Below code snippet demonstrates how to use MSITokenProvider with default port `50342`:  
+
+```ruby
+provider = MsRestAzure::MSITokenProvider.new()
+credentials = MsRest::TokenCredentials.new(provider)
+```
+
+**Note**:  As of 04/04/2018, there are 2 supported ways to get MSI Token. 
+ 1. Using the extension installed locally and accessing http://localhost:50342/oauth2/token to get the MSI Token
+ 2. Accessing the http://169.254.169.254/metadata/identity/oauth2/token to get the MSI Token (default)
+
+Usually, you do not have to worry about the way you get the MSI token. If you would like to access the token specifically using the first approach, then set the environment variable 'MSI_VM' to true.
+
+# Utilizing Telemetry Extension in your SDK
+
+We encourage the customer of ms_rest_azure library to provide information about their product sent via telemetry extension point as below:
+
+```ruby
+additional_user_agent_information = 'fog-azure-rm/0.2.0' # Refer https://github.com/Azure/azure-sdk-for-ruby/issues/517 for more info.
+azure_service_client.add_user_agent_information(additional_user_agent_information)
+```
+
+
+# Provide feedback
+
+Send email to the azsdkteam@microsoft.com or file new issue in this repository.

data/lib/ms_rest_azure/active_directory_service_settings.rb

@@ -0,0 +1,63 @@
+# 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.
+
+module MsRestAzure
+  #
+  # Class which represents an settings for Azure AD authentication.
+  #
+  class ActiveDirectoryServiceSettings
+
+    # @return [String] auth token.
+    attr_accessor :authentication_endpoint
+
+    # @return [String] auth token.
+    attr_accessor :token_audience
+
+    #
+    # Returns a set of properties required to login into regular Azure cloud.
+    #
+    # @return [ActiveDirectoryServiceSettings] settings required for authentication.
+    def self.get_azure_settings
+      get_settings(MsRestAzure::AzureEnvironments::AzureCloud)
+    end
+
+    #
+    # Returns a set of properties required to login into Azure China cloud.
+    #
+    # @return [ActiveDirectoryServiceSettings] settings required for authentication.
+    def self.get_azure_china_settings
+      get_settings(MsRestAzure::AzureEnvironments::AzureChinaCloud)
+    end
+
+    #
+    # Returns a set of properties required to login into Azure German Cloud.
+    #
+    # @return [ActiveDirectoryServiceSettings] settings required for authentication.
+    def self.get_azure_german_settings
+      get_settings(MsRestAzure::AzureEnvironments::AzureGermanCloud)
+    end
+
+    #
+    # Returns a set of properties required to login into Azure US Government.
+    #
+    # @return [ActiveDirectoryServiceSettings] settings required for authentication.
+    def self.get_azure_us_government_settings
+      get_settings(MsRestAzure::AzureEnvironments::AzureUSGovernment)
+    end
+
+    private
+
+    #
+    # Returns a set of properties required to login into Azure Cloud.
+    #
+    # @param azure_environment [AzureEnvironment] An instance of AzureEnvironment.
+    # @return [ActiveDirectoryServiceSettings] settings required for authentication.
+    def self.get_settings(azure_environment = MsRestAzure::AzureEnvironments::Azure)
+      settings = ActiveDirectoryServiceSettings.new
+      settings.authentication_endpoint = azure_environment.active_directory_endpoint_url
+      settings.token_audience = azure_environment.active_directory_resource_id
+      settings
+    end
+  end
+end

data/lib/ms_rest_azure/async_operation_status.rb

@@ -0,0 +1,78 @@
+# 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.
+
+module MsRestAzure
+  #
+  # Defines values for AsyncOperationStatus enum.
+  #
+  class AsyncOperationStatus
+    ACCEPTED = 'Accepted'
+    IN_PROGRESS_STATUS = 'InProgress'
+    RUNNING = 'Running'
+    SUCCESS_STATUS = 'Succeeded'
+    FAILED_STATUS = 'Failed'
+    CANCELED_STATUS = 'Canceled'
+
+    ALL_STATUSES = [ACCEPTED, FAILED_STATUS, CANCELED_STATUS, SUCCESS_STATUS, IN_PROGRESS_STATUS, RUNNING]
+    FAILED_STATUSES = [FAILED_STATUS, CANCELED_STATUS]
+    TERMINAL_STATUSES = [FAILED_STATUS, CANCELED_STATUS, SUCCESS_STATUS]
+
+    DEFAULT_DELAY = 30
+
+    # @return [Integer] delay in seconds which should be used for polling for result of async operation.
+    attr_accessor :retry_after
+
+    # @return [MsRestAzure::CloudErrorData] error information about async operation.
+    attr_accessor :error
+
+    # @return [Stirng] status of polling.
+    attr_accessor :status
+
+    #
+    # Checks if given status is terminal one.
+    # @param status [String] status to verify
+    #
+    # @return [Boolean] True if given status is terminal one, false otherwise.
+    def self.is_terminal_status(status)
+      TERMINAL_STATUSES.any? { |st| st.casecmp(status) == 0 }
+    end
+
+    #
+    # Checks if given status is failed one.
+    # @param status [String] status to verify
+    #
+    # @return [Boolean] True if given status is failed one, false otherwise.
+    def self.is_failed_status(status)
+      FAILED_STATUSES.any? { |st| st.casecmp(status) == 0 }
+    end
+
+    #
+    # Checks if given status is successful one.
+    # @param status [String] status to verify
+    #
+    # @return [Boolean] True if given status is successful one, false otherwise.
+    def self.is_successful_status(status)
+      return (status.casecmp(SUCCESS_STATUS) == 0)
+    end
+
+    #
+    # Deserializes given hash into AsyncOperationStatus object.
+    # @param object [Hash] object to deserialize.
+    #
+    # @return [AsyncOperationStatus] deserialized object.
+    def self.deserialize_object(object)
+      return if object.nil?
+      output_object = AsyncOperationStatus.new
+
+      output_object.status = object['status']
+
+      output_object.error = CloudErrorData.deserialize_object(object['error'])
+
+      output_object.retry_after = Integer(object['retryAfter']) unless object['retryAfter'].nil?
+
+      output_object
+    end
+  end
+
+end

data/lib/ms_rest_azure/azure_cli_error.rb

@@ -0,0 +1,12 @@
+# 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.
+
+module MsRestAzure
+  #
+  # Class which represents an error with the Azure CLI.
+  #
+  class AzureCliError < StandardError
+
+  end
+end

data/lib/ms_rest_azure/azure_environment.rb

@@ -0,0 +1,163 @@
+# 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.
+
+module MsRestAzure
+  module AzureEnvironments
+    #
+    # An instance of this class describes an environment in Azure
+    #
+    class AzureEnvironment
+
+      # @return [String] the Environment name
+      attr_reader :name
+
+      # @return [String] the management portal URL
+      attr_reader :portal_url
+
+      # @return [String] the publish settings file URL
+      attr_reader :publishing_profile_url
+
+      # @return [String] the management service endpoint
+      attr_reader :management_endpoint_url
+
+      # @return [String] the resource management endpoint
+      attr_reader :resource_manager_endpoint_url
+
+      # @return [String] the sql server management endpoint for mobile commands
+      attr_reader :sql_management_endpoint_url
+
+      # @return [String] the dns suffix for sql servers
+      attr_reader :sql_server_hostname_suffix
+
+      # @return [String] the template gallery endpoint
+      attr_reader :gallery_endpoint_url
+
+      # @return [String] the Active Directory login endpoint
+      attr_reader :active_directory_endpoint_url
+
+      # @return [String] the resource ID to obtain AD tokens for
+      attr_reader :active_directory_resource_id
+
+      # @return [String] the Active Directory resource ID
+      attr_reader :active_directory_graph_resource_id
+
+      # @return [String] the Active Directory resource ID
+      attr_reader :active_directory_graph_api_version
+
+      # @return [String] the endpoint suffix for storage accounts
+      attr_reader :storage_endpoint_suffix
+
+      # @return [String] the KeyVault service dns suffix
+      attr_reader :key_vault_dns_suffix
+
+      # @return [String] the data lake store filesystem service dns suffix
+      attr_reader :datalake_store_filesystem_endpoint_suffix
+
+      # @return [String] the data lake analytics job and catalog service dns suffix
+      attr_reader :datalake_analytics_catalog_and_job_endpoint_suffix
+
+      # @return [Boolean] determines whether the authentication endpoint should be validated with Azure AD. Default value is true.
+      attr_reader :validate_authority
+
+      def initialize(options)
+        required_properties = [:name, :portal_url, :management_endpoint_url, :resource_manager_endpoint_url, :active_directory_endpoint_url, :active_directory_resource_id]
+
+        required_supplied_properties = required_properties & options.keys
+
+        if required_supplied_properties.nil? || required_supplied_properties.empty? || (required_supplied_properties & required_properties) != required_properties
+          raise ArgumentError.new("#{required_properties.to_s} are the required properties but provided properties are #{options.to_s}")
+        end
+
+        required_supplied_properties.each do |prop|
+          if options[prop].nil? || !options[prop].is_a?(String) || options[prop].empty?
+            raise ArgumentError.new("Value of the '#{prop}' property must be of type String and non empty.")
+          end
+        end
+
+        # Setting default to true
+        @validate_authority = true
+
+        options.each do |k, v|
+          instance_variable_set("@#{k}", v) unless v.nil?
+        end
+      end
+    end
+
+    AzureCloud = AzureEnvironments::AzureEnvironment.new({
+                                                        :name => 'AzureCloud',
+                                                        :portal_url => 'https://portal.azure.com',
+                                                        :publishing_profile_url => 'http://go.microsoft.com/fwlink/?LinkId=254432',
+                                                        :management_endpoint_url => 'https://management.core.windows.net',
+                                                        :resource_manager_endpoint_url => 'https://management.azure.com/',
+                                                        :sql_management_endpoint_url => 'https://management.core.windows.net:8443/',
+                                                        :sql_server_hostname_suffix => '.database.windows.net',
+                                                        :gallery_endpoint_url => 'https://gallery.azure.com/',
+                                                        :active_directory_endpoint_url => 'https://login.microsoftonline.com/',
+                                                        :active_directory_resource_id => 'https://management.core.windows.net/',
+                                                        :active_directory_graph_resource_id => 'https://graph.windows.net/',
+                                                        :active_directory_graph_api_version => '2013-04-05',
+                                                        :storage_endpoint_suffix => '.core.windows.net',
+                                                        :key_vault_dns_suffix => '.vault.azure.net',
+                                                        :datalake_store_filesystem_endpoint_suffix => 'azuredatalakestore.net',
+                                                        :datalake_analytics_catalog_and_job_endpoint_suffix => 'azuredatalakeanalytics.net'
+                                                    })
+    AzureChinaCloud = AzureEnvironments::AzureEnvironment.new({
+                                                        :name => 'AzureChinaCloud',
+                                                        :portal_url => 'https://portal.azure.cn',
+                                                        :publishing_profile_url => 'http://go.microsoft.com/fwlink/?LinkID=301774',
+                                                        :management_endpoint_url => 'https://management.core.chinacloudapi.cn',
+                                                        :resource_manager_endpoint_url => 'https://management.chinacloudapi.cn',
+                                                        :sql_management_endpoint_url => 'https://management.core.chinacloudapi.cn:8443/',
+                                                        :sql_server_hostname_suffix => '.database.chinacloudapi.cn',
+                                                        :gallery_endpoint_url => 'https://gallery.chinacloudapi.cn/',
+                                                        :active_directory_endpoint_url => 'https://login.chinacloudapi.cn/',
+                                                        :active_directory_resource_id => 'https://management.core.chinacloudapi.cn/',
+                                                        :active_directory_graph_resource_id => 'https://graph.chinacloudapi.cn/',
+                                                        :active_directory_graph_api_version => '2013-04-05',
+                                                        :storage_endpoint_suffix => '.core.chinacloudapi.cn',
+                                                        :key_vault_dns_suffix => '.vault.azure.cn',
+                                                        # TODO: add dns suffixes for the china cloud for datalake store and datalake analytics once they are defined.
+                                                        :datalake_store_filesystem_endpoint_suffix => 'N/A',
+                                                        :datalake_analytics_catalog_and_job_endpoint_suffix => 'N/A'
+                                                    })
+    AzureUSGovernment = AzureEnvironments::AzureEnvironment.new({
+                                                        :name => 'AzureUSGovernment',
+                                                        :portal_url => 'https://portal.azure.us',
+                                                        :publishing_profile_url => 'https://manage.windowsazure.us/publishsettings/index',
+                                                        :management_endpoint_url => 'https://management.core.usgovcloudapi.net',
+                                                        :resource_manager_endpoint_url => 'https://management.usgovcloudapi.net',
+                                                        :sql_management_endpoint_url => 'https://management.core.usgovcloudapi.net:8443/',
+                                                        :sql_server_hostname_suffix => '.database.usgovcloudapi.net',
+                                                        :gallery_endpoint_url => 'https://gallery.usgovcloudapi.net/',
+                                                        :active_directory_endpoint_url => 'https://login.microsoftonline.us/',
+                                                        :active_directory_resource_id => 'https://management.core.usgovcloudapi.net/',
+                                                        :active_directory_graph_resource_id => 'https://graph.windows.net/',
+                                                        :active_directory_graph_api_version => '2013-04-05',
+                                                        :storage_endpoint_suffix => '.core.usgovcloudapi.net',
+                                                        :key_vault_dns_suffix => '.vault.usgovcloudapi.net',
+                                                        # TODO: add dns suffixes for the US government for datalake store and datalake analytics once they are defined.
+                                                        :datalake_store_filesystem_endpoint_suffix => 'N/A',
+                                                        :datalake_analytics_catalog_and_job_endpoint_suffix => 'N/A'
+                                                    })
+    AzureGermanCloud = AzureEnvironments::AzureEnvironment.new({
+                                                        :name => 'AzureGermanCloud',
+                                                        :portal_url => 'http://portal.microsoftazure.de/',
+                                                        :publishing_profile_url => 'https://manage.microsoftazure.de/publishsettings/index',
+                                                        :management_endpoint_url => 'https://management.core.cloudapi.de',
+                                                        :resource_manager_endpoint_url => 'https://management.microsoftazure.de',
+                                                        :sql_management_endpoint_url => 'https://management.core.cloudapi.de:8443/',
+                                                        :sql_server_hostname_suffix => '.database.cloudapi.de',
+                                                        :gallery_endpoint_url => 'https://gallery.cloudapi.de/',
+                                                        :active_directory_endpoint_url => 'https://login.microsoftonline.de/',
+                                                        :active_directory_resource_id => 'https://management.core.cloudapi.de/',
+                                                        :active_directory_graph_resource_id => 'https://graph.cloudapi.de/',
+                                                        :active_directory_graph_api_version => '2013-04-05',
+                                                        :storage_endpoint_suffix => '.core.cloudapi.de',
+                                                        :key_vault_dns_suffix => '.vault.microsoftazure.de',
+                                                        # TODO: add dns suffixes for the US government for datalake store and datalake analytics once they are defined.
+                                                        :datalake_store_filesystem_endpoint_suffix => 'N/A',
+                                                        :datalake_analytics_catalog_and_job_endpoint_suffix => 'N/A'
+                                                    })
+  end
+end

data/lib/ms_rest_azure/azure_operation_error.rb

@@ -0,0 +1,40 @@
+# 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.
+
+module MsRestAzure
+  #
+  # Class which represents an Azure error.
+  #
+  class AzureOperationError < MsRest::HttpOperationError
+
+    # @return [String] the error message.
+    attr_accessor :error_message
+
+    # @return [String] the error code.
+    attr_accessor :error_code
+
+    #
+    # Creates and initialize new instance of the AzureOperationError class.
+    # @param [Hash] the HTTP request data (uri, body, headers).
+    # @param [Faraday::Response] the HTTP response object.
+    # @param [String] body the HTTP response body.
+    # @param [String] error message.
+    #
+    def initialize(*args)
+      super(*args)
+
+      # Try to parse @body to find useful error message and code
+      # Body should meet the error condition response requirements for Microsoft REST API Guidelines
+      # https://github.com/Microsoft/api-guidelines/blob/master/Guidelines.md#7102-error-condition-responses
+      begin
+        unless @body.nil?
+          @error_message = @body['error']['message']
+          @error_code = @body['error']['code']
+          @msg = "#{@msg}: #{@error_code}: #{@error_message}"
+        end
+      rescue
+      end
+    end
+  end
+end

data/lib/ms_rest_azure/azure_operation_response.rb

@@ -0,0 +1,20 @@
+# 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.
+
+module MsRestAzure
+  #
+  # Class which represents the data received and deserialized from Azure service.
+  #
+  class AzureOperationResponse < MsRest::HttpOperationResponse
+
+    # @return [String] identificator of the request.
+    attr_accessor :request_id
+
+    # @return [String] Correlation Id of the request.
+    attr_accessor :correlation_request_id
+
+    # @return [String] Client Request Id of the request.
+    attr_accessor :client_request_id
+  end
+end