Skus - List

Get the list of StorageCache.Cache SKUs available to this subscription.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/skus?api-version=2024-03-01

URI Parameters

Name In Required Type Description
subscriptionId
path True

string

The ID of the target subscription.

api-version
query True

string

The API version to use for this operation.

Responses

Name Type Description
200 OK

ResourceSkusResult

A list of SKU descriptors.

Other Status Codes

CloudError

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

Skus_List

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.StorageCache/skus?api-version=2024-03-01

Sample Response

{
  "value": [
    {
      "resourceType": "caches",
      "name": "Standard_2G",
      "locations": [
        "eastus"
      ],
      "locationInfo": [
        {
          "location": "eastus",
          "zones": []
        }
      ],
      "capabilities": [
        {
          "name": "throughput GB/s",
          "value": "2"
        },
        {
          "name": "cache sizes(GB)",
          "value": "3072,6144,12288"
        }
      ],
      "restrictions": []
    },
    {
      "resourceType": "caches",
      "name": "Standard_4G",
      "locations": [
        "eastus"
      ],
      "locationInfo": [
        {
          "location": "eastus",
          "zones": []
        }
      ],
      "capabilities": [
        {
          "name": "throughput GB/s",
          "value": "4"
        },
        {
          "name": "cache sizes(GB)",
          "value": "6144,12288,24576"
        }
      ],
      "restrictions": []
    },
    {
      "resourceType": "caches",
      "name": "Standard_8G",
      "locations": [
        "eastus"
      ],
      "locationInfo": [
        {
          "location": "eastus",
          "zones": []
        }
      ],
      "capabilities": [
        {
          "name": "throughput GB/s",
          "value": "8"
        },
        {
          "name": "cache sizes(GB)",
          "value": "12288,24576,49152"
        }
      ],
      "restrictions": []
    }
  ]
}

Definitions

Name Description
CloudError

An error response.

CloudErrorBody

An error response.

ReasonCode

The reason for the restriction. As of now this can be "QuotaId" or "NotAvailableForSubscription". "QuotaId" is set when the SKU has requiredQuotas parameter as the subscription does not belong to that quota. "NotAvailableForSubscription" is related to capacity at the datacenter.

ResourceSku

A resource SKU.

ResourceSkuCapabilities

A resource SKU capability.

ResourceSkuLocationInfo

Resource SKU location information.

ResourceSkusResult

The response from the List Cache SKUs operation.

Restriction

The restrictions preventing this SKU from being used.

CloudError

An error response.

Name Type Description
error

CloudErrorBody

The body of the error.

CloudErrorBody

An error response.

Name Type Description
code

string

An identifier for the error. Codes are invariant and are intended to be consumed programmatically.

details

CloudErrorBody[]

A list of additional details about the error.

message

string

A message describing the error, intended to be suitable for display in a user interface.

target

string

The target of the particular error. For example, the name of the property in error.

ReasonCode

The reason for the restriction. As of now this can be "QuotaId" or "NotAvailableForSubscription". "QuotaId" is set when the SKU has requiredQuotas parameter as the subscription does not belong to that quota. "NotAvailableForSubscription" is related to capacity at the datacenter.

Name Type Description
NotAvailableForSubscription

string

QuotaId

string

ResourceSku

A resource SKU.

Name Type Description
capabilities

ResourceSkuCapabilities[]

A list of capabilities of this SKU, such as throughput or ops/sec.

locationInfo

ResourceSkuLocationInfo[]

The set of locations where the SKU is available.

locations

string[]

The set of locations where the SKU is available. This is the supported and registered Azure Geo Regions (e.g., West US, East US, Southeast Asia, etc.).

name

string

The name of this SKU.

resourceType

string

The type of resource the SKU applies to.

restrictions

Restriction[]

The restrictions preventing this SKU from being used. This is empty if there are no restrictions.

ResourceSkuCapabilities

A resource SKU capability.

Name Type Description
name

string

Name of a capability, such as ops/sec.

value

string

Quantity, if the capability is measured by quantity.

ResourceSkuLocationInfo

Resource SKU location information.

Name Type Description
location

string

Location where this SKU is available.

zones

string[]

Zones if any.

ResourceSkusResult

The response from the List Cache SKUs operation.

Name Type Description
nextLink

string

The URI to fetch the next page of cache SKUs.

value

ResourceSku[]

The list of SKUs available for the subscription.

Restriction

The restrictions preventing this SKU from being used.

Name Type Description
reasonCode

ReasonCode

The reason for the restriction. As of now this can be "QuotaId" or "NotAvailableForSubscription". "QuotaId" is set when the SKU has requiredQuotas parameter as the subscription does not belong to that quota. "NotAvailableForSubscription" is related to capacity at the datacenter.

type

string

The type of restrictions. In this version, the only possible value for this is location.

values

string[]

The value of restrictions. If the restriction type is set to location, then this would be the different locations where the SKU is restricted.