1and1 1.1

data/sphinx/_build/html/_sources/load_balancers.txt

@@ -0,0 +1,231 @@
+Load Balancers
+*****************
+
+.. rb:class:: OneAndOne::LoadBalancer()
+   
+   The :rb:class:`LoadBalancer` class allows a user to perform actions against the 1and1 API.
+
+
+   .. rb:method:: list(page: nil, per_page: nil, sort: nil, q: nil, fields: nil)
+
+     Return a list of all load balancers.
+
+     :param page: Allows the use of pagination. Indicate which page to start on.
+     :type page: ``int``
+
+     :param per_page: Number of items per page.
+     :type per_page: ``int``
+
+     :param sort: ``sort: 'name'`` retrieves a list of elements sorted 
+       alphabetically. ``sort: 'creation_date'`` retrieves a list of elements 
+       sorted by their creation date in descending order.
+     :type sort: ``str``
+
+     :param q: ``q`` is for query. Use this parameter to return only the items 
+       that match your search query.
+     :type q: ``str``
+
+     :param fields: Returns only the parameters requested. 
+       (i.e. fields: 'id, name, description, hardware.ram')
+     :type fields: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: create(name: nil, description: nil, health_check_test: nil, health_check_interval: nil, persistence: nil, persistence_time: nil, method: nil, rules: nil, health_check_path: nil, health_check_parse: nil)
+
+     Create a load balancer.
+
+     :param name: load balancer name.
+     :type name: ``str``
+
+     :param description: load balancer description.
+     :type description: ``str``
+
+     :param health_check_test: possible values are ``"NONE"`` or ``"TCP"``.
+     :type health_check_test: ``str``
+
+     :param health_check_interval: Health check period in seconds.  Can range between ``5`` and ``300`` seconds.
+     :type health_check_interval: ``int``
+
+     :param persistence: enable or disable persistence.
+     :type persistence: ``bool``
+
+     :param persistence_time: Persistence time in seconds. Required if persistence is enabled.  Can range from ``30`` to ``1200`` seconds
+     :type persistence_time: ``int``
+
+     :param method: balancing procedure.  Possible values are ``"ROUND_ROBIN"`` or ``"LEAST_CONNECTIONS"``.
+     :type method: ``str`` 
+
+     :param rules: takes an array of "rule" objects to be added to the load balancer.
+     :type rules: ``array``
+
+     :param health_check_path: Url to call for checking. Required for HTTP health check.
+     :type health_check_path: ``str``
+
+     :param health_check_parse: Regular expression to check. Required for HTTP health check.
+     :type health_check_parse: ``str``
+
+
+   .. rb:method:: get(load_balancer_id: @id)
+
+     Returns the current specs of a load balancer.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: modify(load_balancer_id: @id, name: nil, description: nil, health_check_test: nil, health_check_interval: nil, persistence: nil, persistence_time: nil, method: nil, health_check_path: nil, health_check_parse: nil)
+
+      Modify a load balancer.
+
+      :param load_balancer_id: the unique identifier for the load balancer.
+      :type load_balancer_id: ``str``
+
+      :param name: load balancer name.
+      :type name: ``str``
+
+      :param description: load balancer description.
+      :type description: ``str``
+
+      :param health_check_test: possible values are ``"NONE"``,``"TCP"``, or ``"HTTP"``.
+      :type health_check_test: ``str``
+
+      :param health_check_interval: Health check period in seconds.
+      :type health_check_interval: ``int``
+
+      :param persistence: enable or disable persistnece.
+      :type persistence: ``bool``
+
+      :param persistence_time: Persistence time in seconds. Required if persistence is enabled.
+      :type persistence_time: ``int``
+
+      :param method: balancing procedure.  possible values are ``"ROUND_ROBIN"`` or ``"LEAST_CONNECTIONS"``.
+      :type method: ``str``
+
+      :param health_check_path: Url to call for checking. Required for HTTP health check.
+      :type health_check_path: ``str``
+
+      :param health_check_parse: Regular expression to check. Required for HTTP health check.
+      :type health_check_parse: ``str``
+
+      :rtype: JSON
+
+
+   .. rb:method:: delete(load_balancer_id: @id)
+
+     Delete a load balancer.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: ips(load_balancer_id: @id)
+
+     Returns a list of the IP's assigned to a load balancer.
+
+     Delete a load balancer.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: ip(load_balancer_id: @id, ip_id: nil)
+
+     Returns information about an IP assigned to a load balancer.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :param ip_id: the unique identifier for the IP.
+     :type ip_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: remove_ip(load_balancer_id: @id, ip_id: nil)
+
+     Remove an IP from a load balancer.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :param ip_id: the unique identifier for the IP.
+     :type ip_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: add_ips(load_balancer_id: @id, ips: nil)
+
+     Assign IP's to a load balancer.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :param ips: takes an array of IP strings to be added to the load balancer.
+     :type ips: ``array``
+
+     :rtype: JSON
+
+
+   .. rb:method:: rules(load_balancer_id: @id)
+
+     Returns a list of the load balancer's rules.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: rule(load_balancer_id: @id, rule_id: nil)
+
+     Returns information about a load balancer's rule.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :param rule_id: the unique identifier for the rule.
+     :type rule_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: add_rules(load_balancer_id: @id, rules: nil)
+
+     Add rules to a load balancer.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :param rules: takes an array of "rule" objects to be added to the load balancer.
+     :type rules: ``array``
+
+     :rtype: JSON
+
+
+   .. rb:method:: remove_rule(load_balancer_id: @id, rule_id: nil)
+
+     Remove a load balancer's rule.
+
+     :param load_balancer_id: the unique identifier for the load balancer.
+     :type load_balancer_id: ``str``
+
+     :param rule_id: the unique identifier for the rule.
+     :type rule_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: wait_for()
+
+     Polls the load balancer until an "ACTIVE" state is returned.  Use this when chaining actions.
+
+     :rtype: ``nil``

