nifty-cloud-sdk 1.7

data/lib/NIFTY/config.rb

@@ -0,0 +1,41 @@
+module NIFTY
+  module Cloud
+    # 各種設定
+    #
+    # 環境変数から各種設定値を取得します。
+    # 環境変数から取得できなかった場合はデフォルト値が適用されます。
+    #  VAR = ENV['VAR'] || デフォルト値
+
+    # 公開キー
+    ACCESS_KEY = ENV['NIFTY_CLOUD_ACCESS_KEY']                  || '<default access key>'
+    # 秘密キー
+    SECRET_KEY = ENV['NIFTY_CLOUD_SECRET_KEY']                  || '<default secret key>'
+
+    # APIのエンドポイント
+    #  @example 
+    #  'https://example.com/test/'
+    ENDPOINT_URL  = ENV['NIFTY_CLOUD_ENDPOINT_URL']             || 'https://cp.cloud.nifty.com/api/1.7/'
+
+    # プロキシサーバーのURL(デフォルト： nil)
+    #  形式： //<username>:<password>@<hostname>:<port>
+    #  @example 
+    #   '//user:password@proxy.example.com:8080'
+    PROXY_SERVER = ENV['NIFTY_CLOUD_PROXY_SERVER']
+
+    # ユーザーエージェント
+    USER_AGENT          = ENV['NIFTY_CLOUD_USER_AGENT']         || 'NIFTY Cloud API Ruby SDK'
+    # 最大リトライ回数
+    MAX_RETRY           = ENV['NIFTY_CLOUD_MAX_RETRY']          || 3
+    # 接続タイムアウト(秒)
+    CONNECTION_TIMEOUT  = ENV['NIFTY_CLOUD_CONNECTION_TIMEOUT'] || 30
+    # ソケットタイムアウト(秒)
+    SOCKET_TIMEOUT      = ENV['NIFTY_CLOUD_SOCKET_TIMEOUT']     || 30
+
+    # 認証バージョン
+    #   0 | 1 | 2
+    SIGNATURE_VERSION = ENV['NIFTY_CLOUD_SIGNATURE_VERSION']    || '2'
+    # APIの認証ロジック
+    #   HmacSHA1 | HmacSHA256
+    SIGNATURE_METHOD  = ENV['NIFTY_CLOUD_SIGNATURE_METHOD']     || 'HmacSHA256'
+  end
+end

data/lib/NIFTY/exceptions.rb

@@ -0,0 +1,32 @@
+#--
+# エラークラス
+#++
+
+module NIFTY
+  # 基底エラークラス
+  class Error < RuntimeError; end
+
+  #--
+  # クライアントエラー
+  #++
+  # 引数エラークラス
+  class ArgumentError < Error; end
+  # ユーザー定義値エラークラス
+  class ConfigurationError < Error; end
+  # レスポンス解析エラークラス
+  class ResponseFormatError < Error; end
+
+  # ニフティクラウドAPIエラークラス
+  class ResponseError < Error
+    # ニフティクラウドAPIから返却されるエラーコード
+    attr_reader :error_code
+    # ニフティクラウドAPIから返却されるエラーメッセージ
+    attr_reader :error_message
+
+    def initialize(error_code=nil, error_message=nil)
+      @error_code     = error_code
+      @error_message  = error_message
+      super(error_message)
+    end
+  end
+end

data/lib/NIFTY/responses.rb

@@ -0,0 +1,19 @@
+module NIFTY
+  class Response
+    # ニフティクラウドAPIのレスポンス解析クラス
+    #
+    #  @option options [String] :xml           解析対象のXML
+    #  @option options [Hash] :parse_options   xml-simpleの解析オプション
+    #  @return [Hash] レスポンスXML解析結果
+    #
+    def self.parse(options = {})
+      options = {
+        :xml => "",
+        :parse_options => { 'forcearray' => ['item', 'member'], 'suppressempty' => nil, 'keeproot' => false }
+      }.merge(options)
+
+      return response = XmlSimple.xml_in(options[:xml], options[:parse_options])
+    end
+  end
+end 
+

data/lib/NIFTY/version.rb

@@ -0,0 +1,3 @@
+module NIFTY
+  VERSION = '1.7'
+end

data/nifty-cloud-sdk.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "NIFTY/version"
+
+Gem::Specification.new do |s|
+  s.name        = "nifty-cloud-sdk"
+  s.version     = NIFTY::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["NIFTY Corporation"]
+  s.homepage    = "http://cloud.nifty.com/api/"
+  s.summary     = "NIFTY Cloud SDK for Ruby"
+  s.description = "It is an operation library for Nifty Cloud APIs that the server making, starting, stoping, and the server status confirming etc."
+
+  s.rdoc_options = ["--title", "NIFTY Cloud SDK documentation", "--line-numbers", "--main", "README.rdoc", "-c", "UTF-8"]
+  s.extra_rdoc_files = ["LICENSE.txt", "README.rdoc"]
+
+  s.add_dependency('xml-simple', '>= 1.0.12')
+  s.add_development_dependency('mocha', '>= 0.9.9')
+  s.add_development_dependency('test-unit', '>= 2.1.2')
+  s.add_development_dependency('test-spec', '>= 0.10.0')
+  s.add_development_dependency('rcov', '>= 0.9.9')
+  s.add_development_dependency('perftools.rb', '>= 0.5.4')
+  s.add_development_dependency('yard', '>= 0.6.2')
+
+  s.files         = Dir['Gemfile', 'Rakefile', 'nifty-cloud-sdk.gemspec', 'LICENSE.txt', 'INSTALL', 'CHANGELOG', 'README.rdoc',  'lib/**/*.rb', 'sample/**/*.rb', 'test/*.rb']
+  s.test_files    = Dir['test/*.rb']
+  s.require_paths = ["lib"]
+end

