Obter Lista de Informações do Tipo de Serviço Implementado

Artigo
07/19/2023

Obtém a lista que contém as informações sobre os tipos de serviço das aplicações implementadas num nó num cluster do Service Fabric.

Obtém a lista que contém as informações sobre os tipos de serviço das aplicações implementadas num nó num cluster do Service Fabric. A resposta inclui o nome do tipo de serviço, o respetivo estado de registo, o pacote de código que o registou e o ID de ativação do pacote de serviço.

Pedir

Método	URI do pedido
GET	`/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServiceTypes?api-version=6.0&ServiceManifestName={ServiceManifestName}&timeout={timeout}`

Parâmetros

Nome	Tipo	Necessário	Localização
`nodeName`	string	Yes	Caminho
`applicationId`	string	Yes	Caminho
`api-version`	string	Yes	Consulta
`ServiceManifestName`	cadeia (de carateres)	No	Consulta
`timeout`	número inteiro (int64)	No	Consulta

`nodeName`

Tipo: cadeia
Obrigatório: Sim

O nome do nó.

`applicationId`

Tipo: cadeia
Obrigatório: Sim

A identidade da aplicação. Normalmente, este é o nome completo da aplicação sem o esquema de URI "fabric:". A partir da versão 6.0, os nomes hierárquicos são delimitados com o caráter "~". Por exemplo, se o nome da aplicação for "fabric:/myapp/app1", a identidade da aplicação será "myapp~app1" na versão 6.0+ e "myapp/app1" em versões anteriores.

`api-version`

Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.0

A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de 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 alterada. O runtime do Service Fabric suporta mais do que uma versão da API. Esta é a versão suportada mais recente da API. Se for transmitida uma versão inferior da API, a resposta devolvida poderá ser diferente da documentada nesta especificação.

Além disso, o runtime aceita qualquer versão superior à versão suportada mais recente até à versão atual do runtime. Por isso, se a versão mais recente da API for a 6.0, mas se o runtime for 6.1, para facilitar a escrita 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 6.0 documentada.

`ServiceManifestName`

Tipo: cadeia
Obrigatório: Não

O nome do manifesto do serviço para filtrar a lista de informações do tipo de serviço implementado. Se for especificada, a resposta conterá apenas as informações sobre os tipos de serviço definidos neste manifesto de serviço.

`timeout`

Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos.

Respostas

Código de Estado HTTP	Description	Esquema de Resposta
200 (OK)	Lista de informações sobre tipos de serviço de uma aplicação implementada num nó.	matriz de DeployedServiceTypeInfo
Todos os outros códigos de estado	A resposta detalhada ao erro.	FabricError

Partilhar via