コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス・アプリケーションを作成します。

ibmcloud cis access-app-create DNS_DOMAIN_ID --name exampleCreate --domain example.com --session-duration 12h

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のすべてのアクセス・アプリケーションをリストします。

ibmcloud cis access-apps DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 の詳細を表示します。

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。 必須。

--name

アプリケーションの名前。 必須。

--domain

Access がブロックするドメインとパス。 必須。

--session-duration

このアプリケーションで発行されたトークンの有効期間を定義します。 有効な値は、30m、6h、12h、24h、168h、および730hです。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 を更新します。

ibmcloud cis access-app-update DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name exampleUpdate --domain example.com --session-duration 24h

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 を削除します。

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--name

証明書の名前。 必須。

--ca-cert-file

証明書のルート CA ファイル。 必須。

--associated-hostnames

この証明書に対して入力するよう求められるホスト名。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス証明書を作成します。

ibmcloud cis access-certificate-create DNS_DOMAIN_ID --name example --ca-cert-file CERT_FILE --associated-hostnames example.com

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のすべてのアクセス証明書をリストします。

ibmcloud cis access-certificates DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_CERTIFICATE_ID

アクセス証明書のID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

アクセス証明書 a5836c2a7ea72d2e225890caea70ae32 の詳細を表示します。

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_CERTIFICATE_ID

アクセス証明書のID。 必須。

--name

証明書の名前。 必須。

--associated-hostnames

この証明書に対して入力するよう求められるホスト名。 必須。

関連するホスト名は、associated-hostnames で指定されない場合、リセットされます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

アクセス証明書を更新してください a5836c2a7ea72d2e225890caea70ae32。

ibmcloud cis access-certificate-update DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID --name example --associated-hostnames example.com

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_CERTIFICATE_ID

アクセス証明書のID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

アクセス証明書「 a5836c2a7ea72d2e225890caea70ae32 」を削除してください。

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス証明書設定を取得します。

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-f, --feature

証明書設定の機能。 有効値:

client_certificate_forwarding

クライアント証明書のペイロードとその SHA256 署名は、 CF-Client-Cert-DER_BASE64 および CF-Client-Cert-SHA256 ヘッダーを通じてオリジンサーバーに転送されます。

-v, --value

証明書の機能に設定される値。

client_certificate_forwarding

クライアント証明書を転送するかどうかを、ホスト名で指定します。 例えば、-v host1=on,host2=on,host3=off です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス証明書設定を更新します。

ibmcloud cis access-certificates-settings-update DNS_DOMAIN_ID -f client_certificate_forwarding -v mtls1.example.com=on,mtls2.example.com=off

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。 必須。

--name

ポリシーの名前。 必須。

--decision

ポリシーがユーザーに一致した場合に、Accessが実行するアクションを定義します。 有効な値は「 non_identity 」です。 必須。

--include

ポリシーのインクルード・ルール。 有効な値は certificate および common_name です。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

アプリケーション「 a5836c2a7ea72d2e225890caea70ae32 」へのアクセスポリシーを作成します。

ibmcloud cis access-policy-create DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name examplePolicy --decision non_identity --include certificate --include common_name=test

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 のすべてのアクセス・ポリシーをリストします。

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。 必須。

ACCESS_POLICY_ID

アクセスポリシーのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

アクセス・ポリシー a5836c2a7ea72d2e225890caea70ae32 の詳細を表示します。

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_APPLICATION_ID

アクセスアプリケーションのID。 必須。

ACCESS_POLICY_ID

アクセスポリシーのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

アクセス・ポリシー 65fe21071877669cc69544642bc6c4c4 を削除します。

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--all

すべてのキャッシュ・ファイルをパージ中です。 このオプションは --file と同時に指定することはできません。

--file

URL を指定することにより、1 つ以上のファイルを個別に削除します。 このオプションは --all と同時に指定することはできません。

--tag

関連付けられた Cache-Tag により、1 つ以上のファイルを個別に削除します。 このオプションは --all と同時に指定することはできません。 エンタープライズプランのみ

--host

ホストを指定することにより、1 つ以上のファイルを個別に削除します。 このオプションは --all と同時に指定することはできません。 エンタープライズプランのみ

--prefix

プレフィックスにより、1 つ以上のファイルを個別に削除します。 このオプションは --all と同時に指定することはできません。 エンタープライズプランのみ

-f, --force

確認のプロンプトを出さずにすべてのキャッシュ・ファイルをパージ中です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のキャッシュに入れられたアセット・ファイルをすべてクリアします。

ibmcloud cis cache-purge DNS_DOMAIN_ID --all --force

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のキャッシュ設定を取得します。

ibmcloud cis cache-settings DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--caching-level

URL のどの条件下で、キャッシュされたアセットをユーザーに配信したいかを指定してください。 有効な値は no-query-string、 query-string-independent、 query-string-dependent。

• no-query-string: クエリ文字列が存在しない場合にのみ、キャッシュからリソースを配信する。
• query-string-independent: クエリ文字列に関係なく、すべてのユーザーに同じリソースを配信します。
• query-string-dependent: クエリ文字列が変更されるたびに、異なるリソースを返します。

--browser-expiration

ブラウザがキャッシュされたアセットを保存する期間を指定してください。

• 有効な値は、 respect-existing-header、 30s、 1M、 5M、 20M、 30M、 1h、 2h、 4h、 8h、 16h、 1d 3d、 8d、 16d、 1m、 6m、および 1y です。
• 30s, 1M, 5M, および 20M は、Enterprise プランまたは Security プランのインスタンスでのみ利用可能です。
• 30s つまり、 30 seconds となります。
• 30M つまり、 30 minutes となります。
• 1h つまり、 1 hour となります。
• 1d つまり、 1 day となります。
• 1m つまり、 1 month となります。
• 1y つまり、 1 year となります。

--development-mod

すべてのエッジ・キャッシュをバイパスして、トラフィックを起点サーバーに向けて送信します。

--serve-stale-content

オリジンサーバーがオフラインの場合、コンテンツの有効期限が切れていても、ユーザーには引き続きキャッシュされたコンテンツを提供し続けます。

--query-string-sort: キャッシュ内では、 CIS は、クエリ文字列の順序にかかわらず、同じクエリ文字列を持つファイルを同一のファイルとして扱います。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のキャッシュ設定を更新します。

ibmcloud cis cache-settings-update DNS_DOMAIN_ID --caching-level no-query-string --browser-expiration 1h

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ibmcloud cis custom-lists lists

コマンド・オプション

LIST_ID

カスタムリストのID。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ibmcloud cis custom-lists list LIST_ID --output json

コマンド・オプション

--kind

カスタムリストの種類。 有効な値は ip、 asn、 hostname。

--name

リスト名。

--description

リストの説明

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--json

カスタムリストを記述するために使用されるJSONファイルまたはJSON文字列。

JSONデータにおける必須項目は以下の通りです：

kind カスタムリストの種類。 有効な値は ip、 asn、 hostname である。

name リスト名。

オプションのフィールドは

"description": リストの説明。

サンプル JSON データ:

{
  "kind": "ip",
  "name": "string",
  "description": "string"
}

例

ibmcloud cis custom-lists list-create --kind ip --name iplistone --instance INSTANCE

ibmcloud cis custom-lists list-create --json @example.json --instance INSTANCE

コマンド・オプション

LIST_ID

カスタムリストのID。

--description

リストを簡単に説明する。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

json

カスタムリストを記述するために使用されるJSONファイルまたはJSON文字列。

オプションのフィールドは

"description": このリストについて簡単に説明します。

サンプル JSON データ:

  {
    "description": "string"
  }

例

ibmcloud cis custom-lists list-update LIST_ID --description "description example"

ibmcloud cis custom-lists list-update LIST_ID --json @example.json

コマンド・オプション

LIST_ID

カスタムリストのID。

-f, --force

確認のメッセージを表示せずに、カスタムリストを削除しようとします。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ibmcloud cis custom-lists list-delete LIST_ID

コマンド・オプション

LIST_ID

カスタムリストのID。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ibmcloud cis custom-lists items LIST_ID

コマンド・オプション

LIST_ID

カスタムリストのID。

ITEM_ID

カスタムリスト項目のID。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ibmcloud cis custom-lists item LIST_ID ITEM_ID

コマンド・オプション

LIST_ID

カスタムリストのID。

--asn

ASNの値。

--ip

IPv4 のアドレス。

--hostname

ホスト名。

--comment

この件に関する簡単なコメントを述べること。

-i, --instance

インスタンスの名前または ID。 instanceまたはIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--json

カスタムリストを記述するために使用されるJSONファイルまたはJSON文字列。

JSONデータにおける必須項目は以下の通りです：

items 作成するカスタムリスト項目のリスト。

asn ASN.

hostname: ホスト名。

ip IPv4 アドレス。

comment この件に関する簡単なコメントを述べること。

サンプル JSON データ:

  [
    {
      "asn": 19604,
      "comment": "My list of developer IPs.",
      "hostname": "cloud.ibm.com",
      "ip": "172.64.0.0/13"
    }
  ]

コマンドの例

ibmcloud cis custom-lists item-create LIST_ID --ip 192.0.0.3

ibmcloud cis custom-lists item-create LIST_ID --json @example.json

コマンド・オプション

LIST_ID

カスタムリストのID。

--json

カスタムリストを記述するために使用されるJSONファイルまたはJSON文字列。

JSONデータにおける必須項目は以下の通りです：

items 作成するカスタムリスト項目のリスト。

asn ASN の値。

hostname: ホスト名。

ip IPv4 アドレス。

comment この件に関する簡単なコメントを述べること。

サンプル JSON データ:

   [
     {
       "asn": 19604,
       "comment": "My list of developer IPs.",
       "hostname": "cloud.ibm.com",
       "ip": "172.64.0.0/13"
     }
   ]

-f, --force

確認のメッセージを表示せずに、カスタムリストを削除しようとします。

--output value

出力形式。 現在、 json が唯一サポートされている値です。

-i, --instance

インスタンスの名前または ID。 インスタンス値またはIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ibmcloud cis custom-lists item-update LIST_ID --json @example.json -f

コマンド・オプション

LIST_ID

カスタムリストのID。

--item-id

CUSTOM_LIST_ITEM_ID はカスタムリスト項目のIDです。

-f, --force

確認のメッセージを表示せずに、カスタムリストを削除しようとします。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--json

カスタムリストを記述するために使用されるJSONファイルまたはJSON文字列。

JSONデータにおける必須項目は以下の通りです：

items 削除するカスタムリスト項目のIDによるリスト。

id カスタムリスト項目のユニークID。

サンプル JSON データ:

  {
    "items": [
      {
        "id": "70c2009751b24ffc9ed1ab462ba957b4"
      }
    ]
  }

例

ibmcloud cis custom-lists item-delete LIST_ID --item-id CUSTOM_LIST_ITEM_ID --force

ibmcloud cis custom-lists item-delete LIST_ID --json @example.json --force

コマンド・オプション

OPERATION_ID

カスタムリスト操作のID。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ibmcloud cis custom-lists operation OPERATION_ID --output json

コマンド・オプション

PAGE_ID

カスタム・ページ・タイプの名前。 有効な値は、 basic_challenge、 country_challenge、 ip_block、 ratelimit_block、 serve_stale_content、 under_attack、 waf_block、 waf_challenge、 1000_errors、 500_errors です。必須項目です。

PAGE_URL

カスタム・ページに関連付けられている URL。 例えば、http://www.example.com/example.html です。 値 default はデフォルト・ページを使用することを意味します。 必須。

-d, --domain

DNS ドメイン ID。

-i,- --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン basic_challenge の 31984fea73a15b45779fa0df4ef62f9b ページを更新します。

ibmcloud cis custom-page-update basic_challenge http://www.example.com/example.html -d DNS_DOMAIN_ID

コマンド・オプション

PAGE_ID

カスタム・ページ・タイプの名前。 有効な値は、 basic_challenge、 country_challenge、 ip_block、 ratelimit_block、 serve_stale_content、 under_attack、 waf_block、 waf_challenge、 1000_errors、および 500_errors です。 必須。

-d, --domain

DNS ドメイン ID。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン basic_challenge の 31984fea73a15b45779fa0df4ef62f9b ページを取得します。

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

コマンド・オプション

-d, --domain

DNS ドメイン ID。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

DNS_DOMAIN_ID ドメインの既存のカスタムページをリストアップする。

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--name

DNS レコード名。

--type

DNS レコード・タイプ。

--content

DNS レコード・コンテンツ。

--ttl

DNS レコードの存続時間。 値が 1 の場合は、 automatic となります。 デフォルト値は1です。

--proxied

トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS A、、および のレコードについてのみ、トラフィックをプロキシします。 AAAA CNAME 有効な値は true と false です。

--json

DNSレコードを記述するために使用されるJSONファイルまたはJSON文字列。 サポートされる DNS レコード・タイプは A、AAAA、CNAME、NS、TXT、MX、LOC、SRV、CAA、PTR です。

• A、 AAAA、 CNAME、 NS、 TXT については：
  • JSON データ内の必須フィールドは、name、type、content です。
  • オプションのフィールドは、 ttl、 proxied です：
    • proxied トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS A, AAAA および のレコードに対するトラフィックのみをプロキシします。 CNAME

サンプル JSON データ:

