Compartilhar via

Obter informações de tipo de serviço por nome

  • Artigo

Obtém as informações sobre um tipo de serviço específico com suporte por um tipo de aplicativo provisionado em um cluster do Service Fabric.

Obtém as informações sobre um tipo de serviço específico com suporte por um tipo de aplicativo provisionado em um cluster do Service Fabric. O tipo de aplicativo fornecido deve existir. Caso contrário, será retornado um status 404. Uma resposta 204 será retornada se o tipo de serviço especificado não for encontrado no cluster.

Solicitação

Método URI da solicitação
GET /ApplicationTypes/{applicationTypeName}/$/GetServiceTypes/{serviceTypeName}?api-version=6.0&ApplicationTypeVersion={ApplicationTypeVersion}&timeout={timeout}

Parâmetros

Nome Type Obrigatório Location
applicationTypeName string Sim Caminho
serviceTypeName string Sim Caminho
api-version string Sim Consulta
ApplicationTypeVersion string Sim Consulta
timeout inteiro (int64) No Consulta

applicationTypeName

Tipo: string
Obrigatório: sim

O nome do tipo de aplicativo.

serviceTypeName

Tipo: string
Obrigatório: sim

Especifica o nome de um tipo de serviço do Service Fabric.

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 é baseada na versão de runtime na qual a API foi introduzida ou 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 nessa especificação.

Além disso, o runtime aceita qualquer versão 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.

ApplicationTypeVersion

Tipo: string
Obrigatório: sim

A versão do tipo de aplicativo.

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) Um tipo de serviço específico com suporte por um tipo de aplicativo provisionado.
 ServiceTypeInfo
204 (NoContent) Uma resposta 204 será retornada se o tipo de serviço especificado não for encontrado no cluster.
Todos os outros códigos status A resposta de erro detalhada.
 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. Uma resposta 204 será retornada se o tipo de serviço especificado não for encontrado no cluster.

Solicitação

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.