aliyun-api 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e6ab3ca967777d01eb3761e25b07cffa95b9e2f2
-  data.tar.gz: 43bd5e346eaf5e8d1406cf575fdd214d314dbd09
+  metadata.gz: 65d3ac4b3cbdf248bfb914946e63c7452e677a1b
+  data.tar.gz: 0f88ba22119aa5a5a9b8aa265e36804acd4ab32c
 SHA512:
-  metadata.gz: fbc55d2940637b01152b890f547898d1c93d29a254bb8927d80bbbe1b681edcfcc3b6b7d7130f6a4a202c3a31500f88192488a7d63c3452007c7a95910d2adce
-  data.tar.gz: 7d73a98d2be106b22d72f64a80094ac2988a1c689cf68e3388f60084362da71aa23a334c3dd94fb778d4c21208143c782c1049867a0c36b9ff70784cbcf1271f
+  metadata.gz: 4da9e60b500b9c696238cefd53cd8c01c91f007a04dba02a01f5865ac093ac4f1794c4fa90827eddc538b8c7e8ce6008d93a1a7b346ac8d7b05560efabd14a8a
+  data.tar.gz: b353b8388b9251d040ec0f3b846e925363aea0a3d8c33306ba4c7254108f0ef4eb57ab3cd3dafa88c53163f618d6c65c3b4ea709f17e92ddf278256c8036caa0

data/.gitignore

@@ -12,3 +12,4 @@
 *.o
 *.a
 mkmf.log
+*.gem

data/README.md

@@ -1,6 +1,6 @@
-# Aliyun::Api
+# Aliyun
 
