Asset
=====

An Asset resource represents an asset.

Resource definition
-------------------


.. literalinclude:: _static/Asset.json
        :language: json


+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| Name                               | Type                                       | Description                                                                                                       |
+====================================+============================================+===================================================================================================================+
| InvoiceProfile                     | ObjectReference                            | Invoice profile associated with the asset (if any).                                                               |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| Id                                 | int                                        | Unique identifier for the asset.                                                                                  |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| Status                             | int                                        | None = 0,Fulfilling = 1, Succeeded = 2, Cancelled = 4, Expired = 8, All = Fulfilling|Succeeded|Cancelled|Expired  |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ExternalOrderId                    | string                                     | External order identifier related to the asset.                                                                   |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| Quantity                           | int                                        | Number of units in the asset.                                                                                     |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ExternalProductId                  | string                                     | External product unique identifier.                                                                               |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ExternalSkuId                      | string                                     | SKU identifier of the external product.                                                                           |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| Name                               | string                                     | Name of the asset (e.g., software license).                                                                       |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| StartDate                          | DateTime                                   | Start date of the asset's validity.                                                                               |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ExpirationDate                     | DateTime?                                  | Expiration date of the asset.                                                                                     |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ResellerCustomerId                 | int                                        | Identifier of the reseller's customer.                                                                            |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| Scope                              | int                                        | Shared = 1, Single = 2, ManagementGroups = 3                                                                      |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| AssetType                          | int                                        | Reservation = 1, Software = 2, Subscription = 3                                                                   |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| BillingCycle                       | int                                        | Unknown = 0, Monthly = 1, Annual = 2, None = 3, OneTime = 4, Triennial = 5, Biennial = 6                          |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| PublisherId                        | int                                        | Identifier of the publisher.                                                                                      |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ProgramId                          | int                                        | Identifier of the program associated with the asset.                                                              |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ReservationId                      | string                                     | Reservation ID if applicable.                                                                                     |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ReservationUsedInSubscriptionId    | int?                                       | Subscription ID where the reservation is used.                                                                    |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ReservationUsedInSubscription      | SubscriptionLite                           | Details of the subscription where the reservation is used.                                                        |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| PurchaseCurrency                   | string                                     | Currency used for the purchase.                                                                                   |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| PurchasePrice                      | decimal                                    | Purchase price of the asset.                                                                                      |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| SalesCurrency                      | string                                     | Currency used for sales.                                                                                          |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| SalesPrice                         | decimal                                    | Selling price of the asset.                                                                                       |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| CreatedDate                        | DateTime                                   | Date when the asset was created.                                                                                  |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ModifiedDate                       | DateTime                                   | Last modification date of the asset.                                                                              |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ChangedBy                          | string                                     | Information about who modified the asset.                                                                         |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ReservedInstanceArtifactResourceId | string                                     | Reserved instance resource ID.                                                                                    |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| PurchaseDate                       | DateTime?                                  | Date of purchase.                                                                                                 |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| Tags                               | AssetTags                                  | Additional tags associated with the asset.                                                                        |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| AutoRenewEnabled                   | bool?                                      | Indicates if auto-renewal is enabled.                                                                             |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+
| ProductVariantId                   | int?                                       | Variant ID of the product.                                                                                        |
+------------------------------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------------+



Operations on asset
-------------------
  
- :doc:`/scenarios/asset-get`