Class: SoftLayer::NetworkStorageCredential

Inherits:
ModelBase
  • Object
show all
Includes:
DynamicAttribute
Defined in:
lib/softlayer/NetworkStorageCredential.rb

Overview

Each SoftLayer NetworkStorageCredential instance provides information on a username/password credential combination used to access a specific Network Storage.

This class roughly corresponds to the entity SoftLayer_Network_Storage_Credential in the API.

Instance Attribute Summary

Attributes inherited from ModelBase

#softlayer_client

Class Method Summary collapse

Instance Method Summary collapse

Methods included from DynamicAttribute

included

Methods inherited from ModelBase

#[], #has_sl_property?, #initialize, #refresh_details, #service, sl_attr, #to_ary

Constructor Details

This class inherits a constructor from SoftLayer::ModelBase

Class Method Details

.find_network_storage_credentials(options_hash = {}) ⇒ Object

Retrieve a list of network storage credentials from all network storage devices.

The options parameter should contain:

:client - The client used to connect to the API

If no client is given, then the routine will try to use Client.default_client If no client can be found the routine will raise an error.

You may filter the list returned by adding options:

  • :datacenter (string) - Include network storage account passwords from servers matching this datacenter

  • :domain (string) - Include network storage account passwords from servers matching this domain

  • :hostname (string) - Include network storage account passwords from servers matching this hostname

  • :network_storage_server_type (string) - Include network storage account passwords attached to this server type

  • :network_storage_type (string) - Include network storage account passwords from devices of this storage type

  • :tags (Array) - Include network storage account passwords from servers matching these tags

  • :username (string) - Include network storage account passwords with this username only



72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
# File 'lib/softlayer/NetworkStorageCredential.rb', line 72

