Ottenere informazioni sulla replica non posizionate

Articolo
07/19/2023

Ottiene le informazioni sulla replica non posizionata del servizio.

Restituisce le informazioni sulle repliche non posizionate del servizio. Se PartitionId è specificato, il risultato conterrà informazioni solo sulle repliche non posizionate per tale partizione. Se PartitionId non è specificato, il risultato conterrà informazioni sulle repliche non posizionate per tutte le partizioni del servizio. Se OnlyQueryPrimary è impostato su true, il risultato conterrà informazioni solo sulle repliche primarie e ignora le repliche secondarie non posizionate.

Richiesta

Metodo	URI richiesta
GET	`/Services/{serviceId}/$/GetUnplacedReplicaInformation?api-version=6.4&PartitionId={PartitionId}&OnlyQueryPrimaries={OnlyQueryPrimaries}&timeout={timeout}`

Parametri

Nome	Tipo	Necessario	Posizione
`serviceId`	string	Sì	Percorso
`api-version`	string	Sì	Query
`PartitionId`	string (uuid)	No	Query
`OnlyQueryPrimaries`	boolean	No	Query
`timeout`	integer (int64)	No	Query

`serviceId`

Tipo: stringa
Obbligatorio: Sì

L'identità del servizio. Questo ID è in genere il nome completo del servizio senza lo schema URI 'fabric:'. A partire dalla versione 6.0, i nomi gerarchici sono delimitati dal carattere "~". Ad esempio, se il nome del servizio è "fabric:/myapp/app1/svc1", l'identità del servizio sarà "myapp~app1~svc1" in 6.0+ e "myapp/app1/svc1" nelle versioni precedenti.

`api-version`

Tipo: stringa
Obbligatorio: Sì
Impostazione predefinita: 6.4

Versione dell'API. Questo parametro è obbligatorio e il relativo valore deve essere '6.4'.

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 versione è la versione più recente supportata dell'API. Se viene passata una versione api inferiore, 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. Quindi, se la versione più recente dell'API è 6.0 e il runtime è 6.1, 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: stringa (uuid)
Obbligatorio: No

L'identità della partizione.

`OnlyQueryPrimaries`

Tipo: booleano
Obbligatorio: No
Impostazione predefinita: false

Indica che le informazioni sulla replica non posizionate saranno query solo per le repliche primarie.

`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 del tempo 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)	Informazioni sul servizio specificato.	UnplacedReplicaInformation
Tutti gli altri codici di stato	Risposta dettagliata all'errore.	FabricError

Condividi tramite