Freigeben über


Node Types - Get

Ruft einen Service Fabric-Knotentyp ab.
Rufen Sie einen Service Fabric-Knotentyp eines bestimmten verwalteten Clusters ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
path True

string

Der Name der Clusterressource.

nodeTypeName
path True

string

Der Name des Knotentyps.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Der Bezeichner des Kundenabonnements.

api-version
query True

string

Die Version der Service Fabric-Ressourcenanbieter-API. Dies ist ein erforderlicher Parameter, und der Wert muss für diese Spezifikation "2024-04-01" sein.

Antworten

Name Typ Beschreibung
200 OK

NodeType

Der Vorgang wurde erfolgreich abgeschlossen.

Other Status Codes

ErrorModel

Die detaillierte Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Get a node type

Beispielanforderung

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/FE?api-version=2024-04-01

Beispiel für eine Antwort

{
  "type": "Microsoft.ServiceFabric/managedClusters/nodeTypes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/nodeTypes/FE",
  "name": "FE",
  "tags": {},
  "properties": {
    "isPrimary": true,
    "dataDiskSizeGB": 100,
    "dataDiskType": "StandardSSD_LRS",
    "placementProperties": {},
    "capacities": {},
    "vmSize": "Standard_D2",
    "vmImagePublisher": "MicrosoftWindowsServer",
    "vmImageOffer": "WindowsServer",
    "vmImageSku": "2016-Datacenter",
    "vmImageVersion": "latest",
    "vmInstanceCount": 5,
    "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"
          }
        ]
      }
    ]
  }
}

Definitionen

Name Beschreibung
access

Der Netzwerkdatenverkehr wird zugelassen oder verweigert.

AdditionalNetworkInterfaceConfiguration

Gibt die Einstellungen für eine Netzwerkschnittstelle an, die an den Knotentyp angefügt werden soll.

direction

Richtung der Netzwerksicherheitsregel.

DiskType

Verwalteter Datenträgertyp. IOPS und Durchsatz werden durch die Datenträgergröße angegeben. Weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types.

EndpointRangeDescription

Portbereichsdetails

ErrorModel

Die Struktur des Fehlers.

ErrorModelError

Die Fehlerdetails.

EvictionPolicyType

Gibt die Entfernungsrichtlinie für virtuelle Computer in einem SPOT-Knotentyp an.

FrontendConfiguration

Beschreibt die Front-End-Konfigurationen für den Knotentyp.

IPAddressType

Der IP-Adresstyp.

IpConfiguration

Gibt eine IP-Konfiguration der Netzwerkschnittstelle an.

IpTag

Das IP-Tag, das der öffentlichen IP-Adresse zugeordnet ist.

ManagedResourceProvisioningState

Der Bereitstellungsstatus der verwalteten Ressource.

NetworkSecurityRule

Beschreibt eine Netzwerksicherheitsregel.

NodeType

Beschreibt einen Knotentyp im Cluster, wobei jeder Knotentyp eine Untermenge von Knoten im Cluster darstellt.

NodeTypeNatConfig

Stellt Informationen zur NAT-Konfiguration auf der öffentlichen Standard-Load Balancer für den Knotentyp bereit.

NodeTypeSku

Beschreibt eine Knotentypsku.

nsgProtocol

Netzwerkprotokoll, für das diese Regel gilt.

privateIPAddressVersion

Gibt an, ob die private IP-Adresse der IP-Konfiguration IPv4 oder IPv6 ist. Der Standardwert ist IPv4.

PublicIPAddressConfiguration

Die Konfiguration der öffentlichen IP-Adresse der Netzwerkschnittstelle.

publicIPAddressVersion

Gibt an, ob die öffentliche IP-Adresse der IP-Konfiguration IPv4 oder IPv6 ist. Der Standardwert ist IPv4.

securityType

Gibt den Sicherheitstyp des nodeType an. Derzeit werden nur Standard und TrustedLaunch unterstützt.

SubResource

Azure-Ressourcenbezeichner.

SystemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

VaultCertificate

Beschreibt einen einzelnen Zertifikatverweis in einem Key Vault und den Speicherort, an dem sich das Zertifikat auf dem virtuellen Computer befinden soll.

