你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
创建 Service Fabric 群集资源
创建或更新 Service Fabric 群集资源。
创建或更新具有指定名称的 Service Fabric 群集资源。
请求
方法 | 请求 URI |
---|---|
PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/clusters/{clusterName}?api-version=2018-02-01 |
参数
名称 | 类型 | 必须 | 位置 |
---|---|---|---|
resourceGroupName | 字符串 | 是 | 路径 |
clusterName | 字符串 | 是 | 路径 |
subscriptionId | 字符串 | 是 | 路径 |
api-version | 字符串 | 是 | 查询 |
parameters | Cluster | “是” | Body |
resourceGroupName
类型:字符串
必需:是
资源组的名称。
clusterName
类型:字符串
必需:是
群集资源的名称。
subscriptionId
类型:字符串
必需:是
客户订阅标识符。
api-version
类型:字符串
必需:是
默认值:2018-02-01
Service Fabric 资源提供程序 API 的版本。 这是必需参数,对于此规范,其值必须为“2018-02-01”。
parameters
类型: 群集
必需:是
群集资源。
响应
HTTP 状态代码 | 说明 | 响应架构 |
---|---|---|
200 (正常) | 操作已成功完成。 |
Cluster |
202 (已接受) | 请求已接受,操作将以异步方式完成。 |
Cluster |
所有其他状态代码 | 详细的错误响应。 |
ErrorModel |
示例
使用最小参数放置群集
请求
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster?api-version=2018-02-01
正文
{
"type": "Microsoft.ServiceFabric/clusters",
"location": "eastus",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
"name": "myCluster",
"tags": {},
"properties": {
"managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
"fabricSettings": [
{
"name": "UpgradeService",
"parameters": [
{
"name": "AppPollIntervalInSeconds",
"value": "60"
}
]
}
],
"diagnosticsStorageAccountConfig": {
"storageAccountName": "diag",
"protectedAccountKeyName": "StorageAccountKey1",
"blobEndpoint": "https://diag.blob.core.windows.net/",
"queueEndpoint": "https://diag.queue.core.windows.net/",
"tableEndpoint": "https://diag.table.core.windows.net/"
},
"nodeTypes": [
{
"name": "nt1vm",
"clientConnectionEndpointPort": "19000",
"httpGatewayEndpointPort": "19007",
"applicationPorts": {
"startPort": "20000",
"endPort": "30000"
},
"ephemeralPorts": {
"startPort": "49000",
"endPort": "64000"
},
"isPrimary": true,
"vmInstanceCount": "5",
"durabilityLevel": "Bronze"
}
],
"reliabilityLevel": "Silver",
"upgradeMode": "Automatic"
}
}
200 响应
正文
{
"type": "Microsoft.ServiceFabric/clusters",
"location": "eastus",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
"name": "myCluster",
"tags": {},
"etag": "W/\"636462502169240743\"",
"properties": {
"provisioningState": "Succeeded",
"clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
"clusterCodeVersion": "6.1.480.9494",
"clusterState": "WaitingForNodes",
"managementEndpoint": "http://myCluster.eastus.cloudapp.azure.com:19080",
"clusterEndpoint": "https://eastus.servicefabric.azure.com",
"clientCertificateThumbprints": [],
"clientCertificateCommonNames": [],
"fabricSettings": [
{
"name": "UpgradeService",
"parameters": [
{
"name": "AppPollIntervalInSeconds",
"value": "60"
}
]
}
],
"upgradeDescription": {
"forceRestart": false,
"upgradeReplicaSetCheckTimeout": "10675199.02:48:05.4775807",
"healthCheckWaitDuration": "00:05:00",
"healthCheckStableDuration": "00:05:00",
"healthCheckRetryTimeout": "00:45:00",
"upgradeTimeout": "12:00:00",
"upgradeDomainTimeout": "02:00:00",
"healthPolicy": {
"maxPercentUnhealthyNodes": "100",
"maxPercentUnhealthyApplications": "100"
},
"deltaHealthPolicy": {
"maxPercentDeltaUnhealthyNodes": "0",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "0",
"maxPercentDeltaUnhealthyApplications": "0"
}
},
"diagnosticsStorageAccountConfig": {
"storageAccountName": "diag",
"protectedAccountKeyName": "StorageAccountKey1",
"blobEndpoint": "https://diag.blob.core.windows.net/",
"queueEndpoint": "https://diag.queue.core.windows.net/",
"tableEndpoint": "https://diag.table.core.windows.net/"
},
"nodeTypes": [
{
"name": "nt1vm",
"clientConnectionEndpointPort": "19000",
"httpGatewayEndpointPort": "19007",
"applicationPorts": {
"startPort": "20000",
"endPort": "30000"
},
"ephemeralPorts": {
"startPort": "49000",
"endPort": "64000"
},
"isPrimary": true,
"vmInstanceCount": "5",
"durabilityLevel": "Bronze"
}
],
"reliabilityLevel": "Silver",
"upgradeMode": "Automatic",
"availableClusterVersions": [
{
"codeVersion": "6.1.480.9494",
"supportExpiryUtc": "2018-06-15T23:59:59.9999999",
"environment": "Windows"
}
]
}
}
放置具有最大参数的群集
请求
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster?api-version=2018-02-01
正文
{
"type": "Microsoft.ServiceFabric/clusters",
"location": "eastus",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
"name": "myCluster",
"tags": {},
"properties": {
"clusterCodeVersion": "6.1.480.9494",
"managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
"certificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "abc.com",
"certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
}
],
"x509StoreName": "My"
},
"clientCertificateThumbprints": [
{
"isAdmin": true,
"certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
}
],
"clientCertificateCommonNames": [
{
"isAdmin": true,
"certificateCommonName": "abc.com",
"certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
}
],
"fabricSettings": [
{
"name": "UpgradeService",
"parameters": [
{
"name": "AppPollIntervalInSeconds",
"value": "60"
}
]
}
],
"upgradeDescription": {
"forceRestart": false,
"upgradeReplicaSetCheckTimeout": "00:10:00",
"healthCheckWaitDuration": "00:00:30",
"healthCheckStableDuration": "00:00:30",
"healthCheckRetryTimeout": "00:05:00",
"upgradeTimeout": "01:00:00",
"upgradeDomainTimeout": "00:15:00",
"healthPolicy": {
"maxPercentUnhealthyNodes": "0",
"maxPercentUnhealthyApplications": "0",
"applicationHealthPolicies": {
"fabric:/myApp1": {
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyServices": "0"
},
"serviceTypeHealthPolicies": {
"myServiceType1": {
"maxPercentUnhealthyServices": "100"
}
}
}
}
},
"deltaHealthPolicy": {
"maxPercentDeltaUnhealthyNodes": "0",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "0",
"maxPercentDeltaUnhealthyApplications": "0",
"applicationDeltaHealthPolicies": {
"fabric:/myApp1": {
"defaultServiceTypeDeltaHealthPolicy": {
"maxPercentDeltaUnhealthyServices": "0"
},
"serviceTypeDeltaHealthPolicies": {
"myServiceType1": {
"maxPercentDeltaUnhealthyServices": "0"
}
}
}
}
}
},
"diagnosticsStorageAccountConfig": {
"storageAccountName": "diag",
"protectedAccountKeyName": "StorageAccountKey1",
"blobEndpoint": "https://diag.blob.core.windows.net/",
"queueEndpoint": "https://diag.queue.core.windows.net/",
"tableEndpoint": "https://diag.table.core.windows.net/"
},
"nodeTypes": [
{
"name": "nt1vm",
"clientConnectionEndpointPort": "19000",
"httpGatewayEndpointPort": "19007",
"applicationPorts": {
"startPort": "20000",
"endPort": "30000"
},
"ephemeralPorts": {
"startPort": "49000",
"endPort": "64000"
},
"isPrimary": true,
"vmInstanceCount": "5",
"durabilityLevel": "Bronze"
}
],
"vmImage": "Windows",
"azureActiveDirectory": {
"tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
"clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
"clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
},
"reliabilityLevel": "Silver",
"reverseProxyCertificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "abc.com",
"certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
}
],
"x509StoreName": "My"
},
"upgradeMode": "Manual",
"addOnFeatures": [
"RepairManager",
"DnsService",
"BackupRestoreService",
"ResourceMonitorService"
]
}
}
202 响应
标头
Retry-After: 10
Location: http://10.91.140.224/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/4b5f6709-bc12-4365-8df3-894984b2a221?api-version=2018-02-01
正文
{
"type": "Microsoft.ServiceFabric/clusters",
"location": "eastus",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/clusters/myCluster",
"name": "myCluster",
"tags": {},
"etag": "W/\"636462502169240745\"",
"properties": {
"provisioningState": "Succeeded",
"clusterId": "92584666-9889-4ae8-8d02-91902923d37f",
"clusterCodeVersion": "6.1.480.9494",
"clusterState": "WaitingForNodes",
"managementEndpoint": "https://myCluster.eastus.cloudapp.azure.com:19080",
"clusterEndpoint": "https://eastus.servicefabric.azure.com",
"certificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "abc.com",
"certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
}
],
"x509StoreName": "My"
},
"clientCertificateThumbprints": [
{
"isAdmin": false,
"certificateThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
}
],
"clientCertificateCommonNames": [
{
"isAdmin": true,
"certificateCommonName": "abc.com",
"certificateIssuerThumbprint": "5F3660C715EBBDA31DB1FFDCF508302348DE8E7A"
}
],
"fabricSettings": [
{
"name": "UpgradeService",
"parameters": [
{
"name": "AppPollIntervalInSeconds",
"value": "60"
}
]
}
],
"upgradeDescription": {
"forceRestart": true,
"upgradeReplicaSetCheckTimeout": "00:10:00",
"healthCheckWaitDuration": "00:00:30",
"healthCheckStableDuration": "00:00:30",
"healthCheckRetryTimeout": "00:05:00",
"upgradeTimeout": "00:15:00",
"upgradeDomainTimeout": "00:15:00",
"healthPolicy": {
"maxPercentUnhealthyNodes": "0",
"maxPercentUnhealthyApplications": "0",
"applicationHealthPolicies": {
"fabric:/myApp1": {
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyServices": "0"
},
"serviceTypeHealthPolicies": {
"myServiceType1": {
"maxPercentUnhealthyServices": "100"
}
}
}
}
},
"deltaHealthPolicy": {
"maxPercentDeltaUnhealthyNodes": "0",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "0",
"maxPercentDeltaUnhealthyApplications": "0",
"applicationDeltaHealthPolicies": {
"fabric:/myApp1": {
"defaultServiceTypeDeltaHealthPolicy": {
"maxPercentDeltaUnhealthyServices": "0"
},
"serviceTypeDeltaHealthPolicies": {
"myServiceType1": {
"maxPercentDeltaUnhealthyServices": "0"
}
}
}
}
}
},
"diagnosticsStorageAccountConfig": {
"storageAccountName": "diag",
"protectedAccountKeyName": "StorageAccountKey1",
"blobEndpoint": "https://diag.blob.core.windows.net/",
"queueEndpoint": "https://diag.queue.core.windows.net/",
"tableEndpoint": "https://diag.table.core.windows.net/"
},
"nodeTypes": [
{
"name": "nt1vm",
"clientConnectionEndpointPort": "19000",
"httpGatewayEndpointPort": "19007",
"applicationPorts": {
"startPort": "20000",
"endPort": "30000"
},
"ephemeralPorts": {
"startPort": "49000",
"endPort": "64000"
},
"isPrimary": true,
"vmInstanceCount": "5",
"durabilityLevel": "Bronze"
}
],
"vmImage": "Windows",
"azureActiveDirectory": {
"tenantId": "6abcc6a0-8666-43f1-87b8-172cf86a9f9c",
"clusterApplication": "5886372e-7bf4-4878-a497-8098aba608ae",
"clientApplication": "d151ad89-4bce-4ae8-b3d1-1dc79679fa75"
},
"reliabilityLevel": "Silver",
"reverseProxyCertificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "abc.com",
"certificateIssuerThumbprint": "12599211F8F14C90AFA9532AD79A6F2CA1C00622"
}
],
"x509StoreName": "My"
},
"upgradeMode": "Manual",
"availableClusterVersions": [
{
"codeVersion": "6.1.480.9494",
"supportExpiryUtc": "2018-06-15T23:59:59.9999999",
"environment": "Windows"
}
],
"addonFeatures": [
"RepairManager",
"DnsService",
"BackupRestoreService",
"ResourceMonitorService"
]
}
}