# Map a line item to an instance

Maps a line item to an instance. The first time
this API is called, the payload details will be stored, 
and reported in a GET line-item
request. If the line item is already mapped, then the details stored
will be entirely replaced.

This method is intended for use if you do not use FlexNet Operations as your back office, 
so that you can configure your upstream system (e.g. a CRM or back office) 
to create line items in Dynamic Monetization for your end customers. 
(If you use FlexNet Operations as your back office, but use this method directly 
to provision line items that do not exist in FlexNet Operations, then those line items 
will not be reflected in FlexNet Operations.)


Endpoint: PUT /v1.0/instances/{instanceId}/line-items
Version: 1.0
Security: AdministrationAccess

## Path parameters:

  - `instanceId` (string, required)
    The UUID of the Dynamic Monetization instance.

## Request fields (application/json):

  - `activationId` (string, required)
    The activation ID of a line item that should be mapped to the instance.

  - `state` (string, required)
    The line item state. Valid states are:
  - DEPLOYED
  - INACTIVE
  - OBSOLETE

INACTIVE and OBSOLETE can only be set when the line item already exists.
An OBSOLETE line item cannot be set to INACTIVE or DEPLOYED.

  - `quantity` (integer, required)
    The quantity from the line item to map to the instance.

  - `start` (integer, required)
    Start date and time of the line item in milliseconds since 1970-01-01 00:00.

  - `end` (integer, required)
    End date and time of the line item in milliseconds since 1970-01-01 00:00.

  - `attributes` (object, required)
    The properties that determine how the service will respond to access requests.

  - `attributes.elastic` (boolean)
    Indicates whether the line item is elastic.

  - `attributes.rateTableSeries` (string)
    The rate table series used to determine the rate applied to Elastic access requests against this line item. An empty string indicates that the rate is determined by the latest version of a table with no series.

  - `attributes.overdraftLimit` (integer)
    Allow requests to continue consuming tokens from this line item after the entitled quantity has been fully consumed, up to the overdraft limit. 
The overdraftType field must be set to "Number" if an overdraft limit is provided.
To consume tokens from this line item indefinitely, set the overdraftType to "Unlimited", and an overdraft limit is not required.
If an overdraft limit is not set, requests can only consume from this line item until the entitled quantity is reached.

  - `attributes.overdraftType` (string)
    The type of overdraft. Valid types are: 
- Unlimited
- Number