Lösa tjänst

  • Artikel

Lös en Service Fabric-partition.

Lös en Service Fabric-tjänstpartition för att hämta slutpunkterna för tjänstreplikerna.

Förfrågan

Metod URI för förfrågan
GET /Services/{serviceId}/$/ResolvePartition?api-version=6.0&PartitionKeyType={PartitionKeyType}&PartitionKeyValue={PartitionKeyValue}&PreviousRspVersion={PreviousRspVersion}&timeout={timeout}

Parametrar

Namn Typ Obligatorisk Location
serviceId sträng Ja Sökväg
api-version sträng Ja Söka i data
PartitionKeyType heltal No Söka i data
PartitionKeyValue sträng No Söka i data
PreviousRspVersion sträng No Söka i data
timeout heltal (int64) No Söka i data

serviceId

Typ: sträng
Krävs: Ja

Tjänstens identitet. Det här ID:t är vanligtvis det fullständiga namnet på tjänsten utan URI-schemat fabric:. Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om tjänstnamnet till exempel är "fabric:/myapp/app1/svc1" skulle tjänstidentiteten vara "myapp~app1~svc1" i 6.0+ och "myapp/app1/svc1" i tidigare versioner.

api-version

Typ: sträng
Krävs: Ja
Standard: 6.0

Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.0".

Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Det här är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som dokumenteras i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds upp till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0, men om körningen är 6.1, accepterar körningen version 6.1 för det API:et för att göra det enklare att skriva klienterna. Beteendet för API:et är dock enligt den dokumenterade 6.0-versionen.

PartitionKeyType

Typ: heltal
Krävs: Nej

Nyckeltyp för partitionen. Den här parametern krävs om partitionsschemat för tjänsten är Int64Range eller Named. Möjliga värden följer.

  • Ingen (1) – Anger att parametern PartitionKeyValue inte har angetts. Detta är giltigt för partitioner med partitioneringsschema som Singleton. Detta är standardvärdet. Värdet är 1.
  • Int64Range (2) – anger att parametern PartitionKeyValue är en int64-partitionsnyckel. Detta är giltigt för partitioner med partitioneringsschema som Int64Range. Värdet är 2.
  • Med namnet (3) – Anger att parametern PartitionKeyValue är ett namn på partitionen. Detta är giltigt för partitioner med partitioneringsschema som Namngivet. Värdet är 3.

PartitionKeyValue

Typ: sträng
Krävs: Nej

Partitionsnyckel. Detta krävs om partitionsschemat för tjänsten är Int64Range eller Named. Det här är inte partitions-ID:t, utan antingen heltalsnyckelvärdet eller namnet på partitions-ID:t. Om din tjänst till exempel använder intervallpartitioner från 0 till 10 är PartitionKeyValue ett heltal i det intervallet. Fråga efter tjänstbeskrivning för att se intervallet eller namnet.

PreviousRspVersion

Typ: sträng
Krävs: Nej

Värdet i fältet Version för det svar som togs emot tidigare. Detta krävs om användaren vet att resultatet som hämtades tidigare är inaktuellt.

timeout

Typ: heltal (int64)
Krävs: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns tidsgräns för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.

Svar

HTTP-statuskod Description Svarsschema
200 (OK) En lyckad åtgärd returnerar 200 statuskod.
 ResolvedServicePartition
Alla andra statuskoder Det detaljerade felsvaret.
 FabricError