Oracle Cloud Infrastructure Compute ClassicのREST API

セキュリティ・ルールの作成

post

/secrule/

必要なロール: このタスクを実行するには、Compute_Operationsのロールが必要です。このロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 Oracle Cloudの管理および監視のユーザー・ロールの変更に関する項を参照してください。

リクエスト

サポートされるメディア・タイプ

application/oracle-compute-v3+json

ヘッダー・パラメータ

Cookie: string

Cookie:ヘッダーは、サービスに対するすべてのリクエストに含まれる必要があります。それをPOST /authenticate/コールに対して受信されたレスポンス内のset-cookieヘッダーの値に設定してください。

リクエスト本文には、作成するセキュリティ・ルールの詳細が含まれます。

ルート・スキーマ : SecRule-post-request

型: object

リクエスト本文には、作成するセキュリティ・ルールの詳細が含まれます。

ソースの表示

action: string

このパラメータをPERMITに設定します。
application: string

セキュリティ・アプリケーションの、3つの部分からなる名前: ユーザー定義のセキュリティ・アプリケーションの場合は(/Compute-identity_domain/user/object_name)、事前定義済のセキュリティ・アプリケーションの場合は/oracle/public/object_name。
description(optional): string

セキュリティ・ルールの説明。
disabled(optional): boolean

セキュリティ・ルールが有効(falseに設定)または無効(true)のどちらであるかを示します。デフォルト設定はfalseです。
dst_list: string

宛先セキュリティ・リストまたはセキュリティIPリストの、3つの部分からなる名前(/Compute-identity_domain/user/object_name)。
リストのタイプを特定するための接頭辞としてseclist:またはseciplist:を使用する必要があります。
注意: src_listが、アウトバウンド・ポリシーDENYのセキュリティ・リストの場合、セキュリティIPリストを、secruleの宛先として指定できます。
/oracle/publicコンテナ内のセキュリティIPリストのいずれかをsecruleの宛先として指定することはできません。
name: string

オブジェクトの、3つの部分からなる名前(/Compute-identity_domain/user/object)。
オブジェクト名には、英数字、アンダースコア(_)およびハイフン(-)のみを含めることができます。オブジェクト名は大文字と小文字が区別されます。
src_list: string

ソース・セキュリティ・リストまたはセキュリティIPリストの、3つの部分からなる名前(/Compute-identity_domain/user/object_name)。
リストのタイプを特定するための接頭辞としてseclist:またはseciplist:を使用する必要があります。

{
    "required":[
        "action",
        "application",
        "dst_list",
        "name",
        "src_list"
    ],
    "description":"The request body contains details of the security rule that you want to create. ",
    "properties":{
        "action":{
            "type":"string",
            "description":"<p>Set this parameter to <code>PERMIT</code>."
        },
        "application":{
            "type":"string",
            "description":"<p>The three-part name of the security application: (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object_name</em></code>) for user-defined security applications and <code>/oracle/public/<em>object_name</em></code> for predefined security applications."
        },
        "description":{
            "type":"string",
            "description":"<p>A description of the security rule."
        },
        "disabled":{
            "type":"boolean",
            "description":"<p>Indicates whether the security rule is enabled (set to <code>false</code>) or disabled (<code>true</code>). The default setting is <code>false</code>."
        },
        "dst_list":{
            "type":"string",
            "description":"<p>The three-part name (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object_name</em></code>) of the destination security list or security IP list.<p>You must use the prefix <code>seclist</code>: or <code>seciplist</code>: to identify the list type.<p><b>Note:</b> You can specify a security IP list as the destination in a secrule, provided <code>src_list</code> is a security list that has DENY as its outbound policy.<p>You cannot specify any of the security IP lists in the <code>/oracle/public</code> container as a destination in a secrule."
        },
        "name":{
            "type":"string",
            "description":"<p>The three-part name of the object (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>).<p>Object names can contain only alphanumeric characters, hyphens, underscores, and periods. Object names are case-sensitive."
        },
        "src_list":{
            "type":"string",
            "description":"<p>The three-part name (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object_name</em></code>) of the source security list or security IP list.<p>You must use the prefix <code>seclist</code>: or <code>seciplist</code>: to identify the list type."
        }
    }
}

トップに戻る

レスポンス

サポートされるメディア・タイプ

application/oracle-compute-v3+json

201レスポンス

作成されました。返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

ヘッダー

set-cookie: string

セッションが拡張された場合、Cookie値が返されます。

ルート・スキーマ : SecRule-response

型: object

ソースの表示

action(optional): string

このパラメータをPERMITに設定します。
application(optional): string