data/sphinx/_build/html/_sources/logs.txt

@@ -0,0 +1,55 @@
+Logs
+*****************
+
+.. rb:class:: OneAndOne::Log()
+   
+   The :rb:class:`Log` class allows a user to perform actions against the 1and1 API.
+
+
+   .. rb:method:: list(page: nil, per_page: nil, sort: nil, q: nil, fields: nil, period: 'LAST_24H', start_date: nil, end_date: nil)
+
+     List all logs by time period.
+
+     :param page: Allows the use of pagination. Indicate which page to start on.
+     :type page: ``int``
+
+     :param per_page: Number of items per page.
+     :type per_page: ``int``
+
+     :param sort: ``sort: 'name'`` retrieves a list of elements sorted 
+       alphabetically. ``sort: 'creation_date'`` retrieves a list of elements 
+       sorted by their creation date in descending order.
+     :type sort: ``str``
+
+     :param q: ``q`` is for query. Use this parameter to return only the items 
+       that match your search query.
+     :type q: ``str``
+
+     :param fields: Returns only the parameters requested. 
+       (i.e. fields: 'id, name, description, hardware.ram')
+     :type fields: ``str``
+
+     :param period: the time range of logs to be shown.  Possible values are 
+        ``'LAST_HOUR'``, ``'LAST_24H'``, ``'LAST_7D'``, ``'LAST_30D'``, 
+        ``'LAST_365D'``, or ``'CUSTOM'``
+     :type period: ``str``
+
+     :param start_date: start point.  Only required if using ``'CUSTOM'`` for the 
+        ``period`` parameter.  *Format:* ``2015-19-05T00:05:00Z``
+     :type start_date: ``str``
+
+     :param end_date: end point.  Only required if using ``'CUSTOM'`` for the 
+        ``period`` parameter.  *Format:* ``2015-19-05T00:10:00Z``
+     :type end_date: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: get(log_id: nil)
+
+     Returns information about a log
+
+     :param log_id: the unique identifier for the log.
+     :type log_id: ``str``
+
+     :rtype: JSON

data/sphinx/_build/html/_sources/monitoring_center.txt

@@ -0,0 +1,55 @@
+Monitoring Center
+*****************
+
+.. rb:class:: OneAndOne::MonitoringCenter()
+   
+   The :rb:class:`MonitoringCenter` class allows a user to perform actions against the 1and1 API.
+
+
+   .. rb:method:: list(page: nil, per_page: nil, sort: nil, q: nil, fields: nil)
+
+     List all usages and alerts of monitoring servers.
+
+     :param page: Allows the use of pagination. Indicate which page to start on.
+     :type page: ``int``
+
+     :param per_page: Number of items per page.
+     :type per_page: ``int``
+
+     :param sort: ``sort: 'name'`` retrieves a list of elements sorted 
+       alphabetically. ``sort: 'creation_date'`` retrieves a list of elements 
+       sorted by their creation date in descending order.
+     :type sort: ``str``
+
+     :param q: ``q`` is for query. Use this parameter to return only the items 
+       that match your search query.
+     :type q: ``str``
+
+     :param fields: Returns only the parameters requested. 
+       (i.e. fields: 'id, name, description, hardware.ram')
+     :type fields: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: get(server_id: nil, period: nil, start_date: nil, end_date: nil)
+
+     Returns the usage of the resources for the specified time range.
+
+     :param server_id: the unique identifier for the server.
+     :type server_id: ``str``
+
+     :param period: the time range of logs to be shown.  Possible values are 
+        ``'LAST_HOUR'``, ``'LAST_24H'``, ``'LAST_7D'``, ``'LAST_30D'``, 
+        ``'LAST_365D'``, or ``'CUSTOM'``
+     :type period: ``str``
+
+     :param start_date: start point.  Only required if using ``'CUSTOM'`` for the 
+        ``period`` parameter.  *Format:* ``2015-19-05T00:05:00Z``
+     :type start_date: ``str``
+
+     :param end_date: end point.  Only required if using ``'CUSTOM'`` for the 
+        ``period`` parameter.  *Format:* ``2015-19-05T00:10:00Z``
+     :type end_date: ``str``
+
+     :rtype: JSON

data/sphinx/_build/html/_sources/monitoring_policies.txt

@@ -0,0 +1,288 @@
+Monitoring Policies
+*****************
+
+.. rb:class:: OneAndOne::MonitoringPolicy()
+   
+   The :rb:class:`MonitoringPolicy` class allows a user to perform actions against the 1and1 API.
+
+
+   .. rb:method:: list(page: nil, per_page: nil, sort: nil, q: nil, fields: nil)
+
+     Return a list of all monitoring policies.
+
+     :param page: Allows the use of pagination. Indicate which page to start on.
+     :type page: ``int``
+
+     :param per_page: Number of items per page.
+     :type per_page: ``int``
+
+     :param sort: ``sort: 'name'`` retrieves a list of elements sorted 
+       alphabetically. ``sort: 'creation_date'`` retrieves a list of elements 
+       sorted by their creation date in descending order.
+     :type sort: ``str``
+
+     :param q: ``q`` is for query. Use this parameter to return only the items 
+       that match your search query.
+     :type q: ``str``
+
+     :param fields: Returns only the parameters requested. 
+       (i.e. fields: 'id, name, description, hardware.ram')
+     :type fields: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: create(name: nil, description: nil, email: nil, agent: nil, thresholds: nil, ports: nil, processes: nil)
+
+      Create a monitoring policy.
+
+      :param name: monitoring policy name.
+      :type name: ``str``
+
+      :param description: monitoring policy description.
+      :type description: ``str``
+
+      :param email: user's email.
+      :type email: ``str``
+
+      :param agent: set true for using agent.
+      :type agent: ``bool``
+
+      :param thresholds: a "thresholds hash" that sets warning and critical limits for ``cpu``, ``ram``, ``disk``, ``transfer``, and ``internal_ping``.
+      :type thresholds: ``hash``
+
+      :param ports: an array of "port hashes".
+      :type ports: ``array``
+
+      :param processes: an array of "process hashes".
+      :type processes: ``array``
+
+      :rtype: JSON
+
+
+   .. rb:method:: get(monitoring_policy_id: @id)
+
+     Returns a monitoring policy's current specs.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: modify(monitoring_policy_id: @id, name: nil, description: nil, email: nil, thresholds: nil)
+
+     Modify a monitoring policy.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param name: monitoring policy name.
+     :type name: ``str``
+
+     :param description: monitoring policy description.
+     :type description: ``str``
+
+     :param email: user's email.
+     :type email: ``str``
+
+     :param thresholds: a "thresholds hash" that sets warning and critical limits for ``cpu``, ``ram``, ``disk``, ``transfer``, and ``internal_ping``.
+     :type thresholds: ``hash``
+
+     :rtype: JSON
+
+
+   .. rb:method:: delete(monitoring_policy_id: @id)
+
+     Delete a monitoring policy.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: ports(monitoring_policy_id: @id)
+
+     List a monitoring policy's ports.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: add_ports(monitoring_policy_id: @id, ports: nil)
+
+     Add ports to a monitoring policy.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param ports: an array of "port hashes".
+     :type ports: ``array``
+
+     :rtype: JSON
+
+
+   .. rb:method:: port(monitoring_policy_id: @id, port_id: nil)
+
+     Returns information about a monitoring policy's port.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param port_id: the unique identifier for the port.
+     :type port_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: modify_port(monitoring_policy_id: @id, port_id: nil, new_port: nil)
+
+     Modify a monitoring policy's port.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param port_id: the unique identifier for the port.
+     :type port_id: ``str``
+
+     :param new_port: takes a "port hash",
+     :type new_port: ``hash``
+
+     :rtype: JSON
+
+
+   .. rb:method:: delete_port(monitoring_policy_id: @id, port_id: nil)
+
+     Delete a monitoring policy's port.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param port_id: the unique identifier for the port.
+     :type port_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: processes(monitoring_policy_id: @id)
+
+     List a monitoring policy's processes.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: process(monitoring_policy_id: @id, process_id: nil)
+
+     Returns information about a monitoring policy's process.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param process_id: the unique identifier for the process.
+     :type process_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: add_processes(monitoring_policy_id: @id, processes: nil)
+
+     Add processes to a monitoring policy.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param processes: an array of "process hashes".
+     :type processes: ``array``
+
+     :rtype: JSON
+
+
+   .. rb:method:: modify_process(monitoring_policy_id: @id, process_id: nil, new_process: nil)
+
+     Modify a monitoring policy's process.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param process_id: the unique identifier for the process.
+     :type process_id: ``str``
+
+     :param new_process: takes a "process hash",
+     :type new_process: ``hash``
+
+     :rtype: JSON
+
+
+   .. rb:method:: delete_process(monitoring_policy_id: @id, process_id: nil)
+
+     Delete a monitoring policy's process.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param process_id: the unique identifier for the process.
+     :type process_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: servers(monitoring_policy_id: @id)
+
+     List a monitoring policy's servers.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: server(monitoring_policy_id: @id, server_id: nil)
+
+     Returns information about a monitoring policy's server.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param server_id: the unique identifier for the server.
+     :type server_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: add_servers(monitoring_policy_id: @id, servers: nil)
+
+     Add servers to a monitoring policy.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param servers: an array of server ID strings.
+     :type servers: ``array``
+
+     :rtype: JSON
+
+
+   .. rb:method:: remove_server(monitoring_policy_id: @id, server_id: nil)
+
+     Remove a server from a monitoring policy.
+
+     :param monitoring_policy_id: the unique identifier for the monitoring policy.
+     :type monitoring_policy_id: ``str``
+
+     :param server_id: the unique identifier for the server.
+     :type server_id: ``str``
+
+     :rtype: JSON
+
+
+   .. rb:method:: wait_for()
+
+     Polls the monitoring policy until an "ACTIVE" state is returned.  Use this when chaining actions.
+
+     :rtype: ``nil``