SoftLayer Billing Item Network Subnet

From SoftLayer Development Network Wiki

Jump to: navigation, search

Contents

Overview

The SoftLayer_Billing_Item_Network_Subnet data type contains general information relating to a single SoftLayer billing item whose item category code is one of the following:

  • pri_ip_address
  • static_sec_ip_addresses (static secondary)
  • sov_sec_ip_addresses (secondary on vlan, also known as "portable ips")
  • sec_ip_addresses (old style, secondary ip addresses)


These item categories denote that the billing item has subnet information attached.

Warning! Even though our API is object based, XML-RPC can only return data as array values. The SOAP implementation treats data as object properties.

Local Properties

categoryCode

The category code of this billing item. It is used to tell us the difference between a primary disk and a secondary disk, for instance.

  • Type: string
  • Length: 50 characters



createDate

The date the billing item was created. You can see this date on the invoice.



description

A brief description of a billing item.

  • Type: string
  • Length: 200 characters



domainName

The domain name is provided for server billing items.

  • Type: string
  • Length: 100 characters



hostName

The hostname is provided for server billing items

  • Type: string
  • Length: 100 characters



id

The unique identifier for this billing item.

  • Type: integer



laborFee

The labor fee, if any. This is a one time charge.

  • Type: decimal
  • Length: 6 digits before the decimal point



laborFeeTaxRate

The rate at which labor fees are taxed if you are a taxable customer.

  • Type: decimal
  • Length: 1 digits before the decimal point



lastBillDate

The last time this billing item was charged.



nextBillDate

The date on which your account will be charged for this billing item.



notes

Extra information provided to help you identify this billing item. This is often a username or something to help identify items that customers have more than one of.

  • Type: string
  • Length: 200 characters



oneTimeFee

The amount of money charged as a one-time charge for a billing item, if applicable. oneTimeFee is measured in US Dollars ($USD).

  • Type: decimal
  • Length: 6 digits before the decimal point



oneTimeFeeTaxRate

The rate at which one time fees are taxed if you are a taxable customer.

  • Type: decimal
  • Length: 1 digits before the decimal point



orderItemId

the SoftLayer_Billing_Order_Item ID. This is a reference to the original order item from which this billing item was originally created.

  • Type: integer
  • Length: 10 digits



recurringFee

The amount of money charged per month for a billing item, if applicable. recurringFee is measured in US Dollars ($USD).

  • Type: decimal
  • Length: 6 digits before the decimal point



recurringFeeTaxRate

The rate at which recurring fees are taxed if you are a taxable customer.

  • Type: decimal
  • Length: 1 digits before the decimal point



recurringMonths

The number of months in which the recurring fees will be incurred.

  • Type: integer
  • Length: 3 digits
  • Permission: Type Description



resourceTableId

The resource (unique identifier) for a server billing item.

  • Type: integer
  • Length: 10 digits



setupFee

The setup fee, if any. This is a one time charge.

  • Type: decimal
  • Length: 6 digits before the decimal point



setupFeeTaxRate

The rate at which setup fees are taxed if you are a taxable customer.

  • Type: decimal
  • Length: 1 digits before the decimal point


Relational Properties

account

The account that a billing item belongs to.
account can be queried by object mask.
account must be a unique value.



activeBundledItems

A Billing Item's active bundled billing items.
activeBundledItems can be queried by object mask.



activeChildren

A Billing Item's active child billing items.
activeChildren can be queried by object mask.



bundleItems

A Billing Item's bundled billing items
bundleItems can be queried by object mask.



bundledItems

A Billing Item's bundled billing items'
bundledItems can be queried by object mask.



canceledChildren

A Billing Item's active child billing items.
canceledChildren can be queried by object mask.



category

The item category to which the billing item's item belongs.
category can be queried by object mask.
category must be a unique value.



children

A Billing Item's child billing items'
children can be queried by object mask.



downgradeItems

For product items which have a downgrade path defined, this will return those product items.
downgradeItems can be queried by object mask.



invoiceItem