def self.find_network_storage_credentials(options_hash = {})
  softlayer_client = options_hash[:client] || Client.default_client
  raise "#{__method__} requires a client but none was given and Client::default_client is not set" if !softlayer_client

  if(options_hash.has_key? :network_storage_object_filter)
    network_storage_object_filter = options_hash[:network_storage_object_filter]
    raise "Expected an instance of SoftLayer::ObjectFilter" unless network_storage_object_filter.kind_of?(SoftLayer::ObjectFilter)
  else
    network_storage_object_filter = ObjectFilter.new()
  end

  if(options_hash.has_key? :network_storage_credential_object_filter)
    network_storage_credential_object_filter = options_hash[:network_storage_credential_object_filter]
    raise "Expected an instance of SoftLayer::ObjectFilter" unless network_storage_credential_object_filter.kind_of?(SoftLayer::ObjectFilter)
  else
    network_storage_credential_object_filter = ObjectFilter.new()
  end

  if options_hash.has_key?(:network_storage_server_type) && ! [ :hardware, :virtual_server ].include?(options_hash[:network_storage_server_type])
    raise "Expected one of :hardware or :virtual_server for :network_storage_server_type option in #{__method__}"
  end

  filter_label = {
    :evault          => "evaultNetworkStorage",
    :hardware        => "hardware",
    :hub             => "hubNetworkStorage",
    :iscsi           => "iscsiNetworkStorage",
    :lockbox         => "lockboxNetworkStorage",
    :nas             => "nasNetworkStorage",
    :network_storage => "networkStorage",
    :virtual_server  => "virtualGuest"
  }

  option_to_filter_path = {
    :datacenter                 => lambda { |storage_type, server_type| return [ filter_label[storage_type], '.', filter_label[server_type], '.datacenter.name' ].join        },
    :domain                     => lambda { |storage_type, server_type| return [ filter_label[storage_type], '.', filter_label[server_type], '.domain' ].join                 },
    :hostname                   => lambda { |storage_type, server_type| return [ filter_label[storage_type], '.', filter_label[server_type], '.hostname' ].join               },
    :tags                       => lambda { |storage_type, server_type| return [ filter_label[storage_type], '.', filter_label[server_type], '.tagReferences.tag.name' ].join },
    :network_storage_credential => {
      :username                 => "credentials.username"
    }
  }

  if options_hash[:network_storage_type]
    unless filter_label.select{|label,filter| filter.end_with?("Storage")}.keys.include?(options_hash[:network_storage_type])
      raise "Expected :evault, :hub, :iscsi, :lockbox, :nas or :network_storage for option :network_storage_type in #{__method__}"
    end
  end

  if options_hash[:network_storage_server_type]
    network_storage_type = options_hash[:network_storage_type] || :network_storage

    [ :datacenter, :domain, :hostname ].each do |option|
      if options_hash[option]
        network_storage_object_filter.modify do |filter|
          filter.accept(option_to_filter_path[option].call(network_storage_type, options_hash[:network_storage_server_type])).when_it is(options_hash[option])
        end
      end
    end

    if options_hash[:tags]
      network_storage_object_filter.set_criteria_for_key_path(option_to_filter_path[:tags].call(network_storage_type, options_hash[:network_storage_server_type]),
                                                              {
                                                                'operation' => 'in',
                                                                'options' => [{
                                                                                'name' => 'data',
                                                                                'value' => options_hash[:tags].collect{ |tag_value| tag_value.to_s }
                                                                              }]
                                                              })
    end
  end

  option_to_filter_path[:network_storage_credential].each do |option, filter_path|
    network_storage_credential_object_filter.modify { |filter| filter.accept(filter_path).when_it is(options_hash[option]) } if options_hash[option]
  end

   = softlayer_client[:Account]
   = .object_filter(network_storage_object_filter) unless network_storage_object_filter.empty?
   = .object_mask("mask[id]")

  case options_hash[:network_storage_type]
  when :evault
    network_storage_data = .getEvaultNetworkStorage
  when :hub
    network_storage_data = .getHubNetworkStorage
  when :iscsi
    network_storage_data = .getIscsiNetworkStorage
  when :lockbox
    network_storage_data = .getLockboxNetworkStorage
  when :nas
    network_storage_data = .getNasNetworkStorage
  when :network_storage, nil
    network_storage_data = .getNetworkStorage
  end

  network_storage_credentials = network_storage_data.collect do |network_storage|
    network_storage_service = softlayer_client[:Network_Storage].object_with_id(network_storage['id'])
    network_storage_service = network_storage_service.object_filter(network_storage_credential_object_filter) unless network_storage_credential_object_filter.empty?
    network_storage_service = network_storage_service.object_mask(NetworkStorageCredential.default_object_mask)
    network_storage_service = network_storage_service.object_mask(options_hash[:network_storage_credential_object_mask]) if options_hash[:network_storage_credential_object_mask]

    network_storage_credentials_data = network_storage_service.getCredentials
    network_storage_credentials_data.map { |credential| NetworkStorageCredential.new(softlayer_client, credential) unless credential.empty? }.compact
  end

  network_storage_credentials.flatten
end

Instance Method Details

#createdObject

:attr_reader: This is the data that the record was created in the table.



22
# File 'lib/softlayer/NetworkStorageCredential.rb', line 22

sl_attr :created,  'createDate'

#descriptionObject

Returns a description of the Network Storage Credential type



42
43
44
# File 'lib/softlayer/NetworkStorageCredential.rb', line 42

def description
  self['type']['description']
end

#modifiedObject

:attr_reader: This is the date that the record was last updated in the table.



27
# File 'lib/softlayer/NetworkStorageCredential.rb', line 27

sl_attr :modified, 'modifyDate'

#nameObject

Returns the name of the Network Storage Credential type



49
50
51
# File 'lib/softlayer/NetworkStorageCredential.rb', line 49

def name
  self['type']['name']
end

#passwordObject

:attr_reader: This is the password associated with the volume.



32
# File 'lib/softlayer/NetworkStorageCredential.rb', line 32

sl_attr :password

#usernameObject

:attr_reader: This is the username associated with the volume.



37
# File 'lib/softlayer/NetworkStorageCredential.rb', line 37

sl_attr :username