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

Node Types - Update

参考

服务:: Service Fabric

API 版本:: 2024-09-01-preview

更新给定托管群集的节点类型资源的标记。
更新给定托管群集的节点类型的配置，仅更新标记。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/managedClusters/{clusterName}/nodeTypes/{nodeTypeName}?api-version=2024-09-01-preview

URI 参数

名称	在	必需	类型	说明
clusterName	path	True	string	群集资源的名称。
nodeTypeName	path	True	string	节点类型的名称。
resourceGroupName	path	True	string	资源组的名称。
subscriptionId	path	True	string	客户订阅标识符。
api-version	query	True	string	Service Fabric 资源提供程序 API 的版本。这是一个必需参数，其值必须为此规范的“2024-09-01-preview”。

请求正文

名称	类型	说明
sku	NodeTypeSku	节点类型 SKU。
tags	object	节点类型更新参数

响应

名称	类型	说明
200 OK	NodeType	操作已成功完成。
202 Accepted		请求已接受，操作将以异步方式完成。标头 Azure-AsyncOperation: string Location: string
Other Status Codes	ErrorModel	详细的错误响应。

名称

类型

说明

200 OK

NodeType

操作已成功完成。

202 Accepted

请求已接受，操作将以异步方式完成。

标头

Azure-AsyncOperation: string
Location: string

Other Status Codes

ErrorModel

详细的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Patch a node type

Patch a node type while auto-scaling

Patch a node type

示例请求

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/BE?api-version=2024-09-01-preview

{
  "tags": {
    "a": "b"
  }
}


