Accounts - List Skus
List available SKUs for the requested Cognitive Services account
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/skus?api-version=2023-05-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
The name of Cognitive Services account. Regex pattern: |
resource
|
path | True |
string |
The name of the resource group. The name is case insensitive. |
subscription
|
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 |
The resource provider should return 200 (OK) to indicate that the operation completed successfully. For a detailed explanation of each field in the response body, please refer to the request body description in the PUT resource section. The only GET specific properties are "name," "type" and "id." Field Description sku Required, object The exact set of keys that define this sku. This matches the fields on the respective resource. sku.name Required, string The name of the SKU. This is typically a letter + number code, such as A0 or P3 sku.tier Required, string The tier of this particular SKU. Typically one of: · Free · Basic · Standard · Premium |
|
Other Status Codes |
Error response describing why the operation failed. If the resource does not exist, 404 (NotFound) will be returned. |
Examples
List SKUs
Sample Request
Sample Response
{
"value": [
{
"resourceType": "Microsoft.CognitiveServices/accounts",
"sku": {
"name": "F0",
"tier": "Free"
}
},
{
"resourceType": "Microsoft.CognitiveServices/accounts",
"sku": {
"name": "S0",
"tier": "Standard"
}
}
]
}
Definitions
Name | Description |
---|---|
Account |
Cognitive Services resource type and SKU. |
Account |
The list of cognitive services accounts operation response. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Sku |
The resource model definition representing SKU |
Sku |
This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. |
AccountSku
Cognitive Services resource type and SKU.
Name | Type | Description |
---|---|---|
resourceType |
string |
Resource Namespace and Type |
sku |
The SKU of Cognitive Services account. |
AccountSkuListResult
The list of cognitive services accounts operation response.
Name | Type | Description |
---|---|---|
value |
Gets the list of Cognitive Services accounts and their properties. |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
Sku
The resource model definition representing SKU
Name | Type | Description |
---|---|---|
capacity |
integer |
If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted. |
family |
string |
If the service has different generations of hardware, for the same SKU, then that can be captured here. |
name |
string |
The name of the SKU. Ex - P3. It is typically a letter+number code |
size |
string |
The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code. |
tier |
This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT. |
SkuTier
This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.
Name | Type | Description |
---|---|---|
Basic |
string |
|
Enterprise |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |