Services - Create Or Update

Een beheerde Service Fabric-serviceresource met de opgegeven naam maken of bijwerken.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabric/managedClusters/{clusterName}/applications/{applicationName}/services/{serviceName}?api-version=2026-02-01

URI-parameters

Name In Vereist Type Description
applicationName
path True

string

De naam van de toepassingsresource.

clusterName
path True

string

De naam van de clusterresource.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resource group. De naam is hoofdletterongevoelig.

serviceName
path True

string

De naam van de servicebron in het formaat {applicationName}~{serviceName}.

subscriptionId
path True

string

minLength: 1

De ID van het doelabonnement.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
location

string

De geografische locatie waar de resource zich bevindt

properties ServiceResourceProperties:

De eigenschappen van de serviceresource.

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

ServiceResource

De updateoperatie van de bron 'ServiceResource' is geslaagd

202 Accepted

ServiceResource

De aanvraag is geaccepteerd voor verwerking, maar de verwerking is nog niet voltooid.

Kopteksten

  • Azure-AsyncOperation: string
  • Location: string
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Put a service with maximum parameters
Put a service with minimum parameters

Put a service with maximum parameters

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/applications/myApp/services/myService?api-version=2026-02-01

{
  "location": "eastus",
  "properties": {
    "correlationScheme": [
      {
        "scheme": "AlignedAffinity",
        "serviceName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp/services/myService1"
      }
    ],
    "defaultMoveCost": "Medium",
    "instanceCount": 5,
    "minInstanceCount": 3,
    "minInstancePercentage": 30,
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "placementConstraints": "NodeType==frontend",
    "scalingPolicies": [
      {
        "scalingMechanism": {
          "kind": "ScalePartitionInstanceCount",
          "maxInstanceCount": 9,
          "minInstanceCount": 3,
          "scaleIncrement": 2
        },
        "scalingTrigger": {
          "kind": "AveragePartitionLoadTrigger",
          "lowerLoadThreshold": 2,
          "metricName": "metricName",
          "scaleInterval": "00:01:00",
          "upperLoadThreshold": 8
        }
      }
    ],
    "serviceDnsName": "myservicednsname.myApp",
    "serviceKind": "Stateless",
    "serviceLoadMetrics": [
      {
        "name": "metric1",
        "defaultLoad": 3,
        "weight": "Low"
      }
    ],
    "servicePackageActivationMode": "SharedProcess",
    "servicePlacementPolicies": [
      {
        "type": "NonPartiallyPlaceService"
      }
    ],
    "serviceTypeName": "myServiceType"
  },
  "tags": {
    "a": "b"
  }
}

Voorbeeldrespons

{
  "name": "myService",
  "type": "Microsoft.ServiceFabric/managedClusters/applications/services",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp/services/myService",
  "location": "eastus",
  "properties": {
    "correlationScheme": [
      {
        "scheme": "AlignedAffinity",
        "serviceName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp/services/myService1"
      }
    ],
    "defaultMoveCost": "Medium",
    "instanceCount": 5,
    "minInstanceCount": 3,
    "minInstancePercentage": 30,
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "placementConstraints": "NodeType==frontend",
    "provisioningState": "Creating",
    "scalingPolicies": [
      {
        "scalingMechanism": {
          "kind": "ScalePartitionInstanceCount",
          "maxInstanceCount": 9,
          "minInstanceCount": 3,
          "scaleIncrement": 2
        },
        "scalingTrigger": {
          "kind": "AveragePartitionLoadTrigger",
          "lowerLoadThreshold": 2,
          "metricName": "metricName",
          "scaleInterval": "00:01:00",
          "upperLoadThreshold": 8
        }
      }
    ],
    "serviceDnsName": "myservicednsname.myApp",
    "serviceKind": "Stateless",
    "serviceLoadMetrics": [
      {
        "name": "metric1",
        "defaultLoad": 3,
        "weight": "Low"
      }
    ],
    "servicePackageActivationMode": "SharedProcess",
    "servicePlacementPolicies": [
      {
        "type": "NonPartiallyPlaceService"
      }
    ],
    "serviceTypeName": "myServiceType"
  },
  "tags": {
    "a": "b"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2026-02-01
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/9c2ce367-47ea-43de-b69e-c5a423da4557?api-version=2026-02-01
{
  "name": "myService",
  "type": "Microsoft.ServiceFabric/managedClusters/applications/services",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp/services/myService",
  "location": "eastus",
  "properties": {
    "correlationScheme": [
      {
        "scheme": "AlignedAffinity",
        "serviceName": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp/services/myService1"
      }
    ],
    "defaultMoveCost": "Medium",
    "instanceCount": 5,
    "minInstanceCount": 3,
    "minInstancePercentage": 30,
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "placementConstraints": "NodeType==frontend",
    "provisioningState": "Updating",
    "scalingPolicies": [
      {
        "scalingMechanism": {
          "kind": "ScalePartitionInstanceCount",
          "maxInstanceCount": 9,
          "minInstanceCount": 3,
          "scaleIncrement": 2
        },
        "scalingTrigger": {
          "kind": "AveragePartitionLoadTrigger",
          "lowerLoadThreshold": 2,
          "metricName": "metricName",
          "scaleInterval": "00:01:00",
          "upperLoadThreshold": 8
        }
      }
    ],
    "serviceDnsName": "myservicednsname.myApp",
    "serviceKind": "Stateless",
    "serviceLoadMetrics": [
      {
        "name": "metric1",
        "defaultLoad": 3,
        "weight": "Low"
      }
    ],
    "servicePackageActivationMode": "SharedProcess",
    "servicePlacementPolicies": [
      {
        "type": "NonPartiallyPlaceService"
      }
    ],
    "serviceTypeName": "myServiceType"
  },
  "tags": {
    "a": "b"
  }
}

Put a service with minimum parameters

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resRg/providers/Microsoft.ServiceFabric/managedClusters/myCluster/applications/myApp/services/myService?api-version=2026-02-01

{
  "location": "eastus",
  "properties": {
    "instanceCount": 1,
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "serviceKind": "Stateless",
    "serviceTypeName": "myServiceType"
  }
}

Voorbeeldrespons

{
  "name": "myService",
  "type": "Microsoft.ServiceFabric/managedClusters/applications/services",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp/services/myService",
  "location": "eastus",
  "properties": {
    "instanceCount": 1,
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "provisioningState": "Creating",
    "serviceKind": "Stateless",
    "serviceTypeName": "myServiceType"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/managedClusterOperationStatus/1ca6e48d-70ca-4e43-b652-3b0522f64d67?api-version=2026-02-01
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ServiceFabric/locations/eastus/operationResults/9c2ce367-47ea-43de-b69e-c5a423da4557?api-version=2026-02-01
{
  "name": "myService",
  "type": "Microsoft.ServiceFabric/managedClusters/applications/services",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resRg/providers/Microsoft.ServiceFabric/managedclusters/myCluster/applications/myApp/services/myService",
  "location": "eastus",
  "properties": {
    "instanceCount": 1,
    "partitionDescription": {
      "partitionScheme": "Singleton"
    },
    "provisioningState": "Updating",
    "serviceKind": "Stateless",
    "serviceTypeName": "myServiceType"
  }
}

Definities

Name Description
AddRemoveIncrementalNamedPartitionScalingMechanism

Vertegenwoordigt een schaalmechanisme voor het toevoegen of verwijderen van benoemde partities van een staatloze service. Partitienamen hebben de indeling '0', '1'...'N-1'.

AveragePartitionLoadScalingTrigger

Vertegenwoordigt een schaaltrigger die is gerelateerd aan een gemiddelde belasting van een metrische waarde/resource van een partitie.

AverageServiceLoadScalingTrigger

Vertegenwoordigt een schaalbeleid met betrekking tot een gemiddelde belasting van een metrische gegevens/resource van een service.

createdByType

Het identiteitstype dat de resource heeft gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

Het foutdetail.

ErrorResponse

Foutreactie

MoveCost

Hiermee geeft u de verplaatsingskosten voor de service op.

NamedPartitionScheme

Beschrijft het benoemde partitieschema van de service.

PartitionInstanceCountScaleMechanism

Vertegenwoordigt een schaalmechanisme voor het toevoegen of verwijderen van exemplaren van stateless servicepartitie.

PartitionScheme

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

ScalingPolicy

Hiermee geeft u een metrische waarde op om een service tijdens runtime te verdelen.

ServiceCorrelation

Hiermee maakt u een bepaalde correlatie tussen services.

ServiceCorrelationScheme

Het servicecorrelatieschema.

ServiceKind

Het soort service (staatloos of stateful).

ServiceLoadMetric

Hiermee geeft u een metrische waarde op om een service tijdens runtime te verdelen.

ServiceLoadMetricWeight

Bepaalt het gewicht van de metrische gegevens ten opzichte van de andere metrische gegevens die zijn geconfigureerd voor deze service. Tijdens runtime, als twee metrics in conflict komen, geeft de Cluster Resource Manager de voorkeur aan de metric met het hogere gewicht.

ServicePackageActivationMode

De activeringsmodus van het servicepakket

ServicePlacementInvalidDomainPolicy

Beschrijft het beleid dat moet worden gebruikt voor de plaatsing van een Service Fabric-service waarbij een bepaald fout- of upgradedomein niet moet worden gebruikt voor de plaatsing van de exemplaren of replica's van die service.

ServicePlacementNonPartiallyPlaceServicePolicy

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

ServicePlacementPolicyType

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

ServicePlacementPreferPrimaryDomainPolicy

Beschrijft het beleid dat moet worden gebruikt voor het plaatsen van een Service Fabric-service waarbij de primaire replica's van de service optimaal in een bepaald domein moeten worden geplaatst.

Dit plaatsingsbeleid wordt meestal gebruikt met foutdomeinen in scenario's waarin het Service Fabric-cluster geografisch wordt gedistribueerd om aan te geven dat de primaire replica van een service zich moet bevinden in een bepaald foutdomein, dat in geografisch gedistribueerde scenario's meestal overeenkomt met regionale of datacentergrenzen. Aangezien dit een optimalisatie is, is het mogelijk dat de primaire replica zich niet in dit domein bevindt vanwege storingen, capaciteitslimieten of andere beperkingen.

ServicePlacementRequiredDomainPolicy

Beschrijft het beleid dat moet worden gebruikt voor het plaatsen van een Service Fabric-service waarbij de exemplaren of replica's van die service in een bepaald domein moeten worden geplaatst.

ServicePlacementRequireDomainDistributionPolicy

Beschrijft het beleid dat moet worden gebruikt voor het plaatsen van een Service Fabric-service waarbij twee replica's van dezelfde partitie nooit in hetzelfde fout- of upgradedomein mogen worden geplaatst.

Hoewel dit niet gebruikelijk is, kan de service worden blootgesteld aan een verhoogd risico op gelijktijdige fouten vanwege niet-geplande storingen of andere gevallen van volgende/gelijktijdige fouten. Denk bijvoorbeeld aan een geval waarin replica's in verschillende datacenters worden geïmplementeerd, met één replica per locatie. Als een van de datacenters offline gaat, wordt normaal gesproken de replica die in dat datacenter is geplaatst, ingepakt in een van de resterende datacenters. Als dit niet wenselijk is, moet dit beleid worden ingesteld.

ServiceResource

De serviceresource.

ServiceScalingMechanismKind

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

ServiceScalingTriggerKind

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

SingletonPartitionScheme

Beschrijft het partitieschema van een singleton-gepartitioneerde of niet-gepartitioneerde service.

StatefulServiceProperties

De eigenschappen van een stateful serviceresource.

StatelessServiceProperties

De eigenschappen van een staatloze serviceresource.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

UniformInt64RangePartitionScheme

Beschrijft een partitioneringsschema waarbij een geheel getalbereik gelijkmatig wordt toegewezen aan een aantal partities.

AddRemoveIncrementalNamedPartitionScalingMechanism

Vertegenwoordigt een schaalmechanisme voor het toevoegen of verwijderen van benoemde partities van een staatloze service. Partitienamen hebben de indeling '0', '1'...'N-1'.

Name Type Description
kind string:

AddRemoveIncrementalNamedPartition

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

maxPartitionCount

integer (int32)

Maximum aantal benoemde partities van de service.

minPartitionCount

integer (int32)

Minimaal aantal benoemde partities van de service.

scaleIncrement

integer (int32)

Het aantal exemplaren dat moet worden toegevoegd of verwijderd tijdens een schaalbewerking.

AveragePartitionLoadScalingTrigger

Vertegenwoordigt een schaaltrigger die is gerelateerd aan een gemiddelde belasting van een metrische waarde/resource van een partitie.

Name Type Description
kind string:

AveragePartitionLoadTrigger

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

lowerLoadThreshold

number (double)

De ondergrens van de belasting waaronder een schaalbewerking moet worden uitgevoerd.

metricName

string

De naam van de metrische waarde waarvoor het gebruik moet worden bijgehouden.

scaleInterval

string

De periode in seconden waarop een beslissing wordt genomen om te schalen of niet. Deze eigenschap moet een ISO 8601-indeling hebben: "uu:mm:ss".

upperLoadThreshold

number (double)

De bovengrens van de belasting waarboven een scale out-operatie moet worden uitgevoerd.

AverageServiceLoadScalingTrigger

Vertegenwoordigt een schaalbeleid met betrekking tot een gemiddelde belasting van een metrische gegevens/resource van een service.

Name Type Description
kind string:

AverageServiceLoadTrigger

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

lowerLoadThreshold

number (double)

De ondergrens van de belasting waaronder een schaalbewerking moet worden uitgevoerd.

metricName

string

De naam van de metrische waarde waarvoor het gebruik moet worden bijgehouden.

scaleInterval

string

De periode in seconden waarop een beslissing wordt genomen om te schalen of niet. Deze eigenschap moet een ISO 8601-indeling hebben: "uu:mm:ss".

upperLoadThreshold

number (double)

De bovengrens van de belasting waarboven een scale out-operatie moet worden uitgevoerd.

useOnlyPrimaryLoad

boolean

Vlag bepaalt of alleen de belasting van de primaire replica moet worden overwogen voor schalen. Als deze optie is ingesteld op waar, wordt door trigger alleen rekening gehouden met de belasting van primaire replica's van stateful service. Als deze optie is ingesteld op onwaar, wordt door de trigger rekening gehouden met het laden van alle replica's. Deze parameter kan niet worden ingesteld op true voor stateless service.

createdByType

Het identiteitstype dat de resource heeft gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

Het foutdetail.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.

code

string

De foutcode.

details

ErrorDetail[]

De foutgegevens.

message

string

Het foutbericht.

target

string

Het foutdoelwit.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

MoveCost

Hiermee geeft u de verplaatsingskosten voor de service op.

Waarde Description
Zero

Geen verhuiskosten. Deze waarde is nul.

Low

Specificeert de verhuiskosten van de dienst als Laag. De waarde is 1.

Medium

Specificeert de verhuiskosten van de dienst als Medium. De waarde is 2.

High

Specificeert de verhuiskosten van de dienst als Hoog. De waarde is 3.

NamedPartitionScheme

Beschrijft het benoemde partitieschema van de service.

Name Type Description
names

string[]

Matrix voor de namen van de partities.

partitionScheme string:

Named

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

PartitionInstanceCountScaleMechanism

Vertegenwoordigt een schaalmechanisme voor het toevoegen of verwijderen van exemplaren van stateless servicepartitie.

Name Type Description
kind string:

ScalePartitionInstanceCount

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

maxInstanceCount

integer (int32)

Maximum aantal exemplaren van de partitie.

minInstanceCount

integer (int32)

Minimaal aantal exemplaren van de partitie.

scaleIncrement

integer (int32)

Het aantal exemplaren dat moet worden toegevoegd of verwijderd tijdens een schaalbewerking.

PartitionScheme

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

Waarde Description
Singleton

Geeft aan dat de partitie gebaseerd is op stringnamen, en is een SingletonPartitionScheme-object, De waarde is 0.

UniformInt64Range

Geeft aan dat de partitie gebaseerd is op Int64-sleutelbereiken en een UniformInt64RangePartitionScheme-object is. De waarde is 1.

Named

Geeft aan dat de partitie gebaseerd is op stringnamen en een NamedPartitionScheme-object is. De waarde is 2.

ScalingPolicy

Hiermee geeft u een metrische waarde op om een service tijdens runtime te verdelen.

Name Type Description
scalingMechanism ScalingMechanism:

Hiermee geeft u het mechanisme op dat is gekoppeld aan dit schaalbeleid

scalingTrigger ScalingTrigger:

Hiermee geeft u de trigger op die is gekoppeld aan dit schaalbeleid.

ServiceCorrelation

Hiermee maakt u een bepaalde correlatie tussen services.

Name Type Description
scheme

ServiceCorrelationScheme

De ServiceCorrelationScheme die de relatie tussen deze service en de service beschrijft die is opgegeven via ServiceName.

serviceName

string

De Arm-resource-id van de service waarmee de correlatierelatie tot stand is gebracht.

ServiceCorrelationScheme

Het servicecorrelatieschema.

Waarde Description
AlignedAffinity

Alignated affinity zorgt ervoor dat de primaire delen van de partities van de affinitized services op dezelfde knooppunten worden geconjecteerd. Dit is de standaardinstelling en is hetzelfde als het selecteren van het affiniteitsschema. De waarde is 0.

NonAlignedAffinity

Non-Alignity garandeert dat alle replica's van elke dienst op dezelfde knooppunten worden geplaatst. In tegenstelling tot uitgelijnde affiniteit garandeert dit niet dat replica's van een bepaalde rol worden geplaatst. De waarde is 1.

ServiceKind

Het soort service (staatloos of stateful).

Waarde Description
Stateless

Gebruikt Service Fabric niet om zijn staat zeer beschikbaar of betrouwbaar te maken. De waarde is 0.

Stateful

Gebruikt Service Fabric om zijn staat of een deel daarvan zeer beschikbaar en betrouwbaar te maken. De waarde is 1.

ServiceLoadMetric

Hiermee geeft u een metrische waarde op om een service tijdens runtime te verdelen.

Name Type Description
defaultLoad

integer (int32)

Alleen gebruikt voor stateless services. De standaardbelasting, als een getal, die door deze service wordt gemaakt voor deze metrische waarde.

name

string

De naam van de metrische waarde. Als de service ervoor kiest om tijdens runtime belasting te rapporteren, moet de naam van de metrische belasting overeenkomen met de naam die is opgegeven in Naam. Houd er rekening mee dat namen van metrische gegevens hoofdlettergevoelig zijn.

primaryDefaultLoad

integer (int32)

Alleen gebruikt voor Stateful-services. De standaardbelasting, als een getal, die door deze service wordt gemaakt voor deze metrische waarde wanneer het een primaire replica is.

secondaryDefaultLoad

integer (int32)

Alleen gebruikt voor Stateful-services. De standaardbelasting, als een getal, die door deze service wordt gemaakt voor deze metrische waarde wanneer het een secundaire replica is.

weight

ServiceLoadMetricWeight

Het relatieve gewicht van de servicebelasting, vergeleken met andere metrische gegevens die voor deze service zijn geconfigureerd, als een getal.

ServiceLoadMetricWeight

Bepaalt het gewicht van de metrische gegevens ten opzichte van de andere metrische gegevens die zijn geconfigureerd voor deze service. Tijdens runtime, als twee metrics in conflict komen, geeft de Cluster Resource Manager de voorkeur aan de metric met het hogere gewicht.

Waarde Description
Zero

Schakelt resource balancing uit voor deze maatstaf. Deze waarde is nul.

Low

Specificeert het metrische gewicht van de servicebelasting als Laag. De waarde is 1.

Medium

Specificeert het metrische gewicht van de dienstbelasting als Medium. De waarde is 2.

High

Specificeert het metrische gewicht van de servicebelasting als Hoog. De waarde is 3.

ServicePackageActivationMode

De activeringsmodus van het servicepakket

Waarde Description
SharedProcess

Geeft aan dat de activatiemodus van het applicatiepakket gedeeld proces zal gebruiken.

ExclusiveProcess

Geeft aan dat de activatiemodus van het applicatiepakket exclusief proces zal gebruiken.

ServicePlacementInvalidDomainPolicy

Beschrijft het beleid dat moet worden gebruikt voor de plaatsing van een Service Fabric-service waarbij een bepaald fout- of upgradedomein niet moet worden gebruikt voor de plaatsing van de exemplaren of replica's van die service.

Name Type Description
domainName

string

De naam van het domein dat niet moet worden gebruikt voor plaatsing.

type string:

InvalidDomain

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

ServicePlacementNonPartiallyPlaceServicePolicy

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

Name Type Description
type string:

NonPartiallyPlaceService

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

ServicePlacementPolicyType

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

Waarde Description
InvalidDomain

Geeft aan dat de ServicePlacementPolicyDescription van het type ServicePlacementInvalidDomainPolicyDescription is, wat aangeeft dat een bepaald fout- of upgradedomein niet kan worden gebruikt voor de plaatsing van deze service. De waarde is 0.

RequiredDomain

Geeft aan dat de ServicePlacementPolicyDescription van het type ServicePlacementRequireDomainDistributionPolicyDescription is, wat aangeeft dat de replica's van de service in een specifiek domein moeten worden geplaatst. De waarde is 1.

PreferredPrimaryDomain

Geeft aan dat de ServicePlacementPolicyDescription van het type ServicePlacementPreferPrimaryDomainPolicyDescriptionDescription, wat aangeeft dat indien mogelijk de primaire replica voor de partities van de service in een bepaald domein moet worden geplaatst als een optimalisatie. De waarde is 2.

RequiredDomainDistribution

Geeft aan dat de ServicePlacementPolicyDescription van het type ServicePlacementRequireDomainDistributionPolicyDescriptionDescription is, wat aangeeft dat het systeem het plaatsen van twee replica's van dezelfde partitie in hetzelfde domein op elk moment zal verbieden. De waarde is 3.

NonPartiallyPlaceService

Geeft aan dat de ServicePlacementPolicyDescription van het type ServicePlacementNonPartiallyPlaceServicePolicyDescription is, wat aangeeft dat indien mogelijk alle replica's van een bepaalde partitie van de service atomair geplaatst moeten worden. De waarde is 4.

ServicePlacementPreferPrimaryDomainPolicy

Beschrijft het beleid dat moet worden gebruikt voor het plaatsen van een Service Fabric-service waarbij de primaire replica's van de service optimaal in een bepaald domein moeten worden geplaatst.

Dit plaatsingsbeleid wordt meestal gebruikt met foutdomeinen in scenario's waarin het Service Fabric-cluster geografisch wordt gedistribueerd om aan te geven dat de primaire replica van een service zich moet bevinden in een bepaald foutdomein, dat in geografisch gedistribueerde scenario's meestal overeenkomt met regionale of datacentergrenzen. Aangezien dit een optimalisatie is, is het mogelijk dat de primaire replica zich niet in dit domein bevindt vanwege storingen, capaciteitslimieten of andere beperkingen.

Name Type Description
domainName

string

De naam van het domein dat moet worden gebruikt voor plaatsing volgens dit beleid.

type string:

PreferredPrimaryDomain

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

ServicePlacementRequiredDomainPolicy

Beschrijft het beleid dat moet worden gebruikt voor het plaatsen van een Service Fabric-service waarbij de exemplaren of replica's van die service in een bepaald domein moeten worden geplaatst.

Name Type Description
domainName

string

De naam van het domein dat moet worden gebruikt voor plaatsing volgens dit beleid.

type string:

RequiredDomain

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

ServicePlacementRequireDomainDistributionPolicy

Beschrijft het beleid dat moet worden gebruikt voor het plaatsen van een Service Fabric-service waarbij twee replica's van dezelfde partitie nooit in hetzelfde fout- of upgradedomein mogen worden geplaatst.

Hoewel dit niet gebruikelijk is, kan de service worden blootgesteld aan een verhoogd risico op gelijktijdige fouten vanwege niet-geplande storingen of andere gevallen van volgende/gelijktijdige fouten. Denk bijvoorbeeld aan een geval waarin replica's in verschillende datacenters worden geïmplementeerd, met één replica per locatie. Als een van de datacenters offline gaat, wordt normaal gesproken de replica die in dat datacenter is geplaatst, ingepakt in een van de resterende datacenters. Als dit niet wenselijk is, moet dit beleid worden ingesteld.

Name Type Description
domainName

string

De naam van het domein dat moet worden gebruikt voor plaatsing volgens dit beleid.

type string:

RequiredDomainDistribution

Het type plaatsingsbeleid voor een Service Fabric-service. Hier volgen de mogelijke waarden.

ServiceResource

De serviceresource.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijv. - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties ServiceResourceProperties:

De eigenschappen van de serviceresource.

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

tags

object

Resourcetags.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ServiceScalingMechanismKind

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

Waarde Description
ScalePartitionInstanceCount

Vertegenwoordigt een schaalmechanisme voor het toevoegen of verwijderen van exemplaren van stateless servicepartitie. De waarde is 0.

AddRemoveIncrementalNamedPartition

Vertegenwoordigt een schaalmechanisme voor het toevoegen of verwijderen van benoemde partities van een staatloze service. De waarde is 1.

ServiceScalingTriggerKind

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

Waarde Description
AveragePartitionLoadTrigger

Vertegenwoordigt een schaaltrigger die is gerelateerd aan een gemiddelde belasting van een metrische waarde/resource van een partitie. De waarde is 0.

AverageServiceLoadTrigger

Vertegenwoordigt een schaalbeleid met betrekking tot een gemiddelde belasting van een metrische gegevens/resource van een service. De waarde is 1.

SingletonPartitionScheme

Beschrijft het partitieschema van een singleton-gepartitioneerde of niet-gepartitioneerde service.

Name Type Description
partitionScheme string:

Singleton

Inventariseert de manieren waarop een service kan worden gepartitioneerd.

StatefulServiceProperties

De eigenschappen van een stateful serviceresource.

Name Type Description
correlationScheme

ServiceCorrelation[]

Een lijst met een beschrijving van de correlatie van de service met andere services.

defaultMoveCost

MoveCost

Hiermee geeft u de verplaatsingskosten voor de service op.

hasPersistedState

boolean

Een vlag die aangeeft of dit een permanente service is die statussen op de lokale schijf opslaat. Als dit het geval is, is de waarde van deze eigenschap waar, als deze niet onwaar is.

minReplicaSetSize

integer (int32)

minimum: 1

De minimale grootte van de replicaset als een getal.

partitionDescription Partition:

Beschrijft hoe de service wordt gepartitioneerd.

placementConstraints

string

De plaatsingsbeperkingen als een tekenreeks. Plaatsingsbeperkingen zijn Booleaanse expressies op knooppunteigenschappen en maken het mogelijk om een service te beperken tot bepaalde knooppunten op basis van de servicevereisten. Als u bijvoorbeeld een service wilt plaatsen op knooppunten waarin NodeType blauw is, geeft u het volgende op: "NodeColor == blue)".

provisioningState

string

De huidige implementatie- of inrichtingsstatus, die alleen in het antwoord wordt weergegeven

quorumLossWaitDuration

string (duration-constant)

De maximale duur waarvoor een partitie een status van quorumverlies mag hebben, vertegenwoordigd in ISO 8601-indeling "uu:mm:ss".

replicaRestartWaitDuration

string (duration-constant)

De duur tussen het moment waarop een replica uitvalt en wanneer er een nieuwe replica wordt gemaakt, weergegeven in ISO 8601-indeling "uu:mm:ss".

scalingPolicies

ScalingPolicy[]

Schaalbeleid voor deze service.

serviceDnsName

string

Dns-naam die wordt gebruikt voor de service. Als dit is opgegeven, kan de DNS-naam worden gebruikt om de IP-adressen van service-eindpunten voor protocollen op de toepassingslaag (bijvoorbeeld HTTP) te retourneren. Bij het bijwerken van serviceDnsName kan de oude naam tijdelijk worden omgezet. Vertrouw echter op nieuwe naam. Wanneer u serviceDnsName verwijdert, kan de verwijderde naam tijdelijk worden omgezet. Vertrouw niet op de naam die onoplosbaar is.

serviceKind string:

Stateful

Het soort service (staatloos of stateful).

serviceLoadMetrics

ServiceLoadMetric[]

De metrische gegevens voor servicebelasting worden gegeven als een matrix van ServiceLoadMetric-objecten.

servicePackageActivationMode

ServicePackageActivationMode

De activeringsmodus van het servicepakket

servicePlacementPolicies ServicePlacementPolicy[]:

Een lijst met een beschrijving van de correlatie van de service met andere services.

servicePlacementTimeLimit

string (duration-constant)

De duur waarvoor replica's InBuild kunnen blijven voordat wordt gerapporteerd dat de build is vastgelopen, vertegenwoordigd in ISO 8601-indeling "uu:mm:ss".

serviceTypeName

string

De naam van het servicetype

standByReplicaKeepDuration

string (duration-constant)

De definitie over hoe lang StandBy-replica's moeten worden onderhouden voordat ze worden verwijderd, weergegeven in ISO 8601-indeling "uu:mm:ss".

targetReplicaSetSize

integer (int32)

minimum: 1

De grootte van de doelreplicaset als een getal.

StatelessServiceProperties

De eigenschappen van een staatloze serviceresource.

Name Type Description
correlationScheme

ServiceCorrelation[]

Een lijst met een beschrijving van de correlatie van de service met andere services.

defaultMoveCost

MoveCost

Hiermee geeft u de verplaatsingskosten voor de service op.

instanceCount

integer (int32)

minimum: -1

Het aantal exemplaren.

minInstanceCount

integer (int32)

MinInstanceCount is het minimale aantal exemplaren dat moet voldoen aan de veiligheidscontrole EnsureAvailability tijdens bewerkingen zoals upgraden of deactiveren van het knooppunt. Het werkelijke aantal dat wordt gebruikt, is max( MinInstanceCount, ceil( MinInstancePercentage/100,0 * InstanceCount) ). Als InstanceCount is ingesteld op -1, wordt tijdens de berekening MinInstanceCount -1 eerst geconverteerd naar het aantal knooppunten waarop de exemplaren mogen worden geplaatst volgens de plaatsingsbeperkingen voor de service.

minInstancePercentage

integer (int32)

MinInstancePercentage is het minimumpercentage van InstanceCount dat moet voldoen aan de veiligheidscontrole EnsureAvailability tijdens bewerkingen zoals het upgraden of deactiveren van het knooppunt. Het werkelijke aantal dat wordt gebruikt, is max( MinInstanceCount, ceil( MinInstancePercentage/100,0 * InstanceCount) ). Als InstanceCount is ingesteld op -1 tijdens de berekening MinInstancePercentage, wordt -1 eerst geconverteerd naar het aantal knooppunten waarop de exemplaren mogen worden geplaatst op basis van de plaatsingsbeperkingen voor de service.

partitionDescription Partition:

Beschrijft hoe de service wordt gepartitioneerd.

placementConstraints

string

De plaatsingsbeperkingen als een tekenreeks. Plaatsingsbeperkingen zijn Booleaanse expressies op knooppunteigenschappen en maken het mogelijk om een service te beperken tot bepaalde knooppunten op basis van de servicevereisten. Als u bijvoorbeeld een service wilt plaatsen op knooppunten waarin NodeType blauw is, geeft u het volgende op: "NodeColor == blue)".

provisioningState

string

De huidige implementatie- of inrichtingsstatus, die alleen in het antwoord wordt weergegeven

scalingPolicies

ScalingPolicy[]

Schaalbeleid voor deze service.

serviceDnsName

string

Dns-naam die wordt gebruikt voor de service. Als dit is opgegeven, kan de DNS-naam worden gebruikt om de IP-adressen van service-eindpunten voor protocollen op de toepassingslaag (bijvoorbeeld HTTP) te retourneren. Bij het bijwerken van serviceDnsName kan de oude naam tijdelijk worden omgezet. Vertrouw echter op nieuwe naam. Wanneer u serviceDnsName verwijdert, kan de verwijderde naam tijdelijk worden omgezet. Vertrouw niet op de naam die onoplosbaar is.

serviceKind string:

Stateless

Het soort service (staatloos of stateful).

serviceLoadMetrics

ServiceLoadMetric[]

De metrische gegevens voor servicebelasting worden gegeven als een matrix van ServiceLoadMetric-objecten.

servicePackageActivationMode

ServicePackageActivationMode

De activeringsmodus van het servicepakket

servicePlacementPolicies ServicePlacementPolicy[]:

Een lijst met een beschrijving van de correlatie van de service met andere services.

serviceTypeName

string

De naam van het servicetype

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het aanmaken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het identiteitstype dat de resource heeft gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UniformInt64RangePartitionScheme

Beschrijft een partitioneringsschema waarbij een geheel getalbereik gelijkmatig wordt toegewezen aan een aantal partities.

Name Type Description
count

integer (int32)

Het aantal partities.

highKey

integer (int64)

De bovengrens van het partitiesleutelbereik dat verdeeld moet worden tussen de partitie 'Count'

lowKey

integer (int64)

De ondergrens van het partitiesleutelbereik dat verdeeld moet worden tussen de partitie 'Count'

partitionScheme string:

UniformInt64Range

Inventariseert de manieren waarop een service kan worden gepartitioneerd.