5.18. プロダクトポリシーチェーンのエクスポートおよびインポート

プロダクトのポリシーチェーンを yaml または json コンテンツにエクスポートまたはインポートすることができます。コマンドラインで、id または system の値でプロダクトを参照します。プロダクトのポリシーチェーンをエクスポートまたはインポートする前に、3scale プロダクトを設定する必要があります。API コールをテストするための新規プロダクトの作成 を参照してください。

export コマンドの機能

  • このコマンドは、リモートプロダクトの読み取り専用操作になります。
  • このコマンドは、デフォルトで出力を標準出力 stdout に書き込みます。-f フラグは、コマンドの出力をファイルに書き込むために使用できます。
  • コマンド出力形式は、json または yaml のどちらかです。デフォルトの形式は yaml であることに注意してください。

エクスポートプロダクトポリシーチェーンのヘルプオプション

NAME
    export - export product policy chain
USAGE
    3scale policies export [opts] <remote>
    <product>
DESCRIPTION
    export product policy chain
OPTIONS
    -f --file=<value>             Write to file instead of stdout
    -o --output=<value>           Output format. One of: json|yaml

コマンドの形式

  • ポリシーチェーンを yaml のファイルにエクスポートするコマンドの形式を以下に示します。

    $ 3scale policies export -f policies.yaml -o yaml remote_name product_name

import コマンドの機能:

  • コマンドは、標準入力または stdin から入力を読み取ります。-f FILE フラグが設定されている場合、入力はファイルから読み取られます。-u URL フラグが設定されている場合、入力は URL から読み取られます。
  • インポートされたコンテンツは、yaml または json のいずれかになります。toolbox が自動的に検出するため、形式を指定する必要はありません。
  • 既存のポリシーチェーンは、新しくインポートされたポリシーチェーンで上書きされます。SET セマンティクスが実装されます。
  • すべてのコンテンツの検証は、3scale API に委任されます。

インポートプロダクトポリシーチェーンのヘルプオプション

NAME
    import - import product policy chain
USAGE
    3scale policies import [opts] <remote>
    <product>
DESCRIPTION
    import product policy chain
OPTIONS
    -f --file=<value>             Read from file
    -u --url=<value>              Read from url

コマンドの形式

  • 以下は、ファイルからポリシーチェーンをインポートするコマンドの形式です。

    $ 3scale policies import -f plan.yaml remote_name product_name
  • 以下は、URI からポリシーチェーンをインポートするコマンドの形式です。

    $ 3scale policies import -f http[s]://domain/resource/path.yaml remote_name product_name