Ottenere l'elenco di informazioni sulla replica del servizio distribuito
Recupera l'elenco della replica distribuita in un nodo di Service Fabric.
Recupera l'elenco contenente le informazioni relative alle repliche distribuite in un nodo di Service Fabric. Le informazioni includono ID partizione, ID replica, stato della replica, nome del servizio, nome del tipo di servizio e altre informazioni. Usare i parametri di query PartitionId o ServiceManifestName per restituire le informazioni sulle repliche distribuite corrispondenti ai valori specificati per tali parametri.
Richiesta
Metodo | URI richiesta |
---|---|
GET | /Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetReplicas?api-version=6.0&PartitionId={PartitionId}&ServiceManifestName={ServiceManifestName}&timeout={timeout} |
Parametri
Nome | Tipo | Necessario | Posizione |
---|---|---|---|
nodeName |
string | Sì | Percorso |
applicationId |
string | Sì | Percorso |
api-version |
string | Sì | Query |
PartitionId |
string (uuid) | No | Query |
ServiceManifestName |
string | No | Query |
timeout |
integer (int64) | No | Query |
nodeName
Tipo: string
Obbligatorio: Sì
Il nome del nodo.
applicationId
Tipo: string
Obbligatorio: Sì
Identità dell'applicazione. Si tratta in genere del nome completo dell'applicazione senza lo schema URI "fabric:".
A partire dalla versione 6.0, i nomi gerarchici sono delimitati dal carattere "~".
Ad esempio, se il nome dell'applicazione è "fabric:/myapp/app1", l'identità dell'applicazione sarà "myapp~app1" nella versione 6.0 e successive e "myapp/app1" nelle versioni precedenti.
api-version
Tipo: string
Obbligatorio: Sì
Impostazione predefinita: 6.0
Versione dell'API. Questo parametro è obbligatorio e il relativo valore deve essere '6.0'.
La versione dell'API REST di Service Fabric è basata sulla versione di runtime in cui è stata introdotta o modificata l'API. Il runtime di Service Fabric supporta più versioni dell'API. Questa è la versione più recente supportata dell'API. Se viene passata una versione precedente dell'API, la risposta restituita può essere diversa da quella documentata in questa specifica.
Inoltre, il runtime accetta qualsiasi versione superiore alla versione supportata più recente fino alla versione corrente del runtime. Se quindi la versione più recente dell'API è 6.0, ma se il runtime è 6.1, per semplificare la scrittura dei client, il runtime accetterà la versione 6.1 per tale API. Tuttavia, il comportamento dell'API sarà in base alla versione 6.0 documentata.
PartitionId
Tipo: string (uuid)
Obbligatorio: No
L'identità della partizione.
ServiceManifestName
Tipo: string
Obbligatorio: No
Nome di un manifesto del servizio registrato come parte di un tipo di applicazione in un cluster di Service Fabric.
timeout
Tipo: integer (int64)
Obbligatorio: No
Impostazione predefinita: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Timeout del server per l'esecuzione dell'operazione in secondi. Questo timeout specifica la durata di attesa che il client è disposto a attendere il completamento dell'operazione richiesta. Il valore predefinito per questo parametro è 60 secondi.
Risposte
Codice di stato HTTP | Descrizione | Schema di risposta |
---|---|---|
200 (OK) | Un'operazione completata restituirà il codice di stato 200 e l'elenco di informazioni sulla replica del servizio distribuita. |
matrice di DeployedServiceReplicaInfo |
204 (NoContent) | Viene restituita una risposta vuota se il valore applicationId specificato non viene trovato nel nodo specificato. Viene restituita anche una risposta vuota se non sono presenti repliche corrispondenti ai valori di filtro specificati per i parametri di query PartitionId o ServiceManifestName. |
|
Tutti gli altri codici di stato | Risposta dettagliata all'errore. |
FabricError |