{
   "name": "testA",
   "type": "A",
   "content": "127.0.0.1",
   "proxied": true
}
{
   "name": "testAAAA",
   "type": "AAAA",
   "content": "2001:0db8:0012:0001:3c5e:7354:0000:5db1",
   "proxied": false
}
{
   "name": "testCNAME",
   "type": "CNAME",
   "content": "example.com"
}
{
   "name": "testNS",
   "type": "NS",
   "content": "ns1.example.com"
}
{
   "name": "testTXT",
   "type":"TXT",
   "content": "text information"
}

• PTR 型の場合：
  • JSON データ内の必須フィールドは、name、type、content です。
  • オプション・フィールドは ttl です。

サンプル JSON データ:

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}

• MX 型の場合：
  • JSON データ内の必須フィールドは、name、type、content です。
  • オプションのフィールドは、 ttl および priority です。

サンプル JSON データ:

{
   "name": "testMX",
   "type": "MX",
   "content": "smtp.example.com",
   "priority": 10
}

• LOC 型の場合：
  • JSON データ内の必須フィールドは、name、type、data です。
    • data:
      • lat_degrees: 緯度の度数。
      • lat_minutes: 緯度分
      • lat_seconds: 緯度の秒。
      • lat_direction: 緯度の方向。
      • long_degrees: 経度の度数。
      • long_minutes: 経度の分。
      • long_seconds: 経度の秒。
      • long_direction: 経度方向。
      • altitude: その地点の標高（メートル単位）。
      • size: 場所の大きさ（メートル単位）。
      • precision_horz: 位置の水平方向の精度。
      • precision_vert: 位置の垂直方向の精度。
    • オプション・フィールドは ttl です。

サンプル JSON データ:

{
   "name": "testLOC",
   "type": "LOC",
   "data": {
         "lat_degrees": 45,
         "lat_minutes": 0,
         "lat_seconds": 0,
         "lat_direction": "N",
         "long_degrees": 45,
         "long_minutes": 0,
         "long_seconds": 0,
         "long_direction": "E",
         "altitude": 20,
         "size": 0,
         "precision_horz": 0,
         "precision_vert": 0
   }
}

• SRV 型の場合：
  • JSON データ内の必須フィールドは type、data です。
    • data: - service ：アンダースコアで始まるサービスタイプ。 - proto: 有効なプロトコルです。 - priority: 優先度。 - weight ：レコードの重量。 - port ：このサービスのポート番号。 - target ：有効なホスト名。
    • オプション・フィールドは ttl です。

サンプル JSON データ:

{
   "type": "SRV",
   "data": {
         "service": "_ftp",
         "proto": "_tcp",
         "name": "testSRV",
         "priority": 1,
         "weight": 1,
         "port": 21,
         "target": "example.com"
   }
}

• タイプ CAA の場合:
  • JSONデータで必須のフィールドは、 name、 type、および data です。
  • オプション・フィールドは ttl です。

サンプル JSON データ:

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}

-s, --json-str

非推奨。 DNS レコードを説明するための JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」にDNSレコードを作成してください。

ibmcloud cis dns-record-create DNS_DOMAIN_ID --json '{"name": "testCNAME", "type": "CNAME", "content": "example.com"}'
ibmcloud cis dns-record-create DNS_DOMAIN_ID --type A --name testA --content "127.0.0.1"

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

DNS_RECORD_ID

DNSレコードのID。 必須。

--name

DNS レコード名。

--type

DNS レコード・タイプ。

--content

DNS レコード・コンテンツ。

--ttl

DNS レコードの存続時間。 値が 1 の場合は、 automatic となります。 デフォルト値は1です。

--proxied

トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS A、、および のレコードについてのみ、トラフィックをプロキシします。 AAAA CNAME 有効な値は true と false です。

--json

DNSレコードを記述するために使用されるJSONファイルまたはJSON文字列。 サポートされる DNS レコード・タイプは A、AAAA、CNAME、NS、TXT、MX、LOC、SRV、CAA、PTR です。

• A、 AAAA、 CNAME、 NS、 TXT については：
  • JSON データ内の必須フィールドは、name、type、content です。
  • オプションのフィールドは、 ttl および proxied です：
    • proxied トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS A、、および のレコードに対するトラフィックのみをプロキシします。 AAAA CNAME

サンプル JSON データ:

{
   "name": "testA",
   "type": "A",
   "content": "127.0.0.1",
   "proxied": true
}
{
   "name": "testAAAA",
   "type": "AAAA",
   "content": "2001:0db8:0012:0001:3c5e:7354:0000:5db1",
   "proxied": false
}
{
   "name": "testCNAME",
   "type": "CNAME",
   "content": "example.com"
}
{
   "name": "testNS",
   "type": "NS",
   "content": "ns1.example.com"
}
{
   "name": "testTXT",
   "type":"TXT",
   "content": "text information"
}

• PTR 型の場合：
  • JSON データ内の必須フィールドは、name、type、content です。
  • オプション・フィールドは ttl です。

サンプル JSON データ:

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}

• MX 型の場合：

  • JSON データ内の必須フィールドは、name、type、content です。
  • オプションのフィールドは、 ttl および priority です。

  サンプル JSON データ:

{
   "name": "testMX",
   "type": "MX",
   "content": "smtp.example.com",
   "priority": 10
}

• LOC 型の場合：

  • JSON データ内の必須フィールドは、name、type、data です。
    • data:
      • lat_degrees: 緯度の度数。
      • lat_minutes: 緯度分
      • lat_seconds: 緯度の秒。
      • lat_direction: 緯度の方向。
      • long_degrees: 経度の度数。
      • long_minutes: 経度の分。
      • long_seconds: 経度の秒。
      • long_direction: 経度方向。
      • altitude: その地点の標高（メートル単位）。
      • size: 場所の大きさ（メートル単位）。
      • precision_horz: 位置の水平方向の精度。
      • precision_vert: 位置の垂直方向の精度。
  • オプション・フィールドは ttl です。

  サンプル JSON データ:

{
   "name": "testLOC",
   "type": "LOC",
   "data": {
         "lat_degrees": 45,
         "lat_minutes": 0,
         "lat_seconds": 0,
         "lat_direction": "N",
         "long_degrees": 45,
         "long_minutes": 0,
         "long_seconds": 0,
         "long_direction": "E",
         "altitude": 20,
         "size": 0,
         "precision_horz": 0,
         "precision_vert": 0
   }
}

• SRV 型の場合：

  • JSON データ内の必須フィールドは type、data です。
    • data:
      • service: サービスタイプ。先頭にアンダースコアが付きます。
      • proto: 有効なプロトコル。
      • priority: 優先順位。
      • weight: 記録的な重量。
      • port: サービスのポート番号。
      • target: 有効なホスト名。
  • オプション・フィールドは ttl です。

  サンプル JSON データ:

{
   "type": "SRV",
   "data": {
         "service": "_ftp",
         "proto": "_tcp",
         "name": "testSRV",
         "priority": 1,
         "weight": 1,
         "port": 21,
         "target": "example.com"
   }
}

• CAA 型の場合：

  • JSONデータで必須のフィールドは、 name、 type、 data
  • オプション・フィールドは ttl です。

  サンプル JSON データ:

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}

-s, --json-str

非推奨。 DNS レコードを説明するための JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のDNSレコードを更新してください。

ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --json '{"name": "testCNAME", "type": "CNAME", "content": "example.com"}'
ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --type A --name testA --content "127.0.0.1"

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

DNS_RECORD_ID

DNSレコードのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン内のDNSレコードの詳細を取得する DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

DNS_RECORD_ID

DNSレコードのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメイン「 DNS_DOMAIN_ID 」内のDNSレコードを削除します。

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--type

表示する DNS レコードのタイプ。

--name

フィルターで使用する名前フィールドの値。

--content

フィルターで使用するコンテンツ・フィールドの値。

--page

ページ番号付けした結果のページ番号。

--per_page

ページあたりの最大 DNS レコード数。

--order

DNSレコードのリストを並べ替える基準となるフィールド。 有効な値は、 type、 name、 content、 ttl、および proxied です。

--direction

結果の並べ替え順（昇順または降順）。 有効な値は asc および desc です。

--match

すべての検索パラメータに一致させるか、少なくとも1つに一致させるか。 有効な値は any および all です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」内のすべてのDNSレコードを一覧表示してください。

ibmcloud cis dns-records DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--file

インポートする BIND 構成。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン内のBINDコンフィグをインポートする DNS_DOMAIN_ID.

ibmcloud cis dns-records-import DNS_DOMAIN_ID --file bind_config_file.txt

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--file

エクスポートされたDNSレコードを保存するBIND設定ファイル。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメイン DNS_DOMAIN_ID の BIND 設定をエクスポートします。

ibmcloud cis dns-records-export DNS_DOMAIN_ID --file bind_config_file.txt

コマンド・オプション

type

ドメイン・タイプのセットアップを指定してください。 有効な値は full と partial （デフォルトは full ）。

• full: 「フルゾーン」とは、DNSがホストされていることを意味します。
• partial: 部分ゾーンは、CNAME設定のあるドメインを意味します。

jump-start

自動的に既存の DNS レコードの取り出しを試みます。

DNS_DOMAIN_NAME

DNSドメインのFQDN。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_NAME 」を追加します。

ibmcloud cis domain-add DNS_DOMAIN_NAME

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

指定されたドメインを再開します。

ibmcloud cis domain-resume DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

指定されたドメインを一時停止します。

ibmcloud cis domain-pause DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

指定されたドメインの詳細を表示します。

ibmcloud cis domain DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

指定されたドメインを削除します。

ibmcloud cis domain-remove DNS_DOMAIN_ID

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

サービスインスタンスのドメインを一覧表示します。

ibmcloud cis domains

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

指定されたドメインでアクティベーション・チェックを実行します。

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-g, --group

同じグループの機能を表示します。 group の有効な値は、 all、 domain、 reliability、 performance、および security です。 このオプションは、-f, --feature と同時には使用できません。

-f, --feature

確認するドメイン設定の機能。 このオプションは、g, --group と同時には使用できません。 有効な値は次のとおりです。

• always_use_https: スキーマが http のすべてのリクエストを https にリダイレクトします。 この設定は、そのドメインに対するすべての HTTP リクエストに適用されます。
• automatic_https_rewrites: ウェブサイト上のすべてのリソースまたはリンクのうち、 HTTPS で配信可能なものについて、 http を https に変更し、混合コンテンツの問題を解消してください。
• bot_management: ドメイン上のボットトラフィックを検知し、その影響を軽減します。
• brotli: アセットをリクエストしているクライアントが Brotli 圧縮アルゴリズムに対応している場合、 CIS はそのアセットの Brotli 圧縮版を配信します。
• browser_check: 訪問者のブラウザから送信される HTTP ヘッダーを分析し、脅威の有無を確認します。 脅威が検出された場合、ブロックページが配信されます。
• challenge_ttl: IPレピュテーションが不良と判定された訪問者が、認証手続きを完了した後、ウェブサイトへのアクセスを許可される期間を指定します。
• ciphers: TLS の終了時に使用される暗号方式の許可リスト（ BoringSSL 形式）。 このコマンドは、顧客によって許可リストに登録された暗号をリストアップします。 許可リストに登録された暗号方式がない場合、リストは空となり、デフォルトの暗号方式が使用されます。 デフォルトの暗号化方式の一覧は、 Edge暗号スイート と Origin暗号スイート を参照してください。
• cname_flattening: CNAMEレコードが指す先を追跡し、CNAMEレコードの代わりにそのIPアドレスを返す。 デフォルトでは、ドメインのルートにある CNAME のみをフラット化します。
• domain_hold: ドメインの保持機能により、組織内のチームが、別のアカウントですでに有効になっているドメインを追加することを防ぎます。 エンタープライズプランのみ
• email_obfuscation ボットからはウェブページ上のメールアドレスを暗号化し、人間からは見えるようにします。
• opportunistic_onion: Torブラウザの正当なユーザーがあなたのウェブサイトにアクセスできるようにします。
• hotlink_protection: 画像が外部サイトからリンクされるのを防ぎましょう。
• http2: 「 HTTP/2 」でウェブサイトの表示速度を向上させましょう。
• http3: 「 HTTP/3 」でウェブサイトの表示速度を向上させましょう。
• image_load_optimization 非推奨。 低速なネットワークに接続するモバイル・デバイス上のイメージを含むページのロード時間を改善します。
• image_size_optimization: ドメイン上にホストされている画像を最適化することで、画像の読み込み時間を短縮します。
• image_resizing CIS ネットワークを通じて提供される画像のリサイズ、変換、最適化をオンデマンドで提供。
• ip_geolocation: ウェブサイトへのすべてのリクエストに、訪問者の所在地の国コードを含めてください。
• ipv6: 「 IPv6 」のサポートとゲートウェイを有効にします。
• max_upload: 1回のリクエストで、ウェブサイトにデータをアップロードできる訪問者の数。
• min_tls_version: 選択した TLS プロトコルバージョン以降をサポートしている訪問者からの HTTPS 接続のみを許可します。
• minify: ウェブサイト上のソースコードのファイルサイズを縮小してください。
• mobile_redirect: モバイル端末を利用している訪問者を、モバイル向けに最適化されたウェブサイトにリダイレクトします。
• opportunistic_encryption: 「オポチュニスティック暗号化」により、ブラウザは、サイトが暗号化された接続で利用可能であることを認識できるようになり、 HTTP/2 のパフォーマンス向上によるメリットを享受できます。
• origin_error_page_pass_thru: 「オリジンエラーページ」が On に設定されている場合、 CIS は 502 および 504 のエラーページをオリジンから直接プロキシします。 エンタープライズプランのみ
• origin_max_http_version: 「 HTTP 」のバージョンを「Origin」に設定します。
• origin_post_quantum_encryption: CIS があなたのオリジンに接続する際、ポスト量子（PQ）鍵合意アルゴリズムを使用するように指示します。
• prefetch_preload CIS は、Prefetch HTTP ヘッダーに含まれるすべての URL をプリフェッチします。 エンタープライズプランのみ
• pseudo_ipv4: クライアントが IPv6 を使用しているにもかかわらず、サーバーが IPv4 しかサポートしていない場合、リクエストに IPv4 ヘッダーを追加します。
• response_buffering: オリジンサーバーからの応答のバッファリングを有効または無効にします。 エンタープライズプランのみ
• script_load_optimization: JavaScript を含むページの描画時間を改善する。
• security_header: ウェブサイトに対してウェブセキュリティポリシーを適用してください。
• security_level: ウェブサイトに適したセキュリティプロファイルを選択してください。
• server_side_exclude: 不審な訪問者に対して、特定のコンテンツを自動的に非表示にします。
• tls_client_auth: オリジンからのプル時に、認証のために提示された TLS のクライアント証明書。 エンタープライズプランのみ
• true_client_ip_header: CIS は、True-Client-IP ヘッダーにユーザーの IP アドレスを送信します。 エンタープライズプランのみ
• waf: Webアプリケーションファイアウォール（WAF）は、悪意のあるコンテンツを含むリクエストをブロックします。
• websockets: オリジンサーバーへの WebSockets 接続を許可します。
• proxy_read_timeout: オリジンからの2回の読み取り操作間の最大時間。 エンタープライズプランのみ
• url_normalization: 受信リクエストのURLを変更する。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」の ciphers 設定を取得します。

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-f, --feature

