Compartilhar via

Criar serviço com base no modelo

  • Artigo

Cria um serviço do Service Fabric com base no modelo de serviço.

Cria um serviço do Service Fabric com base no modelo de serviço definido no manifesto do aplicativo. Um modelo de serviço contém as propriedades que serão as mesmas para a instância de serviço do mesmo tipo. A API permite substituir as propriedades que geralmente são diferentes para serviços diferentes do mesmo tipo de serviço.

Solicitação

Método URI da solicitação
POST /Applications/{applicationId}/$/GetServices/$/CreateFromTemplate?api-version=6.0&timeout={timeout}

Parâmetros

Nome Tipo Obrigatório Location
applicationId string Sim Caminho
api-version string Sim Consulta
timeout inteiro (int64) Não Consulta
ServiceFromTemplateDescription ServiceFromTemplateDescription Sim Corpo

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.

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.

ServiceFromTemplateDescription

Tipo: ServiceFromTemplateDescription
Obrigatório: sim

Descreve o serviço que precisa ser criado com base no modelo definido no manifesto do aplicativo.

Respostas

Código de status HTTP Descrição Esquema de Resposta
202 (Aceito) Uma operação bem-sucedida retornará 202 status código.
Todos os outros códigos de status A resposta de erro detalhada.
 FabricError