Class: OCI::Config

Inherits:
Object
  • Object
show all
Defined in:
lib/oci/config.rb

Overview

This class contains accessors for configuration attributes needed when using the SDK

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Config

Returns a new instance of Config.



92
93
94
95
96
97
 
# File 'lib/oci/config.rb', line 92

def initialize
  @timeout = 0
  @connection_timeout = 10
  @log_requests = false
  @key_content = nil
end

Instance Attribute Details

#additional_user_agent ⇒ String

If set, then this string will be added to the user agent sent with each request.

Returns:

  • (String) 


90
91
92
 
# File 'lib/oci/config.rb', line 90

def additional_user_agent
  @additional_user_agent
end

#connection_timeout ⇒ Integer

The time limit for the connection phase in seconds. Defaults to 10 seconds.

Returns:

  • (Integer) 


84
85
86
 
# File 'lib/oci/config.rb', line 84

def connection_timeout
  @connection_timeout
end

#fingerprint ⇒ String

SSL Fingerprint to use for authentication. Example: 20:3b:97:13:55:1c:1c:0d:d3:37:d8:50:4e:c5:3a:12

Returns:

  • (String) 


29
30
31
 
# File 'lib/oci/config.rb', line 29

def fingerprint
  @fingerprint
end

#key_content ⇒ String

Client private key content. key_content takes precedence if both key_file and key_content are provided. For the security reason, don’t provide the key content in the configuration file itself and it will be ignored by SDK. The value should be same as the content which is normally found in a .pem file. Example: “—–BEGIN RSA PRIVATE KEY—–nProc-Type: 4,ENCRYPTEDnDEK-Info: AES-128-CBC,D3D04C29BD3061489F4FF579A2133620nnjZO+B3DMBTz6Pszk0EUS8O2gU0T…jZpon—–END RSA PRIVATE KEY—–n”

Returns:

  • (String) 


50
51
52
 
# File 'lib/oci/config.rb', line 50

def key_content
  @key_content
end

#key_file ⇒ String

Client private key file. Example: ~/.ssh/oci_key

Returns:

  • (String) 


41
42
43
 
# File 'lib/oci/config.rb', line 41

def key_file
  @key_file
end

#log_requests ⇒ true, false

Whether to log detailed request and response data. This will always write to STDOUT. Defaults to false.

Returns:

  • (true, false) 


72
73
74
 
# File 'lib/oci/config.rb', line 72

def log_requests
  @log_requests
end

#logger ⇒ Logger

Gets the logger used for debugging. If nil, then OCI#logger will be returned instead.

Returns:

  • (Logger) 


102
103
104
105
106
 
# File 'lib/oci/config.rb', line 102

def logger
  return OCI.logger if @logger.nil?

  @logger
end

#pass_phrase ⇒ String

Pass phrase used for key file, if it is encrypted.

Returns:

  • (String) 


55
56
57
 
# File 'lib/oci/config.rb', line 55

def pass_phrase
  @pass_phrase
end

#region ⇒ OCI::Regions::REGION_ENUM

A region to use for APIs created with this Config.

Returns:



60
61
62
 
# File 'lib/oci/config.rb', line 60

def region
  @region
end

#tenancy ⇒ String

OCID of the tenancy to use for authentication. Example: ocid1.tenancy.oc1..aaaaaaaaba3pv6wkcr4jqae5f15p2b2m2yt2j6rx32uzr4h25vqstifsfdsq

Returns:

  • (String) 


35
36
37
 
# File 'lib/oci/config.rb', line 35

def tenancy
  @tenancy
end

#timeout ⇒ Integer

The time limit for HTTP request in seconds. Defaults to 0 (times out in 365 days).

Returns:

  • (Integer) 


78
79
80
 
# File 'lib/oci/config.rb', line 78

def timeout
  @timeout
end

#user ⇒ String

OCID of the user to use for authentication. Example: ocidv1:user:oc1:phx:1460406592659:aaaaaaaawcbqrkycbolrirg2n3xjl5fabc

Returns:

  • (String) 


23
24
25
 
# File 'lib/oci/config.rb', line 23

def user
  @user
end

Instance Method Details

#validate ⇒ Object 



108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
 
# File 'lib/oci/config.rb', line 108

def validate
  %w[user fingerprint tenancy region].each do |name|
    if !instance_variable_defined?("@#{name}") || instance_variable_get("@#{name}").nil?
      raise OCI::InvalidConfigError, "The #{name} is missing in configuration."
    end
  end

  if (!instance_variable_defined?('@key_file') || instance_variable_get('@key_file').nil?) && @key_content.nil?
    raise OCI::InvalidConfigError, 'The key_file and key_content cannot both be missing in configuration.'
  end

  PATTERNS.each do |name, pattern|
    if (pattern =~ instance_variable_get("@#{name}")).nil?
      raise OCI::InvalidConfigError, "The format of #{name} is invalid."
    end
  end
end