Hämta tjänstinformationslista
Hämtar information om alla tjänster som tillhör programmet som anges av program-ID:t.
Returnerar information om alla tjänster som hör till programmet som anges av program-ID:t.
Förfrågan
| Metod | URI för förfrågan |
|---|---|
| GET | /Applications/{applicationId}/$/GetServices?ServiceTypeName={ServiceTypeName}&api-version=6.0&ContinuationToken={ContinuationToken}&timeout={timeout} |
Parametrar
| Namn | Typ | Obligatorisk | Location |
|---|---|---|---|
applicationId |
sträng | Ja | Sökväg |
ServiceTypeName |
sträng | No | Söka i data |
api-version |
sträng | Ja | Söka i data |
ContinuationToken |
sträng | No | Söka i data |
timeout |
heltal (int64) | No | Söka i data |
applicationId
Typ: sträng
Obligatoriskt: 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.
ServiceTypeName
Typ: sträng
Obligatoriskt: Nej
Namnet på tjänsttypen som används för att filtrera de tjänster som ska efterfrågas.
api-version
Typ: sträng
Obligatoriskt: 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 beskrivs i den här specifikationen.
Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds fram till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0, men om körningen är 6.1, för att göra det enklare att skriva klienterna, accepterar körningen version 6.1 för det API:et. Beteendet för API:et kommer dock att vara enligt den dokumenterade 6.0-versionen.
ContinuationToken
Typ: sträng
Obligatoriskt: Nej
Parametern fortsättningstoken används för att hämta nästa uppsättning resultat. En fortsättningstoken med ett icke-tomt värde ingår i API:ets svar när resultatet från systemet inte får plats i ett enda svar. När det här värdet skickas till nästa API-anrop returnerar API:et nästa uppsättning resultat. Om det inte finns några ytterligare resultat innehåller fortsättningstoken inget värde. Värdet för den här parametern ska inte vara URL-kodat.
timeout
Typ: heltal (int64)
Obligatoriskt: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Serverns timeout 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) | Lista över tjänster i klustret för det angivna programmet. |
PagedServiceInfoList |
| Alla andra statuskoder | Det detaljerade felsvaret. |
FabricError |