Invoice items associated with this billing item
invoiceItem can be queried by object mask.
invoiceItem must be a unique value.



item

The entry in the SoftLayer product catalog that a billing item is based upon.
item can be queried by object mask.
item must be a unique value.



location

The location of the billing item. Some billing items have physical properties such as the server itself. For items such as these, we provide location information.
location can be queried by object mask.
location must be a unique value.



nextInvoiceChildren

A Billing Item's child billing items'
nextInvoiceChildren can be queried by object mask.



nextInvoiceTotalOneTimeAmount

A Billing Item's total, including any child billing items if they exist.'
nextInvoiceTotalOneTimeAmount can be queried by object mask.
nextInvoiceTotalOneTimeAmount must be a unique value.

  • Type: float



nextInvoiceTotalOneTimeTaxAmount

A Billing Item's total, including any child billing items if they exist.'
nextInvoiceTotalOneTimeTaxAmount can be queried by object mask.
nextInvoiceTotalOneTimeTaxAmount must be a unique value.

  • Type: float



nextInvoiceTotalRecurringAmount

A Billing Item's total, including any child billing items if they exist.'
nextInvoiceTotalRecurringAmount can be queried by object mask.
nextInvoiceTotalRecurringAmount must be a unique value.

  • Type: float



nextInvoiceTotalRecurringTaxAmount

A Billing Item's total, including any child billing items if they exist.'
nextInvoiceTotalRecurringTaxAmount can be queried by object mask.
nextInvoiceTotalRecurringTaxAmount must be a unique value.

  • Type: float



orderItem

A billing item's original order item. Simply a reference to the original order from which this billing item was created.
orderItem can be queried by object mask.
orderItem must be a unique value.



originalLocation

The original physical location for this billing item--may differ from current.
originalLocation can be queried by object mask.
originalLocation must be a unique value.



package

The package under which this billing item was sold. A Package is the general grouping of products as seen on our order forms.
package can be queried by object mask.
package must be a unique value.



parent

A billing item's parent item. If a billing item has no parent item then this value is null.
parent can be queried by object mask.
parent must be a unique value.



provisionTransaction

Provisioning transaction for this billing item
provisionTransaction can be queried by object mask.
provisionTransaction must be a unique value.



resource

The resource for a subnet-related billing item.
resource can be queried by object mask.
resource must be a unique value.



softwareDescription

A friendly description of software component
softwareDescription can be queried by object mask.
softwareDescription must be a unique value.



upgradeItem

Billing items whose product item has an upgrade path defined in our system will return the next product item in the upgrade path.
upgradeItem can be queried by object mask.
upgradeItem must be a unique value.



upgradeItems

Billing items whose product item has an upgrade path defined in our system will return all the product items in the upgrade path.
upgradeItems can be queried by object mask.


Count Properties

activeBundledItemCount

A count of a Billing Item's active bundled billing items.
activeBundledItemCount must be a unique value.

  • Type: unsigned long



activeChildrenCount

A count of a Billing Item's active child billing items.
activeChildrenCount must be a unique value.

  • Type: unsigned long



bundleItemCount

A count of a Billing Item's bundled billing items
bundleItemCount must be a unique value.

  • Type: unsigned long



bundledItemCount

A count of a Billing Item's bundled billing items'
bundledItemCount must be a unique value.

  • Type: unsigned long



canceledChildrenCount

A count of a Billing Item's active child billing items.
canceledChildrenCount must be a unique value.

  • Type: unsigned long



childrenCount

A count of a Billing Item's child billing items'
childrenCount must be a unique value.

  • Type: unsigned long



downgradeItemCount

A count of for product items which have a downgrade path defined, this will return those product items.
downgradeItemCount must be a unique value.

  • Type: unsigned long



nextInvoiceChildrenCount

A count of a Billing Item's child billing items'
nextInvoiceChildrenCount must be a unique value.

  • Type: unsigned long



upgradeItemCount

A count of billing items whose product item has an upgrade path defined in our system will return all the product items in the upgrade path.
upgradeItemCount must be a unique value.

  • Type: unsigned long
Personal tools