VaultSecretGroup

Gibt eine Gruppe von Zertifikaten an, die auf den virtuellen Computern installiert werden sollen.

VmImagePlan

Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Images verwendet. Bevor Sie ein Marketplace-Image über eine API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal nach dem Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Programmgesteuerte Bereitstellung, Erste Schritte ->. Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.

VmManagedIdentity

Identitäten für die VM-Skalierungsgruppe unter dem Knotentyp.

VmSetupAction

Aktion, die auf den virtuellen Computern vor dem Bootstrapping der Service Fabric-Runtime ausgeführt werden soll.

VmssDataDisk

Beschreibung des verwalteten Datenträgers.

VMSSExtension

Gibt eine Reihe von Erweiterungen an, die auf den virtuellen Computern installiert werden sollen.

VmssExtensionSetupOrder

Einrichtungsreihenfolge der VM-Erweiterung.

access

Der Netzwerkdatenverkehr wird zugelassen oder verweigert.

Name Typ Beschreibung
allow

string

deny

string

AdditionalNetworkInterfaceConfiguration

Gibt die Einstellungen für eine Netzwerkschnittstelle an, die an den Knotentyp angefügt werden soll.

Name Typ Beschreibung
dscpConfiguration

SubResource

Gibt die DSCP-Konfiguration an, die auf die Netzwerkschnittstelle angewendet werden soll.

enableAcceleratedNetworking

boolean

Gibt an, ob die Netzwerkschnittstelle netzwerkbeschleunigt ist.

ipConfigurations

IpConfiguration[]

Gibt die IP-Konfigurationen der Netzwerkschnittstelle an.

name

string

Name der Netzwerkschnittstelle.

direction

Richtung der Netzwerksicherheitsregel.

Name Typ Beschreibung
inbound

string

outbound

string

DiskType

Verwalteter Datenträgertyp. IOPS und Durchsatz werden durch die Datenträgergröße angegeben. Weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types.

Name Typ Beschreibung
Premium_LRS

string

Lokal redundanter SSD Premium-Speicher. Am besten für Produktions- und leistungsabhängige Workloads geeignet.

StandardSSD_LRS

string

Lokal redundanter SSD Standard-Speicher. Am besten für Webserver, wenig genutzte Unternehmensanwendungen und Enticklung/Testen geeignet.

Standard_LRS

string

Lokal redundanter HDD Standard-Speicher. Am besten für Sicherungen, nicht kritischen und seltenen Zugriff geeignet.

EndpointRangeDescription

Portbereichsdetails

Name Typ Beschreibung
endPort

integer

Endport eines Portbereichs

startPort

integer

Startport eines Portbereichs

ErrorModel

Die Struktur des Fehlers.

Name Typ Beschreibung
error

ErrorModelError

Die Fehlerdetails.

ErrorModelError

Die Fehlerdetails.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

EvictionPolicyType

Gibt die Entfernungsrichtlinie für virtuelle Computer in einem SPOT-Knotentyp an.

Name Typ Beschreibung
Deallocate

string

Die Entfernungsrichtlinie ist Deallocate für SPOT-vms.

Delete

string

Die Entfernungsrichtlinie wird für SPOT-vms gelöscht.

FrontendConfiguration

Beschreibt die Front-End-Konfigurationen für den Knotentyp.

Name Typ Standardwert Beschreibung
applicationGatewayBackendAddressPoolId

string

Die Ressourcen-ID des Back-End-Adresspools des Anwendungsgateways. Das Format der Ressourcen-ID lautet "/subscriptions//resourceGroups//providers/Microsoft.Network/applicationGateways//back-EndAddressPools/".

ipAddressType

IPAddressType

IPv4

Der IP-Adresstyp dieser Front-End-Konfiguration. Wenn nicht angegeben, lautet der Standardwert IPv4.

loadBalancerBackendAddressPoolId

string

Die Ressourcen-ID des Load Balancer Back-End-Adresspools, dem die VM-Instanzen des Knotentyps zugeordnet sind. Das Format der Ressourcen-ID lautet "/subscriptions//resourceGroups//providers/Microsoft.Network/loadBalancers//back-EndAddressPools/".

loadBalancerInboundNatPoolId

string

Die Ressourcen-ID des Load Balancer eingehenden NAT-Pools, dem die VM-Instanzen des Knotentyps zugeordnet sind. Das Format der Ressourcen-ID lautet "/subscriptions//resourceGroups//providers/Microsoft.Network/loadBalancers///inboundNatPools/".

IPAddressType

Der IP-Adresstyp.

Name Typ Beschreibung
IPv4

string

IPv4-Adresstyp.

IPv6

string

IPv6-Adresstyp.

IpConfiguration

Gibt eine IP-Konfiguration der Netzwerkschnittstelle an.

Name Typ Standardwert Beschreibung
applicationGatewayBackendAddressPools

SubResource[]

Gibt ein Array von Verweisen auf Back-End-Adresspools von Anwendungsgateways an. Ein Knotentyp kann auf Back-End-Adresspools mehrerer Anwendungsgateways verweisen. Mehrere Knotentypen können nicht dasselbe Anwendungsgateway verwenden.

loadBalancerBackendAddressPools

SubResource[]

Gibt ein Array von Verweisen auf Back-End-Adresspools von Lastenausgleichsmodulen an. Ein Knotentyp kann auf Back-End-Adresspools eines öffentlichen und eines internen Lastenausgleichs verweisen. Mehrere Knotentypen können nicht denselben einfachen SKU-Lastenausgleich verwenden.

loadBalancerInboundNatPools

SubResource[]

Gibt ein Array von Verweisen auf eingehende Nat-Pools der Lastenausgleichsmodule an. Ein Knotentyp kann auf eingehende NAT-Pools eines öffentlichen und eines internen Lastenausgleichs verweisen. Mehrere Knotentypen können nicht denselben einfachen SKU-Lastenausgleich verwenden.

name

string

Name der Netzwerkschnittstelle.

privateIPAddressVersion

privateIPAddressVersion

IPv4

Gibt an, ob die private IP-Adresse der IP-Konfiguration IPv4 oder IPv6 ist. Der Standardwert ist IPv4.

publicIPAddressConfiguration

PublicIPAddressConfiguration

Die Konfiguration der öffentlichen IP-Adresse der Netzwerkschnittstelle.

subnet

SubResource

Gibt das Subnetz der Netzwerkschnittstelle an.

IpTag

Das IP-Tag, das der öffentlichen IP-Adresse zugeordnet ist.

Name Typ Beschreibung
ipTagType

string

IP-Tagtyp. Beispiel: FirstPartyUsage.

tag

string

IP-Tag, das der öffentlichen IP-Adresse zugeordnet ist. Beispiel: SQL, Storage usw.

ManagedResourceProvisioningState

Der Bereitstellungsstatus der verwalteten Ressource.

Name Typ Beschreibung
Canceled

string

Created

string

Creating

string

Deleted

string

Deleting

string

Failed

string

None

string

Other

string

Succeeded

string

Updating

string

NetworkSecurityRule

Beschreibt eine Netzwerksicherheitsregel.

Name Typ Beschreibung
access

access

Der Netzwerkdatenverkehr wird zugelassen oder verweigert.

description

string

Beschreibung der Netzwerksicherheitsregel.

destinationAddressPrefix

string

Das Präfix der Zieladresse. CIDR oder Ziel-IP-Bereich. Das Sternchen '*' kann auch verwendet werden, um alle Quell-IPs abzugleichen. Standardtags wie "VirtualNetwork", "AzureLoadBalancer" und "Internet" können ebenfalls verwendet werden.

destinationAddressPrefixes

string[]

Die Zieladressenpräfixe. CIDR- oder Ziel-IP-Bereiche.

destinationPortRange

string

der Zielport oder -bereich. Ganze Zahl oder Bereich zwischen 0 und 65535. Das Sternchen "*" kann auch verwendet werden, um alle Ports abzugleichen.

destinationPortRanges

string[]

Die Zielportbereiche.

direction

direction

Richtung der Netzwerksicherheitsregel.

name

string

Name der Netzwerksicherheitsregel.

priority

integer

Die Priorität der Regel. Der Wert kann im Bereich 1000 bis 3000 liegen. Werte außerhalb dieses Bereichs sind für Service Fabric ManagerCluster-Ressourcenanbieter reserviert. Die Prioritätsnummer muss für jede Regel in der Auflistung eindeutig sein. Je niedrigere die Prioritätsnummer ist, desto höher ist die Priorität der Regel.

protocol

nsgProtocol

Netzwerkprotokoll, für das diese Regel gilt.

sourceAddressPrefix

string

Der CIDR- oder Quell-IP-Bereich. Das Sternchen '*' kann auch verwendet werden, um alle Quell-IPs abzugleichen. Standardtags wie "VirtualNetwork", "AzureLoadBalancer" und "Internet" können ebenfalls verwendet werden. Wenn es sich um eine Eingangsregel handelt, gibt an, woher der Netzwerkdatenverkehr stammt.

sourceAddressPrefixes

string[]

Der CIDR- oder Quell-IP-Bereich.

sourcePortRange

string

Der Quellport oder -bereich. Ganze Zahl oder Bereich zwischen 0 und 65535. Das Sternchen "*" kann auch verwendet werden, um alle Ports abzugleichen.

sourcePortRanges

string[]

Der Quellportbereich.

NodeType

Beschreibt einen Knotentyp im Cluster, wobei jeder Knotentyp eine Untermenge von Knoten im Cluster darstellt.

Name Typ Standardwert Beschreibung
id

string

Azure-Ressourcenbezeichner.

name

string

Azure-Ressourcenname.

properties.additionalDataDisks

VmssDataDisk[]

Zusätzliche verwaltete Datenträger.

properties.additionalNetworkInterfaceConfigurations

AdditionalNetworkInterfaceConfiguration[]

Gibt die Einstellungen für alle zusätzlichen sekundären Netzwerkschnittstellen an, die an den Knotentyp angefügt werden sollen.

properties.applicationPorts

EndpointRangeDescription

Der Bereich der Ports, von dem aus der Cluster Service Fabric-Anwendungen Port zugewiesen hat.

properties.capacities

object

Die Kapazitätstags, die auf die Knoten im Knotentyp angewendet werden, verwendet der Clusterressourcen-Manager diese Tags, um zu verstehen, wie viel Ressource ein Knoten hat.

properties.computerNamePrefix

string

Gibt das Präfix für den Computernamen an. Auf 9 Zeichen beschränkt. Wenn angegeben, kann für den Knotentypnamen ein längerer Name angegeben werden.

properties.dataDiskLetter

string

Verwalteter Datenträgerbuchstaben. Der reservierte Buchstabe C oder D kann nicht verwendet werden und kann sich nach der Erstellung nicht ändern.

properties.dataDiskSizeGB

integer

Datenträgergröße für den verwalteten Datenträger, der an die vms auf dem Knotentyp in GBs angefügt ist.

properties.dataDiskType

DiskType

StandardSSD_LRS

Verwalteter Datenträgertyp. Gibt den Speicherkontotyp für den verwalteten Datenträger an.

properties.dscpConfigurationId

string

Gibt die Ressourcen-ID der DSCP-Konfiguration an, die auf die Netzwerkschnittstelle vom Knotentyp angewendet werden soll.

properties.enableAcceleratedNetworking

boolean

Gibt an, ob die Netzwerkschnittstelle netzwerkbeschleunigt ist.

properties.enableEncryptionAtHost

boolean

False

Aktivieren oder deaktivieren Sie die Hostverschlüsselung für die virtuellen Computer auf dem Knotentyp. Dadurch wird die Verschlüsselung für alle Datenträger aktiviert, einschließlich ressourcen-/temporärer Datenträger auf dem Host selbst. Standard: Die Verschlüsselung auf dem Host wird deaktiviert, es sei denn, diese Eigenschaft ist für die Ressource auf true festgelegt.

properties.enableNodePublicIP

boolean

Gibt an, ob jedem Knoten eine eigene öffentliche IPv4-Adresse zugewiesen wird. Dies wird nur für sekundäre Knotentypen mit benutzerdefinierten Load Balancern unterstützt.

properties.enableNodePublicIPv6

boolean

Gibt an, ob jedem Knoten eine eigene öffentliche IPv6-Adresse zugewiesen wird. Dies wird nur für sekundäre Knotentypen mit benutzerdefinierten Load Balancern unterstützt.

properties.enableOverProvisioning

boolean

Gibt an, ob der Knotentyp überprovisioniert werden soll. Dies ist nur für zustandslose Knotentypen zulässig.

properties.ephemeralPorts

EndpointRangeDescription

Der Bereich der kurzlebigen Ports, mit denen Knoten in diesem Knotentyp konfiguriert werden sollten.

properties.evictionPolicy

EvictionPolicyType

Gibt die Entfernungsrichtlinie für virtuelle Computer in einem SPOT-Knotentyp an. Der Standardwert ist Löschen.

properties.frontendConfigurations

FrontendConfiguration[]

Gibt an, dass der Knotentyp seine eigenen Front-End-Konfigurationen anstelle der Standardkonfiguration für den Cluster verwendet. Diese Einstellung kann nur für nicht primäre Knotentypen angegeben werden und kann nicht hinzugefügt oder entfernt werden, nachdem der Knotentyp erstellt wurde.

properties.hostGroupId

string

Gibt die vollständige Hostgruppenressourcen-ID an. Diese Eigenschaft wird für die Bereitstellung auf dedizierten Azure-Hosts verwendet.

properties.isPrimary

boolean

Gibt an, dass die Service Fabric-Systemdienste für den Cluster auf diesem Knotentyp ausgeführt werden. Diese Einstellung kann nicht geändert werden, nachdem der Knotentyp erstellt wurde.

properties.isSpotVM

boolean

Gibt an, ob der Knotentyp Spot Virtual Machines ist. Azure weist die VMs zu, wenn Kapazität verfügbar ist und die VMs jederzeit entfernt werden können.

properties.isStateless

boolean

False

Gibt an, ob der Knotentyp nur zustandslose Workloads hosten kann.

properties.multiplePlacementGroups

boolean

False

Gibt an, ob der dem Knotentyp zugeordnete Skalierungsgruppe aus mehreren Platzierungsgruppen bestehen kann.

properties.natConfigurations

NodeTypeNatConfig[]

Gibt die NAT-Konfiguration auf dem öffentlichen Standard Load Balancer für den Knotentyp an. Dies wird nur für Knotentypen unterstützt, die die öffentliche Standard-Load Balancer verwenden.

properties.natGatewayId

string

Gibt die Ressourcen-ID eines NAT-Gateways an, das an das Subnetz dieses Knotentyps angefügt werden soll. Der Knotentyp muss einen benutzerdefinierten Lastenausgleich verwenden.

properties.networkSecurityRules

NetworkSecurityRule[]

Die Netzwerksicherheitsregeln für diesen Knotentyp. Diese Einstellung kann nur für Knotentypen angegeben werden, die mit Front-End-Konfigurationen konfiguriert sind.

properties.placementProperties

object

Die Platzierungstags, die auf Knoten im Knotentyp angewendet werden, können verwendet werden, um anzugeben, wo bestimmte Dienste (Workload) ausgeführt werden sollen.

properties.provisioningState

ManagedResourceProvisioningState

Der Bereitstellungsstatus der Knotentypressource.

properties.secureBootEnabled

boolean

Gibt an, ob der sichere Start für nodeType aktiviert werden soll. Kann nur mit TrustedLaunch SecurityType verwendet werden

properties.securityType

securityType

Gibt den Sicherheitstyp des nodeType an. Derzeit werden nur Standard und TrustedLaunch unterstützt.

properties.serviceArtifactReferenceId

string

Gibt die Referenz-ID des Dienstartefakts an, die verwendet wird, um dieselbe Imageversion für alle virtuellen Computer in der Skalierungsgruppe festzulegen, wenn die neueste Imageversion verwendet wird.

properties.spotRestoreTimeout

string

Gibt die Zeitdauer an, nach der die Plattform nicht versucht, die ALS ISO 8601 angegebenen VMSS SPOT-Instanzen wiederherzustellen.

properties.subnetId

string

Gibt die Ressourcen-ID des Subnetzes für den Knotentyp an.

properties.useDefaultPublicLoadBalancer

boolean

Gibt an, ob der öffentliche Lastenausgleich verwendet. Wenn er nicht angegeben ist und der Knotentyp keine eigene Front-End-Konfiguration hat, wird er an den Standardlastenausgleich angefügt. Wenn der Knotentyp einen eigenen Load Balancer verwendet und useDefaultPublicLoadBalancer true ist, muss das Front-End eine interne Load Balancer sein. Wenn der Knotentyp seinen eigenen Lastenausgleich verwendet und useDefaultPublicLoadBalancer false ist oder nicht festgelegt ist, muss der benutzerdefinierte Lastenausgleich einen öffentlichen Lastenausgleich enthalten, um ausgehende Konnektivität bereitzustellen.

properties.useEphemeralOSDisk

boolean

Gibt an, ob der kurzlebige Betriebssystemdatenträger verwendet werden soll. Die für die vmSize-Eigenschaft ausgewählte SKU muss dieses Feature unterstützen.

properties.useTempDataDisk

boolean

Gibt an, ob der temporäre Datenträger für den Service Fabric-Datenstamm verwendet werden soll. In diesem Fall wird kein verwalteter Datenträger angefügt, und der temporäre Datenträger wird verwendet. Dies ist nur für zustandslose Knotentypen zulässig.

properties.vmExtensions

VMSSExtension[]

Vm-Erweiterungen.
Eine Reihe von Erweiterungen, die auf den virtuellen Computern installiert werden sollen.

properties.vmImageOffer

string

Der Angebotstyp des Azure Virtual Machines Marketplace-Images. Beispiel: UbuntuServer oder WindowsServer.

properties.vmImagePlan

VmImagePlan

Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Images verwendet. Bevor Sie ein Marketplace-Image über eine API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal nach dem Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Programmgesteuerte Bereitstellung, Erste Schritte ->. Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.

properties.vmImagePublisher

string

Der Herausgeber des Azure Virtual Machines Marketplace-Images. Beispiel: Canonical oder MicrosoftWindowsServer.

properties.vmImageResourceId

string

Gibt die Ressourcen-ID des VM-Images an. Dieser Parameter wird für ein benutzerdefiniertes VM-Image verwendet.

properties.vmImageSku

string

Die SKU des Azure Virtual Machines Marketplace-Images. Beispiel: 14.04.0-LTS oder 2012-R2-Datacenter.

properties.vmImageVersion

string

Die Version des Azure Virtual Machines Marketplace-Images. Der Wert "neueste" kann angegeben werden, um die neueste Version eines Images auszuwählen. Wenn nicht angegeben, lautet der Standardwert "latest".

properties.vmInstanceCount

integer

Die Anzahl der Knoten im Knotentyp.

Werte:
-1 : Verwenden Sie, wenn Regeln für die automatische Skalierung konfiguriert oder sku.capacity definiert sind.
0 : Nicht unterstützt
>0 : Verwenden Sie für die manuelle Skalierung.

properties.vmManagedIdentity

VmManagedIdentity

Identitäten, die der VM-Skalierungsgruppe unter dem Knotentyp zugewiesen werden sollen.

properties.vmSecrets

VaultSecretGroup[]

Vm-Secretes.
Die Geheimnisse, die auf den virtuellen Computern installiert werden sollen.

properties.vmSetupActions

VmSetupAction[]

Gibt die Aktionen an, die auf den virtuellen Computern vor dem Bootstrapping der Service Fabric-Runtime ausgeführt werden sollen.

properties.vmSharedGalleryImageId

string

Gibt die Ressourcen-ID des Images der freigegebenen VM-Kataloge an. Dieser Parameter wird für ein benutzerdefiniertes VM-Image verwendet.

properties.vmSize

string

Die Größe der virtuellen Computer im Pool. Alle virtuellen Computer in einem Pool haben die gleiche Größe. Beispiel: Standard_D3.

properties.zones

string[]

Gibt die Verfügbarkeitszonen an, in denen sich der Knotentyp erstrecken würde. Wenn sich der Cluster nicht über Verfügbarkeitszonen erstreckt, initiiert az migration für den Cluster.

sku

NodeTypeSku

Der Knotentyp sku.

systemData

SystemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

tags

object

Azure-Ressourcentags.

type

string

Azure-Ressourcentyp.

NodeTypeNatConfig

Stellt Informationen zur NAT-Konfiguration auf der öffentlichen Standard-Load Balancer für den Knotentyp bereit.

Name Typ Beschreibung
backendPort

integer

Der interne Port für die NAT-Konfiguration.

frontendPortRangeEnd

integer

Der Portbereich endet für den externen Endpunkt.

frontendPortRangeStart

integer

Der Portbereich beginnt für den externen Endpunkt.

NodeTypeSku

Beschreibt eine Knotentypsku.

Name Typ Beschreibung
capacity

integer

Die Anzahl der Knoten im Knotentyp.

Wenn in der Anforderung vorhanden, wird properties.vmInstanceCount überschrieben.

name

string

Der sku-Name.

Name wird intern generiert und in Szenarien mit automatischer Skalierung verwendet.
Die Eigenschaft lässt es nicht zu, in andere Werte als generiert zu ändern.
Um Bereitstellungsfehler zu vermeiden, lassen Sie die Eigenschaft aus.

tier

string

Gibt die Ebene des Knotentyps an.

Mögliche Werte:
Standard

nsgProtocol

Netzwerkprotokoll, für das diese Regel gilt.

Name Typ Beschreibung
ah

string

esp

string

http

string

https

string

icmp

string

tcp

string

udp

string

privateIPAddressVersion

Gibt an, ob die private IP-Adresse der IP-Konfiguration IPv4 oder IPv6 ist. Der Standardwert ist IPv4.

Name Typ Beschreibung
IPv4

string

IPv6

string

PublicIPAddressConfiguration

Die Konfiguration der öffentlichen IP-Adresse der Netzwerkschnittstelle.

Name Typ Standardwert Beschreibung
ipTags

IpTag[]

Gibt die Liste der IP-Tags an, die der öffentlichen IP-Adresse zugeordnet sind.

name

string

Name der Netzwerkschnittstelle.

publicIPAddressVersion

publicIPAddressVersion

IPv4

Gibt an, ob die öffentliche IP-Adresse der IP-Konfiguration IPv4 oder IPv6 ist. Der Standardwert ist IPv4.

publicIPAddressVersion

Gibt an, ob die öffentliche IP-Adresse der IP-Konfiguration IPv4 oder IPv6 ist. Der Standardwert ist IPv4.

Name Typ Beschreibung
IPv4

string

IPv6

string

securityType

Gibt den Sicherheitstyp des nodeType an. Derzeit werden nur Standard und TrustedLaunch unterstützt.

Name Typ Beschreibung
Standard

string

Standard ist der Standardsicherheitstyp für alle Computer.

TrustedLaunch

string

Trusted Launch ist ein Sicherheitstyp, der virtuelle Computer der 2. Generation schützt.

SubResource

Azure-Ressourcenbezeichner.

Name Typ Beschreibung
id

string

Azure-Ressourcenbezeichner.

SystemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

string

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC).

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

string

Der Identitätstyp, der die Ressource zuletzt geändert hat.

VaultCertificate

Beschreibt einen einzelnen Zertifikatverweis in einem Key Vault und den Speicherort, an dem sich das Zertifikat auf dem virtuellen Computer befinden soll.

Name Typ Beschreibung
certificateStore

string

Gibt für Windows-VMs den Zertifikatspeicher auf dem virtuellen Computer an, dem das Zertifikat hinzugefügt werden soll. Der angegebene Zertifikatspeicher befindet sich implizit im LocalMachine-Konto.

Bei Linux-VMs wird die Zertifikatdatei unter dem Verzeichnis /var/lib/waagent mit dem Dateinamen CRT für die X509-Zertifikatdatei und PRV für privatem Schlüssel platziert. Beide Dateien sind PEM-formatiert.

certificateUrl

string

Dies ist die URL eines Zertifikats, das als Geheimnis in Key Vault hochgeladen wurde. Informationen zum Hinzufügen eines Geheimnisses zum Key Vault finden Sie unter Hinzufügen eines Schlüssels oder Geheimnisses zum Schlüsseltresor. In diesem Fall muss Ihr Zertifikat die Base64-Codierung des folgenden JSON-Objekts sein, das in UTF-8 codiert ist:

{
"data":"",
"dataType":"pfx",
"password":""
}

VaultSecretGroup

Gibt eine Gruppe von Zertifikaten an, die auf den virtuellen Computern installiert werden sollen.

Name Typ Beschreibung
sourceVault

SubResource

Die relative URL der Key Vault, die alle Zertifikate in VaultCertificates enthält.

vaultCertificates

VaultCertificate[]

Die Liste der Schlüsseltresorverweise in SourceVault, die Zertifikate enthalten.

VmImagePlan

Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Images verwendet. Bevor Sie ein Marketplace-Image über eine API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal nach dem Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Programmgesteuerte Bereitstellung, Erste Schritte ->. Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.

Name Typ Beschreibung
name

string

Die Plan-ID.

product

string

Gibt das Produkt des Images aus dem Marketplace an. Dies ist der gleiche Wert wie Offer unter dem imageReference-Element.

promotionCode

string

Der Promotionscode.

publisher

string

Die Herausgeber-ID.

VmManagedIdentity

Identitäten für die VM-Skalierungsgruppe unter dem Knotentyp.

Name Typ Beschreibung
userAssignedIdentities

string[]

Die Liste der Benutzeridentitäten, die der VM-Skalierungsgruppe unter dem Knotentyp zugeordnet sind. Bei jedem Eintrag handelt es sich um eine ARM-Ressourcen-ID im Format "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

VmSetupAction

Aktion, die auf den virtuellen Computern vor dem Bootstrapping der Service Fabric-Runtime ausgeführt werden soll.

Name Typ Beschreibung
EnableContainers

string

Aktivieren sie das Feature "Windows-Container".

EnableHyperV

string

Aktiviert das HyperV-Feature von Windows.

VmssDataDisk

Beschreibung des verwalteten Datenträgers.

Name Typ Standardwert Beschreibung
diskLetter

string

Verwalteter Datenträgerbuchstaben. Der reservierte Buchstabe C oder D kann nicht verwendet werden und kann sich nach der Erstellung nicht ändern.

diskSizeGB

integer

Datenträgergröße für jeden virtuellen Computer im Knotentyp in GBs.

diskType

DiskType

StandardSSD_LRS

Verwalteter Datenträgertyp. Gibt den Speicherkontotyp für den verwalteten Datenträger an.

lun

integer

Gibt die Nummer der logischen Einheit des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an einen virtuellen Computer angefügt ist, eindeutig sein. Lun 0 ist für den Service Fabric-Datenträger reserviert.

VMSSExtension

Gibt eine Reihe von Erweiterungen an, die auf den virtuellen Computern installiert werden sollen.

Name Typ Beschreibung
name

string

Der Name der Erweiterung.

properties.autoUpgradeMinorVersion

boolean

Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf „true“ festgelegt ist.

properties.enableAutomaticUpgrade

boolean

Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist.

properties.forceUpdateTag

string

Wenn ein Wert angegeben wird und sich vom vorherigen Wert unterscheidet, wird der Erweiterungshandler zum Aktualisieren gezwungen, auch wenn sich die Erweiterungskonfiguration nicht geändert hat.

properties.protectedSettings

object

Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder überhaupt keine geschützten Einstellungen enthalten.

properties.provisionAfterExtensions

string[]

Auflistung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss.

properties.provisioningState

string

Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.

properties.publisher

string

Der Name des Erweiterungshandlerherausgebers.

properties.settings

object

Json-formatierte öffentliche Einstellungen für die Erweiterung.

properties.setupOrder

VmssExtensionSetupOrder[]

Gibt die Setupreihenfolge für die Erweiterung an.

properties.type

string

Gibt den Typ der Erweiterung an. ein Beispiel ist "CustomScriptExtension".

properties.typeHandlerVersion

string

Gibt die Version des Skripthandlers an.

VmssExtensionSetupOrder

Einrichtungsreihenfolge der VM-Erweiterung.

Name Typ Beschreibung
BeforeSFRuntime

string

Gibt an, dass die VM-Erweiterung ausgeführt werden soll, bevor die Service Fabric-Runtime gestartet wird.