Page tree
Skip to end of metadata
Go to start of metadata

Customer Visible Objects

The Flexiant Cloud Orchestrator platform presents a number of different resource types. The resources visible to end users are as follows:

  • Clusters
  • Deployment Instances
  • Deployment Templates
  • Disks
  • Disk Clones
  • Firewalls
  • Images
  • IP Addresses
  • Servers (Virtual Machines)
  • SSH Keys
  • Snapshots
  • VDCs
  • Networks

These are explained in more detail here, and in the API documentation at Calling the SOAP Admin API and User API.

Admin Visible Objects

The following resources are also visible to administrative users:

  • Billing entities
  • Customers
  • Users (or Contacts)
  • Products
  • Product Offers

These are explained in more detail here but a brief explanation of each follows below. All resources have a UUID (a Universally Unique Identifier). Several calls allow passing resources of different sorts. Objects other than resources do not, in general, have associated UUIDs.

  • A billing entity is an administrative unit that groups customers together, and is capable of issuing bills. The master billing entity is the billing entity which operates the platform, to which all other billing entities belong. Each customer is owned by a billing entity. Administrative users can only administrate the billing entity they belong to and its customers, unless they belong to the master billing entity, in which case they have administrative access to all billing entities.
  • A customer is an owner of virtual resources who receives billing for those resources. A customer belongs to exactly one billing entity.
  • A User (occasionally referred to as a Contact) is a person authorised to manipulate the virtual resources of a customer. A user belongs to exactly one billing entity. A user can be associated with zero or more customers in the billing entity concerned, by use of groups.
  • A product is a template specifying the technical configuration of virtual resources, is in general created by the master billing entity, and spans the whole system.
  • A product offer is the commercial terms under which the product is sold. There might be more than one product offer per product, and product offers can differ by billing entity.

Aside from resources, you will encounter the following objects in the Jade Admin API:

  • Invoices
  • Invoice Items
  • Promotions
  • Promotion Codes
  • Product Purchases
  • Unit Transactions
  • Unit Transaction Summaries
  • Query Limits
  • Search Filters

Each of these is explained under the documentation for the relevant objects.

System Visible Objects

The following resources are also visible to users with system level access (master billing entity Admins)

  • Clusters (with expanded information)
  • IP Pools
  • Networks (with expanded information)
  • Nodes
  • Storage Units

It is likely that most of your calls to Jade AdminAPI, will be read operations, querying the system. All queries can be made using calls starting with the word 'list', even calls that aim to return a single item. Most of these relate to resources. Each list call returns a list of a specific type of resource based on a supplied query. That query is specified in Flexiant Query Language (FQL), as a Search Filter and a Query Limit.

  • No labels