How to view storage profile usage

Overview

Before allocating more disk space in your UKCloud for VMware account, it's useful to check how much of your allocated space has been used.

Viewing a VDC's storage usage (Tenant Portal)

In the VMware Cloud Director Tenant Portal, you can see how much storage a VDC is currently using.

  1. In the VMware Cloud Director Virtual Data Center dashboard, find the card for the VDC.

  2. The Storage section shows how much storage the VDC is currently using as well as the amount of allocated storage.

    VDC card showing storage usage and allocation

Viewing a VM's storage usage (Tenant Portal)

In the VMware Cloud Director Tenant Portal, you can see how much storage an individual VM is currently using.

  1. In the VMware Cloud Director Virtual Data Center dashboard, select the VDC that contains the VM.

  2. Find the card for the VM.

  3. The Storage section shows how much storage the VM is currently using.

    VM card showing storage usage and allocation

Viewing a VDC's storage usage (Cloud Director API)

To check your storage profile usage programmatically, you need to call the appropriate Cloud Director REST API endpoint.

Note

Before calling this endpoint, you must first authenticate your session as described in How to access VMware Cloud Director through the Cloud Director API.

We've provided some sample code to show how to make this call on our GitHub repository.

The using_curl.md page provides an example of how to use CURL to call the REST API. The example assumes that you have set up the following three environment variables to hold your user credentials:

  • VCD_ORG

  • VCD_USERNAME

  • VCD_PASSWORD

The example makes two calls to the API. The first call authenticates the session:

curl -u %VCD_USERNAME%@%VCD_ORG%:%VCD_PASSWORD%  -H "Accept: application/*+xml;version=5.6" -X POST -i https://vcd.portal.skyscapecloud.com/api/sessions
Tip

On Linux, use $VCD_USERNAME instead of %VCD_USERNAME%.

Having authenticated successfully and received an x-vcloud-authorisation header in the response, the second call passes the authentication token as a header on the request:

curl -H "x-vcloud-authorization: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6" -H "Accept: application/*+xml;version=5.6" -i  https://vcd.portal.skyscapecloud.com/api/query?type=orgVdcStorageProfile

This call returns an XML structure, in which you can see an OrgVdcStorageProfileRecord element containing the following properties:

storageLimitMB="512000" storageUsedMB="65536"

The GitHub repository also provides a ruby example. Again, the script assumes the above environment variables have been set up with your user credentials.

You can use the ruby script by running:

ruby storage_profile.rb

The output will look similar to the following:

Name        Used GB   Total GB   Percent   VDC
BASIC-Any   192       500        38.5%     XXXX

Feedback

If you find a problem with this article, click Improve this Doc to make the change yourself or raise an issue in GitHub. If you have an idea for how we could improve any of our services, send an email to feedback@ukcloud.com.