-TODO: Write a gem description
+The Aliyun ECS API Client for Ruby 是调用 [阿里云 ECS服务](http://help.aliyun.com/view/11108189_13730407.html) 的 Ruby客户端类库.
 
 ## Installation
 
@@ -20,7 +20,42 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+首先，需要在代码中引入类库:
+
+```
+require 'aliyun'
+```
+
+然后利用自己阿里云账号下的access_key初始化ECS对象。如果没有access_key，可以通过[阿里云用户中心](https://i.aliyun.com/access_key/)申请access_key。
+
+```
+options = {
+           :access_key_id => "xxxxxx", 
+           :access_key_secret => "yyyyyy" 
+           }
+ecs = Aliyun::ECS.new options
+```
+
+这样, 你就可以根据 [阿里云弹性计算服务API参考手册](http://help.aliyun.com/view/11108189_13730407.html)初始化业务参数（除Action参数之外）为一个hash对象，并且将其作为参数传给Action方法（Action参数）。
+
+```
+parameters = {:parameter_name => parameter_value}
+ecs.action parameters
+```
+
+(1) 例如查询可用地域列表，其Action参数为DescribeRegions，而没有其他参数，代码如下
+
+```
+ecs.describe_regions {}
+```
+
+(2) 再比如查询可用镜像，代码如下
+
+```
+parameters = {:RegionId => "cn-beijing", :PageNumber => 2, :RageSize => 20}
+service.describe_images parameters
+```
+
 
 ## Contributing
 

data/{aliyun-api.gemspec → aliyun_api.gemspec}

@@ -1,16 +1,16 @@
 # coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'aliyun/api/version'
+require 'aliyun/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "aliyun-api"
-  spec.version       = Aliyun::Api::VERSION
+  spec.version       = Aliyun::VERSION
   spec.authors       = ["qjpcpu"]
   spec.email         = ["qjpcpu@gmail.com"]
   spec.summary       = %q{Aliyun ECS API}
   spec.description   = %q{Used for aliyun ecs api}
-  spec.homepage      = ""
+  spec.homepage      = "https://github.com/qjpcpu/aliyun-api"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files -z`.split("\x0")
@@ -20,4 +20,5 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_runtime_dependency  'rest-client'
 end

data/lib/aliyun/aliyun_error.rb

@@ -0,0 +1,4 @@
+module Aliyun
+    class AliyunError < RuntimeError
+    end
+end

data/lib/aliyun/ecs.rb

@@ -0,0 +1,76 @@
+require 'time'
+require 'securerandom'
+require 'uri'
+require 'rest_client'
+require 'base64'
+require 'hmac-sha1'
+require 'json'
+
+
+module Aliyun
+    class ECS
+        def initialize(options={})
+            Aliyun.config.access_key_id ||= options[:access_key_id]
+            Aliyun.config.access_key_secret ||= options[:access_key_secret]
+            Aliyun.config.endpoint_url ||= options[:endpoint_url]
+        end
+        
+        def method_missing(method_name, *args)
+            super if  /[A-Z]/ =~ method_name.to_s
+            method_name = method_name.to_s.split('_').map{|w| w.capitalize }.join('').gsub '_',''
+            proxy_to_aliyun(method_name, args[0]) 
+        end
+        
+        private
+        def proxy_to_aliyun(method_name, params)
+            params = build_request_parameters method_name, params
+            begin
+                res = RestClient.get Aliyun.config.endpoint_url, {:params => params,:verify_ssl => OpenSSL::SSL::VERIFY_PEER }
+                return JSON.parse res.body if res.code == 200
+            rescue RestClient::Exception => rcex
+                raise AliyunError.new "response error code: #{rcex.response.code}\ndetails: #{rcex.response.body}\nrequest parameters: #{params}"
+            rescue =>e
+                raise AliyunError.new e.to_s
+            end
+        end
+        
+        def build_request_parameters(method_name, params={})
+            params = Aliyun.config.request_parameters.merge(params||{})
+            params.merge!({
+                              :AccessKeyId => Aliyun.config.access_key_id,
+                              :Action => method_name.to_s,
+                              :SignatureNonce => SecureRandom.uuid,
+                              :TimeStamp => Time.now.utc.iso8601
+                          })
+            params[:Signature] = compute_signature params
+            params
+        end
+        
+        def compute_signature(params)
+            params = params.inject({}){|memo,(k,v)| memo[k.to_sym]=v;memo}
+            sorted_keys = params.keys.sort
+            canonicalized_query_string = ""
+            sorted_keys.each do |key|
+                canonicalized_query_string << '&'
+                canonicalized_query_string << percent_encode(key.to_s)
+                canonicalized_query_string << '='
+                canonicalized_query_string << percent_encode(params[key])
+            end
+            length = canonicalized_query_string.length
+            string_to_sign = Aliyun.config.request_method + '&' + percent_encode('/') + '&' + percent_encode(canonicalized_query_string[1,length])
+            calculate_signature Aliyun.config.access_key_secret+"&", string_to_sign
+        end
+        
+        def calculate_signature key, string_to_sign
+            hmac = HMAC::SHA1.new(key)
+            hmac.update(string_to_sign)
+            signature = Base64.encode64(hmac.digest).gsub("\n", '')
+            signature
+        end
+        
+        def percent_encode value
+            value = URI.encode_www_form_component(value).gsub(/\+/,'%20').gsub(/\*/,'%2A').gsub(/%7E/,'~')
+        end
+        
+    end
+end

data/lib/aliyun/version.rb

@@ -0,0 +1,3 @@
+module Aliyun
+    VERSION = "0.0.2"
+end

data/lib/aliyun.rb

@@ -0,0 +1,24 @@
+require "aliyun/version"
+require "aliyun/aliyun_error"
+require "aliyun/ecs"
+require 'singleton'
+
+module Aliyun
+    class Config
+        include Singleton
+        attr_accessor :request_parameters, :access_key_id, :access_key_secret, :endpoint_url, :request_method
+        def initialize
+            self.request_parameters={
+                :Format=>"JSON",
+                :Version=>"2014-05-26", 
+                :SignatureMethod=>"HMAC-SHA1", 
+                :SignatureVersion=>"1.0"
+            }
+            self.request_method = 'GET'
+            self.endpoint_url= 'https://ecs.aliyuncs.com/'
+        end
+    end
+    def self.config
+        Config.instance
+    end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aliyun-api
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - qjpcpu
@@ -38,6 +38,20 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Used for aliyun ecs api
 email:
 - qjpcpu@gmail.com
@@ -50,10 +64,12 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- aliyun-api.gemspec
-- lib/aliyun/api.rb
-- lib/aliyun/api/version.rb
-homepage: ''
+- aliyun_api.gemspec
+- lib/aliyun.rb
+- lib/aliyun/aliyun_error.rb
+- lib/aliyun/ecs.rb
+- lib/aliyun/version.rb
+homepage: https://github.com/qjpcpu/aliyun-api
 licenses:
 - MIT
 metadata: {}

data/lib/aliyun/api/version.rb

@@ -1,5 +0,0 @@
-module Aliyun
-  module Api
-    VERSION = "0.0.1"
-  end
-end

data/lib/aliyun/api.rb

@@ -1,7 +0,0 @@
-require "aliyun/api/version"
-
-module Aliyun
-  module Api
-    # Your code goes here...
-  end
-end