qingcloud-sdk 0.4.1 → 2.0.0.pre.alpha.1

data/lib/qingcloud/sdk/service/image.rb

@@ -0,0 +1,304 @@
+#  +-------------------------------------------------------------------------
+#  | Copyright (C) 2016 Yunify, Inc.
+#  +-------------------------------------------------------------------------
+#  | Licensed under the Apache License, Version 2.0 (the "License");
+#  | you may not use this work except in compliance with the License.
+#  | You may obtain a copy of the License in the LICENSE file, or 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.
+#  +-------------------------------------------------------------------------
+
+require 'active_support/core_ext/hash/keys'
+
+module QingCloud
+  module SDK
+    class ImageService
+      attr_accessor :config, :properties
+
+      def initialize(config, properties)
+        self.config     = config
+        self.properties = properties.deep_symbolize_keys
+      end
+
+      # Documentation URL: https://docs.qingcloud.com/api/image/capture_instance.html
+      def capture_instance(image_name: '', instance: '')
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'CaptureInstance',
+          request_method: 'GET',
+          request_params: {
+            'image_name' => image_name,
+            'instance'   => instance,
+          },
+        }
+
+        capture_instance_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def capture_instance_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['instance'].nil? && !input['request_params']['instance'].to_s.empty?
+          raise ParameterRequiredError.new('instance', 'CaptureInstanceInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/image/delete_images.html
+      def delete_images(images: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'DeleteImages',
+          request_method: 'GET',
+          request_params: {
+            'images' => images,
+          },
+        }
+
+        delete_images_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def delete_images_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['images'].nil? && !input['request_params']['images'].to_s.empty?
+          raise ParameterRequiredError.new('images', 'DeleteImagesInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/image/describe-image-users.html
+      def describe_image_users(image_id: '', limit: nil, offset: nil)
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'DescribeImageUsers',
+          request_method: 'GET',
+          request_params: {
+            'image_id' => image_id,
+            'limit'    => limit,
+            'offset'   => offset,
+          },
+        }
+
+        describe_image_users_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def describe_image_users_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['image_id'].nil? && !input['request_params']['image_id'].to_s.empty?
+          raise ParameterRequiredError.new('image_id', 'DescribeImageUsersInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/image/describe_images.html
+      def describe_images(images: [], limit: nil, offset: nil, os_family: '', processor_type: '', provider: '', search_word: '', status: [], verbose: nil, visibility: '')
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'DescribeImages',
+          request_method: 'GET',
+          request_params: {
+            'images'         => images,
+            'limit'          => limit,
+            'offset'         => offset,
+            'os_family'      => os_family,
+            'processor_type' => processor_type, # processor_type's available values: 64bit, 32bit
+            'provider'       => provider, # provider's available values: system, self
+            'search_word'    => search_word,
+            'status'         => status,
+            'verbose'        => verbose, # verbose's available values: 0
+            'visibility'     => visibility, # visibility's available values: public, private
+          },
+        }
+
+        describe_images_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def describe_images_input_validate(input)
+        input.deep_stringify_keys!
+
+        if input['request_params']['processor_type'] && !input['request_params']['processor_type'].to_s.empty?
+          processor_type_valid_values = %w(64bit 32bit)
+          unless processor_type_valid_values.include? input['request_params']['processor_type'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'processor_type',
+              input['request_params']['processor_type'],
+              processor_type_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['provider'] && !input['request_params']['provider'].to_s.empty?
+          provider_valid_values = %w(system self)
+          unless provider_valid_values.include? input['request_params']['provider'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'provider',
+              input['request_params']['provider'],
+              provider_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['verbose'] && !input['request_params']['verbose'].to_s.empty?
+          verbose_valid_values = ['0']
+          unless verbose_valid_values.include? input['request_params']['verbose'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'verbose',
+              input['request_params']['verbose'],
+              verbose_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['visibility'] && !input['request_params']['visibility'].to_s.empty?
+          visibility_valid_values = %w(public private)
+          unless visibility_valid_values.include? input['request_params']['visibility'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'visibility',
+              input['request_params']['visibility'],
+              visibility_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/image/grant-image-to-users.html
+      def grant_image_to_users(image: '', users: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'GrantImageToUsers',
+          request_method: 'GET',
+          request_params: {
+            'image' => image,
+            'users' => users,
+          },
+        }
+
+        grant_image_to_users_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def grant_image_to_users_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['image'].nil? && !input['request_params']['image'].to_s.empty?
+          raise ParameterRequiredError.new('image', 'GrantImageToUsersInput')
+        end
+
+        unless !input['request_params']['users'].nil? && !input['request_params']['users'].to_s.empty?
+          raise ParameterRequiredError.new('users', 'GrantImageToUsersInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/image/modify_image_attributes.html
+      def modify_image_attributes(description: '', image: '', image_name: '')
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'ModifyImageAttributes',
+          request_method: 'GET',
+          request_params: {
+            'description' => description,
+            'image'       => image,
+            'image_name'  => image_name,
+          },
+        }
+
+        modify_image_attributes_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def modify_image_attributes_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['image'].nil? && !input['request_params']['image'].to_s.empty?
+          raise ParameterRequiredError.new('image', 'ModifyImageAttributesInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/image/revoke-image-from-users.html
+      def revoke_image_from_users(image: '', users: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'RevokeImageFromUsers',
+          request_method: 'GET',
+          request_params: {
+            'image' => image,
+            'users' => users,
+          },
+        }
+
+        revoke_image_from_users_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def revoke_image_from_users_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['image'].nil? && !input['request_params']['image'].to_s.empty?
+          raise ParameterRequiredError.new('image', 'RevokeImageFromUsersInput')
+        end
+
+        unless !input['request_params']['users'].nil? && !input['request_params']['users'].to_s.empty?
+          raise ParameterRequiredError.new('users', 'RevokeImageFromUsersInput')
+        end
+      end
+
+      public
+    end
+  end
+end

data/lib/qingcloud/sdk/service/instance.rb

@@ -0,0 +1,585 @@
+#  +-------------------------------------------------------------------------
+#  | Copyright (C) 2016 Yunify, Inc.
+#  +-------------------------------------------------------------------------
+#  | Licensed under the Apache License, Version 2.0 (the "License");
+#  | you may not use this work except in compliance with the License.
+#  | You may obtain a copy of the License in the LICENSE file, or 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.
+#  +-------------------------------------------------------------------------
+
+require 'active_support/core_ext/hash/keys'
+
+module QingCloud
+  module SDK
+    class InstanceService
+      attr_accessor :config, :properties
+
+      def initialize(config, properties)
+        self.config     = config
+        self.properties = properties.deep_symbolize_keys
+      end
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/describe_instance_types.html
+      def describe_instance_types(instance_types: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'DescribeInstanceTypes',
+          request_method: 'GET',
+          request_params: {
+            'instance_types' => instance_types,
+          },
+        }
+
+        describe_instance_types_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def describe_instance_types_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/describe_instances.html
+      def describe_instances(image_id: [], instance_class: nil, instance_type: [], instances: [], limit: nil, offset: nil, search_word: '', status: [], tags: [], verbose: nil)
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'DescribeInstances',
+          request_method: 'GET',
+          request_params: {
+            'image_id'       => image_id,
+            'instance_class' => instance_class, # instance_class's available values: 0, 1
+            'instance_type'  => instance_type,
+            'instances'      => instances,
+            'limit'          => limit,
+            'offset'         => offset,
+            'search_word'    => search_word,
+            'status'         => status,
+            'tags'           => tags,
+            'verbose'        => verbose, # verbose's available values: 0, 1
+          },
+        }
+
+        describe_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def describe_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        if input['request_params']['instance_class'] && !input['request_params']['instance_class'].to_s.empty?
+          instance_class_valid_values = %w(0 1)
+          unless instance_class_valid_values.include? input['request_params']['instance_class'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'instance_class',
+              input['request_params']['instance_class'],
+              instance_class_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['verbose'] && !input['request_params']['verbose'].to_s.empty?
+          verbose_valid_values = %w(0 1)
+          unless verbose_valid_values.include? input['request_params']['verbose'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'verbose',
+              input['request_params']['verbose'],
+              verbose_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/monitor/get_monitor.html
+      def get_instance_monitor(end_time: '', meters: [], resource: '', start_time: '', step: '')
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'GetMonitor',
+          request_method: 'GET',
+          request_params: {
+            'end_time'   => end_time,
+            'meters'     => meters,
+            'resource'   => resource,
+            'start_time' => start_time,
+            'step'       => step, # step's available values: 5m, 15m, 2h, 1d
+          },
+        }
+
+        get_instance_monitor_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def get_instance_monitor_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['end_time'].nil? && !input['request_params']['end_time'].to_s.empty?
+          raise ParameterRequiredError.new('end_time', 'GetInstanceMonitorInput')
+        end
+
+        unless !input['request_params']['meters'].nil? && !input['request_params']['meters'].to_s.empty?
+          raise ParameterRequiredError.new('meters', 'GetInstanceMonitorInput')
+        end
+
+        unless !input['request_params']['resource'].nil? && !input['request_params']['resource'].to_s.empty?
+          raise ParameterRequiredError.new('resource', 'GetInstanceMonitorInput')
+        end
+
+        unless !input['request_params']['start_time'].nil? && !input['request_params']['start_time'].to_s.empty?
+          raise ParameterRequiredError.new('start_time', 'GetInstanceMonitorInput')
+        end
+
+        unless !input['request_params']['step'].nil? && !input['request_params']['step'].to_s.empty?
+          raise ParameterRequiredError.new('step', 'GetInstanceMonitorInput')
+        end
+
+        if input['request_params']['step'] && !input['request_params']['step'].to_s.empty?
+          step_valid_values = %w(5m 15m 2h 1d)
+          unless step_valid_values.include? input['request_params']['step'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'step',
+              input['request_params']['step'],
+              step_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/modify_instance_attributes.html
+      def modify_instance_attributes(description: '', instance: '', instance_name: '')
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'ModifyInstanceAttributes',
+          request_method: 'GET',
+          request_params: {
+            'description'   => description,
+            'instance'      => instance,
+            'instance_name' => instance_name,
+          },
+        }
+
+        modify_instance_attributes_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def modify_instance_attributes_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['instance'].nil? && !input['request_params']['instance'].to_s.empty?
+          raise ParameterRequiredError.new('instance', 'ModifyInstanceAttributesInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/reset_instances.html
+      def reset_instances(instances: [], login_keypair: '', login_mode: '', login_passwd: '', need_newsid: nil)
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'ResetInstances',
+          request_method: 'GET',
+          request_params: {
+            'instances'     => instances,
+            'login_keypair' => login_keypair,
+            'login_mode'    => login_mode, # login_mode's available values: keypair, passwd
+            'login_passwd'  => login_passwd,
+            'need_newsid'   => need_newsid, # need_newsid's available values: 0, 1
+          },
+        }
+
+        reset_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def reset_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['instances'].nil? && !input['request_params']['instances'].to_s.empty?
+          raise ParameterRequiredError.new('instances', 'ResetInstancesInput')
+        end
+
+        unless !input['request_params']['login_mode'].nil? && !input['request_params']['login_mode'].to_s.empty?
+          raise ParameterRequiredError.new('login_mode', 'ResetInstancesInput')
+        end
+
+        if input['request_params']['login_mode'] && !input['request_params']['login_mode'].to_s.empty?
+          login_mode_valid_values = %w(keypair passwd)
+          unless login_mode_valid_values.include? input['request_params']['login_mode'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'login_mode',
+              input['request_params']['login_mode'],
+              login_mode_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['need_newsid'] && !input['request_params']['need_newsid'].to_s.empty?
+          need_newsid_valid_values = %w(0 1)
+          unless need_newsid_valid_values.include? input['request_params']['need_newsid'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'need_newsid',
+              input['request_params']['need_newsid'],
+              need_newsid_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/resize_instances.html
+      def resize_instances(cpu: nil, instance_type: '', instances: [], memory: nil)
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'ResizeInstances',
+          request_method: 'GET',
+          request_params: {
+            'cpu'           => cpu, # cpu's available values: 1, 2, 4, 8, 16
+            'instance_type' => instance_type,
+            'instances'     => instances,
+            'memory'        => memory, # memory's available values: 1024, 2048, 4096, 6144, 8192, 12288, 16384, 24576, 32768
+          },
+        }
+
+        resize_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def resize_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        if input['request_params']['cpu'] && !input['request_params']['cpu'].to_s.empty?
+          cpu_valid_values = %w(1 2 4 8 16)
+          unless cpu_valid_values.include? input['request_params']['cpu'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'cpu',
+              input['request_params']['cpu'],
+              cpu_valid_values,
+            )
+          end
+        end
+
+        unless !input['request_params']['instances'].nil? && !input['request_params']['instances'].to_s.empty?
+          raise ParameterRequiredError.new('instances', 'ResizeInstancesInput')
+        end
+
+        if input['request_params']['memory'] && !input['request_params']['memory'].to_s.empty?
+          memory_valid_values = %w(1024 2048 4096 6144 8192 12288 16384 24576 32768)
+          unless memory_valid_values.include? input['request_params']['memory'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'memory',
+              input['request_params']['memory'],
+              memory_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/restart_instances.html
+      def restart_instances(instances: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'RestartInstances',
+          request_method: 'GET',
+          request_params: {
+            'instances' => instances,
+          },
+        }
+
+        restart_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def restart_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['instances'].nil? && !input['request_params']['instances'].to_s.empty?
+          raise ParameterRequiredError.new('instances', 'RestartInstancesInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/run_instances.html
+      def run_instances(billing_id: '', count: nil, cpu: nil, hostname: '', image_id: '', instance_class: nil, instance_name: '', instance_type: '', login_keypair: '', login_mode: '', login_passwd: '', memory: nil, need_newsid: nil, need_userdata: nil, security_group: '', ui_type: '', userdata_file: '', userdata_path: '', userdata_type: '', userdata_value: '', volumes: [], vxnets: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'RunInstances',
+          request_method: 'GET',
+          request_params: {
+            'billing_id'     => billing_id,
+            'count'          => count,
+            'cpu'            => cpu, # cpu's available values: 1, 2, 4, 8, 16
+            'hostname'       => hostname,
+            'image_id'       => image_id,
+            'instance_class' => instance_class, # instance_class's available values: 0, 1
+            'instance_name'  => instance_name,
+            'instance_type'  => instance_type,
+            'login_keypair'  => login_keypair,
+            'login_mode'     => login_mode, # login_mode's available values: keypair, passwd
+            'login_passwd'   => login_passwd,
+            'memory'         => memory, # memory's available values: 1024, 2048, 4096, 6144, 8192, 12288, 16384, 24576, 32768
+            'need_newsid'    => need_newsid, # need_newsid's available values: 0, 1
+            'need_userdata'  => need_userdata,  # need_userdata's available values: 0, 1
+            'security_group' => security_group,
+            'ui_type'        => ui_type,
+            'userdata_file'  => userdata_file,
+            'userdata_path'  => userdata_path,
+            'userdata_type'  => userdata_type,  # userdata_type's available values: plain, exec, tar
+            'userdata_value' => userdata_value,
+            'volumes'        => volumes,
+            'vxnets'         => vxnets,
+          },
+        }
+
+        run_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def run_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        if input['request_params']['cpu'] && !input['request_params']['cpu'].to_s.empty?
+          cpu_valid_values = %w(1 2 4 8 16)
+          unless cpu_valid_values.include? input['request_params']['cpu'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'cpu',
+              input['request_params']['cpu'],
+              cpu_valid_values,
+            )
+          end
+        end
+
+        unless !input['request_params']['image_id'].nil? && !input['request_params']['image_id'].to_s.empty?
+          raise ParameterRequiredError.new('image_id', 'RunInstancesInput')
+        end
+
+        if input['request_params']['instance_class'] && !input['request_params']['instance_class'].to_s.empty?
+          instance_class_valid_values = %w(0 1)
+          unless instance_class_valid_values.include? input['request_params']['instance_class'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'instance_class',
+              input['request_params']['instance_class'],
+              instance_class_valid_values,
+            )
+          end
+        end
+
+        unless !input['request_params']['login_mode'].nil? && !input['request_params']['login_mode'].to_s.empty?
+          raise ParameterRequiredError.new('login_mode', 'RunInstancesInput')
+        end
+
+        if input['request_params']['login_mode'] && !input['request_params']['login_mode'].to_s.empty?
+          login_mode_valid_values = %w(keypair passwd)
+          unless login_mode_valid_values.include? input['request_params']['login_mode'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'login_mode',
+              input['request_params']['login_mode'],
+              login_mode_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['memory'] && !input['request_params']['memory'].to_s.empty?
+          memory_valid_values = %w(1024 2048 4096 6144 8192 12288 16384 24576 32768)
+          unless memory_valid_values.include? input['request_params']['memory'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'memory',
+              input['request_params']['memory'],
+              memory_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['need_newsid'] && !input['request_params']['need_newsid'].to_s.empty?
+          need_newsid_valid_values = %w(0 1)
+          unless need_newsid_valid_values.include? input['request_params']['need_newsid'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'need_newsid',
+              input['request_params']['need_newsid'],
+              need_newsid_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['need_userdata'] && !input['request_params']['need_userdata'].to_s.empty?
+          need_userdata_valid_values = %w(0 1)
+          unless need_userdata_valid_values.include? input['request_params']['need_userdata'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'need_userdata',
+              input['request_params']['need_userdata'],
+              need_userdata_valid_values,
+            )
+          end
+        end
+
+        if input['request_params']['userdata_type'] && !input['request_params']['userdata_type'].to_s.empty?
+          userdata_type_valid_values = %w(plain exec tar)
+          unless userdata_type_valid_values.include? input['request_params']['userdata_type'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'userdata_type',
+              input['request_params']['userdata_type'],
+              userdata_type_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/start_instances.html
+      def start_instances(instances: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'StartInstances',
+          request_method: 'GET',
+          request_params: {
+            'instances' => instances,
+          },
+        }
+
+        start_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def start_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['instances'].nil? && !input['request_params']['instances'].to_s.empty?
+          raise ParameterRequiredError.new('instances', 'StartInstancesInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/stop_instances.html
+      def stop_instances(force: nil, instances: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'StopInstances',
+          request_method: 'GET',
+          request_params: {
+            'force'     => force, # force's available values: 0, 1
+            'instances' => instances,
+          },
+        }
+
+        stop_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def stop_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        if input['request_params']['force'] && !input['request_params']['force'].to_s.empty?
+          force_valid_values = %w(0 1)
+          unless force_valid_values.include? input['request_params']['force'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'force',
+              input['request_params']['force'],
+              force_valid_values,
+            )
+          end
+        end
+
+        unless !input['request_params']['instances'].nil? && !input['request_params']['instances'].to_s.empty?
+          raise ParameterRequiredError.new('instances', 'StopInstancesInput')
+        end
+      end
+
+      public
+
+      # Documentation URL: https://docs.qingcloud.com/api/instance/terminate_instances.html
+      def terminate_instances(instances: [])
+        input = {
+          config:         config,
+          properties:     properties,
+          api_name:       'TerminateInstances',
+          request_method: 'GET',
+          request_params: {
+            'instances' => instances,
+          },
+        }
+
+        terminate_instances_input_validate input
+
+        request = Request.new input
+        request.send
+      end
+
+      private
+
+      def terminate_instances_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_params']['instances'].nil? && !input['request_params']['instances'].to_s.empty?
+          raise ParameterRequiredError.new('instances', 'TerminateInstancesInput')
+        end
+      end
+
+      public
+    end
+  end
+end