Share via

Propriedade Put

  • Artigo

Cria ou atualiza uma propriedade de malha do serviço.

Cria ou atualiza a propriedade de malha do serviço especificada em um determinado nome.

Solicitação

Método URI da solicitação
PUT /Names/{nameId}/$/GetProperty?api-version=6.0&timeout={timeout}

Parâmetros

Nome Type Obrigatório Location
nameId string Sim Caminho
api-version string Sim Consulta
timeout inteiro (int64) Não Consulta
PropertyDescription Propertydescription Sim Corpo

nameId

Tipo: string
Obrigatório: sim

Nome da malha do serviço, sem o ' malha:' esquema de URI.

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.

PropertyDescription

Tipo: PropertyDescription
Obrigatório: sim

Descreve a propriedade do Service Fabric a ser criada.

Respostas

Código de status HTTP Descrição Esquema de Resposta
200 (OK) Uma resposta bem-sucedida significa que a propriedade foi criada ou atualizada.
Todos os outros códigos de status A resposta de erro detalhada.
 FabricError

Exemplos

Colocar propriedade

Este exemplo mostra como criar ou atualizar uma propriedade do Service Fabric com um determinado nome.

Solicitação

PUT http://localhost:19080/Names/samples/apps/CalculatorApp/$/GetProperty?api-version=6.0
Corpo
{
  "PropertyName": "AppData",
  "Value": {
    "Kind": "Binary",
    "Data": [
      "0",
      "1",
      "2",
      "3",
      "4",
      "5"
    ]
  }
}

Resposta 200

Corpo

O corpo da resposta está vazio.

Colocar propriedade personalizada

Este exemplo mostra como criar ou atualizar uma propriedade do Service Fabric em um determinado nome com um tipo personalizado.

Solicitação

PUT http://localhost:19080/Names/samples/apps/CalculatorApp/$/GetProperty?api-version=6.0
Corpo
{
  "PropertyName": "AppData",
  "Value": {
    "Kind": "String",
    "Data": "1+2=3"
  },
  "CustomTypeId": "EquationType"
}

Resposta 200

Corpo

O corpo da resposta está vazio.