Compartilhar via

Controle de simultaneidade

  • Artigo

Observação

As APIs do Portal do Cloud Partner são integradas ao Partner Center e continuarão funcionando nele. A transição introduz pequenas alterações. Examine as alterações listadas na API do Portal do Cloud Partner para garantir que seu código continue funcionando após a transição para o Cloud Partner. As APIs do CPP somente devem ser usadas em produtos existentes que já foram integrados antes da transição para o Partner Center. Os novos produtos devem usar as APIs de envio do Partner Center.

Cada chamada às APIs de publicação do Portal do Cloud Partner deve especificar explicitamente qual estratégia de controle de simultaneidade usar. A falha em fornecer o cabeçalho If-Match resultará em uma resposta de erro HTTP 400. Duas estratégias para controle de simultaneidade são ofertadas.

  • Otimista - O cliente que executa a atualização verifica se os dados foram alterados desde a última vez que leu os dados.
  • Último vence - O cliente atualiza os dados diretamente, independentemente de outro aplicativo tê-lo modificado desde o último horário de leitura.

Fluxo de trabalho de simultaneidade otimista

É recomendável usar a estratégia de simultaneidade otimista com o fluxo de trabalho a seguir para garantir que nenhuma edição inesperada seja feita nos recursos.

  1. Recuperar uma entidade usando as APIs. A resposta inclui um valor de ETag que identifica a versão atualmente armazenada da entidade (no momento da resposta).
  2. No momento da atualização, inclua esse mesmo valor de ETag no cabeçalho de solicitação If-Match.
  3. A API compara o valor de ETag recebido na solicitação com o valor de ETag atual da entidade em uma transação atômica.
    • Se os valores de ETag forem diferentes, a API retornará uma resposta HTTP 412 Precondition Failed. Esse erro indica que outro processo atualizou a entidade desde que o cliente a recuperou pela última vez ou que o valor de ETag especificado na solicitação está incorreto.
    • Se os valores de ETag forem iguais ou o cabeçalho If-Match header contiver o caractere asterisco curinga (*), a API executará a operação solicitada. A operação da API também atualiza o valor de ETag armazenado da entidade.

Observação

Especificar o caractere curinga (*) no cabeçalho If-Match resulta na API usando a estratégia de simultaneidade Último vence. Nesse caso, a comparação de ETag não ocorre e o recurso é atualizado sem nenhuma verificação.