rs-cmdb documentation

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
start [2025/02/05 15:20] – [group object] torstenstart [2025/02/06 11:54] (aktuell) – [Tabelle] torsten
Zeile 49: Zeile 49:
 ===== Objects ===== ===== Objects =====
  
-The list of objects depends on the actual interface definition. Some of the objects may not be available in every implementation. Also the visibility of the objects depends on the user rights.+The list of the available objects depends on the actual interface definition. Some of the objects may not be available in every implementation. Also the visibility of the objects depends on the user and group rights.
  
-^ Object      ^ Drescription                                                                               ^ +^ Object                     ^ Drescription                                                                               ^ 
-| [[address|address]]     | postal addresses for area object                                                           | +| [[address|address]]        | postal addresses for area object                                                           | 
-| [[area|area]]        | object to manage geographical area dependencies, anchor for physical staff (i.e. devices)  | +| [[area|area]]              | object to manage geographical area dependencies, anchor for physical staff (i.e. devices)  | 
-| [[asnr|asnr]]        | documentation of AS-numbers                                                                | +| [[asnr|asnr]]              | documentation of AS-numbers                                                                | 
-| [[cabinet|cabinet]]        |                                                                 | +| [[cabinet|cabinet]]        | object to document cabinets and the content like panels or devices                         | 
-| [[device|device]]      | Management of devices and device names                                                     | +| [[device|device]]          | Management of devices and device names                                                     | 
-| [[devtype|devtype]]      |                                                      |+| [[devtype|devtype]]        | device templates to create devices                                                         |
 | [[dhcpoption|dhcpoption]]  | object to manage DHCP optione depending to IP networks                                     | | [[dhcpoption|dhcpoption]]  | object to manage DHCP optione depending to IP networks                                     |
-| [[dhcprange|dhcprange]]   | object to manage DHCP-ranges depending to IP networks                                      | +| [[dhcprange|dhcprange]]    | object to manage DHCP-ranges depending to IP networks                                      | 
-| [[group|group]]       | Group management                                                                           | +| [[group|group]]            | Group management                                                                           | 
-| [[ipaddr|ipaddr]]      | object to manage IP addresses (V4)                                                         | +| [[ipaddr|ipaddr]]          | object to manage IP addresses (V4)                                                         | 
-| [[iparea|iparea]]      | object to manage IP container information, related to nearea objects                       | +| [[iparea|iparea]]          | object to manage IP container information, related to nearea objects                       | 
-| [[ipnet|ipnet]]       | object to manage IP-Networks (V4)                                                          | +| [[ipnet|ipnet]]            | object to manage IP-Networks (V4)                                                          | 
-| [[ipservice|ipservice]]       |                                                           | +| [[ipservice|ipservice]]    | object to document IP services like DNS, ssh ...                                           | 
-| [[license|license]]     | Documentation and management of software licenses                                          | +| [[license|license]]        | Documentation and management of software licenses                                          | 
-| [[natip|natip]]       | object to manage NAT IP assignments (also accessible with ipnet object)                    | +| [[natip|natip]]            | object to manage NAT IP assignments (also accessible with ipnet object)                    | 
-| [[natpool|natpool]]     | object to manage IP networks containing NAT IP addresses                                   | +| [[natpool|natpool]]        | object to manage IP networks containing NAT IP addresses                                   | 
-| [[netarea|netarea]]     | object to manage logical network related structures, container for ipareas                 | +| [[netarea|netarea]]        | object to manage logical network related structures, container for ipareas                 | 
-| [[realm|realm]]       | object to manage realm information and dependencies                                        | +| [[realm|realm]]            | object to manage realm information and dependencies                                        | 
-| [[request|request]]     | Request handling                                                                           | +| [[request|request]]        | Request handling                                                                           | 
-| [[software|software]]    | Documentation and management of software (i.e. applications, operating systems)            | +| [[software|software]]      | Documentation and management of software (i.e. applications, operating systems)            | 
-| [[tenant|tenant]]      | object to manage tenant information and dependencies                                       | +| [[tenant|tenant]]          | object to manage tenant information and dependencies                                       | 
-| [[user|user]]        | User management                                                                            | +| [[user|user]]              | User management                                                                            | 
-| [[vlan|vlan]]        | Management of VLAN information and assignments                                             |+| [[vlan|vlan]]              | Management of VLAN information and assignments                                             |
 | [[vlandomain|vlandomain]]  | Mangement of VLAN-Domains                                                                  | | [[vlandomain|vlandomain]]  | Mangement of VLAN-Domains                                                                  |
