Cloud Services

Enterprise Marketplace

Inventory management
Published On Jun 17, 2024 - 12:08 PM

Inventory management

Managing stacks after they are provisioned using the Enterprise Marketplace Inventory page.
After a catalog has been successfully provisioned, the stack is displayed on the
Enterprise Marketplace Inventory
page. The
Inventory
tab contains detailed information about each stack as configured during the latest order process.The following information for each stack is provided in a table format on the
Inventory
tab:
  • Stack name:
    Name of the stack.
  • Provider name:
    Service provider name, such as AWS EC2, Azure Managed Disk, or IBM Cloud Registry Service.
  • Catalog name:
    Name of the catalog being provided for a stack.
  • Current version:
    Catalog version number used to create the stack in Enterprise Marketplace.
  • Provider account name:
    Name of the individual provider account used for a stack.
  • Provisioned date:
    Date the stack was submitted for provisioning.
  • Status:
    A stack can be in one of the following states:
    • Active:
      Stack has been provisioned.
    • Deleted:
      Stack has been deleted, but details still remain.
    • Delete in progress:
      The system is in the process of deleting the stack.
    • Edit in progress:
      The stack is currently not accessible because another user is modifying it.
  • Stack source:
    Application in which the stack was created.
  • Team:
    The team to which the user who created the stack belongs.
  • Ordered by:
    User name of the person who created the stack.
  • Estimated cost:
    Estimated cost is based on the catalog price in Enterprise Marketplace. Actual costs might differ based on usage,
  • Currency:
    Currency type used for cost in the stack.
  • Application:
    The application used to create the stack.
  • Environment:
    The environment that the stack is deployed in.

Who can access inventory?

The following roles can view, edit, and delete stacks:
  • Buyer, Operator, Purchaser, and Approver Roles:
    View inventory and catalog details.
  • Operator and Approver Roles:
    Edit
    vRA imported
    catalog properties. The Edit Services action is active
    only
    for vRA imported stacks.
  • Approver Role:
    Executes the delete and de-provision process.

Viewing the stack

From the desired stack, select
View Service
from the overflow menu from the right side of the stack. The stack detailed properties display on the
View Stack
page. This page contains the following tabs:
  • Stack Details
  • Bill of Materials (BOM)
  • Order History

Stack Details tab

The
Stack Details
tab is active by default. This tab displays the information in the Inventory table in a single readable pane.
The tab also contains additional information about the stack, including the following:
  • Provider stack ID, where applicable
  • Details of the stack's configuration

Bill of Materials tab

The following detailed line-item charges are displayed in the BOM:
  • Recurring charges
  • Estimated usage charges
  • One time changes
Estimated costs in the BOM do not include provider, regional, or any other tax such as sales or value added tax (VAT).
For information on these charges, see Bill of Materials.
BOMs can be viewed from the following pages in Enterprise Marketplace:
  • Catalog
  • Shopping Cart
  • My team's orders
  • Approve Orders
  • Inventory

Order History tab

The
Order History
tab shows the progress of the stack's order, and includes the complete stack history, including the following information:
  • Order ID
  • Submitted Date
  • Operation Type
  • Status
  • Requested by
  • Total Estimated Cost
  • Error Code/Reason for Failure

Batch Actions tab

You can perform actions on multiple items in the Catalog Instance Inventory view by completing the following steps:
  1. Select the checkbox next to each instance to be refreshed or deleted.
  2. Click the
    Actions
    menu icon.
  3. Choose which batch action you wish to perform. You can use batch processes to perform the following actions on multiple stacks:
    • Turn On
    • Turn Off
    • Reboot
    • Access
When accessing vRealize Automation virtual machines (VMs), you must be logged into the vRA portal before attempting to access the stack component. If you are not logged into the vRA portal, you are redirected to the vRA portal to do so. After you are logged in, you can return to Enterprise Marketplace and click the
Access Component
link to go to the component's login page.

Filters

The list of items displayed in the Inventory view can be filtered for ease of use. Filters for status and provider are available, and can be used together or separately. By default, the display is filtered by Active instances.
Click the
Filters
icon to see the available filters and make your selections. Applied filters are listed at the top of the display. To remove a filter, click the
X
next to the filter name.

Import Inventory

Enterprise Marketplace can import inventory in the
.json
and
.zip.
formats. The maximum uploadable file size is 500 MB.

Export Stack Inventory Details

IT operators can export Enterprise Marketplace stack inventory details using an API. The API transfer results are downloadable to a CSV format. Use this data to reconcile the charges extracted from CAM or update data warehouse systems.
Send the API request using Client for URLs (cURL). cURL is a command-line tool that transfers data using protocols like FTP, HTTP, LDAP, and so on.

Sample API Request

If you want to perform an API request using cURL to transfer stack data, complete the following steps:
  1. Open a command line or terminal interface.
  2. Navigate to the folder to which the file should be downloaded.
  3. Run the following command, substituting your own information for the .CSV file name, user name, API key name, cb user name, cb team name, and endpoint name:
    curl -k --output service_inventory.csv -H username: [email protected] -H apikey: 85fea6c8-84dc-5fa7-976a-6a980d284a67 -H Cb-User-Info: [email protected] -H Cb-User-TeamInfo: TEAMNAME https://< cluster_api_end_point >/inventory/download
The following additional parameters can be added to the previous input:
  • page, mandatory, integer: Identifies page number (starts from 1, with no upper limit)
  • size, mandatory, integer: Defines size of each page (starts from 1, with no upper limit)
  • searchText, optional, string: Defines text to search for
  • sortBy, optional, string: Selects the column to sort by
  • sortOrder, optional, string: Sets the sort order as ascending or descending; ascending is the default
  • filterBy, optional, string: Defines optional strings to filter by
To filter by status and providers, the query string must use the following format:
status: < comma separated list > |providerName: < comma separated list >
The stack inventory details .CSV file is created in the folder from which the cURL command was issued.
The
Output
parameter specifies the output file in the local directory to store the downloaded .CSV file. The Output in this .CSV file includes data from more than 30 fields, including the following:
  • ProviderID
  • Status
  • BusinessUnit
  • Components
  • OrderNumber
  • OrderType
  • ServiceInventoryID
  • Currency
  • Quantity
Do you have two minutes for a quick survey?
Take Survey