更新するドメイン設定の機能。 必須。 有効値:

• always_use_https: スキーマが http のすべてのリクエストを https にリダイレクトします。 このリダイレクトは、このドメインに対するすべての HTTP リクエストに適用されます。
• automatic_https_rewrites: ウェブサイト上のすべてのリソースまたはリンクのうち、 HTTPS で配信可能なものについて、 http を https に変更し、混合コンテンツの問題を解消してください。
• bot_management: ドメイン上のボットトラフィックを検知し、その影響を軽減します。
• brotli: アセットをリクエストしているクライアントが Brotli 圧縮アルゴリズムに対応している場合、 CIS はそのアセットの Brotli 圧縮版を配信します。
• browser_check: 訪問者のブラウザから送信される HTTP ヘッダーを分析し、脅威の有無を確認します。 脅威が検出された場合、ブロックページが配信されます。
• challenge_ttl: IPレピュテーションが不良と判定された訪問者が、認証手続きを完了した後、ウェブサイトへのアクセスを許可される期間を指定します。
• ciphers TLS の終了のための暗号の許可リスト。 これらの暗号は BoringSSL フォーマットである必要があります。
• cname_flattening: CNAMEレコードが指す先を追跡し、CNAMEレコードの代わりにそのIPアドレスを返す。 デフォルトでは、自分のドメインのルートにある CNAME のみをフラット化します。
• domain_hold: ドメインの保持機能により、組織内のチームが、別のアカウントですでに有効になっているドメインを追加することを防ぎます。 エンタープライズプランのみ
• email_obfuscation ボットからはウェブページ上のメールアドレスを暗号化し、人間からは見えるようにします。
• opportunistic_onion: Torブラウザの正当なユーザーがあなたのウェブサイトにアクセスできるようにします。
• hotlink_protection: 画像が外部サイトからリンクされるのを防ぎましょう。
• http2: 「 HTTP/2 」でウェブサイトの表示速度を向上させましょう。
• http3: 「 HTTP/3 」でウェブサイトの表示速度を向上させましょう。
• image_load_optimization 非推奨。 低速なネットワークに接続するモバイル・デバイス上のイメージを含むページのロード時間を改善します。
• image_size_optimization: ドメイン上にホストされている画像を最適化することで、画像の読み込み時間を短縮します。
• image_resizing CIS ネットワークを通じて提供される画像のリサイズ、変換、最適化をオンデマンドで提供。
• ip_geolocation: ウェブサイトへのすべてのリクエストに、訪問者の所在地の国コードを含めてください。
• ipv6: 「 IPv6 」のサポートとゲートウェイを有効にします。
• max_upload: 1回のリクエストで、ウェブサイトにデータをアップロードできる訪問者の数。
• min_tls_version: 選択した TLS プロトコルバージョン以降をサポートしている訪問者からの HTTPS 接続のみを許可します。
• minify: ウェブサイト上のソースコードのファイルサイズを縮小してください。
• mobile_redirect: モバイル端末を利用している訪問者を、モバイル向けに最適化されたウェブサイトにリダイレクトします。
• opportunistic_encryption: 「オポチュニスティック暗号化」により、ブラウザは、サイトが暗号化された接続で利用可能であることを認識できるようになり、 HTTP/2 のパフォーマンス向上によるメリットを享受できます。
• origin_error_page_pass_thru: 「オリジンエラーページ」が On に設定されている場合、 CIS は 502 および 504 のエラーページをオリジンから直接プロキシします。 エンタープライズプランのみ
• origin_max_http_version: 「 HTTP 」のバージョンを「Origin」に設定します。
• origin_post_quantum_encryption: CIS があなたのオリジンに接続する際、ポスト量子（PQ）鍵合意アルゴリズムを使用するように指示します。
• prefetch_preload CIS は、Prefetch HTTP ヘッダーに含まれるすべての URL をプリフェッチします。 エンタープライズプランのみ
• pseudo_ipv4: クライアントが IPv6 を使用しているものの、サーバーが IPv4 のみをサポートしている場合、リクエストに IPv4 ヘッダーを追加します。
• response_buffering: オリジンサーバーからの応答のバッファリングを有効または無効にします。 エンタープライズプランのみ
• script_load_optimization: JavaScript を含むページの描画時間を改善する。
• security_header: ウェブサイトに対してウェブセキュリティポリシーを適用してください。
• security_level: ウェブサイトに適したセキュリティプロファイルを選択してください。
• server_side_exclude: 不審な訪問者に対して、特定のコンテンツを自動的に非表示にします。
• tls_client_auth: オリジンからのプル時に、認証のために提示された TLS のクライアント証明書。 エンタープライズプランのみ
• true_client_ip_header: CIS は、True-Client-IP ヘッダーにユーザーの IP アドレスを送信します。 エンタープライズプランのみ
• waf: Webアプリケーションファイアウォール（WAF）は、悪意のあるコンテンツを含むリクエストをブロックします。
• websockets: オリジンサーバーへの WebSockets 接続を許可します。
• proxy_read_timeout: オリジンからの2回の読み取り操作間の最大時間。
• url_normalization: 受信リクエストのURLを変更する。

-v, --value

ドメインの機能に設定される値。 必須。

• always_use_https の有効な値は、 on および off です。

• automatic_https_rewrites の有効な値は、 on および off です。

• bot_management の有効な値は、「use_latest_model」、「fight_mode」、「session_score」、「enable_js」です。 例: -v fight_mode=true,session_score=true

  • use_latest_model 最新バージョンを有効にするかどうか。 use_latest_model の有効な値は、 true および false です。
  • fight_mode ファイトモードを有効にするかどうか。 fight_mode の有効な値は、 true および false です。
  • session_score セッションスコアを有効にするかどうか。 session_score の有効な値は、 true および false です。
  • enable_js JavaScript の検出を有効にするかどうか。 enable_js の有効な値は、 true および false です。

• browser_check の有効な値は、 on および off です。

• challenge_ttl の有効な値は、300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000 です。

• cname_flattening の有効な値は、flatten_at_root、flatten_all です。

  • flatten_at_root: ルートドメインの CNAME を平坦化する。 この値はデフォルト値です。
  • flatten_all: ドメイン下のすべてのCNAMEレコードをフラット化してください。

• domain_hold の有効な値は hold、 include_subdomains 、 hold_after である。

  • hold ドメインホールドを有効にするかどうか。 hold の有効な値は、 true および false です。
  • include_subdomains ドメインホールドを有効にするかどうか。 include_subdomains の有効な値は、 true および false です。
  • hold_after : hold_after が指定された場合、保留機能は一時的に無効化され、指定された時刻にシステムによって自動的に再有効化されます。

  ドメインおよびサブドメインを有効にするには、 -v hold=true,include_subdomains=true を実行してください。 ドメインホールドを無効にするには： -v hold=false,hold_after=2023-05-31T15:56:36+00:00。

• hotlink_protection の有効な値は、on、off です。

• email_obfuscation の有効な値は、on、off です。

• opportunistic_onion の有効な値は、on、off です。

• http2 の有効な値は、on、off です。

• http3 の有効な値は、on、off です。

• 非推奨。 image_load_optimization の有効な値は、on、off です。

• image_resizing の有効な値は、on、off です。

• image_size_optimization の有効な値は、off、lossless、lossy です。

  • off: イメージ・サイズの最適化を無効にします。
  • lossless: 画質を損なうことなく、画像ファイルのサイズを縮小します。
  • lossy: JPEG画像のファイルサイズは、非可逆圧縮によって縮小されますが、これにより画質が低下する可能性があります。

• ip_geolocation の有効な値は、on、off です。

• ipv6 の有効な値は、on、off です。

• max_upload の有効な値 (MB 単位) は以下のとおりです。 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. エンタープライズプランのみ

• min_tls_version の有効な値は、1.0、1.1、1.2、1,3 です。

• minify の有効な値は、 css、 html、 js です。例えば、 -v css=on,html=off,js=on

  • css: ウェブサイトのすべてのCSSを自動的に圧縮します。 css の有効な値は、on、off です。
  • html: ウェブサイトのすべてのHTMLを自動的に圧縮します。 html の有効な値は、on、off です。
  • js: ウェブサイトのすべてのJSを自動的に圧縮します。 js の有効な値は、on、off です。

• mobile_redirect の有効な値は、 status、 mobile_subdomain、 strip_uriです。 例えば、 -v status=on,mobile_subdomain=m,strip_uri=true のように指定します。

  • status: モバイルリダイレクトが有効になっているかどうか。 status の有効な値は、 on および off です。
  • mobile_subdomain: モバイル端末からの訪問者をどのサブドメインのプレフィックスにリダイレクトするか（サブドメインは存在している必要があります）。
  • strip_uri: 現在のページパスを破棄し、モバイルサブドメイン URL のルートへリダイレクトするかどうか。 strip_uri の有効な値は、true、false です。

• opportunistic_encryption の有効な値は、on、off です。

• origin_error_page_pass_thru の有効な値は、1、2 です。

• origin_max_http_version の有効な値は、supported、preferred、off です。

  • supported: ポスト量子アルゴリズムは宣伝されていますが、送信元からの要求があった場合にのみ使用されます。
  • preferred: 「Preferred」を指定すると、 CIS は、送信元への最初のメッセージで、状況に応じてポスト量子（PQ）キーシェアを送信するよう指示されます（送信元が PQ をサポートし、かつ PQ を優先する場合、接続を最速化するため）。
  • off: ポスト量子アルゴリズムについては、宣伝されていません。

• origin_post_quantum_encryption の有効な値は、on、off です。

• brotli の有効な値は、on、off です。

• prefetch_preload の有効な値は、on、off です。

• pseudo_ipv4 の有効な値は、off、add_header、overwrite_header です。

  • off: Pseudo IPv4 を無効にします。
  • add_header: Cf-Pseudo-IPv4 ヘッダーのみを追加します。
  • overwrite_header: 既存の Cf-Connecting-IP と X-Forwarded-For ヘッダーを Pseudo IPv4 アドレスで上書きします。

• response_buffering の有効な値は、on、off です。

• script_load_optimization の有効な値は、on、off です。

• security_header の有効な値は、 enabled、 max_age、 include_subdomains、 preload、 nosniff です。例えば、 -v enabled=true,max_age=100、include_subdomains=true、preload=true、nosniff=true

  • enabled security_header が有効かどうか。 enabled の有効な値は、true、false です。
  • max_age: ブラウザで security_header がキャッシュされる期間（秒単位）を指定します。
  • include_subdomains: 当該ドメインの下位にあるすべてのドメインは、同じ security_header を継承します。 include_subdomains の有効な値は、true、false です。
  • preload: ブラウザによる security_header のプリロードを許可するかどうか。 enabled の有効な値は、true、false です。
  • nosniff : X-Content-Type-Options: nosniff ヘッダーを送信するかどうか。 nosniff の有効な値は、true、false です。

• server_level の有効な値は、 off、 essentially_off、 low、 medium、 high、 under_attackです。

• server_side_exclude の有効な値は、on、off です。

• tls_client_auth の有効な値は、on、off です。

• true_client_ip_header の有効な値は、on、off です。

• waf の有効な値は、on、off です。

• websockets の有効な値は、on、off です。

• proxy_read_timeout(1 から 6000) の有効な値は 100 です。

• ciphers の有効な値は、 ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-CHACHA20-POLY1305, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-CHACHA20-POLY1305, ECDHE-ECDSA-AES128-SHA256, ECDHE-ECDSA-AES128-SHA, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES128-SHA, AES128-GCM-SHA256, AES128-SHA256, AES128-SHA, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES256-SHA384, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES256-SHA, AES256-GCM-SHA384, AES256-SHA256, AES256-SHA, DES-CBC3-SHA, default である。例えば、 -v AES256-SHA256,AES256-SHA、 -v default を使用して、設定済みの暗号スイートをデフォルト値にリセットする。

• url_normalization の有効な値は「type」、「scope」です。 例えば、 -v type=cis,scope=both

  • type: CIS によって実行される「 URL 」正規化のタイプを選択します。 type の有効な値は、cis、rfc3986 です。
  • scope: 「 URL 」の正規化の範囲を設定します。 scope の有効な値は、both、incoming です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID に対して、 tls_client_auth を有効にしてください。

ibmcloud cis domain-settings-update DNS_DOMAIN_ID -f tls_client_auth -v on

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

すべてのエッジ関数のアクションを一覧表示します。

ibmcloud cis edge-functions-actions

コマンド・オプション

--name

アクション名。 エンタープライズプランのみ

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

Edge Functions アクション「 ACTION_NAME 」の詳細を表示します。

ibmcloud cis edge-functions-action --name ACTION_NAME

コマンド・オプション

--name

アクション名。 エンタープライズプランのみ

--javascript-str

Javascript ストリング。 例: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Javascript ファイル。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

Edge Functions アクションを作成します。

ibmcloud cis edge-functions-action-create --name ACTION_NAME --javascript-str "addEventListener('fetch', event => { event.respondWith(fetch(event.request)) })"

コマンド・オプション

--name

アクション名。 エンタープライズプランのみ

--javascript-str

Javascript ストリング。 例: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Javascript ファイル。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

Edge Functions のアクションを更新します。

ibmcloud cis edge-functions-action-update --name ACTION_NAME --javascript-str "addEventListener('fetch', event => { event.respondWith(fetch(event.request)) })"

コマンド・オプション

--name

アクション名。 エンタープライズプランのみ

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

「エッジ関数を削除」アクション ACTION_NAME。

ibmcloud cis edge-functions-action-delete --name ACTION_NAME

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID のすべてのエッジ関数のトリガーを一覧表示します。

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

TRIGGER_ID

トリガーのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

「Edge Functions」のトリガー「 TRIGGER_ID 」の詳細を表示します。

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

PATTERN_URL

アクションをトリガーするリクエスト URL。 必須。

name

作成されたトリガーが関連付けられるアクション名。 エンタープライズプランのみ

disable

Edge Functions トリガーを無効にします。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」用のEdge Functionsトリガーを作成します。

ibmcloud cis edge-functions-trigger-create DNS_DOMAIN_ID PATTERN_URL --name ACTION_NAME

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

TRIGGER_ID

トリガーのID。 必須。

PATTERN_URL

アクションをトリガーするリクエスト URL。 必須。

name

作成されたトリガーが紐付けられるアクション名。 エンタープライズプランのみ

disable

Edge Functions トリガーを無効にします。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

Edge Functionsのトリガーを TRIGGER_ID に更新します。

ibmcloud cis edge-functions-trigger-update DNS_DOMAIN_ID TRIGGER_ID PATTERN_URL --name ACTION_NAME

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

TRIGGER_ID

トリガーのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

「Edge Functionsの削除」が TRIGGER_ID をトリガーします。

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

コマンド・オプション

-t, --type

作成するファイアウォールルールの種類。 有効な値： access-rules、 ua-rules、 lockdowns。必須。

• access-rules: アクセス・ルールは、Web サイトへの要求を許可、チャレンジ、ブロックするための方法です。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
• ua-rules: クライアントによって報告された UserAgent と厳密に一致させるときは、アクセス制御を実行します。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 このオプションを使用すると、サイトへのアクセス設定をカスタマイズできます。
• lockdowns: このドメインの URL へのアクセスをロックして、許可されたアドレスまたはアドレス範囲のみに限定します。

-d, --domain

DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。

--json

ファイアウォールルールを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• --type access-rules について：ファイアウォールのアクセスルールを記述する JSON データは以下の通りです。
  • 必須フィールドは、mode、configuration です。
    • mode: 実行するアクションの種類。 有効な値は、 block、 challenge、 whitelist、および js_challenge です。
    • configuration: このルールで使用するターゲット/値のペア。
      • target: 対象とするリクエストのプロパティ。 有効な値は、 ip、 ip_range、 asn、および country です。
      • value: 選択されたターゲットの値。
        • ip については、その値は有効な IP アドレスです。
        • ip_range の値は、 /16 および /24 に限定された IP 範囲を指定します。
        • asn の場合、その値は AS 番号です。
        • 国については、その値は当該国の国コードとなります。
  • オプション・フィールドは notes です。
    • notes: このルールの目的を理解するのに役立つ、いくつかの有用な情報です。

サンプル JSON データ:

{
   "mode": "block",
   "notes": "This rule is added because of event X that occurred on date xyz",
   "configuration": {
      "target": "ip",
      "value": "127.0.0.1"
   }
}

• --type ua-rules について：ユーザーエージェントルールを記述する JSON データは以下の通りです。
  • 必須フィールドは、mode、configuration です。
    • mode: 実行するアクションの種類。 有効な値は block、 challenge、 js_challenge である。
    • configuration: このルールで使用するターゲット/値のペア。
      • target: 対象とするリクエストのプロパティ。 有効な値は「 ua 」です。
      • value: このルールで一致させる UserAgent の正確な文字列。
  • オプション・フィールドは、paused、description です。
    • paused: このルールが現在無効になっているかどうか。
    • description: このルールの目的を理解するのに役立つ、いくつかの有用な情報です。

サンプル JSON データ:

{
   "mode": "block",
   "configuration": {
      "target": "ua",
      "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"
   }
}

• --type lockdowns ：ロックダウン・ルールを記述するJSONデータは以下の通り。
  • 必須フィールドは、urls、configurations です。
    • urls: このルール定義に含めるURL。
      • ワイルドカードを使用できます。
      • ここに入力した URL パターンは使用前にエスケープされます。
      • このフィールドを設定すると、 URL で使用できるワイルドカードパターンが単純な形式に制限されます。
    • configurations: このルールで使用するIPアドレスまたはCIDR範囲の一覧。
      • このフィールドには、指定されたURLにアクセスできるIPアドレスまたはIPアドレス範囲の設定を、いくつでも含めることができます。
      • target: 対象とするリクエストのプロパティ。 有効な値は ip および ip_range。
      • value: IPアドレスまたはCIDR。 ターゲットが「 ip 」の場合、値はIPアドレスでなければなりません。それ以外の場合はCIDRでなければなりません。
  • オプション・フィールドは、paused、description です。
    • paused: このルールが現在無効になっているかどうか。
    • description: このルールの目的を理解するのに役立つ、いくつかの有用な情報です。

サンプル JSON データ:

{
   "urls": [
      "api.mysite.com/some/endpoint*"
   ],
   "configurations": [
      {
         "target": "ip",
         "value": "127.0.0.1"
      },
      {
         "target": "ip_range",
         "value": " 2.2.2.0/24"
      }
   ]
}

-s, --json-str

非推奨。 ファイアウォール・ルールを記述する JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ファイアウォール・ルールを作成します。

ibmcloud cis firewall-create --type access-rules --json '{"mode": "block", "notes": "This rule is added because of event X that occurred on date xyz", "configuration": {"target": "ip", "value": "127.0.0.1"}}' --instance INSTANCE
ibmcloud cis firewall-create --type ua-rules --domain DNS_DOMAIN_ID --json '{"mode": "block", "configuration": {"target": "ua", "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"}}' --instance INSTANCE
ibmcloud cis firewall-create --type lockdowns --domain DNS_DOMAIN_ID --json '{"urls": ["api.mysite.com/some/endpoint*"], "configurations": [{"target": "ip", "value": "127.0.0.1"}, {"target": "ip_range", "value": "2.2.2.0/24"}]}' --instance INSTANCE

コマンド・オプション

• FIREWALL_RULE_ID: ファイアウォール・ルールの ID。 必須。

-t, --type

作成するファイアウォールルールの種類。 有効な値は access-rules、 ua-rules、 lockdowns。 必須。

• access-rules: アクセスルールとは、ウェブサイトへのリクエストを許可、確認、またはブロックするための仕組みです。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
• ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行する。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 これにより、サイトへのアクセスをカスタマイズできるようになります。
• lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。

-d, --domain

DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。

--json

ファイアウォールルールを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• --type access-rules の場合：ファイアウォールのアクセスルールを記述するJSONデータは以下の通り。
  • オプション・フィールドは、mode、notes です。
    • mode: 実行するアクションの種類。 有効な値は、 block、 challenge、 whitelist、および js_challenge です。
    • notes: このルールの目的を理解するのに役立つ、いくつかの有用な情報です。

サンプル JSON データ:

{
   "mode": "challenge",
   "notes": "This rule is added because of event X that occurred on date xyz",
}

• --type ua-rules ：ユーザー・エージェント・ルールを記述するJSONデータは以下の通り。

  • 必須フィールドは、mode、configuration です。
    • mode: 実行するアクションの種類。 有効な値は block、 challenge、 js_challenge である。
    • configuration: このルールで使用するターゲット/値のペア。
      • target: 対象とするリクエストのプロパティ。 有効な値は「 ua 」です。
      • value: このルールで一致させる UserAgent の正確な文字列。
  • オプション・フィールドは、paused、description です。
    • paused: このルールが現在無効になっているかどうか。
    • description: このルールの目的を理解するのに役立つ、いくつかの有用な情報です。

  サンプル JSON データ:

{
   "mode": "block",
   "configuration": {
      "target": "ua",
      "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"
   }
}

• --type lockdowns ：ロックダウン・ルールを記述するJSONデータは以下の通り。
  • 必須フィールドは、urls、configurations です。
    • urls: このルール定義に含めるURL。
      • ワイルドカードを使用できます。
      • ここに入力した URL パターンは使用前にエスケープされます。
      • このフィールドを設定すると、 URL で使用できるワイルドカードパターンが単純な形式に制限されます。
    • configurations: このルールで使用するIPアドレスまたはCIDR範囲の一覧。
      • このフィールドには、指定されたURLにアクセスできるIPアドレスまたはIPアドレス範囲の設定を、いくつでも含めることができます。
      • target: 対象とするリクエストのプロパティ。 有効な値は ip と ip_range。
      • value: IPアドレスまたはCIDR。 対象が「 ip 」である場合は、その値はIPアドレスでなければなりません。それ以外の場合はCIDRでなければなりません。
  • オプション・フィールドは、paused、description です。
    • paused: このルールが現在無効になっているかどうか。
    • description: このルールの目的を理解するのに役立つ、いくつかの有用な情報です。

サンプル JSON データ:

{
   "urls": [
      "api.mysite.com/some/endpoint*"
   ],
   "configurations": [
      {
         "target": "ip",
         "value": "127.0.0.1"
      },
      {
         "target": "ip_range",
         "value": " 2.2.2.0/24"
      }
   ]
}

-s, --json-str

非推奨。 ファイアウォールルールを記述するJSONデータ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ファイアウォール・ルールを更新します。

ibmcloud cis firewall-update FIREWALL_RULE_ID -t access-rules --json '{"mode": "challenge", "notes": "This rule is added because of event X that occurred on date xyz"}'
ibmcloud cis firewall-update FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID --json '{"mode": "block", "configuration": {"target": "ua", "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"}}'
ibmcloud cis firewall-update FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID --json '{"urls": ["api.mysite.com/some/endpoint*"], "configurations": [{"target": "ip", "value": "127.0.0.1"}, {"target": "ip_range", "value": "2.2.2.0/24"}]}'

コマンド・オプション

-t, --type

作成するファイアウォールルールの種類。 有効な値は access-rules、 ua-rules、 lockdowns。 必須。

• access-rules: アクセスルールとは、ウェブサイトへのリクエストを許可、確認、またはブロックするための仕組みです。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
• ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行する。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 この操作により、サイトへのアクセス権限をカスタマイズすることができます。
• lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。

-d, --domain

DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。

--page

ページ番号付けした結果のページ番号。 デフォルト値は 0です。

--per-page

ページあたりの最大アクセス・ルール数。 最小値は 5 です。 デフォルト値は20です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ファイアウォール・ルールをリストします。

ibmcloud cis firewalls --type access-rules --instance INSTANCE
ibmcloud cis firewalls --type ua-rules --domain DNS_DOMAIN_ID --instance INSTANCE
ibmcloud cis firewalls --type lockdowns --domain DNS_DOMAIN_ID --instance INSTANCE

コマンド・オプション

FIREWALL_RULE_ID

ファイアウォールルールのID。 必須。

-t, --type

作成するファイアウォール・ルールのタイプ。 有効な値は access-rules、 ua-rules、 lockdowns。

• access-rules: アクセスルールとは、ウェブサイトへのリクエストを許可、確認、またはブロックするための仕組みです。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
• ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行する。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 これにより、サイトへのアクセスをカスタマイズできるようになります。
• lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。

-d, --domain

DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ファイアウォール・ルールの詳細を取得します。

ibmcloud cis firewall FIREWALL_RULE_ID -t access-rules
ibmcloud cis firewall FIREWALL_RULE_ID -t access-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID

コマンド・オプション

FIREWALL_RULE_ID

ファイアウォールルールのID。 必須。

-t, --type