-| [[vrf|vrf]]         | VRF management                                                                             | +| [[vrf|vrf]]                | VRF management                                                                             |
- +
- +
- +
- +
- +
- +
- +
- +
- +
- +
-==== ipaddr object ==== +
- +
-^ Method  ^ URL                    ^ Notes                                                  ^ +
-| GET     | /rest/{IF}/ipnet       | returns a list of all IP networks                      | +
-| GET     | /rest/{IF}/ipnet/{id}  | returns a list of all IP addresses in this IP network  | +
- +
-== available parameters == +
- +
-^ Parameter    ^ Type    ^ Method            ^ Notes                              ^ +
-| id           | int     | GET, PUT, DELETE  | unique identifier of the object    | +
-| name         | string  | POST,PUT          | name (DNS) assigned to ip address  | +
-| addr         | IP      | POST, PUT         | IP address                         | +
-| natip        | int     | POST, PUT         | NAT IP address                     | +
-| natdir       | text    | POST, PUT         | NAT direction                      | +
-| gateway      | int     | POST, PUT         | default gateway flag               | +
-| dhcp         | int     | POST, PUT         | dhcp flag                          | +
-| notes        | int     | POST, PUT         | further description                | +
-| objstatus    | int     | POST, PUT         | Status of the IP address           | +
-| ipif_id      | int     | POST, PUT         | link to interface                  | +
-| ipdevice_id  | int     | POST, PUT         | link to device                     | +
- +
-[[start#objects|<< zurück]] +
- +
- +
-==== iparea object ==== +
- +
-^ Method  ^ URL                            ^ Notes                                                       ^ +
-| GET     | /rest/{IF}/iparea              | returns a list of all iparea objects                        | +
-| GET     | /rest/{IF}/iparea/{id}         | information about a single iparea                           | +
-| GET     | /rest/{IF}/iparea/{id}/iparea  | returns a list of all ipareas below the iparea in the tree  | +
-| GET     | /rest/{IF}/iparea/{id}/ipnet   | returns a list of all ipnets connected                      | +
- +
-== available parameters == +
- +
-^ Parameter  ^ Type    ^ Method            ^ Notes                                              ^ +
-| id         | int     | GET, PUT, DELETE  | unique identifier of the object                    | +
-| name       | string  | POST,PUT          | iparea's name or readable identifier               | +
-| net        | IP      | POST              | network address of iparea                          | +
-| bits       | int     | POST              | number of bits (CIDR), related to the iparea size  | +
-| func       | int     | POST, PUT         | global flag                                        | +
-| notes      | text    | POST, PUT         | further notes or description of the iparea         | +
- +
-[[start#objects|<< zurück]] +
- +
- +
-==== ipnet object ==== +
- +
-^ Method  ^ URL                               ^ Notes                                                            ^ +
-| GET     | /rest/{IF}/ipnet                  | returns a list of all IP networks                                | +
-| GET     | /rest/{IF}/ipnet/{id}             | information of the IP network                                    | +
-| GET     | /rest/{IF}/ipnet/{id}/ipaddr      | returns a list of all IP addresses in this IP network            | +
-| GET     | /rest/{IF}/ipnet/{id}/natip       | returns a list of all IP NAT addresses in this IP network        | +
-| GET     | /rest/{IF}/ipnet/{id}/dhcpoption  | returns a list of the dhcp options of this network               | +
-| GET     | /rest/{IF}/ipnet/{id}/dhcprange   | returns a list of the dhcp ranges of this network                | +
-| GET     | /rest/{IF}/ipnet/{id}/service     | returns a list of all services that are related to this network  | +
- +
-== available parameters == +
- +
-^ Parameter  ^ Type    ^ Method            ^ Notes                                               ^ +
-| id         | int     | GET, PUT, DELETE  | unique identifier of the object                     | +
-| name       | string  | POST,PUT          | network's name or readable identifier               | +
-| net        | IP      | POST              | network address                                     | +
-| bits       | int     | POST              | number of bits (CIDR), related to the network size  | +
-| notes      | text    | POST, PUT         | Description of the network                          | +
-| vrf_id     | int     | POST, PUT         | id of the related VRF                               | +
-| realm_id   | int     | POST, PUT         | id of the related realm                             | +
-| tenant_id  | int     | POST, PUT         | id of the related tenant                            | +
- +
-[[start#objects|<< zurück]] +
- +
- +
-==== ipservice object ==== +
- +
-==== license object ==== +
- +
-==== natip object ==== +
- +
-==== natpool object ==== +
- +
- +
-==== netarea object ==== +
- +
-^ Method  ^ URL                                 ^ Notes                                                          ^ +
-| GET     | /rest/{IF}/netarea                  | returns a list of all netareas                                 | +
-| GET     | /rest/{IF}/netarea/{id}             | Information about a single netarea                             | +
-| GET     | /rest/{IF}/netarea/{id}/netarea     | returns a list of all netareas below the selected in the tree  | +
-| GET     | /rest/{IF}/netarea/{id}/iparea      | returns the assigned ipareas                                   | +
-| GET     | /rest/{IF}/netarea/{id}/vlandomain  | returns the assigned vlandomains                               | +
-| GET     | /rest/{IF}/netarea/{id}/vlan        | returns a list of all vlans assigned to the netarea            | +
-| GET     | /rest/{IF}/netarea/{id}/ipnet       | returns a list of all ipnets assigned to the netarea           | +
- +
-== available parameters == +
- +
-^ Parameter   ^ Type    ^ Method            ^ Notes                                                     ^ +
-| id          | int     | GET, PUT, DELETE  | unique identifier of the object                           | +
-| name        | string  | POST,PUT          | netarea's name, unique per hierarchy level                | +
-| notes       | text    | POST, PUT         | Description                                               | +
-| plancount   | int     | POST, PUT         | Number of planned users in the netarea                    | +
-| tcontact    | string  | POST, PUT         | name, UPN, etc. of the technical contact of this netarea  | +
-| area_id     | int     | POST              | link to the geographical area                             | +
-| netarea_id  | int     | POST              | link to the predecessor in the netarea-hierarchy          | +
- +
-[[start#objects|<< zurück]] +
- +
- +
-==== realm object ==== +
- +
-==== request object ==== +
- +
-==== software object ==== +
- +
-==== tenant object ==== +
- +
-==== user object ==== +
- +
-==== vlan object ==== +
- +
-==== vlandomain object ==== +
- +
-==== vrf object ====+