セキュリティ・アプリケーションの、3つの部分からなる名前: ユーザー定義のセキュリティ・アプリケーションの場合は(/Compute-identity_domain/user/object_name)、事前定義済のセキュリティ・アプリケーションの場合は/oracle/public/object_name。
description(optional): string

セキュリティ・ルールの説明。
disabled(optional): boolean

セキュリティ・ルールが有効(falseに設定)または無効(true)のどちらであるかを示します。デフォルト設定はfalseです。
dst_list(optional): string

宛先セキュリティ・リストまたはセキュリティIPリストの、3つの部分からなる名前(/Compute-identity_domain/user/object_name)。
リストのタイプを特定するための接頭辞としてseclist:またはseciplist:を使用する必要があります。
注意: src_listが、アウトバウンド・ポリシーDENYのセキュリティ・リストの場合、セキュリティIPリストを、secruleの宛先として指定できます。
/oracle/publicコンテナ内のセキュリティIPリストのいずれかをsecruleの宛先として指定することはできません。
name(optional): string

オブジェクトの、3つの部分からなる名前(/Compute-identity_domain/user/object)。
src_list(optional): string

ソース・セキュリティ・リストまたはセキュリティIPリストの、3つの部分からなる名前(/Compute-identity_domain/user/object_name)。
リストのタイプを特定するための接頭辞としてseclist:またはseciplist:を使用する必要があります。
uri(optional): string

Uniform Resource Identifier

{
    "properties":{
        "action":{
            "type":"string",
            "description":"<p>Set this parameter to <code>PERMIT</code>."
        },
        "application":{
            "type":"string",
            "description":"<p>The three-part name of the security application: (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object_name</em></code>) for user-defined security applications and <code>/oracle/public/<em>object_name</em></code> for predefined security applications."
        },
        "description":{
            "type":"string",
            "description":"<p>A description of the security rule."
        },
        "disabled":{
            "type":"boolean",
            "description":"<p>Indicates whether the security rule is enabled (set to <code>false</code>) or disabled (<code>true</code>). The default setting is <code>false</code>."
        },
        "dst_list":{
            "type":"string",
            "description":"<p>The three-part name (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object_name</em></code>) of the destination security list or security IP list.<p>You must use the prefix <code>seclist</code>: or <code>seciplist</code>: to identify the list type.<p><b>Note:</b> You can specify a security IP list as the destination in a secrule, provided <code>src_list</code> is a security list that has DENY as its outbound policy.<p>You cannot specify any of the security IP lists in the <code>/oracle/public</code> container as a destination in a secrule."
        },
        "name":{
            "type":"string",
            "description":"The three-part name of the object (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>)."
        },
        "src_list":{
            "type":"string",
            "description":"<p>The three-part name (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object_name</em></code>) of the source security list or security IP list.<p>You must use the prefix <code>seclist</code>: or <code>seciplist</code>: to identify the list type."
        },
        "uri":{
            "type":"string",
            "description":"Uniform Resource Identifier"
        }
    }
}

トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、セキュリティ・ルールを追加する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを1行で入力します。この例では、読みやすくするために改行が使用されています。

curl -i -X POST
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Content-Type: application/oracle-compute-v3+json"
     -H "Accept: application/oracle-compute-v3+json"
     -d "@requestbody.json"
        https://api-z999.compute.us0.oraclecloud.com/secrule/

COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。認証クッキーの取得および変数への格納の詳細は、認証を参照してください。
api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。サイトのRESTエンドポイントURLを見つける方法については、「リクエストの送信」を参照してください。

リクエスト本文の例

次は、requestbody.jsonファイルのリクエスト本文のコンテンツの例です。

{
  "dst_list": "seclist:/Compute-acme/jack.jones@example.com/allowed_video_servers",
  "name": "/Compute-acme/jack.jones@example.com/es_to_videoservers_stream",
  "src_list": "seciplist:/Compute-acme/jack.jones@example.com/es_iplist",
  "application": "/Compute-acme/jack.jones@example.com/video_streaming_udp",
  "action": "PERMIT"
}

レスポンス本文の例

次の例は、レスポンス本文をJSON形式で示しています。

{
  "dst_list": "seclist:/Compute-acme/jack.jones@example.com/allowed_video_servers",
  "name": "/Compute-acme/jack.jones@example.com/es_to_videoservers_stream",
  "src_list": "seciplist:/Compute-acme/jack.jones@example.com/es_iplist",
  "uri": "https://api-z999.compute.us0.oraclecloud.com/secrule/Compute-acme/jack.jones@example.com/es_to_videoservers_stream",
  "disabled": false,
  "application": "/Compute-acme/jack.jones@example.com/video_streaming_udp",
  "action": "PERMIT"
}

トップに戻る