Update-ServiceFabricPartitionLoad
Aktualizace zatížení zadaných oddílů Service Fabric.
Syntax
Update-ServiceFabricPartitionLoad
[-PartitionMetricLoadDescriptionList] <System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription]>
[-ContinuationToken <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Update-ServiceFabricPartitionLoad
[-PartitionMetricLoadDescriptionList] <System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription]>
[-GetSinglePage]
[-ContinuationToken <String>]
[-MaxResults <Int64>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
Rutina Update-ServiceFabricPartitionLoad aktualizuje zatížení oddílů Service Fabric, jak je uvedeno prostřednictvím PartitionMetricLoadDescriptionList
, a poté vrátí výsledky.
Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .
Příklady
Příklad 1: Použití Update-ServiceFabricParitionLoad k hlášení různých načtení oddílu
# This demonstrates various ways in which Update-ServiceFabricPartitionLoad can be used to report loads for a partition
# Part 1: reporting primary load for one or more metrics
# Part 2: reporting secondary load for one or more metrics
# Part 3: reporting loads for a given replica on a given node
# We need a guid object to identify the partition
$partitionIdString = '12345678-9012-4242-9876-432109876543'
$partitionId = [GUID]$partitionIdString
# Part 1: report primary load 42 for Metric0 and 43 for Metric1
$primaryLoad0 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 42)
$primaryLoad1 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 43)
$primaryLoads = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$primaryLoads.Add($primaryLoad0)
$primaryLoads.Add($primaryLoad1)
# Part 2: report secondary load 5 for Metric0 and 6 for Metric1
$secondaryLoads = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$secondaryLoad0 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 5)
$secondaryLoad1 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 6)
$secondaryLoads.Add($secondaryLoad0)
$secondaryLoads.Add($secondaryLoad1)
# Part 3a: for the replica on Node0 report a load of 42 for Metric0 and 24 for Metric1
$perNodeSecondaryLoads0 = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$perNodeSecondaryLoad00 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 42)
$perNodeSecondaryLoad01 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 24)
$perNodeSecondaryLoads0.Add($perNodeSecondaryLoad00)
$perNodeSecondaryLoads0.Add($perNodeSecondaryLoad01)
$perNodeLoadsNode0 = New-Object -TypeName System.Fabric.Description.ReplicaMetricLoadDescription("Node0", $perNodeSecondaryLoads0)
# Part 3b: for the replica on Node1 report a load of 5 for Metric0 and 6 for Metric1
$perNodeSecondaryLoads1 = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$perNodeSecondaryLoad10 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 5)
$perNodeSecondaryLoad11 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 6)
$perNodeSecondaryLoads1.Add($perNodeSecondaryLoad10)
$perNodeSecondaryLoads1.Add($perNodeSecondaryLoad11)
$perNodeLoadsNode1 = New-Object -TypeName System.Fabric.Description.ReplicaMetricLoadDescription("Node1", $perNodeSecondaryLoads1)
# Part 3c: put all node loads in an aggregate list
$perNodeLoads = New-Object 'System.Collections.Generic.List[System.Fabric.Description.ReplicaMetricLoadDescription]'
$perNodeLoads.Add($perNodeLoadsNode0)
$perNodeLoads.Add($perNodeLoadsNode1)
# Generate a description object which can contain all 3 load types (primary, secondary and per node)
# Empty dummy lists can be passed to the constructor if not all 3 types of reporting are used
$loadDescription = New-Object -TypeName System.Fabric.Description.PartitionMetricLoadDescription($partitionId, $primaryLoads, $secondaryLoads, $perNodeLoads)
# Create the final list of descriptions
# In this example we are reporting the load for a single partition
# But in general, more descriptions can be added to partitionMetricLoadDescriptionList
# This way, loads for multiple partitions can be reported through a single Update-ServiceFabricPartitionLoad call
$partitionMetricLoadDescriptionList = New-Object 'System.Collections.Generic.List[System.Fabric.Description.PartitionMetricLoadDescription]'
$partitionMetricLoadDescriptionList.Add($loadDescription)
# Finally, report the loads
Update-ServiceFabricPartitionLoad -PartitionMetricLoadDescriptionList $partitionMetricLoadDescriptionList
Podívejte se také na načtení sestav pro oddíl.
Parametry
-ContinuationToken
Určuje token pokračování, který lze použít k načtení další stránky výsledků dotazu.
Pokud je zadaných filtrů respektuje příliš mnoho výsledků, nemusí se vejít do jedné zprávy. Stránkování se používá k tomu rozdělením kolekce vrácených výsledků na samostatné stránky. Token pro pokračování slouží k tomu, aby věděl, kde předchozí stránka skončila, což má význam pouze pro samotný dotaz. Tato hodnota by se měla vygenerovat ze spuštění tohoto dotazu a lze ji předat do dalšího požadavku dotazu, aby bylo možné získat další stránky. Hodnota tokenu pokračování bez hodnoty null se vrátí jako součást výsledku pouze v případě, že je k dispozici další stránka. Pokud je tato hodnota zadaná bez -GetSinglePage
možnosti, dotaz vrátí všechny stránky začínající hodnotou tokenu pokračování.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GetSinglePage
Určuje, zda dotaz vrátí jednu stránku výsledků dotazu s hodnotou tokenu pokračování nebo všechny stránky sloučené do jednoho seznamu výsledků. Pokud je tato možnost vybraná, je zodpovědná za volajícího dotazu, aby zkontroloval další stránky.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxResults
Určuje maximální počet výsledků položek, které lze vrátit na stránku. Tím se definuje horní mez počtu vrácených výsledků, nikoli minimálně. Pokud například stránka odpovídá maximálně 1000 vrácených položek podle maximálního omezení velikosti zprávy definované v konfiguraci a hodnota MaxResults je nastavena na 2000, vrátí se pouze 1 000 výsledků, a to i v případě, že 2000 položek výsledků odpovídá popisu dotazu. Tato hodnota vyžaduje výběr příznaku GetSinglePage
, jinak bude ignorována.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionMetricLoadDescriptionList
Seznam objektů PartitionMetricLoadDescription , které určují aktualizace načítání pro konkrétní oddíly Service Fabric.
Type: | System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
System.Collections.Generic.List`1[[System.Fabric.Description.PartitionMetricLoadDescription, System.Fabric, Version=8.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
Výstupy
System.Object