作成するファイアウォール・ルールのタイプ。 有効な値は access-rules、 ua-rules、 lockdowns。 必須。

• access-rules: アクセスルールとは、ウェブサイトへのリクエストを許可、確認、またはブロックするための仕組みです。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
• ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行する。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 このフィールドを使用すると、サイトへのアクセス権限をカスタマイズできます。
• lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。

-d, --domain

DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ファイアウォール・ルールを削除します。

ibmcloud cis firewall-delete FIREWALL_RULE_ID -t access-rules
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t access-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--page

ページ番号付けした結果のページ番号。 デフォルト値は 1です。

--per-page

ページあたりのファイアウォール・ルールの数。 最小値は 5で、最大値は 100 です。 デフォルト値は25です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン内の既存のファイアーウォールルールをリストアップする DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

FIREWALL_RULE_ID

ファイアウォールルールのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ファイアウォールルール「 FIREWALL_RULE_ID 」の詳細を確認してください。

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--expression

フィルター演算式。 例えば、ip.src eq 93.184.216.0 です。

--action

実行するルール・アクション。 有効な値は、log、allow、challenge、js_challenge、block、およびbypassです。

--priority

ルールの優先度。 有効な値の範囲は、 0 から 2147483647 までです。 0 という値は、デフォルト値に設定することを意味します。

--description

ルールを簡潔に説明するためのものです。

--paused

そのルールが有効かどうかを示します。 有効な値は on および off です。 デフォルト値はoffです。

--products

バイパスされるセキュリティー製品のリスト。 有効な値は、 zoneLockdown、 uaBlock、 bic、 hot、 securityLevel、 rateLimit、および waf です。

--json

ファイアウォールルールを記述するために使用されるJSONファイルまたはJSON文字列。

• JSONデータで必須のフィールドは、 expression および action です。
  • expression: フィルタ式。 例: ip.src eq 93.184.216.0
  • action: 実行するルールアクション。 有効な値は、 log、 allow、 challenge、 js_challenge、 block、および bypass です。
• オプション・フィールドは、description、priority、paused、products です。
  • description: そのルールを簡単に説明します。
  • priority: ルールの優先順位。 有効な値の範囲は、 0 から 2147483647 までです。 0 という値は、デフォルト値に設定することを意味します。
  • paused: ルールが有効かどうかを示します。 有効な値は on と off。 デフォルト値は offです。
  • products: バイパス対象となるセキュリティ製品のリスト。 有効な値は、 zoneLockdown、 uaBlock、 bic、 hot、 securityLevel、 rateLimit、および waf です。例えば、 --products、 zoneLockdown, などです。 rateLimit

サンプル JSON データ:

{
   "expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"",
   "action": "allow",
   "priority": 100,
   "paused": false,
   "description": "do not challenge login from office"
}

-s, --json-str

非推奨。 ファイアウォールルールを記述するJSONデータ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID にファイアウォールルールを作成する。

ibmcloud cis firewall-rule-create DNS_DOMAIN_ID --expression "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"" --action allow --priority 200 --paused off --description "do not challenge login from office"
ibmcloud cis firewall-rule-create DNS_DOMAIN_ID --json '{"expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"", "action": "allow", "priority": 100, "paused": false, "description": "do not challenge login from office"}'

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

FIREWALL_RULE_ID

ファイアウォールルールのID。 必須。

--expression

フィルター演算式。 例えば、ip.src eq 93.184.216.0 です。

--action

実行するルール・アクション。 有効な値は、log、allow、challenge、js_challenge、block、およびbypassです。

--priority

ルールの優先度。 有効な値の範囲は、 0 から 2147483647 までです。 0 という値は、デフォルト値に設定することを意味します。

--description

ルールを簡潔に説明するためのものです。

--paused

そのルールが有効かどうかを示します。 有効な値は on および off です。 デフォルト値はoffです。

--products

バイパスされるセキュリティー製品のリスト。 有効な値は、 zoneLockdown、 uaBlock、 bic、 hot、 securityLevel、 rateLimit、および waf です。

--json

ファイアウォールルールを記述するために使用されるJSONファイルまたはJSON文字列。

• JSONデータで必須のフィールドは、 expression、および action です。
  • expression: フィルタ式。 例: ip.src eq 93.184.216.0
  • action: 実行するルールアクション。 有効な値は、 log、 allow、 challenge、 js_challenge、 block、および bypass です。
• オプション・フィールドは、description、priority、paused、products です。
  • description: そのルールを簡単に説明します。
  • priority: ルールの優先順位。 有効な値の範囲は、 0 から 2147483647 までです。 0 という値は、デフォルト値に設定することを意味します。
  • paused: ルールが有効かどうかを示します。 有効な値は on と off。 デフォルト値は offです。
  • products: バイパス対象となるセキュリティ製品のリスト。 有効な値は、 zoneLockdown、 uaBlock、 bic、 hot、 securityLevel、 rateLimit、および waf です。例えば、 --products、 zoneLockdown, などです。 rateLimit

JSONデータで明示的に設定されていないフィールド description、 priority、 paused は、デフォルト値で上書きされます。

サンプル JSON データ:

{
   "expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"",
   "action": "allow",
   "priority": 100,
   "paused": false,
   "description": "do not challenge login from office"
}

-s, --json-str

非推奨。 ファイアウォールルールを記述するJSONデータ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ファイアウォールルールの更新 FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID --expression "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"" --action allow --priority 200 --paused off --description "do not challenge login from office"
ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID --json '{"expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"", "action": "allow", "priority": 100, "paused": false, "description": "do not challenge login from office"}'

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

FIREWALL_RULE_ID

ファイアウォールルールのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ファイアウォールルールの削除 FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

EXPRESSION

フィルタ式。 例えば、ip.src eq 93.184.216.0 です。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ファイアウォールルール式を検証する。

ibmcloud cis firewall-rule-validate DNS_DOMAIN_ID "ip.src eq 93.184.216.0"

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--json

グローバルロードバランサーを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• JSONデータで必須のフィールドは、 name、 fallback_pool 、および default_pools です：
  • name: ロードバランサーに関連付けるDNSホスト名。
  • fallback_pool: 他のすべてのプールが正常でない状態であると検出された場合に使用するプールID。
  • default_pools: フェイルオーバーの優先順位順に並べられたプールIDの一覧。
• オプションのフィールドは、description、ttl、region_pools、proxied、enabled、session_affinity、 session_affinity_ttl、steering_policy です。
  • description: ロードバランサーの説明。
  • ttl: このロード・バランサーから返された IP アドレス用の DNS エントリーの存続時間 (TTL)。
  • region_pools: リージョンおよび国コードと、そのリージョンにおけるプールIDのリスト（フェイルオーバー優先度順）との対応関係。
  • proxied: CIS 上のセキュリティ機能およびパフォーマンス機能を通過するトラフィックの有無を制御します。
  • enabled: このロードバランサーを有効にするかどうか（デフォルトは有効）。
  • session_affinity セッション中、ユーザーのリクエストが一貫して同じバックエンドサーバーに向けられるようにします。 有効な値は cookie と none。
  • session_affinity_ttl: このロードバランサーのセッションアフィニティクッキーが作成されてから有効期限が切れるまでの時間（秒単位）。 有効な値は [1800, 604800] の範囲内です。 デフォルト値は82800です。
  • steering_policy : steering_policy の有効な値は、 off、 geo、 random、 dynamic_latency です。
    • off : default_pools`` を使用してください。
    • geo : region_pools/pop_pools`` を使用してください。
    • random: プールをランダムに選択してください。
    • dynamic_latency: 往復時間を基に、 default_pools で最も近いプールを選択します（プールのヘルスチェックが必要です）。

サンプル JSON データ:

{
      "name": "www.example.com",
      "fallback_pool": "17b5962d775c646f3f9725cbc7a53df4",
      "default_pools": [
         "17b5962d775c646f3f9725cbc7a53df4",
         "9290f38c5d07c2e2f4df57b1f61d4196"
      ],
      "description": "Example global load balancer.",
      "ttl": 60,
      "region_pools": {
         "WNAM": [
               "de90f38ced07c2e2f4df50b1f61d4194",
               "9290f38c5d07c2e2f4df57b1f61d4196"
         ],
         "ENAM": [
               "00920f38ce07c2e2f4df50b1f61d4194"
         ]
      }
}

-s, --json-str

非推奨。 グローバル・ロード・バランサーを記述する JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」にグローバルロードバランサーを作成します。

ibmcloud cis glb-create DNS_DOMAIN_ID --json '{"description":"Example global load balancer.","name":"www.example.com","ttl":60,"fallback_pool":"17b5962d775c646f3f9725cbc7a53df4","default_pools":["17b5962d775c646f3f9725cbc7a53df4","9290f38c5d07c2e2f4df57b1f61d4196"],"region_pools":{"WNAM":["de90f38ced07c2e2f4df50b1f61d4194","9290f38c5d07c2e2f4df57b1f61d4196"],"ENAM":["00920f38ce07c2e2f4df50b1f61d4194"]}}'

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

GLB_ID

グローバルロードバランサーのID。 必須。

--json

グローバルロードバランサーを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• JSON データで必須となるフィールドは、 name、 fallback_pool、および default_pools です：
  • name: ロードバランサーに関連付けるDNSホスト名。
  • fallback_pool: 他のすべてのプールが正常でない状態であると検出された場合に使用するプールID。
  • default_pools: フェイルオーバーの優先順位順に並べられたプールIDの一覧。
• オプションのフィールドは、description、ttl、region_pools、proxied、enabled、session_affinity、 session_affinity_ttl、steering_policy です。
  • description: ロードバランサーの説明。
  • ttl: このロードバランサーによって返されるIPアドレスに対応するDNSエントリの有効期間（TTL）。
  • region_pools: リージョンおよび国コードと、そのリージョンにおけるプールIDのリスト（フェイルオーバー優先度順）との対応関係。
  • proxied: CIS 上のセキュリティ機能およびパフォーマンス機能を経由してトラフィックを流す必要があるかどうかを制御します。
  • enabled: このロードバランサーを有効にするかどうか（デフォルトは有効）。
  • session_affinity セッション中、ユーザーのリクエストが一貫して同じバックエンドサーバーに向けられるようにします。 有効な値は cookie と none。
  • session_affinity_ttl: このロードバランサーのセッションアフィニティクッキーが作成されてから有効期限が切れるまでの時間（秒単位）。 有効な値は [1800, 604800] の範囲内です。 デフォルト値は82800です。
  • steering_policy : steering_policy の有効な値は、 off、 geo、 random、 dynamic_latency です。
    • off : default_pools`` を使用してください。
    • geo : region_pools/pop_pools`` を使用してください。
    • random: プールをランダムに選択してください。
    • dynamic_latency: 往復時間を基に、 default_pools で最も近いプールを選択します（プールのヘルスチェックが必要です）。

サンプル JSON データ:

{
      "name": "www.example.com",
      "fallback_pool": "17b5962d775c646f3f9725cbc7a53df4",
      "default_pools": [
         "17b5962d775c646f3f9725cbc7a53df4",
         "9290f38c5d07c2e2f4df57b1f61d4196"
      ],
      "description": "Example global load balancer.",
      "ttl": 60,
      "region_pools": {
         "WNAM": [
               "de90f38ced07c2e2f4df50b1f61d4194",
               "9290f38c5d07c2e2f4df57b1f61d4196"
         ],
         "ENAM": [
               "00920f38ce07c2e2f4df50b1f61d4194"
         ]
      }
}

-s, --json-str

非推奨。 グローバル・ロード・バランサーを記述する JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID のグローバルロードバランサー GLB_ID を更新する。

ibmcloud cis glb-update DNS_DOMAIN_ID GLB_ID --json '{"description":"Example global load balancer.","name":"www.example.com","ttl":60,"fallback_pool":"17b5962d775c646f3f9725cbc7a53df4","default_pools":["17b5962d775c646f3f9725cbc7a53df4","9290f38c5d07c2e2f4df57b1f61d4196"],"region_pools":{"WNAM":["de90f38ced07c2e2f4df50b1f61d4194","9290f38c5d07c2e2f4df57b1f61d4196"],"ENAM":["00920f38ce07c2e2f4df50b1f61d4194"]}}'

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

GLB_ID

グローバルロードバランサーのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID 内のグローバルロードバランサー GLB_ID を表示します。

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

GLB_ID

グローバルロードバランサーのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメイン DNS_DOMAIN_ID にあるグローバルロードバランサー GLB_ID を削除します。

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のロードバランサーを一覧表示してください。

ibmcloud cis glbs DNS_DOMAIN_ID

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力フォーマットを指定します。 JSON のみがサポートされます。

例

GLBプールをすべてリストアップする。

ibmcloud cis glb-pools

コマンド・オプション

--json

GLBプールを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• JSONデータで必須のフィールドは、 name、 origins 、および check_regions です：
  • name: プールの略称（タグ）。
  • origins: このプールに含まれる起源の一覧。
  • check_regions: 地理的地域コードの一覧。
• オプション・フィールドは、description、minimum_origins、enabled、monitor です。

サンプル JSON データ:

{
   "name": "us-pool",
   "description": "application server pool in US",
   "origins": [
      {
            "name": "us-app-dal01",
            "address": "1.1.1.1",
            "enabled": true,
            "header": {
               "host": ["test.com"]
            }
      },
      {
            "name": "us-app-dal02",
            "address": "2.2.2.2",
            "enabled": true,
            "header": {
               "host": ["example.com"]
            }
      }
   ],
   "minimum_origins": 1,
   "check_regions": [ "WNAM" ],
   "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
   "enabled": true
}

