Getting Information About Your Account and Quotas

You can get information about attributes of your account, such as your account ID, login details and access keys. You can also get information about your resources and their associated quotas.

Getting Information About Your Account and Quotas Using Cockpit v2

  1. In the top right corner, click the IconProfil icon.
    A drop-down menu appears.

  2. Click IconMySpace Personal Space.

    • A page appears with your personal information at the top. The following attributes are listed:

      • Account ID

      • First name

      • Last name

      • Email

      • Job title

      • Phone number

      • Mobile number

      • Country

      • Zip code

      • Company

    • Below your personal information, you can get information about your resources and their associated quotas. The following resources are listed:

      Resources Description

      Compute

      VMs

      The maximum number of VMs you can create.

      Cores

      The maximum number of vCores you can use for all your resources.

      Memory (GiB)

      The maximum amount of RAM you can use for all your resources, in gibibytes.

      Flexible GPUs

      The maximum number of flexible GPUs (fGPUs) you can allocate to your account.

      Services

      Load balancers

      The maximum number of load balancers you can create.

      Load balancer listener rules

      The maximum number of listener rules you can create.

      Customer Master Keys

      The maximum number of Customer Master Keys you can create.

      Security

      Public IPs

      The maximum number of Public IPs you can allocate to your account.

      Storage

      Number of volumes

      The maximum number of volumes you can use for all your resources.

      Cumulated GiB for standard volume type

      The maximum cumulated size of standard volumes you can create, in gibibytes.

      Cumulated size (GiB) for gp2 volumes

      The maximum cumulated size of gp2 volumes you can create, in gibibytes.

      Cumulated size (GiB) for io1 volumes

      The maximum cumulated size of io1 volumes you can create, in gibibytes.

      IOPS

      The maximum number of IOPS delivered by provisioned IOPS volumes (io1 volumes only).

      Snapshots

      The maximum number of snapshots you can create from your volumes.

      Net

      Nets

      The maximum number of Nets you can create.

      Internet services

      The maximum number of internet services you can create.

      NAT services

      The maximum number of NAT services you can create.

      Net access points

      The maximum number of Net access points you can create.

      Virtual gateways

      The maximum number of virtual gateways you can create.

      Client gateways

      The maximum number of client gateways you can create.

Getting Information About Your Account and Quotas Using OSC CLI

Getting Information About Your Account

The ReadAccounts command gets information about the account that sent the request.

Request sample
$ osc-cli api ReadAccounts --profile "default"

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

The ReadAccounts command returns the following elements:

  • Accounts: The list of the accounts.

    • AccountId: The ID of the account.

    • AdditionalEmails: One or more additional email addresses for the account. These addresses are used for notifications only.
      Pattern: ^.+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)+$.

    • City: The city of the account owner.

    • CompanyName: The name of the company for the account.

    • Country: The country of the account owner.

    • CustomerId: The ID of the customer.

    • Email: The main email address for the account. This address is used for your credentials and for notifications.

    • FirstName: The first name of the account owner.

    • JobTitle: The job title of the account owner.

    • LastName: The last name of the account owner.

    • MobileNumber: The mobile phone number of the account owner.

    • PhoneNumber: The landline phone number of the account owner.

    • StateProvince: The state/province of the account.

    • VatNumber: The value added tax (VAT) number for the account.

    • ZipCode: The ZIP code of the city.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Accounts": [
    {
      "ZipCode": "92210",
      "CompanyName": "EXAMPLE SAS",
      "FirstName": "JEAN",
      "City": "SAINT-CLOUD",
      "Country": "FRANCE",
      "LastName": "DUPONT",
      "AccountId": "123456789012",
      "CustomerId": "87654321",
      "Email": "example@example.com"
    }
  ]
}

Getting Information About Your Quotas

The ReadQuotas command lists one or more of your quotas.

For more information, see About Your Account.

Request sample: Reading specific quota
$ osc-cli api ReadQuotas --profile "default" \
    --Filters '{
        "QuotaNames": ["lb_limit"]
      }'
Request sample: Reading collection of quotas
$ osc-cli api ReadQuotas --profile "default" \
    --Filters '{
        "Collections": ["VPC"]
      }'

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Filters: (optional) One or more filters.

    • Collections: (optional) The group names of the quotas.

    • QuotaNames: (optional) The names of the quotas.

    • QuotaTypes: (optional) The resource IDs if these are resource-specific quotas, global if they are not.

    • ShortDescriptions: (optional) The description of the quotas.

  • NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.

  • ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1 and 1000, both included). By default, 100.