data/sample/availability_zones/describe-availability-zones.rb

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:zone_name => []
+}
+
+pp response = ncs4r.describe_availability_zones(options)
+
+response.availabilityZoneInfo.item.each do |zone|
+  p zone.zoneName
+  p zone.zoneState
+  p zone.regionName
+  if set = zone.messageSet
+    set.item.each do |item|
+      p item.message
+    end
+  end
+end

data/sample/certificate/create-ssl-certificate.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:fqdn_id                => "fqdnId",
+  #:fqdn                   => "fqdn",
+  #:count                  => 0,
+  #:validity_term          => 0,
+  #:key_length             => 0,
+  #:organization_name      => "organizationName",
+  #:organization_unit_name => "organizationUnitName",
+  #:country_name           => "countryName",
+  #:state_name             => "stateName",
+  #:location_name          => "locationName",
+  #:email_address          => "emailAddress"
+}
+
+pp response = ncs4r.create_ssl_certificate(options)
+
+p response.fqdnId
+p response.fqdn
+p response.validityTerm
+p response.certState

data/sample/certificate/delete-ssl-certificate.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:fqdn_id  => "fqdnId"
+}
+
+pp response = ncs4r.delete_ssl_certificate(options)
+
+p response.return

data/sample/certificate/describe-ssl-certificate-attribute.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:fqdn_id    => "fqdnId",
+  #:attribute  => "attribute"
+}
+
+pp response = ncs4r.describe_ssl_certificate_attribute(options)
+
+
+p response.fqdnId
+p response.fqdn
+if response["count"]
+  p response["count"].value
+end
+if response.certState.value
+  p response.certState.value
+end
+if response.period
+  p response.period.startDate
+  p response.period.endDate
+end
+if response.keyLength
+  p response.keyLength
+end
+if response.uploadState
+  p response.uploadState
+end
+if response.description
+  p response.description
+end
+if cert_info = response.certInfo
+  p cert_info.organizationName
+  p cert_info.organizationUnitName
+  p cert_info.countryName
+  p cert_info.stateName
+  p cert_info.locationName
+  p cert_info.emailAddress
+end

data/sample/certificate/describe-ssl-certificates.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:fqdn_id  => ["fqdnId"],
+  #:fqdn     => ["fqdn"],
+}
+
+pp response = ncs4r.describe_ssl_certificates(options)
+
+response.certsSet.item.each do |cert|
+  p cert.fqdnId
+  p cert.fqdn
+  p count = cert["count"]
+  p cert.certState
+  if period = cert.period
+    p period.startDate
+    p period.endDate
+  end
+  p cert.keyLength
+  p cert.uploadState
+  p cert.description
+  if cert_info = cert.certInfo
+    p cert_info.organizationName
+    p cert_info.organizationUnitName
+    p cert_info.countryName
+    p cert_info.stateName
+    p cert_info.locationName
+    p cert_info.emailAddress
+  end
+end

data/sample/certificate/download-ssl-certificate.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:fqdn_id    => "fqdnId",
+  #:file_type  => "fileType"
+}
+
+pp response = ncs4r.download_ssl_certificate(options)
+
+p response.fqdnId
+p response.fqdn
+p response.fileData

data/sample/certificate/modify-ssl-certificate-attribute.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:fqdn_id      => "fqdnId",
+  #:description  => "value"
+}
+
+pp response = ncs4r.modify_ssl_certificate_attribute(options)
+
+p response.return

data/sample/certificate/register-corporate-info-for-certificate.rb

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+#--
+# ニフティクラウドSDK for Ruby
+#
+# Ruby Gem Name::  nifty-cloud-sdk
+# Author::    NIFTY Corporation
+# Copyright:: Copyright 2011 NIFTY Corporation All Rights Reserved.
+# License::   Distributes under the same terms as Ruby
+# Home::      http://cloud.nifty.com/api/
+#++
+
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/NIFTY"
+require 'pp'
+
+ACCESS_KEY = ENV["NIFTY_CLOUD_ACCESS_KEY"] || "<Your Access Key ID>"
+SECRET_KEY = ENV["NIFTY_CLOUD_SECRET_KEY"] || "<Your Secret Access Key>"
+
+
+ncs4r = NIFTY::Cloud::Base.new(:access_key => ACCESS_KEY, :secret_key => SECRET_KEY)
+
+options = {
+  #:agreement        => true,
+  #:tdb_code         => "tdbCode",
+  #:corp_name        => "corpName",
+  #:corp_grade       => "corpGrade",
+  #:president_name1  => "presidentName1",
+  #:president_name2  => "presidentName2",
+  #:zip1             => 123,
+  #:zip2             => 4567,
+  #:pref             => "pref",
+  #:city             => "city",
+  #:name1            => "name1",
+  #:name2            => "name2",
+  #:kana_name1       => "kanaName1",
+  #:kana_name2       => "kanaName2",
+  #:post_name        => "postName",
+  #:division_name    => "divisionName"
+}
+
+pp response = ncs4r.register_corporate_info_for_certificate(options)
+
+p response.tdbCode
+p response.corpName
+p response.corpGrade
+p response.presidentName
+p response.presidentName
+p response.zip1
+p response.zip2
+p response.pref
+p response.city
+p response.name1
+p response.name2
+p response.kanaName
+p response.kanaName
+p response.postName
+p response.divisionName