SSMドキュメントで、「MaxDocumentSizeExceeded: 64 KiB」と表示された場合の解決方法を教えてください

2023.08.14

困っていた内容

AWSのドキュメントを一部編集して利用するために、SSMドキュメントを複製しようとしたところ、「MaxDocumentSizeExceeded: 64 KiB」というエラーが表示され、コピーできない事象が発生しました。何の編集もしない状態で複製を試みましたが同様のアラートが表示されました。こちらのエラーの解消方法を教えてください。

具体的な解決方法

MaxDocumentSizeExceeded: 64 KiBエラーは作成するドキュメントサイズが 64 KiB 以上のときに発生するエラーです。また、こちらは AWS の仕様であり、サービスクオータ等で変更することはできない制限となっております。

CreateDocument - AWS システムマネージャー

コンテンツ: JSON または YAML 形式の新しい SSM ドキュメントのコンテンツ。ドキュメントの内容は 64KB を超えてはなりません。このクォータには、実行時に入力パラメータに指定された内容も含まれます。新しいドキュメントのコンテンツを外部 JSON または YAML ファイルに保存し、コマンドでそのファイルを参照することをお勧めします。

そのため、以下記載する方法にて、ドキュメントサイズを変更する必要があります。

  • ドキュメントの縮小: 不要なスペース、改行、コメントを削除することでドキュメントのサイズを減らすことができます。ただし、これはサイズがそれほど大きくない場合にのみ効果的です。

  • ドキュメントの分割: 大きなドキュメントを複数の小さなドキュメントに分割し、それぞれを個別に実行することを検討してみてください。これにより、各ドキュメントが64KiB制限を超えないようにすることができます。ただし、このアプローチでは、複数のドキュメントの依存関係と実行順序を管理する必要があります。

参考情報