The ReadQuotas command returns the following elements:

  • NextPageToken: The token to request the next page of results. Each token refers to a specific page.

  • QuotaTypes: Information about one or more quotas.

    • QuotaType: The resource ID if it is a resource-specific quota, global if it is not.

    • Quotas: One or more quotas associated with the account.

      • AccountId: The account ID of the owner of the quotas.

      • Description: The description of the quota.

      • MaxValue: The maximum value of the quota for the account (if there is no limit, 0).

      • Name: The unique name of the quota.

      • QuotaCollection: The group name of the quota.

      • ShortDescription: The description of the quota.

      • UsedValue: The limit value currently used by the account.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample: Reading specific quota
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "QuotaTypes": [
    {
      "Quotas": [
        {
          "ShortDescription": "Load Balancer Limit",
          "QuotaCollection": "LBU",
          "AccountId": "123456789012",
          "Description": "Maximum number of load balancers per region",
          "MaxValue": 20,
          "UsedValue": 0,
          "Name": "lb_limit"
        }
      ],
      "QuotaType": "global"
    }
  ]
}
Result sample: Reading collection of quotas
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "QuotaTypes": [
    {
      "Quotas": [
        {
          "ShortDescription": "Example Limit",
          "QuotaCollection": "VPC",
          "AccountId": "123456789012",
          "Description": "Maximum number of examples",
          "MaxValue": 5,
          "UsedValue": 0,
          "Name": "example_limit"
        }
      ],
      "QuotaType": "global"
    },
    {
      "Quotas": [
        {
          "ShortDescription": "Other Example Limit",
          "QuotaCollection": "VPC",
          "AccountId": "123456789012",
          "Description": "Maximum number of other examples",
          "MaxValue": 50,
          "UsedValue": 1,
          "Name": "other_example_limit"
        }
      ],
      "QuotaType": "vpc-12345678"
    }
  ]
}

Getting Information About Your Account and Quotas Using oapi-cli

Getting Information About Your Account

The ReadAccounts command gets information about the account that sent the request.

Request sample
$ oapi-cli --profile "default" ReadAccounts

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

The ReadAccounts command returns the following elements:

  • Accounts: The list of the accounts.

    • AccountId: The ID of the account.

    • AdditionalEmails: One or more additional email addresses for the account. These addresses are used for notifications only.
      Pattern: ^.+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)+$.

    • City: The city of the account owner.

    • CompanyName: The name of the company for the account.

    • Country: The country of the account owner.

    • CustomerId: The ID of the customer.

    • Email: The main email address for the account. This address is used for your credentials and for notifications.

    • FirstName: The first name of the account owner.

    • JobTitle: The job title of the account owner.

    • LastName: The last name of the account owner.

    • MobileNumber: The mobile phone number of the account owner.

    • PhoneNumber: The landline phone number of the account owner.

    • StateProvince: The state/province of the account.

    • VatNumber: The value added tax (VAT) number for the account.

    • ZipCode: The ZIP code of the city.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Accounts": [
    {
      "ZipCode": "92210",
      "CompanyName": "EXAMPLE SAS",
      "FirstName": "JEAN",
      "City": "SAINT-CLOUD",
      "Country": "FRANCE",
      "LastName": "DUPONT",
      "AccountId": "123456789012",
      "CustomerId": "87654321",
      "Email": "example@example.com"
    }
  ]
}

Getting Information About Your Quotas

The ReadQuotas command lists one or more of your quotas.

For more information, see About Your Account.

Request sample: Reading specific quota
$ oapi-cli --profile "default" ReadQuotas \
    --Filters '{
        "QuotaNames": ["lb_limit"]
      }'
Request sample: Reading collection of quotas
$ oapi-cli --profile "default" ReadQuotas \
    --Filters '{
        "Collections": ["VPC"]
      }'

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Filters: (optional) One or more filters.

    • Collections: (optional) The group names of the quotas.

    • QuotaNames: (optional) The names of the quotas.

    • QuotaTypes: (optional) The resource IDs if these are resource-specific quotas, global if they are not.

    • ShortDescriptions: (optional) The description of the quotas.

  • NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.

  • ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1 and 1000, both included). By default, 100.

The ReadQuotas command returns the following elements:

  • NextPageToken: The token to request the next page of results. Each token refers to a specific page.

  • QuotaTypes: Information about one or more quotas.

    • QuotaType: The resource ID if it is a resource-specific quota, global if it is not.

    • Quotas: One or more quotas associated with the account.

      • AccountId: The account ID of the owner of the quotas.

      • Description: The description of the quota.

      • MaxValue: The maximum value of the quota for the account (if there is no limit, 0).

      • Name: The unique name of the quota.

      • QuotaCollection: The group name of the quota.

      • ShortDescription: The description of the quota.

      • UsedValue: The limit value currently used by the account.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample: Reading specific quota
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "QuotaTypes": [
    {
      "Quotas": [
        {
          "ShortDescription": "Load Balancer Limit",
          "QuotaCollection": "LBU",
          "AccountId": "123456789012",
          "Description": "Maximum number of load balancers per region",
          "MaxValue": 20,
          "UsedValue": 0,
          "Name": "lb_limit"
        }
      ],
      "QuotaType": "global"
    }
  ]
}
Result sample: Reading collection of quotas
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "QuotaTypes": [
    {
      "Quotas": [
        {
          "ShortDescription": "Example Limit",
          "QuotaCollection": "VPC",
          "AccountId": "123456789012",
          "Description": "Maximum number of examples",
          "MaxValue": 5,
          "UsedValue": 0,
          "Name": "example_limit"
        }
      ],
      "QuotaType": "global"
    },
    {
      "Quotas": [
        {
          "ShortDescription": "Other Example Limit",
          "QuotaCollection": "VPC",
          "AccountId": "123456789012",
          "Description": "Maximum number of other examples",
          "MaxValue": 50,
          "UsedValue": 1,
          "Name": "other_example_limit"
        }
      ],
      "QuotaType": "vpc-12345678"
    }
  ]
}

Related Pages

Corresponding API Methods

Export to PDF