fog/fog-profitbricks

View on GitHub
lib/fog/profitbricks/requests/compute/update_lan.rb

Summary

Maintainability
A
1 hr
Test Coverage
module Fog
  module Compute
    class ProfitBricks
      class Real
        # Update LAN properties
        #
        # ==== Parameters
        # * datacenter_id<~String> - Required - UUID of the virtual data center
        # * lan_id<~String>         - Required - UUID of the LAN
        # * properties<~Hash>:
        #   * name<~String>           - The name of the LAN
        #   * public<~Integer>        - Boolean indicating if the LAN faces the public Internet or not
        #
        # ==== Returns
        # * response<~Excon::Response>:
        #   * body<~Hash>:
        #     * id<~String>           - The resource's unique identifier
        #     * type<~String>          - The type of the created resource
        #     * href<~String>          - URL to the object’s representation (absolute path)
        #     * items<~Hash>      - Collection of individual lan objects
        #       * id<~String>           - The resource's unique identifier
        #       * type<~String>          - The type of the created resource
        #       * href<~String>          - URL to the object’s representation (absolute path)
        #       * metadata<~Hash>      - Hash containing the LAN metadata
        #         * createdDate<~String>          - The date the resource was created
        #         * createdBy<~String>            - The user who created the resource
        #         * etag<~String>                      - The etag for the resource
        #         * lastModifiedDate<~String>    - The last time the resource has been modified
        #         * lastModifiedBy<~String>      - The user who last modified the resource
        #         * state<~String>            - LAN state
        #       * properties<~Hash> - Hash containing the LAN properties
        #         * name<~String>             - The name of the LAN
        #         * public<~Boolean>          - Boolean indicating if the LAN faces the public Internet or not
        #         * ipFailover<~Array>        - Attributes related to IP failover groups
        #       * entities<~Hash>   - Hash containing the LAN entities
        #         * nics<~Hash> - Hash containing the NIC properties
        #           * id<~String>           - The resource's unique identifier
        #           * type<~String>          - The type of the created resource
        #           * href<~String>          - URL to the object’s representation (absolute path)
        #           * items<~Hash>      - Collection of individual nic objects
        #             * id<~String>           - The resource's unique identifier
        #             * type<~String>          - The type of the created resource
        #             * href<~String>          - URL to the object’s representation (absolute path)
        #             * metadata<~Hash>      - Hash containing the NIC metadata
        #               * createdDate<~String>          - The date the resource was created
        #               * createdBy<~String>            - The user who created the resource
        #               * etag<~String>                      - The etag for the resource
        #               * lastModifiedDate<~String>    - The last time the resource has been modified
        #               * lastModifiedBy<~String>      - The user who last modified the resource
        #               * state<~String>            - NIC state
        #             * properties<~Hash> - Hash containing the NIC properties
        #               * name<~String>             - The name of the NIC
        #               * mac<~String>              - The MAC address of the NIC
        #               * ips<~Array>               - IPs assigned to the NIC represented as a collection
        #               * dhcp<~Boolean>            - Boolean value that indicates if the NIC is using DHCP or not
        #               * lan<~Integer>             - The LAN ID the NIC sits on
        #               * firewallActive<~Boolean>  - Once a firewall rule is added, this will reflect a true value
        #             * entities<~Hash>           - Hash containing the NIC entities
        #               * firewallrules<~Hash>      - A list of firewall rules associated to the NIC represented as a collection
        #                 * id<~String>               - The resource's unique identifier
        #                 * type<~String>                    - The type of the resource
        #                 * href<~String>                    - URL to the object’s representation (absolute path)
        #                 * items<~Array>                    - Collection of individual firewall rules objects
        #                   * id<~String>                 - The resource's unique identifier
        #                   * type<~String>                - The type of the resource
        #                   * href<~String>                - URL to the object’s representation (absolute path)
        #                   * metadata<~Hash>            - Hash containing the Firewall Rule metadata
        #                     * createdDate<~String>          - The date the resource was created
        #                     * createdBy<~String>            - The user who created the resource
        #                     * etag<~String>                      - The etag for the resource
        #                     * lastModifiedDate<~String>    - The last time the resource has been modified
        #                     * lastModifiedBy<~String>      - The user who last modified the resource
        #                     * state<~String>            - Firewall Rule state
        #                   * properties<~Hash>       - Hash containing the Firewall Rule properties
        #                     * name<~String>             - The name of the Firewall Rule
        #                     * protocol<~String>         - The protocol for the rule: TCP, UDP, ICMP, ANY
        #                     * sourceMac<~Array>         - Only traffic originating from the respective MAC address is allowed.
        #                                                   Valid format: aa:bb:cc:dd:ee:ff. Value null allows all source MAC address
        #                     * sourceIp<~Boolean>        - Only traffic originating from the respective IPv4 address is allowed.
        #                                                   Value null allows all source IPs
        #                     * targetIp<~Integer>        - In case the target NIC has multiple IP addresses, only traffic directed
        #                                                   to the respective IP address of the NIC is allowed. Value null allows all target IPs
        #                     * icmpCode<~Boolean>        - Defines the allowed code (from 0 to 254) if protocol ICMP is chosen.
        #                                                   Value null allows all codes.
        #                     * icmpType<~Boolean>        - Defines the allowed type (from 0 to 254) if the protocol ICMP is chosen.
        #                                                   Value null allows all types
        #                     * portRangeStart<~Boolean>  - Defines the start range of the allowed port (from 1 to 65534)
        #                                                   if protocol TCP or UDP is chosen. Leave portRangeStart and portRangeEnd
        #                                                   value null to allow all ports
        #                     * portRangeEnd<~Boolean>    - Defines the end range of the allowed port (from 1 to 65534)
        #                                                   if the protocol TCP or UDP is chosen. Leave portRangeStart and
        #                                                   portRangeEnd value null to allow all ports
        #
        # {ProfitBricks API Documentation}[https://devops.profitbricks.com/api/cloud/v2/#update-lan]
        def update_lan(datacenter_id, lan_id, options = {})
          request(
            :expects  => [202],
            :method   => 'PATCH',
            :path     => "/datacenters/#{datacenter_id}/lans/#{lan_id}",
            :body     => Fog::JSON.encode(options)
          )
        end
      end

      class Mock
        def update_lan(datacenter_id, lan_id, options = {})
          if lan = data[:lans]['items'].find do |attrib|
            attrib['datacenter_id'] == datacenter_id && attrib['id'] == lan_id
          end
            options.each do |key, value|
              lan[key] = value
            end
          else
            raise Fog::Errors::NotFound, 'The requested LAN resource could not be found'
          end

          response        = Excon::Response.new
          response.status = 202
          response.body   = lan
          response
        end
      end
    end
  end
end