View a markdown version of this page

Perguntas frequentes sobre protocolos compatíveis - Amazon Comprehend Medical

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Perguntas frequentes sobre protocolos compatíveis

O serviço Amazon Comprehend Medical está adicionando suporte ao SDK para o protocolo Smithy RPC v2 CBOR, além do protocolo JSON existente.AWS O protocolo Smithy RPC v2 CBOR tem mais desempenho do que o JSON para a maioria das cargas de trabalho. AWS AWS Os SDKs priorizarão o protocolo com melhor desempenho para cada idioma.

Quais são os AWS Protocolos JSON e Smithy RPC v2 CBOR, e como eles diferem?

Um protocolo eletrônico atua como um mediador entre o cliente e o serviço. O AWS SDK lida com a serialização (convertendo um objeto para o formato de conexão) e a desserialização (convertendo o formato de conexão de volta em um objeto) entre o cliente e o servidor de forma transparente para ambos os protocolos.

AWS JSON - JSON é um dos formatos de dados mais usados e aceitos para comunicação entre sistemas. Esse serviço usa AWS JSON como meio de comunicação entre um cliente AWS SDK e o servidor. Uma solicitação HTTP para uma operação de API de serviço aceita entradas na forma de JSON, a operação é executada e a resposta é retornada ao cliente SDK na forma de JSON.

Smithy RPC v2 CBOR - O Smithy RPC v2 CBOR (Concise Binary Object Representation) é um protocolo desenvolvido pela Amazon para uma transmissão de dados mais eficiente. É um formato de dados projetado para manter os tamanhos das mensagens compactos e permitir que o formato evolua sem exigir negociação de versão entre sistemas. A principal diferença do AWS JSON é que o AWS JSON usa texto legível por humanos (como{"name": "John"}), enquanto o Smithy RPC v2 CBOR usa um formato binário (sequências de 1s e 0s). Essa abordagem binária cria pacotes de dados menores que viajam mais depressa pela rede e reduzem o tempo de serialização, pois os computadores processam os dados binários diretamente.

Como faço para começar a usar o protocolo Smithy RPC v2 CBOR?

Para começar, use a AWS SDK/CLI versão mais recente para usar o protocolo Smithy RPC v2 CBOR para esse serviço. O SDK usará automaticamente o protocolo Smithy RPC v2 CBOR quando disponível. Atualize seu AWS SDK para a versão especificada ou qualquer versão posterior.

A partir de 16/04/2020, os seguintes AWS SDKs usarão o protocolo Smithy RPC v2 CBOR, enquanto os outros SDKs continuarão usando o protocolo JSON: AWS

  • AWS SDK para C++

  • AWS SDK para Go V2

  • AWS SDK para Java 2.x

  • AWS SDK para .NET v4

  • AWS Ferramentas para PowerShell v5

  • AWS SDK para Swift

  • AWS SDK para Kotlin

Quais são os riscos de ativar o protocolo Smithy RPC v2 CBOR?

Espera-se que o suporte adicional do Smithy RPC v2 CBOR nos SDKs seja totalmente transparente e fácil para os clientes. No entanto, se você estiver usando uma implementação personalizada do AWS SDK, ou uma combinação de clientes personalizados e do AWS SDK, que depende do comportamento de AWS JSON-specific serialização, ela pode ser incompatível com o protocolo CBOR Smithy RPC v2.

E se minha solução não for compatível com o Smithy RPC v2 CBOR?

Para usar o protocolo AWS JSON, faça o downgrade do SDK para uma versão lançada antes de 16/04/2026.

O que AWS As regiões oferecem suporte ao protocolo Smithy RPC v2 CBOR?

O protocolo Smithy RPC v2 CBOR é suportado em todas as AWS regiões em que esse serviço está disponível.

Quais melhorias de latência posso esperar ao atualizar para versões do SDK compatíveis com o Smithy RPC v2 CBOR?

O Smithy RPC v2 CBOR fornece até 13% menos latência e até 15% de redução no tamanho da carga útil em comparação com o JSON. AWS A codificação binária elimina a sobrecarga da análise de texto JSON e do escape de cadeias de caracteres, o que reduz o tempo de transferência de rede e o custo de serialização.

Será que o AWS O protocolo JSON está obsoleto?

AWS O protocolo JSON continuará sendo suportado por meio de versões mais antigas dos SDKs. Além disso, alguns SDKs específicos da linguagem continuarão usando o AWS JSON, pois ele tem mais desempenho do que o Smithy RPC v2 CBOR, pois a implementação de JSON disponível para a linguagem é mais rápida do que a implementação do CBOR.

Onde posso encontrar mais informações sobre o Smithy RPC v2 CBOR?

Você pode encontrar mais informações sobre o protocolo JSON no protocolo AWS JSON 1.0 e no protocolo AWSAWS JSON1.1 na documentação do Smithy, e sobre o Smithy RPC v2 CBOR no protocolo Smithy RPC v2 CBOR na documentação do Smithy.