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

Clusters - Create

创建 HCI 群集。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}?api-version=2022-09-01

URI 参数

Name In Required Type Description
clusterName
path True
  • string

群集的名称。

resourceGroupName
path True
  • string

资源组的名称。 此名称不区分大小写。

subscriptionId
path True
  • string

目标订阅的 ID。

api-version
query True
  • string

要用于此操作的 API 版本。

请求正文

Name Required Type Description
location True
  • string

资源所在的地理位置

properties.aadApplicationObjectId
  • string

群集 AAD 标识的对象 ID。

properties.aadClientId
  • string

群集 AAD 标识的应用 ID。

properties.aadServicePrincipalObjectId
  • string

群集标识服务主体的 ID。

properties.aadTenantId
  • string

群集 AAD 标识的租户 ID。

properties.cloudManagementEndpoint
  • string

配置为从Azure 门户进行管理的终结点。

properties.desiredProperties

群集的所需属性。

properties.softwareAssuranceProperties

群集的软件保障属性。

systemData.createdAt
  • string

资源创建时间戳 (UTC) 。

systemData.createdBy
  • string

创建资源的标识。

systemData.createdByType

创建资源的标识的类型。

systemData.lastModifiedAt
  • string

资源上次修改的时间戳 (UTC)

systemData.lastModifiedBy
  • string

上次修改资源的标识。

systemData.lastModifiedByType

上次修改资源的标识的类型。

tags
  • object

资源标记。

响应

Name Type Description
200 OK

OK

Other Status Codes

描述操作失败原因的错误响应。

安全性

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 模拟用户帐户

示例

Create cluster

Sample Request

PUT https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/clusters/myCluster?api-version=2022-09-01

{
  "location": "East US",
  "properties": {
    "cloudManagementEndpoint": "https://98294836-31be-4668-aeae-698667faf99b.waconazure.com",
    "aadClientId": "24a6e53d-04e5-44d2-b7cc-1b732a847dfc",
    "aadTenantId": "7e589cc1-a8b6-4dff-91bd-5ec0fa18db94"
  }
}

Sample Response

{
  "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/clusters/myCluster",
  "name": "myCluster",
  "type": "Microsoft.AzureStackHCI/clusters",
  "location": "East US",
  "tags": {},
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "status": "NotYetRegistered",
    "cloudId": "a3c0468f-e38e-4dda-ac48-817f620536f0",
    "cloudManagementEndpoint": "https://98294836-31be-4668-aeae-698667faf99b.waconazure.com",
    "aadClientId": "24a6e53d-04e5-44d2-b7cc-1b732a847dfc",
    "aadTenantId": "7e589cc1-a8b6-4dff-91bd-5ec0fa18db94",
    "desiredProperties": {
      "windowsServerSubscription": "Disabled",
      "diagnosticLevel": "Basic"
    },
    "reportedProperties": {},
    "trialDaysRemaining": 30,
    "billingModel": "Trial",
    "serviceEndpoint": "https://azurestackhci.azurefd.net/eastus"
  }
}

定义

Cluster

群集详细信息。

ClusterDesiredProperties

群集的所需属性。

ClusterNode

群集节点详细信息。

ClusterNodeType

群集节点硬件的类型。

ClusterReportedProperties

群集代理报告的属性。

createdByType

创建资源的标识的类型。

DiagnosticLevel

群集发出的所需诊断数据级别。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

ImdsAttestation

群集的 IMDS 证明状态。

ProvisioningState

预配状态。

SoftwareAssuranceIntent

软件保障权益的客户意向。

SoftwareAssuranceProperties

群集的软件保障属性。

SoftwareAssuranceStatus

群集的软件保障状态。

Status

群集代理的状态。

WindowsServerSubscription

Windows Server 订阅的所需状态。

Cluster

群集详细信息。

Name Type Description
id
  • string

资源的完全限定的资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

资源所在的地理位置

name
  • string

资源的名称

properties.aadApplicationObjectId
  • string

群集 AAD 标识的对象 ID。

properties.aadClientId
  • string

群集 AAD 标识的应用 ID。

properties.aadServicePrincipalObjectId
  • string

群集标识服务主体的 ID。

properties.aadTenantId
  • string

群集 AAD 标识的租户 ID。

properties.billingModel
  • string

应用于资源的计费类型。

properties.cloudId
  • string

唯一的不可变资源 ID。

properties.cloudManagementEndpoint
  • string

配置为从Azure 门户进行管理的终结点。

properties.desiredProperties

群集的所需属性。

properties.lastBillingTimestamp
  • string

最新的计费计量时间戳。

properties.lastSyncTimestamp
  • string

最新的群集同步时间戳。

properties.provisioningState

预配状态。

properties.registrationTimestamp
  • string

第一个群集同步时间戳。

properties.reportedProperties

群集代理报告的属性。

properties.serviceEndpoint
  • string

群集的区域特定 DataPath 终结点。

properties.softwareAssuranceProperties

群集的软件保障属性。

properties.status

群集代理的状态。

properties.trialDaysRemaining
  • number

试用期内剩余的天数。

systemData.createdAt
  • string

资源创建时间戳 (UTC) 。

systemData.createdBy
  • string

创建资源的标识。

systemData.createdByType

创建资源的标识的类型。

systemData.lastModifiedAt
  • string

资源上次修改的时间戳 (UTC)

systemData.lastModifiedBy
  • string

上次修改资源的标识。

systemData.lastModifiedByType

上次修改资源的标识的类型。

tags
  • object

资源标记。

type
  • string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ClusterDesiredProperties

群集的所需属性。

Name Type Description
diagnosticLevel

群集发出的所需诊断数据级别。

windowsServerSubscription

Windows Server 订阅的所需状态。

ClusterNode

群集节点详细信息。

Name Type Description
coreCount
  • number

群集节点上的物理核心数。

id
  • number

群集中节点的 ID。

manufacturer
  • string

群集节点硬件制造商。

memoryInGiB
  • number

GiB) 中的群集节点上的总可用内存 (。

model
  • string

群集节点硬件的模型名称。

name
  • string

群集节点的名称。

nodeType

群集节点硬件的类型。

osDisplayVersion
  • string

显示群集节点上运行的操作系统的版本。

osName
  • string

在群集节点上运行的操作系统。

osVersion
  • string

在群集节点上运行的操作系统的版本。

serialNumber
  • string

群集节点的不可变 ID。

windowsServerSubscription

Windows Server 订阅的状态。

ClusterNodeType

群集节点硬件的类型。

Name Type Description
FirstParty
  • string
ThirdParty
  • string

ClusterReportedProperties

群集代理报告的属性。

Name Type Description
clusterId
  • string

本地群集生成的唯一 ID。

clusterName
  • string

连接到此资源的本地群集的名称。

clusterVersion
  • string

群集软件的版本。

diagnosticLevel

群集发出的诊断数据级别。

imdsAttestation

群集的 IMDS 证明状态。

lastUpdated
  • string

上次群集报告数据的时间。

nodes

群集报告的节点列表。

createdByType

创建资源的标识的类型。

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DiagnosticLevel

群集发出的所需诊断数据级别。

Name Type Description
Basic
  • string
Enhanced
  • string
Off
  • string

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

ErrorDetail

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

ErrorResponse

错误响应

Name Type Description
error

错误对象。

ImdsAttestation

群集的 IMDS 证明状态。

Name Type Description
Disabled
  • string
Enabled
  • string

ProvisioningState

预配状态。

Name Type Description
Accepted
  • string
Canceled
  • string
Failed
  • string
Provisioning
  • string
Succeeded
  • string

SoftwareAssuranceIntent

软件保障权益的客户意向。

Name Type Description
Disable
  • string
Enable
  • string

SoftwareAssuranceProperties

群集的软件保障属性。

Name Type Description
lastUpdated
  • string

TimeStamp 表示已验证最新的 SA 权益适用性。

softwareAssuranceIntent

软件保障权益的客户意向。

softwareAssuranceStatus

群集的软件保障状态。

SoftwareAssuranceStatus

群集的软件保障状态。

Name Type Description
Disabled
  • string
Enabled
  • string

Status

群集代理的状态。

Name Type Description
ConnectedRecently
  • string
Disconnected
  • string
Error
  • string
NotConnectedRecently
  • string
NotYetRegistered
  • string

WindowsServerSubscription

Windows Server 订阅的所需状态。

Name Type Description
Disabled
  • string
Enabled
  • string