-s, --json-str

非推奨。 GLB プールを説明するために使用される JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

GLBプールを作る。

ibmcloud cis glb-pool-create --json '{"description":"application server pool in US", "name":"us-pool", "enabled":true, "check_regions":["WNAM"], "minimum_origins":1,"monitor":"f1aba936b94213e5b8dca0c0dbf1f9cc", "origins":[{"name":"us-app-dal01","address":"1.1.1.1","enabled":true,"header":{"host":["test.com"]}}, {"name":"us-app-dal02","address":"2.2.2.2","enabled":true,"header":{"host":["example.com"]}}]}'

コマンド・オプション

GLB_POOL_ID

グローバルロードバランサープールのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

GLBプール「 GLB_POOL_ID 」の詳細を表示します。

ibmcloud cis glb-pool GLB_POOL_ID

コマンド・オプション

GLB_POOL_ID

グローバルロードバランサープールのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

GLBプール「 GLB_POOL_ID 」を削除します。

ibmcloud cis glb-pool-delete GLB_POOL_ID

コマンド・オプション

GLB_POOL_ID

グローバルロードバランサープールのID。 必須。

--json

GLBプールを記述するために使用されるJSONファイルまたはJSON文字列。

• JSONデータで必須のフィールドは、 name、 origins 、および check_regions です：
  • name: プールの略称（タグ）。
  • origins: このプールに含まれる起源の一覧。
  • check_regions: 地理的地域コードの一覧。
• オプション・フィールドは、description、minimum_origins、enabled、monitor です。

サンプル JSON データ:

{
   "name": "us-pool",
   "description": "application server pool in US",
   "origins": [
      {
            "name": "us-app-dal01",
            "address": "1.1.1.1",
            "enabled": true,
            "header": {
               "host": ["example.com"]
            }
      },
      {
            "name": "us-app-dal02",
            "address": "2.2.2.2",
            "enabled": true
      }
   ],
   "minimum_origins": 1,
   "check_regions": [ "WNAM" ],
   "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
   "enabled": true
}

--enable-origin

プール内で起点を有効にします。 値には ORIGIN_NAME または ORIGIN_ADDRESS を指定できます。

--disable-origin

プール内で起点を無効にします。 値には ORIGIN_NAME または ORIGIN_ADDRESS を指定できます。

--add-origin

プールに起点を追加します。 ORIGIN_NAME と ORIGIN_ADDRESS は必須です。 例えば、 --add-origin name=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com

--remove-origin

プールから起点を削除します。 値には ORIGIN_NAME または ORIGIN_ADDRESS を指定できます。

-s, --json-str

非推奨。 GLB プールを説明するために使用される JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

GLB プール「 GLB_POOL_ID 」を更新します。

ibmcloud cis glb-pool-update GLB_POOL_ID --json '{"description":"application server pool in US", "name":"us-pool", "enabled":true, "check_regions":["WNAM"], "minimum_origins":1,"monitor":"f1aba936b94213e5b8dca0c0dbf1f9cc", "origins":[{"name":"us-app-dal01","address":"1.1.1.1","enabled":true,"header":{"host":["example.com"]}}, {"name":"us-app-dal02","address":"2.2.2.2","enabled":true}]}'

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

すべてのGLBモニターをリストアップする。

ibmcloud cis glb-monitors

コマンド・オプション

--json

GLBモニターを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• JSON データ内の必須フィールドは type です。
  • type: ヘルスチェックに使用するプロトコル。 有効な値は HTTP、 HTTPS、 TCP である。
• オプション・フィールドは、description、timeout、retries、interval です。
  • description: 説明。
  • timeout: ヘルスチェックを「失敗」と判定するまでのタイムアウト（秒単位）。
  • retries: タイムアウトが発生した場合、そのオリジンを「正常でない」状態としてマークする前に試行する再試行回数。
  • interval: 各ヘルスチェックの間隔。
• TCP タイプのヘルス・チェックの場合。 追加の必須フィールドは port です。
  • port: ヘルスチェックに使用する TCP ポート。
• HTTP/HTTPS タイプのヘルス・チェックの場合。 追加のオプション・フィールドは、 port、 expected_body、 expected_codes、 method、 path、 header、 follow_redirects、 allow_insecureです。
  • port: ヘルスチェックに使用する TCP ポート。
  • expected_body: レスポンス本文内で検索する、大文字小文字を区別しない部分文字列。
  • expected_codes: ヘルスチェックで期待される HTTP のレスポンスコードまたはコードの範囲。
  • method: ヘルスチェックに使用する HTTP メソッド。
  • path: ヘルスチェックの対象となるエンドポイントのパス。
  • header: ヘルスチェックで送信する HTTP リクエストヘッダー。
  • follow_redirects: オリジンからリダイレクトが返された場合は、そのリダイレクトに従う。
  • allow_insecure: モニターが HTTPS を使用している場合は、証明書の検証を行わないでください。
  • probe_zone: プローブ実行中に、このモニターを指定されたゾーンをエミュレートするように割り当てます。

サンプル JSON データ:

HTTP/HTTPS の場合:

{
      "description": "Health monitor of web service",
      "type": "https",
      "method": "GET",
      "path": "/health",
      "header": {
         "Host": [
            "example.com"
         ],
         "X-App-ID": [
            "abc123"
         ]
      },
      "timeout": 5,
      "retries": 2,
      "interval": 90,
      "follow_redirects": true,
      "allow_insecure": false,
      "expected_codes": "2xx",
      "expected_body": "alive",
      "probe_zone": "example.com"
}

TCP の場合:

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}

-s, --json-str

非推奨。 GLB モニターを説明するために使用される JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

GLBモニターを作る。

ibmcloud cis glb-monitor-create --json '{"type":"https", "description":"Health monitor of web service", "method":"GET", "path":"/health", "header":{"Host":["example.com"],"X-App-ID":["abc123"]}, "port":8080, "timeout":5, "retries":2, "interval":90, "expected_body":"alive", "expected_codes":"2xx", "follow_redirects":true, "allow_insecure":true}'

コマンド・オプション

GLB_MON_ID

グローバルロードバランサーモニターのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

GLBモニター「 GLB_MON_ID 」の詳細を表示します。

ibmcloud cis glb-monitor GLB_MON_ID

コマンド・オプション

GLB_MON_ID

グローバル・ロード・バランサー・モニターの ID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

GLBモニターを削除する GLB_MON_ID。

ibmcloud cis glb-monitor-delete GLB_MON_ID

コマンド・オプション

GLB_MON_ID

グローバルロードバランサーモニターのID。 必須。

--json

GLBモニターを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• JSON データ内の必須フィールドは type です。
  • type: ヘルスチェックに使用するプロトコル。 有効な値は HTTP、 HTTPS、 TCP である。
• オプション・フィールドは、description、timeout、retries、interval です。
  • description: 説明。
  • timeout: ヘルスチェックを「失敗」と判定するまでのタイムアウト（秒単位）。
  • retries: タイムアウトが発生した場合、そのオリジンを「正常でない」状態としてマークする前に試行する再試行回数。
  • interval: 各ヘルスチェックの間隔。
• TCP タイプのヘルス・チェックの場合。 追加の必須フィールドは port です。
  • port: ヘルスチェックに使用する TCP ポート。
• HTTP/HTTPS タイプのヘルス・チェックの場合。 追加のオプション・フィールドは、 port、 expected_body、 expected_codes、 method、 path、 header、 follow_redirects、 allow_insecureです。
  • port: ヘルスチェックに使用する TCP ポート。
  • expected_body: レスポンス本文内で検索する、大文字小文字を区別しない部分文字列。
  • expected_codes: ヘルスチェックで期待される HTTP のレスポンスコードまたはコードの範囲。
  • method: ヘルスチェックに使用する HTTP メソッド。
  • path: ヘルスチェックの対象となるエンドポイントのパス。
  • header: ヘルスチェックで送信する HTTP リクエストヘッダー。
  • follow_redirects: オリジンからリダイレクトが返された場合は、そのリダイレクトに従う。
  • allow_insecure: モニターが HTTPS を使用している場合は、証明書の検証を行わないでください。
  • probe_zone: プローブ実行中に、このモニターを指定されたゾーンをエミュレートするように割り当てます。

サンプル JSON データ:

HTTP/HTTPS の場合:

{
      "description": "Health monitor of web service",
      "type": "https",
      "method": "GET",
      "path": "/health",
      "header": {
         "Host": [
            "example.com"
         ],
         "X-App-ID": [
            "abc123"
         ]
      },
      "timeout": 5,
      "retries": 2,
      "interval": 90,
      "follow_redirects": true,
      "allow_insecure": false,
      "expected_codes": "2xx",
      "expected_body": "alive",
      "probe_zone": "example.com"
}

TCP の場合:

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}

-s, --json-str

非推奨。 GLB モニターを説明するために使用される JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

GLBモニターを更新してください GLB_MON_ID。

ibmcloud cis glb-monitor-update GLB_MON_ID --json '{"type":"https", "description":"Health monitor of web service", "method":"GET", "path":"/health", "header":{"Host":["example.com"],"X-App-ID":["abc123"]}, "port":8080, "timeout":5, "retries":2, "interval":90, "expected_body":"alive", "expected_codes":"2xx", "follow_redirects":true, "allow_insecure":true}'

コマンド・オプション

-s, --since

ISO8601 フォーマットでのデータ期間の開始日。 例: 2018-11-26。

-u, --until

ISO8601 フォーマットでのデータ期間の終了日。 例: 2018-11-28。

--origin-name

フィルター対象の起点の名前。

--pool-name

フィルター対象のプールの名前。

--origin-healthy

true の場合は、オリジンのステータスが「正常」であるイベントをフィルタリングし、false の場合は、オリジンのステータスが「異常」であるイベントをフィルタリングします。 デフォルト値は true であり、有効な値は true および false`` です。

--pool-healthy

true の場合は、プールのステータスが「正常」であるイベントをフィルタリングし、false の場合は、プールのステータスが「異常」であるイベントをフィルタリングします。 デフォルト値は true であり、有効な値は true および false`` です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

glbのイベントを取得します。

ibmcloud cis glb-events --since "2020-05-20" --until "2020-05-22" --origin-name "dal09" --origin-healthy true --instance INSTANCE

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--fields

戻り値として設定されるフィールドを定義してください。

• このフィールドは、空白を含まないカンマ区切りのリストとして指定する必要があり、すべてのフィールドが存在している必要があります。
• フィールドの指定順序は問題になりません。返答内でのフィールドの順序は指定されません。
• フィールドは大文字と小文字を区別する。

--filter

特定のイベントをドリルダウンするためのフィルター。 フィルターは、キー、演算子、値の3つの部分で構成される。 サポートされている演算子については 、「フィールド、関数、および式の使用」 を参照してください。

--sample

クライアントによって設定されたレコードのサンプリング率： sample ：1 は、レコードの 100% に相当します。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

-h, --help

このコマンドに関するヘルプを表示します。

例

ドメイン DNS_DOMAIN_ID のインスタントログを作成する：

ibmcloud cis instant-log-create DNS_DOMAIN_ID --fields all --sample 1

以下にフィルターの例を3つ挙げる：

• クライアントのIPの国がカナダ以外の場合にフィルタリングする：

"filter": "{\"where\":{\"and\":[{\"key\":\"ClientCountry\",\"operator\":\"neq\",\"value\":\"ca\"}]}}"

• CIS から返されたステータスコードが200または201の場合にフィルタリングする

"filter": "{\"where\":{\"and\":[{\"key\":\"EdgeResponseStatus\",\"operator\":\"in\",\"value\":\"200,201\"}]}}"

• リクエストパスに「/static」が含まれ、リクエストのホスト名が「 example.com 」の場合にフィルタリングする

"filter": "{\"where\":{\"and\":[{\"key\":\"ClientRequestPath\",\"operator\":\"contains\",\"value\":\"/static\"}, {\"where\":{\"and\":[{\"key\":\"ClientRequestHost\",\"operator\":\"eq\",\"value\":\"example.com\"}]}}"

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

-h, --help

このコマンドのヘルプ。

例

ドメイン DNS_DOMAIN_ID の即時ログ取得ジョブを取得します：

ibmcloud cis instant-log-get DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--available-fields

使用可能なすべてのフィールドのリスト。

--ray-id

特定のレイ ID でログを検索します。

--fields

戻り値として設定されるフィールドを定義してください。 このフィールドは、スペースを含まないカンマ区切りのリストとして指定する必要があり、すべてのフィールドが存在している必要があります。 フィールドの指定順序は問題になりません。返答内でのフィールドの順序は指定されません。 フィールドでは大/小文字が区別されることに注意してください。

--start

要求された時間フレームの開始時点 (その時刻を含む)。 これは UNIX タイム・スタンプ (秒またはナノ秒単位) または RFC 3339 に準拠する絶対タイム・スタンプにできます。 現在、過去7日を超える日付を設定することはできません。 デフォルトは 65 分前です。

--end

要求された時間フレームの終了時点 (その時刻を含まない)。 この値は、Unixタイムスタンプ（秒またはナノ秒単位）か、RFC 3339に準拠した絶対タイムスタンプのいずれかです。 end は少なくとも現在の 5 分前であり、start より後である必要があります。 start と end の差は、 1h を超えてはならない。 デフォルトでは5分早くなります。

