Criar serviço com base no modelo
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 |