Skip to content

Commit

Permalink
Update: 07-11-2024
Browse files Browse the repository at this point in the history
  • Loading branch information
cldocid2 committed Nov 7, 2024
1 parent 56d7708 commit b0aff77
Show file tree
Hide file tree
Showing 3 changed files with 61 additions and 44 deletions.
59 changes: 59 additions & 0 deletions infra_usage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---

copyright:
years: 2018, 2024
lastupdated: "2024-07-24"

keywords: SoftLayer billing, classic infrastructure usage, orders, IaaS usage, invoice, billing item

subcollection: account

---

{{site.data.keyword.attribute-definition-list}}

# Viewing usage for your classic infrastructure resources
{: #infra-usage}

You can view your device usage and service purchases for classic infrastructure devices and services by going to **Manage > Billing and usage**.
{: shortdesc}

## Viewing device and service purchase information
{: #infra-orders}
{: help}
{: support}

You can view information about your classic infrastructure device and service purchases by selecting an option from the **Sales** navigation.

* Select **Device upgrades** to view specific information, such as which devices are upgraded and the date the case was created and completed. To view this page, you need an access policy with the Viewer role or higher on the Billing service.

You can view all open and closed cases for your infrastructure device upgrades. You can also track the progress of the case, view a logged correspondence with support, and keep track of cases that are opened and completed.
* Select **Orders** to view a list of all the orders made in your account. To view this page, you need the Add/Upgrade Storage (StorageLayer), Add Server, or Add/Upgrade Services [classic infrastructure permission](/docs/account?topic=account-mngclassicinfra).
* Select **Cancellations** to view all cancellations on your account. To view this page, you need both the Cancel server and Cancel services classic infrastructure permissions.

You can view a list of all of the cancellations made in the account, and you can view them by type of device or service. The cancellations show the device name and the case number. This list tracks ongoing and closed cases, and you can view your messages with support.
* Select **Shipments** to view your digital shipments, such as data transfer requests or physical shipments. To view this page, you need an access policy with the Viewer role or higher on the Billing service.

## Viewing billing and usage information in the console
{: #infra-billing-ui}
{: ui}

To view billing and usage for classic infrastructure resources, you need an access policy with the Viewer role or higher on the Billing account management service. See [IAM access](/docs/account?topic=account-userroles) for more information.

* Select **Billing items** to view billing items and their associated devices. Billing items are services and products that are not a server, such as storage. Associating a billing item with a device helps you track and organize costs in your invoice.

By default, the Billing items page displays all associated billing items. You can change your view by clicking the **Associated Billing Items** menu and selecting another option. You can associate or disassociate one item, or expand the **Bulk Actions** operation for multiple items at a time. You can cancel individual billing items at any time.
* Select **Invoices** to view detailed invoices that list your device and service usage and the billed amount for each item.

To view your billed usage for the current invoicing period, click the link with your next invoice date under Next Recurring Invoice.

You can download a PDF or spreadsheet copy of an invoice for your offline records by clicking the **Download** icon ![Download icon](../icons/download.svg "Download") and selecting your download options.
{: tip}

## Viewing your usage by using the API
{: #infra-billing-api}
{: api}

You can programmatically view your classic infrastructure usage by calling the [{{site.data.keyword.cloud_notm}} Usage Reports API](/apidocs/metering-reporting#get-account-usage). You can base the query in your API call on an account, org, resource group, or resource instance. For more information, see [Viewing your usage by using the API](/docs/account?topic=account-viewingusage&interface=api).

Some accounts must use the [SoftLayer API](https://sldn.softlayer.com/) to retrieve usage information for classic infrastructure resources. For more information, see [SoftLayer_Billing_Invoice](https://sldn.softlayer.com/reference/datatypes/SoftLayer_Billing_Invoice/) and [SoftLayer_Billing_Invoice_Item](https://sldn.softlayer.com/reference/datatypes/SoftLayer_Billing_Invoice_Item/).
1 change: 1 addition & 0 deletions toc.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -240,6 +240,7 @@ toc:
- change_pricing_plan.md
- getting-pricing-api.md
- viewing_usage.md
- infra_usage.md
- project-spend.md
- understand-invoice.md
- manage_billing.md
Expand Down
45 changes: 1 addition & 44 deletions viewing_usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

copyright:
years: 2017, 2024
lastupdated: "2024-11-06"
lastupdated: "2024-11-07"

keywords: view usage, view cost, service usage, usage report, usage permissions, usage details, SoftLayer billing, classic infrastructure usage, orders, IaaS usage, invoice, billing item

Expand Down Expand Up @@ -197,46 +197,3 @@ As an alternative to the console, you can view your usage by using the {{site.da
ibmcloud billing resource-instances-usage [-o ORG] [-g RESOURCE_GROUP] [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
```
{: codeblock}

## Viewing device and service purchase information by using the console
{: #infra-orders}
{: help}
{: support}
{: ui}

You can view your device usage and service purchases for classic infrastructure devices and services by going to **Manage > Billing and usage** in the {{site.data.keyword.cloud_notm}} console.

View information about your classic infrastructure device and service purchases by selecting an option from the **Sales** navigation:

* Select **Device upgrades** to view specific information, such as which devices are upgraded and the date the case was created and completed. To view this page, you need an access policy with the Viewer role or higher on the Billing service.

You can view all open and closed cases for your infrastructure device upgrades. You can also track the progress of the case, view a logged correspondence with support, and keep track of cases that are opened and completed.
* Select **Orders** to view a list of all the orders made in your account. To view this page, you need the Add/Upgrade Storage (StorageLayer), Add Server, or Add/Upgrade Services [classic infrastructure permission](/docs/account?topic=account-mngclassicinfra).
* Select **Cancellations** to view all cancellations on your account. To view this page, you need both the Cancel server and Cancel services classic infrastructure permissions.

You can view a list of all of the cancellations made in the account, and you can view them by type of device or service. The cancellations show the device name and the case number. This list tracks ongoing and closed cases, and you can view your messages with support.
* Select **Shipments** to view your digital shipments, such as data transfer requests or physical shipments. To view this page, you need an access policy with the Viewer role or higher on the Billing service.

## Viewing billing and usage information by using the console
{: #infra-billing-ui}
{: ui}

To view billing and usage for classic infrastructure resources, you need an access policy with the Viewer role or higher on the Billing account management service. See [IAM access](/docs/account?topic=account-userroles) for more information.

* Select **Billing items** to view billing items and their associated devices. Billing items are services and products that are not a server, such as storage. Associating a billing item with a device helps you track and organize costs in your invoice.

By default, the Billing items page displays all associated billing items. You can change your view by clicking the **Associated Billing Items** menu and selecting another option. You can associate or disassociate one item, or expand the **Bulk Actions** operation for multiple items at a time. You can cancel individual billing items at any time.
* Select **Invoices** to view detailed invoices that list your device and service usage and the billed amount for each item.

To view your billed usage for the current invoicing period, click the link with your next invoice date under Next Recurring Invoice.

You can download a PDF or spreadsheet copy of an invoice for your offline records by clicking the **Download** icon ![Download icon](../icons/download.svg "Download") and selecting your download options.
{: tip}

## Viewing your classic infrastructure usage by using the API
{: #infra-billing-api}
{: api}

You can programmatically view your classic infrastructure usage by calling the [{{site.data.keyword.cloud_notm}} Usage Reports API](/apidocs/metering-reporting#get-account-usage). You can base the query in your API call on an account, org, resource group, or resource instance. For more information, see [Viewing your usage by using the API](/docs/account?topic=account-viewingusage&interface=api).

Some accounts must use the [SoftLayer API](https://sldn.softlayer.com/) to retrieve usage information for classic infrastructure resources. For more information, see [SoftLayer_Billing_Invoice](https://sldn.softlayer.com/reference/datatypes/SoftLayer_Billing_Invoice/) and [SoftLayer_Billing_Invoice_Item](https://sldn.softlayer.com/reference/datatypes/SoftLayer_Billing_Invoice_Item/).

0 comments on commit b0aff77

Please sign in to comment.