--count

検索するログの数。 デフォルト値は -1です。

--sample

サンプリングのパーセント。 サンプルが指定されると、一致するレコードのサンプルが返されます。 sample=0.1 の場合、レコードの10%が返されます。 サンプリングはランダムに行われます。呼び出しを繰り返すと、返されるレコードが異なるだけでなく、返されるレコードの数にもわずかなばらつきが生じる可能性があります。 カウントも指定されている場合、カウントはサンプリングされたレコードではなく、返されるレコードの数に適用されます。 つまり、 sample=0.05 と count=7 の場合、利用可能なレコードが合計 100 件あるとき、約 5 件のレコードが返されます。 レコードが1000件ある場合、7件が返されます。 レコードが10,000件ある場合、7件が返されます。 デフォルト値は 1です。

--timestamps

応答タイム・スタンプが返される際の形式を設定します。 有効な値は、unix、unixnano、およびrfc3339です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ibmcloud cis logpull DNS_DOMAIN_ID --available-fields
ibmcloud cis logpull DNS_DOMAIN_ID --ray-id 59348abde87afe50 --all-fields --timestamps rfc3339 --output json
ibmcloud cis logpull DNS_DOMAIN_ID --start 2020-05-18T12:14:58Z --end 2020-05-18T13:14:58Z --fields ClientIP,EdgeServerIP,ClientRequestHost --count 10 --sample 1 --timestamps rfc3339 --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--destination

データのプッシュ先を指定する。 サポートされる宛先の詳細については、 Logpushジョブの管理を 参照してください。

• Cloud Object Storage のパスに関する構文： cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' 次に例を示します。 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' ログを日ごとのサブフォルダに分割するには、バケットパスに「 {DATE} 」という特別な文字列を使用してください。 これは、 YYYYMMDD 形式の日付（例：'20190423'）に置き換えられます。 必要に応じてサブフォルダが作成されます。例えば： 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'

--name

ジョブ名。 必須。

--enable

ジョブを有効にします。 デフォルトでは、ジョブは無効に設定されています。

--fields

ログ・ファイルに含めるログ・フィールドのリストを定義します。 複数のフィールドはコンマで区切ることができます。また、コマンド [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] を使用して利用可能なログフィールドの包括的なリストを取得するか、 all を使用して、利用可能なすべてのフィールドをログファイルに含めることができます。 フィールドでは大/小文字が区別されることに注意してください。

--timestamps

応答タイム・スタンプが返される際の形式を設定します。 有効な値は、unix、unixnano、およびrfc3339です。

--dataset

受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events, dns_logs です。デフォルト値は http_requests です。

--frequency

CIS がユーザーの宛先にログのバッチを送信する頻度。 周波数を高く設定すると、ログがより多くの小さなファイルに分割されて送信されます。 周波数を「低」に設定すると、ログは少量ずつ、より大きなファイルとして送信されます。 有効な値は、 high、 low です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID のlogpushジョブを作成する。

ibmcloud cis logpush-job-create DNS_DOMAIN_ID --destination cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX --name logpushcreate --enable true --fields all --timestamps rfc3339 --dataset http_requests --frequency low --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--destination

データのプッシュ先を指定する。 サポートされる宛先の詳細については、 Logpushジョブの管理を 参照してください。 Cloud Object Storage のパスに関する構文： cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> 次に例を示します。 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' ログを日付別のサブフォルダーに分けるには、バケット・パスで特殊ストリング {DATE} を使用します。 YYYYMMDD 形式の日付（例：'20190423'）に置き換えてください。 必要に応じてサブフォルダが作成されます。例えば： 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'

--enable

ジョブを有効にします。 デフォルトでは、ジョブは無効に設定されています。

--fields

ログ・ファイルに含めるログ・フィールドのリストを定義します。 複数のフィールドは、コンマで区切ることができます。使用可能なログ・フィールドの包括的なリストを取得するにはコマンド ibmcloud cis logpush-available-fields DNS_DOMAIN_ID を使用し、使用可能なすべてのフィールドをログ・ファイルに含めるには all を使用します。 フィールドでは大/小文字が区別されることに注意してください。

--timestamps

応答タイム・スタンプが返される際の形式を設定します。 有効な値は、 unix、 unixnano、 rfc3339 です。

--dataset

受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。

--jobid

JOB_IDはlogpushジョブのIDである。

--frequency

CIS がユーザーの宛先にログのバッチを送信する頻度。 周波数を高く設定すると、ログがより多くの小さなファイルに分割されて送信されます。 周波数を「低」に設定すると、ログは少量ずつ、より大きなファイルとして送信されます。 有効な値は high および low です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

DNS_DOMAIN_ID ドメインの range_events logpush ジョブを更新する。

ibmcloud cis logpush-job-update DNS_DOMAIN_ID --destination cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX --enable true --fields all --timestamps rfc3339 --dataset range_events --frequency high --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

-output

出力形式。 現在、 json が唯一サポートされている値です。

例

DNS_DOMAIN_ID ドメインのすべての logpush ジョブを取得します。

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--dataset

受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。

--jobid

JOB_IDはlogpushジョブのIDである。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

http_requests logpushジョブの詳細を取得する。

ibmcloud cis logpush-job DNS_DOMAIN_ID --dataset http_requests --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--dataset

受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。

--jobid

JOB_IDはlogpushジョブのIDである。

-f, --force

確認のメッセージを表示せずに、logpushジョブを削除します。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

DNS_DOMAIN_ID ドメインの http_requests logpush ジョブを削除する。

ibmcloud cis logpush-job-delete DNS_DOMAIN_ID --dataset http_requests --force

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--dataset

受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

http_requests ログの使用可能なすべてのフィールドを取得します。

ibmcloud cis logpush-available-fields DNS_DOMAIN_ID --dataset http_requests

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のログ保存期間の設定を取得してください。

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--flag

ログの保持を有効にするか無効にするか。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のログ保持を有効にします。

ibmcloud cis log-retention-update DNS_DOMAIN_ID --flag on --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--dataset

要求されたデータ・セット。 デフォルト値は firewallEventsAdaptiveGroupsです。

次の表で、プランに含まれるデータ・セットと、照会可能な履歴データの範囲を確認してください。

プランに含まれるデータセット

データ・セット	トライアル / スタンダード / スタンダード-ネクスト	エンタープライズ / セキュリティー / GLB
firewallEventsAdaptiveGroups	30 日間	30 日間
firewallEventsAdaptive	30 日間	30 日間

--filter

イベントをフィルターします。 デフォルト値は直近 6 時間のデータです。

次の演算子はすべてのフィルター・オプションでサポートされています。

フィルタオプションでサポートされている演算子

オペレーター	比較
gt	次より大きい
リトアニア	より小さい
GEQ	以上
leq	以下
ネク	等しくない
in	in

• firewallEventsAdaptiveGroups filter options.
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFiveMinutes
  • datetimeMinute
  • matchIndex
  • sampleInterval
• The following filter options support like and notlike operators.
  • action
  • clientASNDescription
  • clientAsn
  • clientCountryName
  • clientIP
  • clientRefererHost
  • clientRefererPath
  • clientRefererQuery
  • clientRefererScheme
  • clientRequestHTTPHost
  • clientRequestHTTPMethodName
  • clientRequestHTTPProtocol
  • clientRequestPath
  • clientRequestQuery
  • clientRequestScheme
  • edgeColoName
  • edgeResponseStatus
  • kind
  • originResponseStatus
  • originatorRayName
  • rayName
  • ref
  • ruleId
  • source
  • userAgent

--order

出力順。 （デフォルト値は datetime_ASC です）

以下のリストは、対応するデータ・セットの使用可能な順序オプションであり、すべての順序オプションは ASC および DESC アクションをサポートします。 これらのフィルター・オプションとアクションを _ で組み合わせてください。

たとえば、 datetime_ASC は、datetime 順に昇順で並べ替えます。

• firewallEventsAdaptiveGroups 順序オプション。
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFiveMinutes
  • datetimeMinute
  • action
  • avg_sampleInterval
  • clientASNDescription
  • clientAsn
  • clientCountryName
  • clientIPClass
  • clientIP
  • clientRefererHost
  • clientRefererPath
  • clientRefererQuery
  • clientRefererScheme
  • clientRequestHTTPHost
  • clientRequestHTTPMethodName
  • clientRequestHTTPProtocol
  • clientRequestPath
  • clientRequestQuery
  • clientRequestScheme
  • count
  • edgeColoName
  • edgeResponseStatus
  • kind
  • matchIndex
  • originResponseStatus
  • originatorRayName
  • rayName
  • ref
  • ruleId
  • sampleInterval
  • source
  • userAgent
  • visibility

--limit

返すイベントの数。（最小： 1、最大： 10000、デフォルト： 10000 ）

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のファイアウォールイベント分析を取得します。

ibmcloud cis firewall-event-analytics DNS_DOMAIN_ID --order datetime_ASC --filter "datetime_geq:2020-06-28T00:00:00Z" --filter "datetime_leq:2020-06-29T00:00:00Z" --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--dataset

要求されたデータ・セット。 デフォルト値は httpRequests1dGroupsです。 次の表で、プランに含まれるデータ・セットと、照会可能な履歴データの範囲を確認してください。

プランに含まれるデータセットを特定する

データ・セット	トライアル / スタンダード / スタンダードネクスト	エンタープライズ / セキュリティー / GLB
httpRequests1dGroups	365 日間	365 日間
httpRequests1hGroups	30 日間	90 日間
httpRequests1mGroups	3 日	7 日間

--filter

イベントをフィルターします。 デフォルト値は直近 7 日間のデータです。 次の演算子はすべてのフィルター・オプションでサポートされています。

フィルタオプションでサポートされている演算子

オペレーター	比較
gt	次より大きい
リトアニア	より小さい
GEQ	以上
leq	以下
ネク	等しくない
in	in

• httpRequests1dGroups および httpRequests1hGroups フィルター・オプション。

  • date

• httpRequests1mGroups フィルター・オプション。

  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--order

出力順。 （デフォルト値は datetime_ASC です）

以下のリストは、対応するデータ・セットの使用可能な順序オプションであり、すべての順序オプションは ASC および DESC アクションをサポートします。 これらの順序オプションとアクションを _ で組み合わせてください。

たとえば、 date_ASC は日付の昇順で並べ替えます。

• 日常の http データ・セットに共通の順序オプション。
  • orderByParams
  • date
  • sum_bytes
  • sum_cachedBytes
  • sum_cachedRequests
  • sum_requests
• httpRequests1dGroups 順序オプション。
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
• httpRequests1hGroups 順序オプション。
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
• httpRequests1mGroups 順序オプション。
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--limit

返すイベントの数。（最小： 1、最大： 10000、デフォルト： 10000 ）

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のHTTPリクエスト分析を取得します。

ibmcloud cis http-request-analytics DNS_DOMAIN_ID --order date_ASC --dataset httpRequests1dGroups --limit 500 --filter "date_geq:2020-06-28" --filter "date_leq:2020-06-29" --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--recent

要求された時間フレームの開始時点。 有効な値は、 6h （6時間前）、 12h、 1d （1日前）、 1w （1週間前）、 1m （1ヶ月前）、 2m、 3m です。デフォルト値は 1w です。

-t, --table

出力テーブル。 有効な値は、 requests、 bandwidth、 uniques、 threats 、および status_code です。 このフィールドが設定されていない場合は、すべてのテーブルを出力する。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のウェブ解析データを確認する。

ibmcloud cis web-analytics DNS_DOMAIN_ID --recent 1d -t requests

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

DIMENSION

問い合わせられたディメンション。 有効な値は queries-by-response-code, queries-by-type, queries-by-name。必須。

-s, --since

現在からどのくらい前か。 有効な値は、 6h （6時間前）、 12h、 1d （1日前）、 1w （1週間前）です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のDNS分析情報を取得します。

ibmcloud cis dns-analytics DNS_DOMAIN_ID queries-by-response-code -s 6h --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--recent

要求された時間フレームの開始時点。 有効な値は、 6h （6時間前）、 12h、 1d （1日前）、 1w （1週間前）、 1m （1ヶ月前）、 2m、 3m です。デフォルト値は 1w です。

--time-delta

各アナリティクスのレコードの時間間隔 (秒単位)。 有効な値は 60, 3600, 86400, 2592000 です。デフォルト値は 3600 です。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のレート制限に関する分析情報を取得します。

ibmcloud cis ratelimit-analytics DNS_DOMAIN_ID --recent 6h --time-delta 3600 --output json

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

相互 TLS を有効にする。

ibmcloud cis access-enable

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID に関するすべてのオリジン証明書を一覧表示します。

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--request-type REQUEST_TYPE

証明書に記載する署名タイプ。 有効な値は origin-rsa および origin-ecc です。

--hostnames HOSTNAME

証明書にバインドされるホスト名またはワイルドカード名。

--requested-validity DAYS

証明書の有効期間（日数）。 デフォルト値は 5475です。

--csr CSR

証明書署名要求 (CSR)。 このフィールドが設定されていない場合、 CIS。

--json value*

オリジン証明書を記述するために使用されるJSONファイルまたはJSON文字列。

• JSON データ内の必須フィールドは request_type、hostnames です。
  • request_type 証明書に記載する署名タイプ。 有効な値は、 origin-rsa、 origin-ecc です。
  • hostnames: 証明書に紐付けられているホスト名またはワイルドカード名の配列。
