第2章 Apicurio Registry のコンテンツルール

ルールは、コンテンツが Apicurio Registry に追加された場合のみ、適用されます。これには、以下の REST 操作が含まれます。

ルールに違反した場合、Apicurio Registry は HTTP エラーを返します。応答本文には、違反したルールと、何が問題だったのかを示すメッセージが含まれます。

グローバルレベルおよびアーティファクトレベルで Apicurio Registry コンテンツルールを設定できます。優先順位は次のとおりです。

各ルールには、名前と設定情報があります。Apicurio Registry は、各アーティファクトのルールのリストとグローバルルールのリストを維持します。リスト内の各ルールは、ルール実装の名前と設定で構成されます。

アーティファクトの現在のバージョン (存在する場合) および追加されるアーティファクトの新しいバージョンのコンテンツを含むルールが提供されます。ルール実装は、アーティファクトがルールを渡すかどうかに応じて true または false を返します。そうでない場合、Apicurio Registry は HTTP エラー応答で理由を報告します。一部のルールは、コンテンツの以前のバージョンを使用しない場合があります。たとえば、互換性ルールは以前のバージョンを使用しますが、構文またはセマンティック妥当性ルールは使用しません。

アーティファクトごとに個別にルールを設定することも、グローバルに設定することもできます。Apicurio Registry は、特定のアーティファクト用に設定されたルールを適用します。そのレベルでルールが設定されていない場合、Apicurio Registry はグローバルに設定されたルールを適用します。グローバルルールが設定されていない場合は、ルールが適用されません。

アーティファクトルールの設定

Apicurio Registry Web コンソールまたは REST API を使用してアーティファクトルールを設定できます。詳細は以下を参照してください。

グローバルルールの設定

グローバルルールは、複数の方法で設定できます。

registry.rules.global.<ruleName>

registry.rules.global.<ruleName>

現在、以下のルール名がサポートされています。

application プロパティーの値は、設定されたルールに固有の有効な設定オプションである必要があります。