comet_backup_ruby_sdk 1.13.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd41ef7f0ce9f54555af78b82719b073f2bdedb8a1fac79da00fcfff58a82aae
-  data.tar.gz: aca0a1786bd48d8ed2f61a080c02fda37ac8d6b2bffc75421c3a37ea51c993a3
+  metadata.gz: 32e7a6800c1e43d0b3f33497694693dd69a090317a03ecee5a4ab8dcdbf3a8a5
+  data.tar.gz: ecbcdf90a4cf337d0f02c52c927481607611cc8f1c0c0859f2ff300e27e36a0a
 SHA512:
-  metadata.gz: 34d97b5cf4cd1bd01ee04602688b5f5355e2cbe3b5667aef32973d0f7298178cef7fb3678f4a26ecbd524cc88a03ebcce1837398be4ad1bb9e6656508ce53c8e
-  data.tar.gz: 2c205b4ead8426f4e380977510b99069a74d9233ede9d1dce74c6ca43bede641784c5edd275a9a863bfd3a938d0a40484fa87155a0d53e0bd69656723d0fc919
+  metadata.gz: 1d27e14ede1f37a25afb39292f5151b85822111c9222c45718e2e3fe25a6e0496d3dd0d327eff7887eebd50c3cc817bc6e68be1034963eb451081dc32cb9fad3
+  data.tar.gz: e76b0af2406eb542afc776130c1ae1d56e4ec6d94bca5ea4118eca1b1563a0f4b925c38ddacc686014bd19d69462da4c80a608d47c97e6de269b62b639ec019c

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # CHANGELOG
 
+## 2022-06-28 v2.0.0
+- Based on 22.6.2
+- **BREAKING:** The `Organization.Email` class member is now declared as `EmailOptions` type instead of `AdminEmailOptions`. This change is fully backward-compatible on the HTTP/JSON level, but may cause issues if your application code checked this type explicitly
+- **BREAKING:** The `AdminOrganizationDeleteRequest` API's response type has changed to be `APIResponseMessage`, not `OrganizationResponse`. The Comet Server API had only ever filled in the `APIResponseMessage`-compatible fields of the `OrganizationResponse` structure, so the HTTP/JSON response is unchanged, but this may cause issues if your application code checked this type explicitly
+- Move `frozen_string_literal` declaration to the top line of all `*.rb` files
+- "Requestable" Storage Vaults have been renamed to "Storage Templates". The API endpoint is unchanged, so this is backward-compatible with older Comet Server instances
+- Document all `ServerConfigOptions` types for the `AdminMetaServerConfigSet` and `AdminMetaServerConfigGet` APIs
+- Add new `FallbackServers` option for LDAP external authentication sources
+- Add new `RandomDelaySecs` option for job schedules
+
+## 2022-06-03 v1.15.0
+- Based on 22.5.0
+- Add `COMPRESS_*` compression settings for Self-Backups
+- Add `RESTOREARCHIVEFORMAT_TARZSTD` for using the tar.zst archive restore format
+- Add `target_organization` parameter to support cross-tenant operations in some API methods
+
+## 2022-05-25 v1.14.0
+- Based on 22.3.7
+- Add new `REMOTESERVER_S3_GENERIC` `RemoteServerType`
+- Add new `S3GenericVirtualStorageRole` support to the `RemoteServerAddress`
+
 ## 2022-05-10 v1.13.0
 - Based on 22.3.5
 - Add new `RestrictRuntime`, `FromTime`, `ToTime`, `RestrictDays`, `DaysSelect` types to ScheduleConfig to add time and day restrictions in a hourly schedule.