import com.azure.resourcemanager.servicefabricmanagedclusters.models.NodeType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for NodeTypes Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/
     * examples/NodeTypePatchOperation_example.json
     */
    /**
     * Sample code: Patch a node type.
     * 
     * @param manager Entry point to ServiceFabricManagedClustersManager.
     */
    public static void patchANodeType(
        com.azure.resourcemanager.servicefabricmanagedclusters.ServiceFabricManagedClustersManager manager) {
        NodeType resource = manager.nodeTypes()
            .getWithResponse("resRg", "myCluster", "BE", com.azure.core.util.Context.NONE).getValue();
        resource.update().withTags(mapOf("a", "b")).apply();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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.servicefabricmanagedclusters import ServiceFabricManagedClustersManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-servicefabricmanagedclusters
# USAGE
    python node_type_patch_operation_example.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 = ServiceFabricManagedClustersManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.node_types.begin_update(
        resource_group_name="resRg",
        cluster_name="myCluster",
        node_type_name="BE",
        parameters={"tags": {"a": "b"}},
    ).result()
    print(response)


# x-ms-original-file: specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperation_example.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 armservicefabricmanagedclusters_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/servicefabricmanagedclusters/armservicefabricmanagedclusters"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperation_example.json
func ExampleNodeTypesClient_BeginUpdate_patchANodeType() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armservicefabricmanagedclusters.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewNodeTypesClient().BeginUpdate(ctx, "resRg", "myCluster", "BE", armservicefabricmanagedclusters.NodeTypeUpdateParameters{
		Tags: map[string]*string{
			"a": to.Ptr("b"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.NodeType = armservicefabricmanagedclusters.NodeType{
	// 	Name: to.Ptr("BE"),
	// 	Type: to.Ptr("Microsoft.ServiceFabric/managedClusters/nodeTypes"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/BE"),
	// 	Tags: map[string]*string{
	// 		"a": to.Ptr("b"),
	// 	},
	// 	Properties: &armservicefabricmanagedclusters.NodeTypeProperties{
	// 		Capacities: map[string]*string{
	// 			"ClientConnections": to.Ptr("65536"),
	// 		},
	// 		DataDiskSizeGB: to.Ptr[int32](200),
	// 		DataDiskType: to.Ptr(armservicefabricmanagedclusters.DiskTypeStandardSSDLRS),
	// 		IsPrimary: to.Ptr(false),
	// 		IsStateless: to.Ptr(false),
	// 		PlacementProperties: map[string]*string{
	// 			"HasSSD": to.Ptr("true"),
	// 			"NodeColor": to.Ptr("green"),
	// 			"SomeProperty": to.Ptr("5"),
	// 		},
	// 		ProvisioningState: to.Ptr(armservicefabricmanagedclusters.ManagedResourceProvisioningStateSucceeded),
	// 		VMExtensions: []*armservicefabricmanagedclusters.VMSSExtension{
	// 			{
	// 				Name: to.Ptr("Microsoft.Azure.Geneva.GenevaMonitoring"),
	// 				Properties: &armservicefabricmanagedclusters.VMSSExtensionProperties{
	// 					Type: to.Ptr("GenevaMonitoring"),
	// 					AutoUpgradeMinorVersion: to.Ptr(true),
	// 					Publisher: to.Ptr("Microsoft.Azure.Geneva"),
	// 					Settings: map[string]any{
	// 					},
	// 					TypeHandlerVersion: to.Ptr("2.0"),
	// 				},
	// 		}},
	// 		VMImageOffer: to.Ptr("WindowsServer"),
	// 		VMImagePublisher: to.Ptr("MicrosoftWindowsServer"),
	// 		VMImageSKU: to.Ptr("2016-Datacenter-Server-Core"),
	// 		VMImageVersion: to.Ptr("latest"),
	// 		VMInstanceCount: to.Ptr[int32](10),
	// 		VMManagedIdentity: &armservicefabricmanagedclusters.VMManagedIdentity{
	// 			UserAssignedIdentities: []*string{
	// 				to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity")},
	// 			},
	// 			VMSecrets: []*armservicefabricmanagedclusters.VaultSecretGroup{
	// 				{
	// 					SourceVault: &armservicefabricmanagedclusters.SubResource{
	// 						ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.KeyVault/vaults/myVault"),
	// 					},
	// 					VaultCertificates: []*armservicefabricmanagedclusters.VaultCertificate{
	// 						{
	// 							CertificateStore: to.Ptr("My"),
	// 							CertificateURL: to.Ptr("https://myVault.vault.azure.net:443/secrets/myCert/ef1a31d39e1f46bca33def54b6cda54c"),
	// 					}},
	// 			}},
	// 			VMSize: to.Ptr("Standard_D3"),
	// 		},
	// 	}
}

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

const {
  ServiceFabricManagedClustersManagementClient,
} = require("@azure/arm-servicefabricmanagedclusters");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update the configuration of a node type of a given managed cluster, only updating tags.
 *
 * @summary Update the configuration of a node type of a given managed cluster, only updating tags.
 * x-ms-original-file: specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperation_example.json
 */
async function patchANodeType() {
  const subscriptionId =
    process.env["SERVICEFABRICMANAGEDCLUSTERS_SUBSCRIPTION_ID"] ||
    "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["SERVICEFABRICMANAGEDCLUSTERS_RESOURCE_GROUP"] || "resRg";
  const clusterName = "myCluster";
  const nodeTypeName = "BE";
  const parameters = { tags: { a: "b" } };
  const credential = new DefaultAzureCredential();
  const client = new ServiceFabricManagedClustersManagementClient(credential, subscriptionId);
  const result = await client.nodeTypes.beginUpdateAndWait(
    resourceGroupName,
    clusterName,
    nodeTypeName,
    parameters,
  );
  console.log(result);
}

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ServiceFabricManagedClusters.Models;
using Azure.ResourceManager.ServiceFabricManagedClusters;

// Generated from example definition: specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperation_example.json
// this example is just showing the usage of "NodeTypes_Update" 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 ServiceFabricManagedNodeTypeResource created on azure
// for more information of creating ServiceFabricManagedNodeTypeResource, please refer to the document of ServiceFabricManagedNodeTypeResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "resRg";
string clusterName = "myCluster";
string nodeTypeName = "BE";
ResourceIdentifier serviceFabricManagedNodeTypeResourceId = ServiceFabricManagedNodeTypeResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, clusterName, nodeTypeName);
ServiceFabricManagedNodeTypeResource serviceFabricManagedNodeType = client.GetServiceFabricManagedNodeTypeResource(serviceFabricManagedNodeTypeResourceId);

// invoke the operation
ServiceFabricManagedNodeTypePatch patch = new ServiceFabricManagedNodeTypePatch()
{
    Tags =
    {
    ["a"] = "b",
    },
};
ArmOperation<ServiceFabricManagedNodeTypeResource> lro = await serviceFabricManagedNodeType.UpdateAsync(WaitUntil.Completed, patch);
ServiceFabricManagedNodeTypeResource result = lro.Value;

// the variable result 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
ServiceFabricManagedNodeTypeData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

示例响应

状态代码:: 200

{
  "type": "Microsoft.ServiceFabric/managedClusters/nodeTypes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/BE",
  "name": "BE",
  "tags": {
    "a": "b"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "isPrimary": false,
    "dataDiskSizeGB": 200,
    "dataDiskType": "StandardSSD_LRS",
    "placementProperties": {
      "HasSSD": "true",
      "NodeColor": "green",
      "SomeProperty": "5"
    },
    "capacities": {
      "ClientConnections": "65536"
    },
    "vmSize": "Standard_D3",
    "vmImagePublisher": "MicrosoftWindowsServer",
    "vmImageOffer": "WindowsServer",
    "vmImageSku": "2016-Datacenter-Server-Core",
    "vmImageVersion": "latest",
    "vmInstanceCount": 10,
    "isStateless": false,
    "vmSecrets": [
      {
        "sourceVault": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.KeyVault/vaults/myVault"
        },
        "vaultCertificates": [
          {
            "certificateStore": "My",
            "certificateUrl": "https://myVault.vault.azure.net:443/secrets/myCert/ef1a31d39e1f46bca33def54b6cda54c"
          }
        ]
      }
    ],
    "vmExtensions": [
      {
        "name": "Microsoft.Azure.Geneva.GenevaMonitoring",
        "properties": {
          "autoUpgradeMinorVersion": true,
          "publisher": "Microsoft.Azure.Geneva",
          "type": "GenevaMonitoring",
          "typeHandlerVersion": "2.0",
          "settings": {}
        }
      }
    ],
    "vmManagedIdentity": {
      "userAssignedIdentities": [
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"
      ]
    }
  }
}

状态代码:: 202

Location: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-09-01-preview
Azure-AsyncOperation: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-09-01-preview

Patch a node type while auto-scaling

示例请求

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/BE?api-version=2024-09-01-preview

{
  "tags": {
    "a": "b"
  },
  "sku": {
    "name": "Standard_S0",
    "tier": "Standard",
    "capacity": 10
  }
}


import com.azure.resourcemanager.servicefabricmanagedclusters.models.NodeType;
import com.azure.resourcemanager.servicefabricmanagedclusters.models.NodeTypeSku;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for NodeTypes Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/
     * examples/NodeTypePatchOperationAutoScale_example.json
     */
    /**
     * Sample code: Patch a node type while auto-scaling.
     * 
     * @param manager Entry point to ServiceFabricManagedClustersManager.
     */
    public static void patchANodeTypeWhileAutoScaling(
        com.azure.resourcemanager.servicefabricmanagedclusters.ServiceFabricManagedClustersManager manager) {
        NodeType resource = manager.nodeTypes()
            .getWithResponse("resRg", "myCluster", "BE", com.azure.core.util.Context.NONE).getValue();
        resource.update().withTags(mapOf("a", "b"))
            .withSku(new NodeTypeSku().withName("Standard_S0").withTier("Standard").withCapacity(10)).apply();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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.servicefabricmanagedclusters import ServiceFabricManagedClustersManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-servicefabricmanagedclusters
# USAGE
    python node_type_patch_operation_auto_scale_example.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 = ServiceFabricManagedClustersManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.node_types.begin_update(
        resource_group_name="resRg",
        cluster_name="myCluster",
        node_type_name="BE",
        parameters={"sku": {"capacity": 10, "name": "Standard_S0", "tier": "Standard"}, "tags": {"a": "b"}},
    ).result()
    print(response)


# x-ms-original-file: specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperationAutoScale_example.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 armservicefabricmanagedclusters_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/servicefabricmanagedclusters/armservicefabricmanagedclusters"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperationAutoScale_example.json
func ExampleNodeTypesClient_BeginUpdate_patchANodeTypeWhileAutoScaling() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armservicefabricmanagedclusters.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewNodeTypesClient().BeginUpdate(ctx, "resRg", "myCluster", "BE", armservicefabricmanagedclusters.NodeTypeUpdateParameters{
		SKU: &armservicefabricmanagedclusters.NodeTypeSKU{
			Name:     to.Ptr("Standard_S0"),
			Capacity: to.Ptr[int32](10),
			Tier:     to.Ptr("Standard"),
		},
		Tags: map[string]*string{
			"a": to.Ptr("b"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.NodeType = armservicefabricmanagedclusters.NodeType{
	// 	Name: to.Ptr("BE"),
	// 	Type: to.Ptr("Microsoft.ServiceFabric/managedClusters/nodeTypes"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/BE"),
	// 	Tags: map[string]*string{
	// 		"a": to.Ptr("b"),
	// 	},
	// 	Properties: &armservicefabricmanagedclusters.NodeTypeProperties{
	// 		Capacities: map[string]*string{
	// 			"ClientConnections": to.Ptr("65536"),
	// 		},
	// 		DataDiskSizeGB: to.Ptr[int32](200),
	// 		DataDiskType: to.Ptr(armservicefabricmanagedclusters.DiskTypeStandardSSDLRS),
	// 		IsPrimary: to.Ptr(false),
	// 		IsStateless: to.Ptr(false),
	// 		PlacementProperties: map[string]*string{
	// 			"HasSSD": to.Ptr("true"),
	// 			"NodeColor": to.Ptr("green"),
	// 			"SomeProperty": to.Ptr("5"),
	// 		},
	// 		ProvisioningState: to.Ptr(armservicefabricmanagedclusters.ManagedResourceProvisioningStateSucceeded),
	// 		VMExtensions: []*armservicefabricmanagedclusters.VMSSExtension{
	// 			{
	// 				Name: to.Ptr("Microsoft.Azure.Geneva.GenevaMonitoring"),
	// 				Properties: &armservicefabricmanagedclusters.VMSSExtensionProperties{
	// 					Type: to.Ptr("GenevaMonitoring"),
	// 					AutoUpgradeMinorVersion: to.Ptr(true),
	// 					Publisher: to.Ptr("Microsoft.Azure.Geneva"),
	// 					Settings: map[string]any{
	// 					},
	// 					TypeHandlerVersion: to.Ptr("2.0"),
	// 				},
	// 		}},
	// 		VMImageOffer: to.Ptr("WindowsServer"),
	// 		VMImagePublisher: to.Ptr("MicrosoftWindowsServer"),
	// 		VMImageSKU: to.Ptr("2016-Datacenter-Server-Core"),
	// 		VMImageVersion: to.Ptr("latest"),
	// 		VMInstanceCount: to.Ptr[int32](10),
	// 		VMManagedIdentity: &armservicefabricmanagedclusters.VMManagedIdentity{
	// 			UserAssignedIdentities: []*string{
	// 				to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity")},
	// 			},
	// 			VMSecrets: []*armservicefabricmanagedclusters.VaultSecretGroup{
	// 				{
	// 					SourceVault: &armservicefabricmanagedclusters.SubResource{
	// 						ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.KeyVault/vaults/myVault"),
	// 					},
	// 					VaultCertificates: []*armservicefabricmanagedclusters.VaultCertificate{
	// 						{
	// 							CertificateStore: to.Ptr("My"),
	// 							CertificateURL: to.Ptr("https://myVault.vault.azure.net:443/secrets/myCert/ef1a31d39e1f46bca33def54b6cda54c"),
	// 					}},
	// 			}},
	// 			VMSize: to.Ptr("Standard_D3"),
	// 		},
	// 		SKU: &armservicefabricmanagedclusters.NodeTypeSKU{
	// 			Name: to.Ptr("Standard_S0"),
	// 			Capacity: to.Ptr[int32](10),
	// 			Tier: to.Ptr("Standard"),
	// 		},
	// 	}
}

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

const {
  ServiceFabricManagedClustersManagementClient,
} = require("@azure/arm-servicefabricmanagedclusters");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Update the configuration of a node type of a given managed cluster, only updating tags.
 *
 * @summary Update the configuration of a node type of a given managed cluster, only updating tags.
 * x-ms-original-file: specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperationAutoScale_example.json
 */
async function patchANodeTypeWhileAutoScaling() {
  const subscriptionId =
    process.env["SERVICEFABRICMANAGEDCLUSTERS_SUBSCRIPTION_ID"] ||
    "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["SERVICEFABRICMANAGEDCLUSTERS_RESOURCE_GROUP"] || "resRg";
  const clusterName = "myCluster";
  const nodeTypeName = "BE";
  const parameters = {
    sku: { name: "Standard_S0", capacity: 10, tier: "Standard" },
    tags: { a: "b" },
  };
  const credential = new DefaultAzureCredential();
  const client = new ServiceFabricManagedClustersManagementClient(credential, subscriptionId);
  const result = await client.nodeTypes.beginUpdateAndWait(
    resourceGroupName,
    clusterName,
    nodeTypeName,
    parameters,
  );
  console.log(result);
}

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ServiceFabricManagedClusters.Models;
using Azure.ResourceManager.ServiceFabricManagedClusters;

// Generated from example definition: specification/servicefabricmanagedclusters/resource-manager/Microsoft.ServiceFabric/preview/2024-09-01-preview/examples/NodeTypePatchOperationAutoScale_example.json
// this example is just showing the usage of "NodeTypes_Update" 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 ServiceFabricManagedNodeTypeResource created on azure
// for more information of creating ServiceFabricManagedNodeTypeResource, please refer to the document of ServiceFabricManagedNodeTypeResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "resRg";
string clusterName = "myCluster";
string nodeTypeName = "BE";
ResourceIdentifier serviceFabricManagedNodeTypeResourceId = ServiceFabricManagedNodeTypeResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, clusterName, nodeTypeName);
ServiceFabricManagedNodeTypeResource serviceFabricManagedNodeType = client.GetServiceFabricManagedNodeTypeResource(serviceFabricManagedNodeTypeResourceId);

// invoke the operation
ServiceFabricManagedNodeTypePatch patch = new ServiceFabricManagedNodeTypePatch()
{
    Tags =
    {
    ["a"] = "b",
    },
    Sku = new NodeTypeSku(10)
    {
        Name = "Standard_S0",
        Tier = "Standard",
    },
};
ArmOperation<ServiceFabricManagedNodeTypeResource> lro = await serviceFabricManagedNodeType.UpdateAsync(WaitUntil.Completed, patch);
ServiceFabricManagedNodeTypeResource result = lro.Value;

// the variable result 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
ServiceFabricManagedNodeTypeData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

示例响应

状态代码:: 200

{
  "type": "Microsoft.ServiceFabric/managedClusters/nodeTypes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/BE",
  "name": "BE",
  "tags": {
    "a": "b"
  },
  "sku": {
    "name": "Standard_S0",
    "tier": "Standard",
    "capacity": 10
  },
  "properties": {
    "provisioningState": "Succeeded",
    "isPrimary": false,
    "dataDiskSizeGB": 200,
    "dataDiskType": "StandardSSD_LRS",
    "placementProperties": {
      "HasSSD": "true",
      "NodeColor": "green",
      "SomeProperty": "5"
    },
    "capacities": {
      "ClientConnections": "65536"
    },
    "vmSize": "Standard_D3",
    "vmImagePublisher": "MicrosoftWindowsServer",
    "vmImageOffer": "WindowsServer",
    "vmImageSku": "2016-Datacenter-Server-Core",
    "vmImageVersion": "latest",
    "vmInstanceCount": 10,
    "isStateless": false,
    "vmSecrets": [
      {
        "sourceVault": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.KeyVault/vaults/myVault"
        },
        "vaultCertificates": [
          {
            "certificateStore": "My",
            "certificateUrl": "https://myVault.vault.azure.net:443/secrets/myCert/ef1a31d39e1f46bca33def54b6cda54c"
          }
        ]
      }
    ],
    "vmExtensions": [
      {
        "name": "Microsoft.Azure.Geneva.GenevaMonitoring",
        "properties": {
          "autoUpgradeMinorVersion": true,
          "publisher": "Microsoft.Azure.Geneva",
          "type": "GenevaMonitoring",
          "typeHandlerVersion": "2.0",
          "settings": {}
        }
      }
    ],
    "vmManagedIdentity": {
      "userAssignedIdentities": [
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"
      ]
    }
  }
}

状态代码:: 202

Location: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationResults/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-09-01-preview
Azure-AsyncOperation: http://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2024-09-01-preview

定义

名称	说明
access	允许或拒绝网络流量。
AdditionalNetworkInterfaceConfiguration	指定要附加到节点类型的网络接口的设置。
direction	网络安全规则方向。
DiskType	托管数据磁盘类型。 IOPS 和吞吐量由磁盘大小提供，有关详细信息，请转到 https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types。
EndpointRangeDescription	端口范围详细信息
ErrorModel	错误的结构。
ErrorModelError	错误详细信息。
EvictionPolicyType	指定 SPOT 节点类型中虚拟机的逐出策略。
FrontendConfiguration	描述节点类型的前端配置。
IPAddressType	IP 地址类型。
IpConfiguration	指定网络接口的 IP 配置。
IpTag	与公共 IP 地址关联的 IP 标记。
ManagedResourceProvisioningState	托管资源的预配状态。
NetworkSecurityRule	描述网络安全规则。
NodeType	描述群集中的节点类型，每个节点类型表示群集中的子节点集。
NodeTypeNatConfig	提供有关节点类型默认公共负载均衡器上的 NAT 配置的信息。
NodeTypeSku	描述节点类型 SKU。
NodeTypeUpdateParameters	节点类型更新请求
nsgProtocol	此规则适用于的网络协议。
privateIPAddressVersion	指定 IP 配置的专用 IP 是 IPv4 还是 IPv6。默认值为 IPv4。
PublicIPAddressConfiguration	网络接口的公共 IP 地址配置。
publicIPAddressVersion	指定 IP 配置的公共 IP 是 IPv4 还是 IPv6。默认值为 IPv4。
securityType	指定 nodeType 的安全类型。目前仅支持 Standard 和 TrustedLaunch
SubResource	Azure 资源标识符。
SystemData	与创建和上次修改资源相关的元数据。
VaultCertificate	介绍 Key Vault 中的单个证书引用，以及证书应驻留在 VM 上的位置。
VaultSecretGroup	指定应安装在虚拟机上的证书集。
VmApplication	指定应提供给基础 VMSS 的库应用程序。
VmImagePlan	指定有关用于创建虚拟机的市场映像的信息。此元素仅用于市场映像。必须先启用映像以编程方式使用映像，然后才能从 API 使用市场映像。在 Azure 门户中，找到要使用的市场映像，然后单击“想要以编程方式部署”->。输入任何必需信息，然后单击“保存”。
VmManagedIdentity	节点类型下虚拟机规模集的标识。
VmSetupAction	在启动 Service Fabric 运行时之前，在 VM 上执行的操作。
VmssDataDisk	托管数据磁盘说明。
VMSSExtension	指定应安装在虚拟机上的扩展集。
VmssExtensionSetupOrder	Vm 扩展设置顺序。

access

枚举

允许或拒绝网络流量。

值	说明
allow
deny

AdditionalNetworkInterfaceConfiguration

Object

指定要附加到节点类型的网络接口的设置。

名称	类型	说明
dscpConfiguration	SubResource	指定要应用于网络接口的 DSCP 配置。
enableAcceleratedNetworking	boolean	指定网络接口是否已启用加速网络。
ipConfigurations	IpConfiguration[]	指定网络接口的 IP 配置。
name	string	网络接口的名称。

direction

枚举

网络安全规则方向。

值	说明
inbound
outbound

DiskType

枚举

托管数据磁盘类型。 IOPS 和吞吐量由磁盘大小提供，有关详细信息，请转到 https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types。

值	说明
Premium_LRS	高级 SSD 本地冗余存储。最适合生产和性能敏感的工作负荷。
StandardSSD_LRS	标准 SSD 本地冗余存储。最适合 Web 服务器、轻型企业应用程序和开发/测试。
Standard_LRS	标准 HDD 本地冗余存储。最适合备份、非关键访问和不经常访问。

EndpointRangeDescription

Object

端口范围详细信息

名称	类型	说明
endPort	integer (int32)	一系列端口的结束端口
startPort	integer (int32)	一系列端口的起始端口

ErrorModel

Object

错误的结构。

名称	类型	说明
error	ErrorModelError	错误详细信息。

ErrorModelError

Object

错误详细信息。

名称	类型	说明
code	string	错误代码。
message	string	错误消息。

EvictionPolicyType

枚举

指定 SPOT 节点类型中虚拟机的逐出策略。

值	说明
Deallocate	逐出策略将为 SPOT vm 的解除分配。
Delete	逐出策略将为 SPOT vm 删除。

FrontendConfiguration

Object

描述节点类型的前端配置。

名称	类型	默认值	说明
applicationGatewayBackendAddressPoolId	string (arm-id)		应用程序网关后端地址池的资源 ID。资源 ID 的格式为“/subscriptions//resourceGroups//providers/Microsoft.Network/applicationGateways//backendAddressPools/”。
ipAddressType	IPAddressType	IPv4	此前端配置的 IP 地址类型。如果省略默认值为 IPv4。
loadBalancerBackendAddressPoolId	string (arm-id)		与节点类型的 VM 实例关联的负载均衡器后端地址池的资源 ID。资源 ID 的格式为“/subscriptions//resourceGroups//providers/Microsoft.Network/loadBalancers//backendAddressPools/”。
loadBalancerInboundNatPoolId	string (arm-id)		与节点类型的 VM 实例关联的负载均衡器入站 NAT 池的资源 ID。资源 ID 的格式为“/subscriptions//resourceGroups//providers/Microsoft.Network/loadBalancers//inboundNatPools/”。

IPAddressType

枚举

IP 地址类型。

值	说明
IPv4	IPv4 地址类型。
IPv6	IPv6 地址类型。

IpConfiguration

Object

指定网络接口的 IP 配置。

名称	类型	默认值	说明
applicationGatewayBackendAddressPools	SubResource[]		指定对应用程序网关后端地址池的引用数组。节点类型可以引用多个应用程序网关的后端地址池。多个节点类型不能使用相同的应用程序网关。
loadBalancerBackendAddressPools	SubResource[]		指定对负载均衡器后端地址池的引用数组。节点类型可以引用一个公共负载均衡器和一个内部负载均衡器的后端地址池。多个节点类型不能使用相同的基本 SKU 负载均衡器。
loadBalancerInboundNatPools	SubResource[]		指定对负载均衡器的入站 Nat 池的引用数组。节点类型可以引用一个公共负载均衡器和一个内部负载均衡器的入站 NAT 池。多个节点类型不能使用相同的基本 SKU 负载均衡器。
name	string		网络接口的名称。
privateIPAddressVersion	privateIPAddressVersion	IPv4	指定 IP 配置的专用 IP 是 IPv4 还是 IPv6。默认值为 IPv4。
publicIPAddressConfiguration	PublicIPAddressConfiguration		网络接口的公共 IP 地址配置。
subnet	SubResource		指定网络接口的子网。

IpTag

Object

与公共 IP 地址关联的 IP 标记。

名称	类型	说明
ipTagType	string	IP 标记类型。示例：FirstPartyUsage。
tag	string	与公共 IP 关联的 IP 标记。示例：SQL、存储等。

ManagedResourceProvisioningState

枚举

托管资源的预配状态。

值	说明
Canceled
Created
Creating
Deleted
Deleting
Failed
None
Other
Succeeded
Updating

NetworkSecurityRule

Object

描述网络安全规则。

名称	类型	说明
access	access	允许或拒绝网络流量。
description	string	网络安全规则说明。
destinationAddressPrefix	string	目标地址前缀。 CIDR 或目标 IP 范围。星号“*”还可用于匹配所有源 IP。也可以使用默认标记，例如“VirtualNetwork”、“AzureLoadBalancer”和“Internet”。
destinationAddressPrefixes	string[]	目标地址前缀。 CIDR 或目标 IP 范围。
destinationPortRange	string	他的目标端口或范围。介于 0 和 65535 之间的整数或范围。星号“*”也可用于匹配所有端口。
destinationPortRanges	string[]	目标端口范围。
direction	direction	网络安全规则方向。
name	string	网络安全规则名称。
priority	integer (int32) minimum: 1000 maximum: 3000	规则的优先级。该值可以介于 1000 到 3000 的范围内。此范围之外的值是为 Service Fabric ManagerCluster 资源提供程序保留的。对于集合中的每个规则，优先级编号必须是唯一的。优先级编号越低，规则优先级越高。
protocol	nsgProtocol	此规则适用于的网络协议。
sourceAddressPrefix	string	CIDR 或源 IP 范围。星号“*”还可用于匹配所有源 IP。也可以使用默认标记，例如“VirtualNetwork”、“AzureLoadBalancer”和“Internet”。如果这是入口规则，则指定网络流量的来源。
sourceAddressPrefixes	string[]	CIDR 或源 IP 范围。
sourcePortRange	string	源端口或范围。介于 0 和 65535 之间的整数或范围。星号“*”也可用于匹配所有端口。
sourcePortRanges	string[]	源端口范围。

NodeType

Object

描述群集中的节点类型，每个节点类型表示群集中的子节点集。

名称	类型	默认值	说明
id	string		Azure 资源标识符。
name	string		Azure 资源名称。
properties.additionalDataDisks	VmssDataDisk[]		其他托管数据磁盘。
properties.additionalNetworkInterfaceConfigurations	AdditionalNetworkInterfaceConfiguration[]		指定要附加到节点类型的任何其他辅助网络接口的设置。
properties.applicationPorts	EndpointRangeDescription		群集分配端口到 Service Fabric 应用程序的端口范围。
properties.capacities	object		应用于节点类型的节点的容量标记，群集资源管理器使用这些标记来了解节点拥有的资源量。
properties.computerNamePrefix	string		指定计算机名称前缀。限制为 9 个字符。如果指定，则允许为节点类型名称指定更长的名称。
properties.dataDiskLetter	string pattern: ^[a-zA-Z]{1}$		托管数据磁盘字母。它不能使用保留的字母 C 或 D，并且无法在创建后更改。
properties.dataDiskSizeGB	integer (int32)		附加到 BLOB 中节点类型的 VM 的托管磁盘的磁盘大小。
properties.dataDiskType	DiskType	StandardSSD_LRS	托管数据磁盘类型。指定托管磁盘的存储帐户类型
properties.dscpConfigurationId	string (arm-id)		指定要应用于节点类型网络接口的 DSCP 配置的资源 ID。
properties.enableAcceleratedNetworking	boolean		指定网络接口是否已启用加速网络。
properties.enableEncryptionAtHost	boolean	False	为节点类型上的虚拟机启用或禁用主机加密。这将为所有磁盘启用加密，包括主机本身的资源/临时磁盘。默认值：除非将此属性设置为 true，否则将禁用主机上的加密。
properties.enableNodePublicIP	boolean		指定是否为每个节点分配自己的公共 IPv4 地址。这仅在具有自定义负载均衡器的辅助节点类型上受支持。
properties.enableNodePublicIPv6	boolean		指定是否为每个节点分配自己的公共 IPv6 地址。这仅在具有自定义负载均衡器的辅助节点类型上受支持。
properties.enableOverProvisioning	boolean		指定是否应过度预配节点类型。仅允许无状态节点类型使用。
properties.ephemeralPorts	EndpointRangeDescription		应配置此节点类型的节点的临时端口范围。
properties.evictionPolicy	EvictionPolicyType		指定 SPOT 节点类型中虚拟机的逐出策略。默认值为 Delete。
properties.frontendConfigurations	FrontendConfiguration[]		指示节点类型使用自己的前端配置，而不是群集的默认配置。此设置只能为非主节点类型指定，并且无法在创建节点类型后添加或删除。
properties.hostGroupId	string		指定完整的主机组资源 ID。此属性用于在 Azure 专用主机上部署。
properties.isPrimary	boolean		指示群集的 Service Fabric 系统服务将在此节点类型上运行。创建节点类型后，无法更改此设置。
properties.isSpotVM	boolean		指示节点类型是否为现成虚拟机。如果容量可用，Azure 将分配 VM，并且可以随时逐出 VM。
properties.isStateless	boolean	False	指示节点类型是否只能托管无状态工作负荷。
properties.multiplePlacementGroups	boolean	False	指示与节点类型关联的规模集是否可以由多个放置组组成。
properties.natConfigurations	NodeTypeNatConfig[]		为节点类型指定默认公共负载均衡器上的 NAT 配置。只有节点类型才支持使用默认的公共负载均衡器。
properties.natGatewayId	string (arm-id)		指定要附加到此节点类型的子网的 NAT 网关的资源 ID。节点类型必须使用自定义负载均衡器。
properties.networkSecurityRules	NetworkSecurityRule[]		此节点类型的网络安全规则。只能为配置前端配置的节点类型指定此设置。
properties.placementProperties	object		应用于节点类型的节点的放置标记，可用于指示某些服务（工作负荷）应运行的位置。
properties.provisioningState	ManagedResourceProvisioningState		节点类型资源的预配状态。
properties.secureBootEnabled	boolean		指定是否应在 nodeType 上启用安全启动。只能与 TrustedLaunch SecurityType 一起使用
properties.securityType	securityType		指定 nodeType 的安全类型。目前仅支持 Standard 和 TrustedLaunch
properties.serviceArtifactReferenceId	string (arm-id)		指定使用“latest”映像版本时，用于为规模集中的所有虚拟机设置相同映像版本的服务项目引用 ID。
properties.spotRestoreTimeout	string		指示平台不会尝试还原指定为 ISO 8601 的 VMSS SPOT 实例的持续时间。
properties.subnetId	string (arm-id)		指示节点类型的子网的资源 ID。
properties.useDefaultPublicLoadBalancer	boolean		指定是否使用公共负载均衡器。如果未指定且节点类型没有自己的前端配置，它将附加到默认负载均衡器。如果节点类型使用自己的负载均衡器，并且 useDefaultPublicLoadBalancer 为 true，则前端必须是内部负载均衡器。如果节点类型使用自己的负载均衡器，并且 useDefaultPublicLoadBalancer 为 false 或未设置，则自定义负载均衡器必须包含公共负载均衡器才能提供出站连接。
properties.useEphemeralOSDisk	boolean		指示是否使用临时 os 磁盘。 vmSize 属性上选择的 SKU 需要支持此功能。
properties.useTempDataDisk	boolean		指定是否将临时磁盘用于 Service Fabric 数据根目录，在这种情况下，不会附加托管数据磁盘，并且将使用临时磁盘。仅允许无状态节点类型使用。
properties.vmApplications	VmApplication[]		指定应提供给基础 VMSS 的库应用程序。
properties.vmExtensions	VMSSExtension[]		虚拟机扩展。应安装在虚拟机上的扩展集。
properties.vmImageOffer	string		Azure 虚拟机市场映像的产品/服务类型。例如，UbuntuServer 或 WindowsServer。
properties.vmImagePlan	VmImagePlan		指定有关用于创建虚拟机的市场映像的信息。此元素仅用于市场映像。必须先启用映像以编程方式使用映像，然后才能从 API 使用市场映像。在 Azure 门户中，找到要使用的市场映像，然后单击“想要以编程方式部署”->。输入任何必需信息，然后单击“保存”。
properties.vmImagePublisher	string		Azure 虚拟机市场映像的发布者。例如，Canonical 或 MicrosoftWindowsServer。
properties.vmImageResourceId	string (arm-id)		指示 vm 映像的资源 ID。此参数用于自定义 VM 映像。
properties.vmImageSku	string		Azure 虚拟机市场映像的 SKU。例如，14.04.0-LTS 或 2012-R2-Datacenter。
properties.vmImageVersion	string		Azure 虚拟机市场映像的版本。可以指定值“latest”以选择映像的最新版本。如果省略，则默认值为“latest”。
properties.vmInstanceCount	integer (int32) minimum: -1 maximum: 2147483647		节点类型中的节点数。值： -1 - 配置自动缩放规则或定义 sku.capacity 时使用 0 - 不支持 >0 - 用于手动缩放。
properties.vmManagedIdentity	VmManagedIdentity		要分配给节点类型下的虚拟机规模集的标识。
properties.vmSecrets	VaultSecretGroup[]		虚拟机机密。要安装在虚拟机中的机密。
properties.vmSetupActions	VmSetupAction[]		指定要在启动 Service Fabric 运行时之前在 VM 上执行的操作。
properties.vmSharedGalleryImageId	string (arm-id)		指示 vm 共享库映像的资源 ID。此参数用于自定义 VM 映像。
properties.vmSize	string		池中虚拟机的大小。池中的所有虚拟机的大小都相同。例如，Standard_D3。
properties.zones	string[]		指定节点类型跨越的可用性区域。如果群集未跨可用性区域，请启动群集的 az migration。
sku	NodeTypeSku		节点类型 SKU。
systemData	SystemData		与创建和上次修改资源相关的元数据。
tags	object		Azure 资源标记。
type	string		Azure 资源类型。

NodeTypeNatConfig

Object

提供有关节点类型默认公共负载均衡器上的 NAT 配置的信息。

名称	类型	说明
backendPort	integer (int32) minimum: 1 maximum: 65535	NAT 配置的内部端口。
frontendPortRangeEnd	integer (int32) minimum: 1 maximum: 65534	外部终结点的端口范围结束。
frontendPortRangeStart	integer (int32) minimum: 1 maximum: 65534	端口范围从外部终结点开始。

NodeTypeSku

Object

描述节点类型 SKU。

名称	类型	说明
capacity	integer (int32) minimum: 1 maximum: 2147483647	节点类型中的节点数。如果请求中存在，它将替代 properties.vmInstanceCount。
name	string	SKU 名称。名称在内部生成，用于自动缩放方案。属性不允许更改为生成的其他值。若要避免部署错误，请省略该属性。
tier	string	指定节点类型的层。可能的值：标准

NodeTypeUpdateParameters

Object

节点类型更新请求

名称	类型	说明
sku	NodeTypeSku	节点类型 SKU。
tags	object	节点类型更新参数

nsgProtocol

枚举

此规则适用于的网络协议。

值	说明
ah
esp
http
https
icmp
tcp
udp

privateIPAddressVersion

枚举

指定 IP 配置的专用 IP 是 IPv4 还是 IPv6。默认值为 IPv4。

值	说明
IPv4
IPv6

PublicIPAddressConfiguration

Object

网络接口的公共 IP 地址配置。

名称	类型	默认值	说明
ipTags	IpTag[]		指定与公共 IP 地址关联的 IP 标记列表。
name	string		网络接口的名称。
publicIPAddressVersion	publicIPAddressVersion	IPv4	指定 IP 配置的公共 IP 是 IPv4 还是 IPv6。默认值为 IPv4。

publicIPAddressVersion

枚举

指定 IP 配置的公共 IP 是 IPv4 还是 IPv6。默认值为 IPv4。

值	说明
IPv4
IPv6

securityType

枚举

指定 nodeType 的安全类型。目前仅支持 Standard 和 TrustedLaunch

值	说明
Standard	标准是所有计算机的默认安全类型。
TrustedLaunch	受信任的启动是保护第 2 代虚拟机的安全类型。

SubResource

Object

Azure 资源标识符。

名称	类型	说明
id	string	Azure 资源标识符。

SystemData

Object

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

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

VaultCertificate

Object

介绍 Key Vault 中的单个证书引用，以及证书应驻留在 VM 上的位置。

名称	类型	说明
certificateStore	string	对于 Windows VM，指定应向其添加证书的虚拟机上的证书存储。指定的证书存储隐式位于 LocalMachine 帐户中。对于 Linux VM，证书文件位于 /var/lib/waagent 目录下，文件名为 .crt，用于 X509 证书文件和私钥的 .prv。这两个文件都是 .pem 格式的。
certificateUrl	string	这是已作为机密上传到 Key Vault 的证书的 URL。若要将机密添加到 Key Vault，请参阅向密钥保管库添加密钥或机密。

VaultSecretGroup

Object

指定应安装在虚拟机上的证书集。

名称	类型	说明
sourceVault	SubResource	Key Vault 的相对 URL，其中包含 VaultCertificates 中的所有证书。
vaultCertificates	VaultCertificate[]	SourceVault 中包含证书的密钥保管库引用列表。

VmApplication

Object

指定应提供给基础 VMSS 的库应用程序。

名称	类型	说明
configurationReference	string (uri)	可选，指定 Azure Blob 的 URI，该 URI 将替换包的默认配置（如果提供）。
enableAutomaticUpgrade	boolean	如果设置为 true，则当 PIR/SIG 中提供了新的库应用程序版本时，基础 VMSS 会自动更新它。
order	integer (int32)	可选，指定包必须安装的顺序。
packageReferenceId	string (arm-id)	指定 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version} 形式的 GalleryApplicationVersion 资源 ID。
treatFailureAsDeploymentFailure	boolean	可选，如果为 true，则 VmApplication 中任何操作的任何失败都将使部署失败。
vmGalleryTags	string	可选，指定更多泛型上下文的传递值。接受 JSON 格式的字符串，例如“{”Tag1“：”Value1“，”Tag2“：”Value2“}”。

VmImagePlan

Object

指定有关用于创建虚拟机的市场映像的信息。此元素仅用于市场映像。必须先启用映像以编程方式使用映像，然后才能从 API 使用市场映像。在 Azure 门户中，找到要使用的市场映像，然后单击“想要以编程方式部署”->。输入任何必需信息，然后单击“保存”。

名称	类型	说明
name	string	计划 ID。
product	string	指定来自市场的映像的产品。此值与 imageReference 元素下的 Offer 相同。
promotionCode	string	促销代码。
publisher	string	发布者 ID。

VmManagedIdentity

Object

节点类型下虚拟机规模集的标识。

名称	类型	说明
userAssignedIdentities	string[]	与节点类型下的虚拟机规模集关联的用户标识列表。每个条目都是 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

VmSetupAction

枚举

在启动 Service Fabric 运行时之前，在 VM 上执行的操作。

值	说明
EnableContainers	启用 Windows 容器功能。
EnableHyperV	启用 Windows HyperV 功能。

VmssDataDisk

Object

托管数据磁盘说明。

名称	类型	默认值	说明
diskLetter	string pattern: ^[a-zA-Z]{1}$		托管数据磁盘字母。它不能使用保留的字母 C 或 D，并且无法在创建后更改。
diskSizeGB	integer (int32)		节点类型中每个 VM 的磁盘大小（以 GB 为单位）。
diskType	DiskType	StandardSSD_LRS	托管数据磁盘类型。指定托管磁盘的存储帐户类型
lun	integer (int32) minimum: 1		指定数据磁盘的逻辑单元号。此值用于标识 VM 中的数据磁盘，因此对于附加到 VM 的每个数据磁盘必须是唯一的。 Lun 0 是为 Service Fabric 数据磁盘保留的。

VMSSExtension

Object

指定应安装在虚拟机上的扩展集。

名称	类型	说明
name	string	扩展的名称。
properties.autoUpgradeMinorVersion	boolean	指示扩展是否应在部署时使用较新的次要版本。但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。
properties.enableAutomaticUpgrade	boolean	指示如果有较新版本的扩展可用，平台是否应自动升级扩展。
properties.forceUpdateTag	string	如果提供值并且与上一个值不同，则即使扩展配置未更改，扩展处理程序也会强制更新。
properties.protectedSettings	object	该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。
properties.provisionAfterExtensions	string[]	需要预配此扩展的扩展名称的集合。
properties.provisioningState	string	预配状态，仅出现在响应中。
properties.publisher	string	扩展处理程序发布者的名称。
properties.settings	object	扩展的 Json 格式公共设置。
properties.setupOrder	VmssExtensionSetupOrder[]	指示扩展的设置顺序。
properties.type	string	指定扩展的类型;例如“CustomScriptExtension”。
properties.typeHandlerVersion	string	指定脚本处理程序的版本。

VmssExtensionSetupOrder

枚举

Vm 扩展设置顺序。

值	说明
BeforeSFRuntime	指示 VM 扩展应在 Service Fabric 运行时启动之前运行。

通过

Node Types - Update

URI 参数

请求正文

响应

安全性

azure_auth

作用域

示例

Patch a node type

示例请求

示例响应

Patch a node type while auto-scaling

示例请求

示例响应

定义

access

AdditionalNetworkInterfaceConfiguration

direction

DiskType

EndpointRangeDescription

ErrorModel

ErrorModelError

EvictionPolicyType

FrontendConfiguration

IPAddressType

IpConfiguration

IpTag

ManagedResourceProvisioningState

NetworkSecurityRule

NodeType

NodeTypeNatConfig

NodeTypeSku

NodeTypeUpdateParameters

nsgProtocol

privateIPAddressVersion

PublicIPAddressConfiguration

publicIPAddressVersion

securityType

SubResource

SystemData

VaultCertificate

VaultSecretGroup

VmApplication

VmImagePlan

VmManagedIdentity

VmSetupAction

VmssDataDisk

VMSSExtension

VmssExtensionSetupOrder