Obter lista de informações da réplica de serviço implantada
Obtém a lista de réplicas implantadas em um nó do Service Fabric.
Obtém a lista que contém as informações sobre réplicas implantado em um nó de malha do serviço. As informações incluem a ID de partição, o ID da réplica, o status da réplica, o nome do serviço, nome do tipo de serviço e outras informações. Use PartitionId ou ServiceManifestName parâmetros de consulta para retornar informações sobre as réplicas implantadas os valores especificados para os parâmetros de correspondência.
Solicitação
| Método | URI da solicitação |
|---|---|
| GET | /Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetReplicas?api-version=6.0&PartitionId={PartitionId}&ServiceManifestName={ServiceManifestName}&timeout={timeout} |
Parâmetros
| Nome | Tipo | Obrigatório | Location |
|---|---|---|---|
nodeName |
string | Sim | Caminho |
applicationId |
string | Sim | Caminho |
api-version |
string | Sim | Consulta |
PartitionId |
string (uuid) | Não | Consulta |
ServiceManifestName |
string | Não | Consulta |
timeout |
inteiro (int64) | Não | Consulta |
nodeName
Tipo: string
Obrigatório: sim
O nome do nó.
applicationId
Tipo: string
Obrigatório: sim
A identidade do aplicativo. Normalmente, este é o nome completo do aplicativo sem o esquema de URI "fabric:".
A partir da versão 6.0, nomes hierárquicos são delimitados pelo caractere "~".
Por exemplo, se o nome do aplicativo for "fabric:/meuaplicativo/aplicativo1", a identidade do aplicativo será "meuaplicativo~aplicativo1" na versão 6.0 e superiores, e "meuaplicativo/aplicativo1" nas versões anteriores.
api-version
Tipo: string
Obrigatório: sim
Padrão: 6.0
A versão da API. Esse parâmetro é necessário e seu valor deve ser '6.0'.
A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou foi alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta é a versão mais recente com suporte da API. Se uma versão inferior da API for passada, a resposta retornada poderá ser diferente daquela documentada nesta especificação.
Além disso, o runtime aceita qualquer versão que seja maior do que a versão mais recente com suporte até a versão atual do runtime. Portanto, se a versão mais recente da API for 6.0, mas se o runtime for 6.1, para facilitar a gravação dos clientes, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão documentada 6.0.
PartitionId
Tipo: cadeia de caracteres (uuid)
Obrigatório: não
A identidade da partição.
ServiceManifestName
Tipo: string
Obrigatório: não
O nome de um manifesto de serviço registrado como parte de um tipo de aplicativo em um cluster do Service Fabric.
timeout
Tipo: inteiro (int64)
Obrigatório: não
Padrão: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos.
Respostas
| Código de status HTTP | Descrição | Esquema de Resposta |
|---|---|---|
| 200 (OK) | Uma operação bem-sucedida retornará 200 status código e a lista de informações de réplica de serviço implantadas. |
matriz de DeployedServiceReplicaInfo |
| 204 (NoContent) | Uma resposta vazia será retornada se a applicationId especificada não for encontrada no nó especificado. Uma resposta vazia também será retornada se não houver réplicas que correspondam aos valores de filtro especificados para parâmetros de consulta PartitionId ou ServiceManifestName. |
|
| Todos os outros códigos de status | A resposta de erro detalhada. |
FabricError |