Hämta informationslista för distribuerad tjänstreplik

Artikel
07/19/2023

Hämtar listan över repliker som distribuerats på en Service Fabric-nod.

Hämtar listan med information om repliker som distribuerats på en Service Fabric-nod. Informationen omfattar partitions-ID, replik-ID, status för repliken, namnet på tjänsten, namnet på tjänsttypen och annan information. Använd Frågeparametrarna PartitionId eller ServiceManifestName för att returnera information om de distribuerade replikerna som matchar de angivna värdena för dessa parametrar.

Förfrågan

Metod	URI för förfrågan
GET	`/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetReplicas?api-version=6.0&PartitionId={PartitionId}&ServiceManifestName={ServiceManifestName}&timeout={timeout}`

Parametrar

Namn	Typ	Obligatorisk	Location
`nodeName`	sträng	Ja	Sökväg
`applicationId`	sträng	Ja	Sökväg
`api-version`	sträng	Ja	Söka i data
`PartitionId`	sträng (uuid)	No	Söka i data
`ServiceManifestName`	sträng	No	Söka i data
`timeout`	heltal (int64)	No	Söka i data

`nodeName`

Typ: sträng
Krävs: Ja

Namnet på noden.

`applicationId`

Typ: sträng
Krävs: Ja

Programmets identitet. Detta är vanligtvis det fullständiga namnet på programmet utan URI-schemat "fabric:". Från och med version 6.0 avgränsas hierarkiska namn med tecknet "~". Om programnamnet till exempel är "fabric:/myapp/app1" skulle programidentiteten vara "myapp~app1" i 6.0+ och "myapp/app1" 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.

`PartitionId`

Typ: sträng (uuid)
Krävs: Nej

Partitionens identitet.

`ServiceManifestName`

Typ: sträng
Krävs: Nej

Namnet på ett tjänstmanifest som registrerats som en del av en programtyp i ett Service Fabric-kluster.

`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 och listan över distribuerad tjänstreplikinformation.	matris med DeployedServiceReplicaInfo
204 (NoContent)	Ett tomt svar returneras om det angivna applicationId inte hittas på den angivna noden. Ett tomt svar returneras också om det inte finns några repliker som matchar de angivna filtervärdena för frågeparametrarna PartitionId eller ServiceManifestName.
Alla andra statuskoder	Det detaljerade felsvaret.	FabricError

Share via