List Role Sizes
Updated: September 5, 2017
The List Role Sizes operation lists the role sizes that are available under the specified subscription.
The List Role Sizes request may be specified as follows. Replace <subscription-id> with the subscription ID.
| Method | Request URI |
|---|---|
| GET | https://management.core.windows.net/<subscription-id>/rolesizes |
URI Parameters
None.
Request Headers
The following table describes the request headers.
| Request Header | Description |
|---|---|
x-ms-version | Required. Specifies the version of the operation to use for this request. This header should be set to 2013-08-01 or higher. |
Request Body
None.
The response includes an HTTP status code, a set of response headers, and a response body.
Status Code
A successful operation returns status code 200 (OK).
Response Headers
The response for this operation includes the following headers. The response may also include additional standard HTTP headers.
| Response Header | Description |
|---|---|
x-ms-request-id | A value that uniquely identifies a request made against the management service. |
Response Body
The format of the response body is as follows:
<?xml version="1.0" encoding="utf-8"?>
<RoleSizes xmlns=”http://schemas.microsoft.com/windowsazure”>
<RoleSize>
<Name>name-of-role-size</Name>
<Label>identifier-of-role-size</Label>
<Cores>available-vcpus</Cores>
<MemoryInMb>available-memory</MemoryInMb>
<SupportedByWebWorkerRoles>indicator-of-web-worker-support</SupportedByWebWorkerRoles>
<SupportedByVirtualMachines>indicator-of-virtual-machine-support</SupportedByVirtualMachines>
<MaxDataDiskCount>maximum-allowed-data-disks</MaxDataDiskCount>
<WebWorkerResourceDiskSizeInMb>resource-disk-size</WebWorkerResourceDiskSizeInMb>
<VirtualMachineResourceDiskSizeInMb>resource-disk-size</VirtualMachineResourceDiskSizeInMb>
</RoleSize>
</RoleSizes>
The following table describes the elements of the response body.
| Element name | Description |
|---|---|
| RoleSize | Specifies information about a role size that is available in your subscription. |
| Name | Specifies the name of the role size. |
| Label | Specifies the description of the role size. |
| Cores | Specifies the number of vCPUs that are available in the role size. |
| MemoryInMb | Specifies the amount of memory that is available in the role size. |
| SupportedByWebWorkerRoles | Indicates whether the role size supports web roles or worker roles. Possible values are: - true- false |
| SupportedByVirtualMachines | Indicates whether the role size supports Virtual Machines. Possible values are: - true- false |
| MaxDataDiskCount | Specifies the maximum number of data disks that can be attached to the role. |
| WebWorkerResourceDiskSizeInMb | Specifies the size of the resource disk for a web role or worker role. |
| VirtualMachineResourceDiskSizeInMb | Specifies the size of the resource disk for a Virtual Machine. |
Show: