View a markdown version of this page

Modifiche al supporto del protocollo per AWS clienti di servizio - AWS SDK e strumenti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Modifiche al supporto del protocollo per AWS clienti di servizio

AWS Gli SDK gestiscono i protocolli cablati utilizzati per serializzare le richieste e deserializzare le risposte durante la comunicazione con AWS servizi. Se il client SDK supporta la modifica, l'applicazione utilizza automaticamente il protocollo aggiornato senza modifiche al codice. Una modifica al supporto del protocollo non modifica l'API del servizio modellato. Tuttavia, le applicazioni e l'infrastruttura che dipendono da una rappresentazione cablata specifica potrebbero richiedere test o aggiornamenti.

Client di assistenza con modifiche al supporto del protocollo

Le tabelle seguenti identificano AWS client di servizio le cui modifiche al supporto del protocollo sono in anteprima o rilasciate. La presenza di un servizio in una tabella non significa che ogni AWS La versione SDK o service-client include la modifica. Prima di eseguire l'aggiornamento, consulta le note di rilascio dell'SDK applicabili e la documentazione specifica del servizio per gli SDK, le versioni, i protocolli e Regioni AWS.

Smithy RPC v2 CBOR è un protocollo RPC (Remote Procedure Call). Utilizza la codifica Concise Binary Object Representation (CBOR). AWS JSON 1.0 e AWS JSON 1.1 sono AWS protocolli di servizio. Usano la codifica JSON.

Il supporto per l'anteprima è solo per test e valutazione. Non utilizzarlo per carichi di lavoro di produzione. Segui la documentazione di anteprima e i termini associati al servizio elencato. Il supporto rilasciato è disponibile per l'uso in produzione a partire dalle versioni SDK e service-client identificate nelle note di rilascio dell'SDK applicabili.

Anteprima dei client

La tabella seguente identifica AWS client di servizio con modifiche al supporto del protocollo visualizzate in anteprima. Il Modificare la colonna confronta Smithy RPC v2 CBOR con l'applicabile AWS Protocollo JSON.

Servizi Modifica AWS CLI v2 C++ Vai alla v2 Java v2 JavaScript v3 Kotlin .NET v4 PHP v3 Python-boto3 Python-botocore Ruby v3 Rust Swift
ACM PCA Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Athena Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
CloudHSM V2 Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
CloudTrail Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
CodeBuild Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
CodeDeploy Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
CodePipeline Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Cognito Identity Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Comprehend Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Servizio di configurazione Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
DataSync Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Direct Connect Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Directory Service Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
EMR Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
EventBridge Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Firehose Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
KMS Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
MemoryDB Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Network Firewall Preferisci Smithy RPC v2 CBOR a AWS JSON 1.0
Rekognition Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Resource Groups Tagging API Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Domini Route 53 Preferisci Smithy RPC v2 CBOR rispetto a AWS JSON 1.1
Secrets Manager Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Service Catalog Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Service Quotas Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
ServiceDiscovery Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
SFN Preferisci Smithy RPC v2 CBOR a AWS JSON 1.0
Scudo Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
SWF Preferisci Smithy RPC v2 CBOR a AWS JSON 1.0
Textract Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
Transcribe Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1
WorkSpaces Preferisci Smithy RPC v2 CBOR a AWS JSON 1.1

Clienti rilasciati

Tutti i collegamenti alle versioni nella tabella seguente rimandano alle pagine di rilascio in GitHub sito web.

Servizi Data di rilascio Modifica AWS CLI v2 C++ Vai alla v2 Java v2 JavaScript v3 Kotlin .NET v4 PHP v3 Python-boto3 Python-botocore Ruby v3 Rust Swift
Amazon CloudWatch Approfondimenti sulle applicazioni 24 luglio 2026 Preferisci RPC v2 CBOR rispetto a AWS JSON 1.0 2.36.8 1,11,855 1,38,0 2,49,3 3,1095,0 1,8,14 4,0,101,0 3,389,0 1,43,56 1,43,56 1,83,0 1,107,0 1,7,46
23 luglio 2026 Preferisci RPC v2 CBOR rispetto a AWS JSON 1.0 2.36.7 1,11,854
  • Classifica intelligente di Amazon Kendra: 1.19.0

  • Amazon WorkSpaces Applicazioni: 1.64.0

  • AWS Gateway di backup: 1.30.0

  • Amazon WorkSpaces Istanze: 1.9.0

2,492 3,1094,0 1,8,13
3,388,13 1,43,55 1,43,55
  • Classifica intelligente di Amazon Kendra: 1.48.0

  • Amazon WorkSpaces Applicazioni: 1.140.0

  • AWS Gateway di backup: 1.56.0

  • Amazon WorkSpaces Istanze: 1.19.0

  • Classifica intelligente di Amazon Kendra: 1.104.0

  • Amazon WorkSpaces Applicazioni: 1.120.0

  • AWS Gateway di backup: 1.107.0

  • Amazon WorkSpaces Istanze: 1.34.0

1,7,45
Gestore di posta Amazon SES 6 luglio 2026 Preferisci RPC v2 CBOR rispetto a AWS JSON 1.0 2.35.16 1,11,840 1,20,0 2,47,0 3,1080,0 1,6107 4,0,101,0 3,387,3 1,43,41 1,43,41 1,46,0 1,89,0 1,7,31
21 aprile 2026 Preferisci RPC v2 CBOR rispetto a AWS JSON 1.0 2.34.34 1,11,794
  • AWS Compute Optimizer: 1.50.0

  • AWS Compute Optimizer Automation: 1.1.0

  • Amazon Comprehend Medical: 1,32,0

  • Amazon GameLift Server: 1.53.0

  • AWS Marketplace Entitlement Service: 1.37.0

  • AWS Snowball: 1.36.0

2,42,38 3,1034,0 1,6,61
3,379,4 1,42,93 1,42,93
  • AWS Compute Optimizer: 1.92,0

  • AWS Compute Optimizer Automation: 1.5.0

  • Amazon Comprehend Medical: 1.82.0

  • Amazon GameLift Server: 1.125.0

  • AWS Marketplace Entitlement Service: 1.86.0

  • AWS Snowball: 1.100,0

  • AWS Compute Optimizer: 1.104,0

  • AWS Compute Optimizer Automation: 1.9.0

  • Amazon Comprehend Medical: 1.99.0

  • Amazon GameLift Server: 1.109.0

  • AWS Marketplace Entitlement Service: 1.105,0

  • AWS Snowball: 1.98.0

1,6,99
CloudWatch 10 dicembre 2025 Preferisci AWS JSON 1.0 o RPC v2 CBOR finito AWS Domanda 2.32.14 1,11,708 1,53,0 2,40,6 3,949,0 1,5100 4,0150,0 3,367,0 1,42,7 1,42,7 1,126,0 1,100,0 1,6,14
Amazon SQS 8 novembre 2023 Preferisco AWS JSON 1.0 oltre AWS Domanda Non applicabile 1.11.198 1,27,0 2,21,18 3,446,0 0.34.2-beta Non applicabile 3.285.1 1,28,81 1,31,81 1,66,0 Non applicabile Non applicabile

Domande frequenti

Domande generali

Cos'è una modifica al supporto del protocollo?

Una modifica al supporto del protocollo aggiorna il modo in cui un client SDK supportato codifica le richieste e decodifica le risposte quando comunica con un AWS servizio. La modifica può aggiungere un protocollo o modificare il protocollo selezionato da un client. Non modifica le operazioni di servizio esposte tramite l'API pubblica dell'SDK.

Devo modificare la mia applicazione?

La maggior parte delle applicazioni che utilizzano un AWS Il client SDK non richiede modifiche al codice. Aggiorna il client SDK in base alle relative note di rilascio e testa l'aggiornamento utilizzando il normale processo di integrazione e distribuzione.

Esamina l'aggiornamento con maggiore attenzione se l'applicazione o l'infrastruttura dipendono da una rappresentazione cablata specifica. Gli esempi includono middleware o proxy che ispezionano o modificano i corpi di richiesta e risposta, dispositivi HTTP registrati e test che confrontano i payload serializzati.

Dove è disponibile una modifica al supporto del protocollo?

La disponibilità può variare in base al servizio, Regione AWS, SDK, versione del service-client e protocollo. Utilizza la documentazione specifica del servizio associata a una voce della tabella e le note di rilascio dell'SDK applicabili per verificare la disponibilità.

Cosa succede ai protocolli esistenti?

Una modifica al supporto del protocollo non annuncia di per sé la deprecazione di un protocollo di servizio esistente. Segui gli annunci specifici del servizio, le note di rilascio dell'SDK e AWS Politica di manutenzione degli SDK e degli strumenti per informazioni sul supporto e sul ciclo di vita.

domande sul CBOR di Smithy RPC v2

Che cos'è Smithy RPC v2 CBOR?

Smithy RPC v2 CBOR utilizza Concise Binary Object Representation (CBOR), un formato di dati binari compatto, per codificare richieste e risposte. Rispetto a una codifica JSON basata su testo, una codifica binaria può ridurre le dimensioni del payload codificato e il sovraccarico di serializzazione. Le prestazioni effettive variano in base al funzionamento del servizio, al payload, all'SDK, al runtime e alle condizioni di rete. Per saperne di più su Protocollo Smithy RPC v2 CBOR sul sito web di Smithy.

Cosa succede se la mia applicazione non è in grado di utilizzare Smithy RPC v2 CBOR?

Prima dell'aggiornamento, testa le integrazioni dipendenti dal protocollo e consulta le note di rilascio dell'SDK applicabili per verificare la compatibilità o le linee guida alternative. Se un problema ne impedisce l'adozione, continua a utilizzare una versione client supportata che soddisfi i tuoi requisiti mentre aggiorni l'integrazione interessata. Evita di affidarti a una versione SDK non supportata come soluzione a lungo termine.