data/Gemfile

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 source 'https://rubygems.org'
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    comet_backup_ruby_sdk (1.13.0)
+    comet_backup_ruby_sdk (2.0.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -81,8 +81,9 @@ end
 
 ### Running SDK test suite
 
-```ruby
-bundle exec rake rubocop
+```bash
+# safe formatting/fixing and linting
+bundle exec rake rubocop -a
 
   COMETSERVER_ADDRESS='http://127.0.0.1:8060' \
 	COMETSERVER_ADMINUSER=admin \

data/Rakefile

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'rake/testtask'
 require 'rubocop/rake_task'

data/comet_backup_ruby_sdk.gemspec

@@ -12,7 +12,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'comet_backup_ruby_sdk'
-  spec.version       = '1.13.0'
+  spec.version       = '2.0.0'
   spec.authors       = ['Comet Licensing Ltd.']
   spec.email         = ['hello@cometbackup.com']
 

data/lib/comet/api_response_error.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 module Comet
 

data/lib/comet/comet_server.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'net/http'
 require 'json'
@@ -314,8 +312,9 @@ module Comet
     # @param [String] target_password New account password
     # @param [Number] store_recovery_code (Optional) If set to 1, store and keep a password recovery code for the generated user (>= 18.3.9)
     # @param [Number] require_password_change (Optional) If set to 1, require to reset password at the first login for the generated user (>= 20.3.4)
+    # @param [String] target_organization (Optional) If present, create the user account on behalf of another organization. Only allowed for administrator accounts in the top-level organization. (>= 22.3.7)
     # @return [Comet::CometAPIResponseMessage]
-    def admin_add_user(target_user, target_password, store_recovery_code = nil, require_password_change = nil)
+    def admin_add_user(target_user, target_password, store_recovery_code = nil, require_password_change = nil, target_organization = nil)
       submit_params = {}
       raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
 
@@ -333,6 +332,11 @@ module Comet
 
         submit_params['RequirePasswordChange'] = require_password_change
       end
+      unless target_organization.nil?
+        raise TypeError, "'target_organization' expected String, got #{target_organization.class}" unless target_organization.is_a? String
+
+        submit_params['TargetOrganization'] = target_organization
+      end
 
       body = perform_request('api/v1/admin/add-user', submit_params)
       json_body = JSON.parse body
@@ -352,8 +356,9 @@ module Comet
     #
     # @param [String] target_user New account username
     # @param [Comet::UserProfileConfig] profile_data New account profile
+    # @param [String] target_organization (Optional) If present, create the user account on behalf of another organization. Only allowed for administrator accounts in the top-level organization. (>= 22.3.7)
     # @return [Comet::CometAPIResponseMessage]
-    def admin_add_user_from_profile(target_user, profile_data)
+    def admin_add_user_from_profile(target_user, profile_data, target_organization = nil)
       submit_params = {}
       raise TypeError, "'target_user' expected String, got #{target_user.class}" unless target_user.is_a? String
 
@@ -361,6 +366,11 @@ module Comet
       raise TypeError, "'profile_data' expected Comet::UserProfileConfig, got #{profile_data.class}" unless profile_data.is_a? Comet::UserProfileConfig
 
       submit_params['ProfileData'] = profile_data.to_json
+      unless target_organization.nil?
+        raise TypeError, "'target_organization' expected String, got #{target_organization.class}" unless target_organization.is_a? String
+
+        submit_params['TargetOrganization'] = target_organization
+      end
 
       body = perform_request('api/v1/admin/add-user-from-profile', submit_params)
       json_body = JSON.parse body
@@ -2180,7 +2190,9 @@ module Comet
     #
     # This API will return all jobs that either started or ended within the supplied range.
     #
-    # Incomplete jobs have an end time of `0`. You can use this API to find incomplete jobs by setting both `Start` and `End` to `0`.
+    # Incomplete jobs have an end time of `0`. You can use this API to find only incomplete jobs by setting both `Start` and `End` to `0`.
+    #
+    # Prior to Comet Server 22.6.0, additional Incomplete jobs may have been returned if you specified non-zero arguments for both `Start` and `End`.
     #
     # You must supply administrator authentication credentials to use this API.
     # This API requires the Auth Role to be enabled.
@@ -2586,7 +2598,7 @@ module Comet
 
     # AdminMetaRemoteStorageVaultSet
     #
-    # Set Requestable Remote Storage Vault options.
+    # Set Storage template vault options.
     #
     # You must supply administrator authentication credentials to use this API.
     # Access to this API may be prevented on a per-administrator basis.
@@ -2974,12 +2986,14 @@ module Comet
     #
     # Delete an organization and all related users.
     #
+    # Prior to Comet 22.6.0, this API was documented as returning the OrganizationResponse type. However, it always has returned only a CometAPIResponseMessage.
+    #
     # You must supply administrator authentication credentials to use this API.
     # This API is only available for administrator accounts in the top-level Organization, not in any other Organization.
     #
     # @param [String] organization_id (Optional) (No description available)
     # @param [Comet::UninstallConfig] uninstall_config (Optional) Uninstall software configuration
-    # @return [Comet::OrganizationResponse]
+    # @return [Comet::CometAPIResponseMessage]
     def admin_organization_delete(organization_id = nil, uninstall_config = nil)
       submit_params = {}
       unless organization_id.nil?
@@ -2996,7 +3010,7 @@ module Comet
       body = perform_request('api/v1/admin/organization/delete', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      ret = Comet::OrganizationResponse.new
+      ret = Comet::CometAPIResponseMessage.new
       ret.from_hash(json_body)
       ret
     end
@@ -3029,6 +3043,8 @@ module Comet
     #
     # Create or Update an Organization.
     #
+    # Prior to Comet 22.6.0, the 'ID' and 'Organization' fields were not present in the response.
+    #
     # You must supply administrator authentication credentials to use this API.
     # This API is only available for administrator accounts in the top-level Organization, not in any other Organization.
     #
@@ -3106,13 +3122,22 @@ module Comet
     # AdminPoliciesList
     #
     # List all policy object names.
+    # For the top-level organization, the API result includes all policies for all organizations, unless the TargetOrganization parameter is present.
     #
     # You must supply administrator authentication credentials to use this API.
     # This API requires the Auth Role to be enabled.
     #
+    # @param [String] target_organization (Optional) If present, list the policies belonging to another organization. Only allowed for administrator accounts in the top-level organization. (>= 22.3.7)
     # @return [Hash{String => String}]
-    def admin_policies_list
-      body = perform_request('api/v1/admin/policies/list')
+    def admin_policies_list(target_organization = nil)
+      submit_params = {}
+      unless target_organization.nil?
+        raise TypeError, "'target_organization' expected String, got #{target_organization.class}" unless target_organization.is_a? String
+
+        submit_params['TargetOrganization'] = target_organization
+      end
+
+      body = perform_request('api/v1/admin/policies/list', submit_params)
       json_body = JSON.parse body
       check_status json_body
       ret = {}
@@ -3131,13 +3156,22 @@ module Comet
     # AdminPoliciesListFull
     #
     # Get all policy objects.
+    # For the top-level organization, the API result includes all policies for all organizations, unless the TargetOrganization parameter is present.
     #
     # You must supply administrator authentication credentials to use this API.
     # This API requires the Auth Role to be enabled.
     #
+    # @param [String] target_organization (Optional) If present, list the policies belonging to another organization. Only allowed for administrator accounts in the top-level organization. (>= 22.3.7)
     # @return [Hash{String => Comet::GroupPolicy}]
-    def admin_policies_list_full
-      body = perform_request('api/v1/admin/policies/list-full')
+    def admin_policies_list_full(target_organization = nil)
+      submit_params = {}
+      unless target_organization.nil?
+        raise TypeError, "'target_organization' expected String, got #{target_organization.class}" unless target_organization.is_a? String
+
+        submit_params['TargetOrganization'] = target_organization
+      end
+
+      body = perform_request('api/v1/admin/policies/list-full', submit_params)
       json_body = JSON.parse body
       check_status json_body
       ret = {}
@@ -3272,12 +3306,13 @@ module Comet
     # Request a new Storage Vault on behalf of a user.
     # This action does not respect the "Prevent creating new Storage Vaults (via Request)" policy setting. New Storage Vaults can be requested regardless of the policy setting.
     # Prior to Comet 19.8.0, the response type was CometAPIResponseMessage (i.e. no DestinationID field in response).
+    # The StorageProvider must exist for the target user account's organization.
     #
     # You must supply administrator authentication credentials to use this API.
     # This API requires the Auth Role to be enabled.
     #
     # @param [String] target_user The user to receive the new Storage Vault
-    # @param [String] storage_provider ID for the Requestable destination
+    # @param [String] storage_provider ID for the storage template destination
     # @param [String] self_address (Optional) The external URL for this server. Used to resolve conflicts
     # @return [Comet::RequestStorageVaultResponseMessage]
     def admin_request_storage_vault(target_user, storage_provider, self_address = nil)
@@ -3311,9 +3346,17 @@ module Comet
     # You must supply administrator authentication credentials to use this API.
     # This API requires the Auth Role to be enabled.
     #
+    # @param [String] target_organization (Optional) If present, list the storage template options belonging to another organization. Only allowed for administrator accounts in the top-level organization. (>= 22.3.7)
     # @return [Hash{String => String}]
-    def admin_request_storage_vault_providers
-      body = perform_request('api/v1/admin/request-storage-vault-providers')
+    def admin_request_storage_vault_providers(target_organization = nil)
+      submit_params = {}
+      unless target_organization.nil?
+        raise TypeError, "'target_organization' expected String, got #{target_organization.class}" unless target_organization.is_a? String
+
+        submit_params['TargetOrganization'] = target_organization
+      end
+
+      body = perform_request('api/v1/admin/request-storage-vault-providers', submit_params)
       json_body = JSON.parse body
       check_status json_body
       ret = {}

data/lib/comet/definitions.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 module Comet
 
@@ -235,6 +233,9 @@ module Comet
   # RestoreArchiveFormat: SquashFS container
   RESTOREARCHIVEFORMAT_SQFS = 3
 
+  # RestoreArchiveFormat:
+  RESTOREARCHIVEFORMAT_TARZSTD = 4
+
   # RetentionMode: If this mode is set in a RetentionPolicy, then RetentionPolicy.Ranges should be ignored.
   RETENTIONMODE_KEEP_EVERYTHING = 801
 
@@ -319,6 +320,9 @@ module Comet
 
   SCHEDULE_FREQUENCY_HIGHEST = 8015
 
+  # Maximum random delay (5 hours)
+  SCHEDULE_MAX_RANDOM_DELAY_SECS = 18_000
+
   # 2^50 (1 << 50)
   SCHEDULE_MAXINT = 1_125_899_906_842_624
 
@@ -465,13 +469,13 @@ module Comet
 
   DEFAULT_TIMEZONE = 'UTC'
 
-  APPLICATION_VERSION = '22.3.5'
+  APPLICATION_VERSION = '22.6.3'
 
   APPLICATION_VERSION_MAJOR = 22
 
-  APPLICATION_VERSION_MINOR = 3
+  APPLICATION_VERSION_MINOR = 6
 
-  APPLICATION_VERSION_REVISION = 5
+  APPLICATION_VERSION_REVISION = 3
 
   RELEASE_CODENAME = 'Voyager'
 
@@ -652,10 +656,19 @@ module Comet
   # RemoteServerType:
   REMOTESERVER_CUSTOM = 'custom'
 
+  # RemoteServerType:
+  REMOTESERVER_S3_GENERIC = 's3'
+
+  # RemoteServerType:
+  REMOTESERVER_AWS = 'aws'
+
+  # LDAPSecurityMethod:
   LDAPSECURITYMETHOD_PLAIN = 'plain'
 
+  # LDAPSecurityMethod:
   LDAPSECURITYMETHOD_LDAPS = 'ldaps'
 
+  # LDAPSecurityMethod:
   LDAPSECURITYMETHOD_STARTTLS = 'starttls'
 
   # MacOSCodesignLevel:
@@ -667,6 +680,12 @@ module Comet
   # MacOSCodesignLevel:
   MACOSCODESIGN_LEVEL_SIGN_NOTARISE_STAPLE = 2
 
+  # ClientBrandingBuildMode: Public-Doc: The software client will be custom-built by this Comet Server, allowing custom branding, default server URL, and codesigning.
+  CLIENTBRANDINGBUILD_CUSTOM = 0
+
+  # ClientBrandingBuildMode: Public-Doc: A pre-built software client will be served, with Comet-branding, no server URL, and Comet codesigning.
+  CLIENTBRANDINGBUILD_PREBUILT = 1
+
   # StreamableEventType:
   SEVT__MIN = 4000
 
@@ -694,6 +713,30 @@ module Comet
   # StreamableEventType:
   SEVT__MAX = 4999
 
+  # CompressMode:
+  COMPRESS_INVALID = 0
+
+  # CompressMode:
+  COMPRESS_LVL_1 = 1
+
+  # CompressMode:
+  COMPRESS_LVL_2 = 2
+
+  # CompressMode:
+  COMPRESS_LVL_3 = 3
+
+  # CompressMode:
+  COMPRESS_LVL_4 = 4
+
+  # CompressMode:
+  COMPRESS_LVL_5 = 5
+
+  # CompressMode:
+  COMPRESS_MAX = COMPRESS_LVL_5
+
+  # CompressMode:
+  COMPRESS_DEFAULT = COMPRESS_LVL_4
+
   OFFICE365_REGION_PUBLIC = 'GlobalPublicCloud'
 
   OFFICE365_REGION_CHINA = 'ChinaCloud'

data/lib/comet/models/add_bucket_response_message.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'json'
 

data/lib/comet/models/admin_account_properties_response.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'json'
 

data/lib/comet/models/admin_email_options.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'json'
 

data/lib/comet/models/admin_resource_response.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'json'
 

data/lib/comet/models/admin_security_options.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'json'
 

data/lib/comet/models/admin_u2fregistration.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'base64'
 require 'json'

data/lib/comet/models/admin_user_permissions.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'json'
 

data/lib/comet/models/admin_web_authn_registration.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'base64'
 require 'json'

data/lib/comet/models/allowed_admin_user.rb

@@ -1,11 +1,9 @@
-#!/usr/bin/env ruby --enable-frozen-string-literal
-#
+# frozen_string_literal: true
+
 # Copyright (c) 2020-2022 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
-#
-# frozen_string_literal: true
 
 require 'json'
 

data/lib/comet/models/amazon_awsvirtual_storage_role_settings.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2020-2022 Comet Licensing Ltd.
+# Please see the LICENSE file for usage information.
+#
+# SPDX-License-Identifier: MIT
+
+require 'json'
+
+module Comet
+
+  # AmazonAWSVirtualStorageRoleSettings is a typed class wrapper around the underlying Comet Server API data structure.
+  class AmazonAWSVirtualStorageRoleSettings
+
+    # @type [String] master_bucket
+    attr_accessor :master_bucket
+
+    # @type [String] access_key
+    attr_accessor :access_key
+
+    # @type [String] secret_key
+    attr_accessor :secret_key
+
+    # @type [Hash] Hidden storage to preserve future properties for non-destructive roundtrip operations
+    attr_accessor :unknown_json_fields
+
+    def initialize
+      clear
+    end
+
+    def clear
+      @master_bucket = ''
+      @access_key = ''
+      @secret_key = ''
+      @unknown_json_fields = {}
+    end
+
+    # @param [String] json_string The complete object in JSON format
+    def from_json(json_string)
+      raise TypeError, "'json_string' expected String, got #{json_string.class}" unless json_string.is_a? String
+
+      from_hash(JSON.parse(json_string))
+    end
+
+    # @param [Hash] obj The complete object as a Ruby hash
+    def from_hash(obj)
+      raise TypeError, "'obj' expected Hash, got #{obj.class}" unless obj.is_a? Hash
+
+      obj.each do |k, v|
+        case k
+        when 'MasterBucket'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @master_bucket = v
+        when 'AccessKey'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @access_key = v
+        when 'SecretKey'
+          raise TypeError, "'v' expected String, got #{v.class}" unless v.is_a? String
+
+          @secret_key = v
+        else
+          @unknown_json_fields[k] = v
+        end
+      end
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_hash
+      ret = {}
+      ret['MasterBucket'] = @master_bucket
+      ret['AccessKey'] = @access_key
+      ret['SecretKey'] = @secret_key
+      @unknown_json_fields.each do |k, v|
+        ret[k] = v
+      end
+      ret
+    end
+
+    # @return [Hash] The complete object as a Ruby hash
+    def to_h
+      to_hash
+    end
+
+    # @return [String] The complete object as a JSON string
+    def to_json(options = {})
+      to_hash.to_json(options)
+    end
+  end
+end