Obter Informações de Tipo de Serviço por Nome
Obtém as informações sobre um tipo de serviço específico suportado por um tipo de aplicação aprovisionado num cluster do Service Fabric.
Obtém as informações sobre um tipo de serviço específico suportado por um tipo de aplicação aprovisionado num cluster do Service Fabric. O tipo de aplicação fornecido tem de existir. Caso contrário, é devolvido um estado 404. É devolvida uma resposta 204 se o tipo de serviço especificado não for encontrado no cluster.
Pedir
Método | URI do pedido |
---|---|
GET | /ApplicationTypes/{applicationTypeName}/$/GetServiceTypes/{serviceTypeName}?api-version=6.0&ApplicationTypeVersion={ApplicationTypeVersion}&timeout={timeout} |
Parâmetros
Nome | Tipo | Necessário | Localização |
---|---|---|---|
applicationTypeName |
string | Yes | Caminho |
serviceTypeName |
string | Yes | Caminho |
api-version |
string | Yes | Consulta |
ApplicationTypeVersion |
string | Yes | Consulta |
timeout |
número inteiro (int64) | No | Consulta |
applicationTypeName
Tipo: cadeia
Obrigatório: Sim
O nome do tipo de aplicação.
serviceTypeName
Tipo: cadeia
Obrigatório: Sim
Especifica o nome de um tipo de serviço do Service Fabric.
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.
ApplicationTypeVersion
Tipo: cadeia
Obrigatório: Sim
A versão do tipo de aplicaçã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) | Um tipo de serviço específico que é suportado por um tipo de aplicação aprovisionado. |
ServiceTypeInfo |
204 (NoContent) | É devolvida uma resposta 204 se o tipo de serviço especificado não for encontrado no cluster. |
|
Todos os outros códigos de estado | A resposta detalhada ao erro. |
FabricError |
Exemplos
Obtenha informações sobre todos os nós.
Este exemplo mostra como obter informações sobre um tipo de serviço específico. É devolvida uma resposta 204 se o tipo de serviço especificado não for encontrado no cluster.
Pedir
GET http://localhost:19080/ApplicationTypes/Application2Type/$/GetServiceTypes/Actor1ActorServiceType?api-version=6.0&ApplicationTypeVersion=1.0.0
Resposta 200
Corpo
{
"ServiceTypeDescription": {
"IsStateful": true,
"ServiceTypeName": "Actor1ActorServiceType",
"PlacementConstraints": "",
"HasPersistedState": true,
"Kind": "Stateful",
"Extensions": [
{
"Key": "__GeneratedServiceType__",
"Value": "<GeneratedNames xmlns=\"http://schemas.microsoft.com/2015/03/fabact-no-schema\">\r\n <DefaultService Name=\"Actor1ActorService\" />\r\n <ReplicatorEndpoint Name=\"Actor1ActorServiceReplicatorEndpoint\" />\r\n <ReplicatorConfigSection Name=\"Actor1ActorServiceReplicatorConfig\" />\r\n <ReplicatorSecurityConfigSection Name=\"Actor1ActorServiceReplicatorSecurityConfig\" />\r\n <StoreConfigSection Name=\"Actor1ActorServiceLocalStoreConfig\" />\r\n <ServiceEndpointV2 Name=\"Actor1ActorServiceEndpointV2\" />\r\n </GeneratedNames>"
}
],
"LoadMetrics": [],
"ServicePlacementPolicies": []
},
"ServiceManifestVersion": "1.0.0",
"ServiceManifestName": "Actor1Pkg",
"IsServiceGroup": false
}
Resposta 204
Corpo
O corpo da resposta está vazio.