• オプション・フィールドは、requested_validity、csr です。
  • requested_validity: 証明書の有効期間（日数）。 有効な値は、 0、 7、 30、 90、 365、 730、 1095、 5475 です。
  • csr: 証明書署名要求（CSR）。 このフィールドが設定されていない場合、 CIS。

サンプル JSON データ:

{
   "request_type": "origin-rsa",
   "hostnames": [
      "*.example.com",
      "example.com",
],
   "requested_validity": 5475,
   "csr": "your_csr"
}

-s, --json-str

非推奨。 オリジン証明書を記述するJSONデータ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン DNS_DOMAIN_ID 用の、 CIS で署名された証明書を作成します。

ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --request-type origin-rsa --hostnames "*.example.com" --hostnames "example.com" --requested-validity 5475 --csr your_csr --output json
ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --json '{"hostnames":["example.com","*.example.com"], "requested_validity":5475,"request_type": "origin-rsa","csr":"-----BEGIN CERTIFICATE REQUEST-----\nMIICxzCCAa8CAQAwSDELMAkGA1UEBhMCVVMxFjAUBgNVBAgTDVNhbiBGcmFuY2lz\nY28xCzAJBgNVBAcTAkNBMRQwEgYDVQQDEwtleGFtcGxlLm5ldDCCASIwDQYJKoZI\nhvcNAQEBBQADggEPADCCAQoCggEBALxejtu4b+jPdFeFi6OUsye8TYJQBm3WfCvL\nHu5EvijMO/4Z2TImwASbwUF7Ir8OLgH+mGlQZeqyNvGoSOMEaZVXcYfpR1hlVak8\n4GGVr+04IGfOCqaBokaBFIwzclGZbzKmLGwIQioNxGfqFm6RGYGA3be2Je2iseBc\nN8GV1wYmvYE0RR+yWweJCTJ157exyRzu7sVxaEW9F87zBQLyOnwXc64rflXslRqi\ng7F7w5IaQYOl8yvmk/jEPCAha7fkiUfEpj4N12+oPRiMvleJF98chxjD4MH39c5I\nuOslULhrWunfh7GB1jwWNA9y44H0snrf+xvoy2TcHmxvma9Eln8CAwEAAaA6MDgG\nCSqGSIb3DQEJDjErMCkwJwYDVR0RBCAwHoILZXhhbXBsZS5uZXSCD3d3dy5leGFt\ncGxlLm5ldDANBgkqhkiG9w0BAQsFAAOCAQEAcBaX6dOnI8ncARrI9ZSF2AJX+8mx\npTHY2+Y2C0VvrVDGMtbBRH8R9yMbqWtlxeeNGf//LeMkSKSFa4kbpdx226lfui8/\nauRDBTJGx2R1ccUxmLZXx4my0W5iIMxunu+kez+BDlu7bTT2io0uXMRHue4i6quH\nyc5ibxvbJMjR7dqbcanVE10/34oprzXQsJ/VmSuZNXtjbtSKDlmcpw6To/eeAJ+J\nhXykcUihvHyG4A1m2R6qpANBjnA0pHexfwM/SgfzvpbvUg0T1ubmer8BgTwCKIWs\ndcWYTthM51JIqRBfNqy4QcBnX+GY05yltEEswQI55wdiS3CjTTA67sdbcQ==\n-----END CERTIFICATE REQUEST-----"}' --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

CERT_ID

原産地証明書のID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

原産地証明書の詳細については、 CERT_ID をご覧ください。

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

CERT_ID

原産地証明書のID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

CERT_ID の発行元証明書を削除します。

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」の概要情報を表示します。

ibmcloud cis overview DNS_DOMAIN_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--json

ページルールを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• JSONデータにおける必須項目は、targets、actions です：
  • targets: リクエストに対して評価する対象の URL パターン。
  • actions: このルールの対象がリクエストと一致した場合に実行される一連のアクション。 以下のアクションが使用可能です。
    • disable_security
    • always_use_https
    • ssl
    • browser_cache_ttl
    • security_level
    • cache_level
    • edge_cache_ttl
    • bypass_cache_on_cookie
    • browser_check
    • server_side_exclude
    • email_obfuscation
    • automatic_https_rewrites
    • opportunistic_encryption
    • ip_geolocation
    • explicit_cache_control
    • cache_deception_armor
    • waf
    • forwarding_url
    • 非推奨。 image_load_optimization.
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • 一部の機能はエンタープライズプランでのみ利用可能です：
      • cache_on_cookie
      • disable_apps
      • disable_performance
      • minify
      • origin_error_page_pass_thru
      • response_buffering
      • true_client_ip_header
      • sort_query_string_for_cache
      • respect_strong_etag
• オプションのフィールドは、 priority および status です：
  • priority: あるページルールを別のページルールよりも優先する度合いを示す数値。 デフォルト値は1です。
  • status: ページルールのステータス。 有効な値は、 active および disabled （デフォルト）です。

サンプル JSON データ:

   {
   "targets": [
      {
            "target": "url",
            "constraint": {
               "operator": "matches",
               "value": "*example.com/images/*"
            }
      }
   ],
   "actions": [
      {
            "id": "ssl",
            "value": "flexible"
      },
      {
            "id": "browser_cache_ttl",
            "value": 14400
      },
      {
            "id": "security_level",
            "value": "medium"
      },
      {
            "id": "cache_level",
            "value": "basic"
      },
      {
            "id": "edge_cache_ttl",
            "value": 7200
      },
      {
            "id": "bypass_cache_on_cookie",
            "value": "wp-.*|wordpress.*|comment_.*"
      }
   ]
}

-s, --json-str

非推奨。 ページ・ルールを記述する JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」のページルールを作成します。

ibmcloud cis page-rule-create DNS_DOMAIN_ID --json '{"targets":[{"target":"url", "constraint":{"operator": "matches", "value":"*example.com/images/*"}}], "actions":[{"id":"always_online", "value":"on"}], "priority":1, "status": "active"}' --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

PAGE_RULE_ID

ページルールのID。 必須。

--json VALUE

ページルールを記述するために使用されるJSONファイルまたはJSON文字列。 必須。

• JSON データで必須のフィールドは、 targets および actions です：
  • targets: リクエストに対して評価する対象の URL パターン。
  • actions: このルールの対象がリクエストと一致した場合に実行される一連のアクション。 以下のアクションが使用可能です。
    • disable_security
    • always_use_https
    • ssl
    • browser_cache_ttl
    • security_level
    • cache_level
    • edge_cache_ttl
    • bypass_cache_on_cookie
    • browser_check
    • server_side_exclude
    • email_obfuscation
    • automatic_https_rewrites
    • opportunistic_encryption
    • ip_geolocation
    • explicit_cache_control
    • cache_deception_armor
    • waf
    • forwarding_url
    • 非推奨。 image_load_optimization
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • 一部の機能はエンタープライズプランでのみ利用可能です：
      • cache_on_cookie
      • disable_apps
      • disable_performance
      • minify
      • origin_error_page_pass_thru
      • response_buffering
      • true_client_ip_header
      • sort_query_string_for_cache
      • respect_strong_etag
• オプションのフィールドは、 priority および status です：
  • priority: あるページルールを別のページルールよりも優先する度合いを示す数値。 デフォルト値は1です。
  • status: ページルールのステータス。 有効な値は active と disabled。 デフォルト値は disabledです。

サンプル JSON データ:

{
   "targets": [
      {
            "target": "url",
            "constraint": {
               "operator": "matches",
               "value": "*example.com/images/*"
            }
      }
   ],
   "actions": [
      {
            "id": "ssl",
            "value": "flexible"
      },
      {
            "id": "browser_cache_ttl",
            "value": 14400
      },
      {
            "id": "security_level",
            "value": "medium"
      },
      {
            "id": "cache_level",
            "value": "basic"
      },
      {
            "id": "edge_cache_ttl",
            "value": 7200
      },
      {
            "id": "bypass_cache_on_cookie",
            "value": "wp-.*|wordpress.*|comment_.*"
      }
   ]
}

-s, --json-str

非推奨。 ページ・ルールを記述する JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ページルール「 PAGE_RULE_ID 」を更新します。

ibmcloud cis page-rule-update DNS_DOMAIN_ID PAGE_RULE_ID --json '{"targets":[{"target":"url", "constraint":{"operator":"matches", "value":"*example.com/images/*"}}], "actions":[{"id":"always_online", "value":"on"}],"priority":1, "status":"active"}' --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

PAGE_RULE_ID

ページルールのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ページルール「 PAGE_RULE_ID 」を削除します。

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ドメイン「 DNS_DOMAIN_ID 」内のすべてのページルールを一覧表示します。

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

PAGE_RULE_ID

ページルールのID。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

ページルール「 PAGE_RULE_ID 」の詳細を確認する。

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--name

範囲アプリケーションのDNSレコード名。

--edge-port

CIS のエッジでのポート構成。 デフォルト値は 22です。

--origin-direct

起点への宛先アドレス。

--origin-lb-name

「range」アプリケーションに関連付けられているロードバランサーの名前。

--origin-lb-port

「range」アプリケーションに関連付けられたロードバランサーのポート。 デフォルト値は 22です。

--protocol

プロトコル・タイプ。 有効な値は tcp および udp です。 UDP プロトコル・サポートは早期アクセスに含まれます。Range UDP アプリを作成する前にカスタム UDP を CIS ダッシュボードから要求してください。 デフォルト値はtcpです。

--proxy-protocol

起点への Proxy Protocol を有効にします。 有効な値は on, off, v1, v2, simple。デフォルト値は off です。 非推奨。 値 on は v1 と同等です。

--ip-firewall

このアプリケーションのIPファイアウォールを有効にするかどうかを制御します。 有効な値は on および off です。 デフォルト値はoffです。

--edge-connectivity

任意のアニキャストIPアドレス範囲におけるインバウンド接続でサポートされるIPバージョン。 有効な値は all, ipv4, ipv6 です。デフォルト値は all です。

--edge-tls

アプリケーションに関連付けられた TLS 終端のタイプ。 有効な値は off, flexible, full, strict です。デフォルト値は off です。

--traffic-type

データをエッジから起点に移動する方法を決定します。 有効な値は direct, http, https です。デフォルト値は direct です。

--json

範囲アプリケーションを記述するために使用されるJSONファイルまたはJSON文字列。

• JSONデータで必須のフィールドは、 protocol および dns です。
  • protocol: CIS のエッジにおけるポート設定。
  • dns: 範囲申請に関するDNSレコードの名前と種類。
    • name: 範囲申請に関するDNSレコードの名前。
    • type: アプリケーションに関連付けられたDNSレコードのタイプ。 有効な値は「 CNAME 」です。
• オプションのフィールドは、 origin_direct、 origin_dns、 origin_port、 proxy_protocol、 ip_firewall、 edge_ips、 tls、および traffic_type です。
  • origin_direct: 送信元への宛先アドレスの一覧。
  • origin_dns: DNS を通じてオリジンサーバーのアドレスを特定するために使用される方法とパラメータ。
    • name: DNSレコード名。
  • origin_port: 発送元の宛先港。
  • proxy_protocol: オリジンへのプロキシプロトコルを有効にします。 有効な値は on, off, v1, v2, simple。デフォルト値は off です。 非推奨. 値 on は v1 と同等です。
  • ip_firewall このアプリケーションのIPファイアウォールを有効にするかどうかを制御します。 有効な値は on と off。
  • edge_ips: このアプリケーションのホスト名に対するエニーキャスト・エッジ IP の設定。
    • type: 指定されたエッジIP設定の種類。 動的に割り当てられたエッジ IP は、指定した接続に従って、range エニーキャスト IP を使用します。 有効な値は「 dynamic 」です。
    • connectivity: 任意のアニキャストIPアドレス範囲における着信接続でサポートされるIPバージョン。 有効な値は、all、ipv4、ipv6 です。
  • tls: アプリケーションに関連付けられた TLS 終端のタイプ。 有効な値は、 off、 flexible、 full、および strict です。
  • traffic_type: データがエッジからオリジンへどのように転送されるかを決定します。 direct に設定すると、rangeはトラフィックをオリジンに直接送信し、アプリケーションのタイプはプロトコルから判別されます。 http または https に設定すると、range はトラフィックをオリジンに送信する際に、 CIS の HTTP / HTTPS の機能を採用し、アプリケーションタイプはこのプロパティと完全に一致します。 有効な値は、 direct、 http、および https です。 デフォルト値はdirectです。

サンプル JSON データ:

{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "ssh.example.com"
   },
   "origin_direct": [
      "tcp://1.2.3.4:22",
      "tcp://1.2.3.4:23",
      "tcp://1.2.3.4:24"
   ],
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}
{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "glb.example.com"
   },
   "origin_dns": {
      "name": "name-to-glb.example.com"
   },
   "origin_port": 22,
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}

-s, --json-str

非推奨。 範囲アプリケーションを記述する JSON データ。

-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 json が唯一サポートされている値です。

例

DNS_DOMAIN_ID ドメインの範囲アプリを作成する。

ibmcloud cis range-app-create DNS_DOMAIN_ID --json '{"protocol":"tcp/22", "dns":{"type":"CNAME","name":"ssh.example.com"}, "origin_direct":["tcp://1.2.3.4:22"], "proxy_protocol":"off", "ip_firewall":true, "tls":"full", "edge_ips":{"type":"dynamic", "connectivity":"all"}, "traffic_type":"direct"}'