你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Rack Skus - List By Subscription

参考

服务:: Operator Nexus - Network Cloud

API 版本:: 2023-07-01

列出订阅中的机架 SKU。
获取提供的订阅中的机架 SKU 列表。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.NetworkCloud/rackSkus?api-version=2023-07-01

URI 参数

名称	在	必需	类型	说明
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。

响应

名称	类型	说明
200 OK	RackSkuList	还行
Other Status Codes	ErrorResponse	描述作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

List rack SKUs for subscription

示例请求

GET https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/rackSkus?api-version=2023-07-01

/** Samples for RackSkus List. */
public final class Main {
    /*
     * x-ms-original-file: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2023-07-01/examples/RackSkus_ListBySubscription.json
     */
    /**
     * Sample code: List rack SKUs for subscription.
     *
     * @param manager Entry point to NetworkCloudManager.
     */
    public static void listRackSKUsForSubscription(com.azure.resourcemanager.networkcloud.NetworkCloudManager manager) {
        manager.rackSkus().list(com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential
from azure.mgmt.networkcloud import NetworkCloudMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-networkcloud
# USAGE
    python rack_skus_list_by_subscription.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = NetworkCloudMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="123e4567-e89b-12d3-a456-426655440000",
    )

    response = client.rack_skus.list_by_subscription()
    for item in response:
        print(item)


# x-ms-original-file: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2023-07-01/examples/RackSkus_ListBySubscription.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armnetworkcloud_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/networkcloud/armnetworkcloud"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4cd95123fb961c68740565a1efcaa5e43bd35802/specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2023-07-01/examples/RackSkus_ListBySubscription.json
func ExampleRackSKUsClient_NewListBySubscriptionPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetworkcloud.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewRackSKUsClient().NewListBySubscriptionPager(nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.RackSKUList = armnetworkcloud.RackSKUList{
		// 	Value: []*armnetworkcloud.RackSKU{
		// 		{
		// 			Name: to.Ptr("rackSkuName"),
		// 			Type: to.Ptr("Microsoft.NetworkCloud/rackSkus"),
		// 			ID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/rackSkus/rackSkuName"),
		// 			SystemData: &armnetworkcloud.SystemData{
		// 				CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-01-22T13:27:03.008Z"); return t}()),
		// 				CreatedBy: to.Ptr("identityA"),
		// 				CreatedByType: to.Ptr(armnetworkcloud.CreatedByTypeApplication),
		// 				LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-01-22T13:29:03.001Z"); return t}()),
		// 				LastModifiedBy: to.Ptr("identityB"),
		// 				LastModifiedByType: to.Ptr(armnetworkcloud.CreatedByTypeUser),
		// 			},
		// 			Properties: &armnetworkcloud.RackSKUProperties{
		// 				Description: to.Ptr("Sample SKU for the single rack."),
		// 				ComputeMachines: []*armnetworkcloud.MachineSKUSlot{
		// 					{
		// 						Properties: &armnetworkcloud.MachineSKUProperties{
		// 							BootstrapProtocol: to.Ptr(armnetworkcloud.BootstrapProtocolPXE),
		// 							CPUCores: to.Ptr[int64](28),
		// 							CPUSockets: to.Ptr[int64](2),
		// 							Disks: []*armnetworkcloud.MachineDisk{
		// 								{
		// 									Type: to.Ptr(armnetworkcloud.DiskTypeSSD),
		// 									CapacityGB: to.Ptr[int64](893),
		// 									Connection: to.Ptr(armnetworkcloud.MachineSKUDiskConnectionTypeSAS),
		// 							}},
		// 							Generation: to.Ptr("8"),
		// 							HardwareVersion: to.Ptr("3"),
		// 							MemoryCapacityGB: to.Ptr[int64](512),
		// 							Model: to.Ptr("PowerEdge R750"),
		// 							NetworkInterfaces: []*armnetworkcloud.NetworkInterface{
		// 								{
		// 									Address: to.Ptr("04:00.0"),
		// 									DeviceConnectionType: to.Ptr(armnetworkcloud.DeviceConnectionTypePCI),
		// 									Model: to.Ptr("Broadcom Gigabit Ethernet BCM5720"),
		// 									PhysicalSlot: to.Ptr[int64](1),
		// 									PortCount: to.Ptr[int64](2),
		// 									PortSpeed: to.Ptr[int64](1),
		// 									Vendor: to.Ptr("Broadcom Corp"),
		// 							}},
		// 							TotalThreads: to.Ptr[int64](112),
		// 							Vendor: to.Ptr("Dell"),
		// 						},
		// 						RackSlot: to.Ptr[int64](1),
		// 				}},
		// 				ControllerMachines: []*armnetworkcloud.MachineSKUSlot{
		// 					{
		// 						Properties: &armnetworkcloud.MachineSKUProperties{
		// 							BootstrapProtocol: to.Ptr(armnetworkcloud.BootstrapProtocolPXE),
		// 							CPUCores: to.Ptr[int64](8),
		// 							CPUSockets: to.Ptr[int64](1),
		// 							Disks: []*armnetworkcloud.MachineDisk{
		// 								{
		// 									Type: to.Ptr(armnetworkcloud.DiskTypeSSD),
		// 									CapacityGB: to.Ptr[int64](893),
		// 									Connection: to.Ptr(armnetworkcloud.MachineSKUDiskConnectionTypeSAS),
		// 							}},
		// 							Generation: to.Ptr("8"),
		// 							HardwareVersion: to.Ptr("3"),
		// 							MemoryCapacityGB: to.Ptr[int64](128),
		// 							Model: to.Ptr("PowerEdge R650"),
		// 							NetworkInterfaces: []*armnetworkcloud.NetworkInterface{
		// 								{
		// 									Address: to.Ptr("04:00.0"),
		// 									DeviceConnectionType: to.Ptr(armnetworkcloud.DeviceConnectionTypePCI),
		// 									Model: to.Ptr("Broadcom Gigabit Ethernet BCM5720"),
		// 									PhysicalSlot: to.Ptr[int64](2),
		// 									PortCount: to.Ptr[int64](2),
		// 									PortSpeed: to.Ptr[int64](1),
		// 									Vendor: to.Ptr("Broadcom Corp"),
		// 							}},
		// 							TotalThreads: to.Ptr[int64](16),
		// 							Vendor: to.Ptr("Dell"),
		// 						},
		// 						RackSlot: to.Ptr[int64](5),
		// 				}},
		// 				MaxClusterSlots: to.Ptr[int64](0),
		// 				ProvisioningState: to.Ptr(armnetworkcloud.RackSKUProvisioningStateSucceeded),
		// 				RackType: to.Ptr(armnetworkcloud.RackSKUTypeSingle),
		// 				StorageAppliances: []*armnetworkcloud.StorageApplianceSKUSlot{
		// 					{
		// 						Properties: &armnetworkcloud.StorageApplianceSKUProperties{
		// 							CapacityGB: to.Ptr[int64](9100),
		// 							Model: to.Ptr("x70r3-9"),
		// 						},
		// 						RackSlot: to.Ptr[int64](2),
		// 				}},
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { NetworkCloud } = require("@azure/arm-networkcloud");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Get a list of rack SKUs in the provided subscription.
 *
 * @summary Get a list of rack SKUs in the provided subscription.
 * x-ms-original-file: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2023-07-01/examples/RackSkus_ListBySubscription.json
 */
async function listRackSkUsForSubscription() {
  const subscriptionId =
    process.env["NETWORKCLOUD_SUBSCRIPTION_ID"] || "123e4567-e89b-12d3-a456-426655440000";
  const credential = new DefaultAzureCredential();
  const client = new NetworkCloud(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.rackSkus.listBySubscription()) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.NetworkCloud;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2023-07-01/examples/RackSkus_ListBySubscription.json
// this example is just showing the usage of "RackSkus_ListBySubscription" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "123e4567-e89b-12d3-a456-426655440000";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// get the collection of this NetworkCloudRackSkuResource
NetworkCloudRackSkuCollection collection = subscriptionResource.GetNetworkCloudRackSkus();

// invoke the operation and iterate over the result
await foreach (NetworkCloudRackSkuResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    NetworkCloudRackSkuData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "value": [
    {
      "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/rackSkus/rackSkuName",
      "name": "rackSkuName",
      "systemData": {
        "createdAt": "2021-01-22T13:27:03.008Z",
        "createdBy": "identityA",
        "createdByType": "Application",
        "lastModifiedAt": "2021-01-22T13:29:03.001Z",
        "lastModifiedBy": "identityB",
        "lastModifiedByType": "User"
      },
      "type": "Microsoft.NetworkCloud/rackSkus",
      "properties": {
        "provisioningState": "Succeeded",
        "rackType": "Single",
        "maxClusterSlots": 0,
        "description": "Sample SKU for the single rack.",
        "controllerMachines": [
          {
            "properties": {
              "vendor": "Dell",
              "model": "PowerEdge R650",
              "generation": "8",
              "hardwareVersion": "3",
              "bootstrapProtocol": "PXE",
              "cpuSockets": 1,
              "cpuCores": 8,
              "totalThreads": 16,
              "memoryCapacityGB": 128,
              "disks": [
                {
                  "capacityGB": 893,
                  "type": "SSD",
                  "connection": "SAS"
                }
              ],
              "networkInterfaces": [
                {
                  "address": "04:00.0",
                  "physicalSlot": 2,
                  "portCount": 2,
                  "portSpeed": 1,
                  "deviceConnectionType": "PCI",
                  "vendor": "Broadcom Corp",
                  "model": "Broadcom Gigabit Ethernet BCM5720"
                }
              ]
            },
            "rackSlot": 5
          }
        ],
        "computeMachines": [
          {
            "properties": {
              "vendor": "Dell",
              "model": "PowerEdge R750",
              "generation": "8",
              "hardwareVersion": "3",
              "bootstrapProtocol": "PXE",
              "cpuSockets": 2,
              "cpuCores": 28,
              "totalThreads": 112,
              "memoryCapacityGB": 512,
              "disks": [
                {
                  "capacityGB": 893,
                  "type": "SSD",
                  "connection": "SAS"
                }
              ],
              "networkInterfaces": [
                {
                  "address": "04:00.0",
                  "physicalSlot": 1,
                  "portCount": 2,
                  "portSpeed": 1,
                  "deviceConnectionType": "PCI",
                  "vendor": "Broadcom Corp",
                  "model": "Broadcom Gigabit Ethernet BCM5720"
                }
              ]
            },
            "rackSlot": 1
          }
        ],
        "storageAppliances": [
          {
            "properties": {
              "capacityGB": 9100,
              "model": "x70r3-9"
            },
            "rackSlot": 2
          }
        ]
      }
    }
  ]
}

定义

名称	说明
BootstrapProtocol	使用的启动协议的类型。
createdByType	创建资源的标识的类型。
DeviceConnectionType	设备的连接类型。
DiskType	机架 SKU 资源的磁盘类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
MachineDisk	磁盘表示磁盘的属性。
MachineSkuDiskConnectionType	机架 SKU 资源的连接类型。
MachineSkuSlot	MachineSkuSlot 表示与计算机关联的单个 SKU 和机架槽。
NetworkInterface	NetworkInterface 表示网络接口的属性。
RackSku	RackSku 表示机架的 SKU 信息。
RackSkuList	RackSkuList 表示机架 SKU 的列表。
RackSkuProvisioningState	机架 SKU 资源的预配状态。
RackSkuType	机架的类型。
StorageApplianceSkuSlot	StorageApplianceSkuSlot 表示与存储设备关联的单个 SKU 和机架槽。
systemData	与创建和上次修改资源相关的元数据。

BootstrapProtocol

枚举

使用的启动协议的类型。

值	说明
PXE

createdByType

枚举

创建资源的标识的类型。

值	说明
Application
Key
ManagedIdentity
User

DeviceConnectionType

枚举

设备的连接类型。

值	说明
PCI

DiskType

枚举

机架 SKU 资源的磁盘类型。

值	说明
HDD
SSD

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

MachineDisk

Object

磁盘表示磁盘的属性。

名称	类型	说明
capacityGB	integer (int64)	最大存储量（以 GB 为单位）。
connection	MachineSkuDiskConnectionType	机架 SKU 资源的连接类型。
type	DiskType	机架 SKU 资源的磁盘类型。

MachineSkuDiskConnectionType

枚举

机架 SKU 资源的连接类型。

值	说明
PCIE
RAID
SAS
SATA

MachineSkuSlot

Object

MachineSkuSlot 表示与计算机关联的单个 SKU 和机架槽。

名称	类型	说明
properties.bootstrapProtocol	BootstrapProtocol	使用的启动协议的类型。
properties.cpuCores	integer (int64)	此计算机的 CPU 内核计数。
properties.cpuSockets	integer (int64)	此计算机的 CPU 套接字计数。
properties.disks	MachineDisk[]	磁盘列表。
properties.generation	string	体系结构的生成。
properties.hardwareVersion	string	计算机的硬件版本。
properties.memoryCapacityGB	integer (int64)	最大内存量（以 GB 为单位）。
properties.model	string	计算机的模型。
properties.networkInterfaces	NetworkInterface[]	网络接口列表。
properties.totalThreads	integer (int64)	此计算机的 SMT 和物理核心线程计数。
properties.vendor	string	计算机的构成。
rackSlot	integer (int64)	机器机架中的位置。

NetworkInterface

Object

NetworkInterface 表示网络接口的属性。

名称	类型	说明
address	string	外围组件互连（PCI）的部分地址。
deviceConnectionType	DeviceConnectionType	设备的连接类型。
model	string	设备的模型名称。
physicalSlot	integer (int64)	此设备的物理槽。
portCount	integer (int64)	设备上的端口数。
portSpeed	integer (int64)	行卡在任何给定秒内通过端口传输的最大数据量（以 GB 为单位）。
vendor	string	设备的供应商名称。

RackSku

Object

RackSku 表示机架的 SKU 信息。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties.computeMachines	MachineSkuSlot[]	此机架模型中计算专用计算机的计算机 SKU 和关联的机架槽的列表。
properties.controllerMachines	MachineSkuSlot[]	此机架模型中控制平面专用计算机的计算机 SKU 和关联的机架槽的列表。
properties.description	string	描述机架的自由格式文本。
properties.maxClusterSlots	integer (int64)	聚合器机架支持的最大计算机架数。如果这是单个机架群集（rackType=“Single”）的计算机架或机架，则为 0。
properties.provisioningState	RackSkuProvisioningState	机架 SKU 资源的预配状态。
properties.rackType	RackSkuType	机架的类型。
properties.storageAppliances	StorageApplianceSkuSlot[]	此机架模型中的存储设备 SKU 和关联的机架槽的列表。
properties.supportedRackSkuIds	string[]	如果机架是聚合器，则支持 SKU 的列表。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源的类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

RackSkuList

Object

RackSkuList 表示机架 SKU 的列表。

名称	类型	说明
nextLink	string	用于获取下一页作的链接。
value	RackSku[]	Rack SKU 列表。

RackSkuProvisioningState

枚举

机架 SKU 资源的预配状态。

值	说明
Succeeded

RackSkuType

枚举

机架的类型。

值	说明
Aggregator
Compute
Single

StorageApplianceSkuSlot

Object

StorageApplianceSkuSlot 表示与存储设备关联的单个 SKU 和机架槽。

名称	类型	说明
properties.capacityGB	integer (int64)	存储设备的最大容量。
properties.model	string	存储设备的模型。
rackSlot	integer (int64)	存储设备机架中的位置。

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。