Oracle Cloud Infrastructureドキュメント

プライベート・エンドポイントの作成

OCI生成AIのホスティング専用AIクラスタで、カスタム・モデルまたは事前トレーニング済モデルのプライベート・エンドポイントを作成します。

ノート

プライベート・エンドポイントを作成する前に、プライベート・エンドポイントの前提条件を実行し、次の詳細を示します:

  • Virtual Cloud Networkの名前(VCN)
  • VCN内のプライベート・サブネットの名前

デフォルトでは、テナンシのプライベート・エンドポイントの最大制限は5です。生成AIプライベート・エンドポイントを増やすには、制限の引上げをリクエストし、生成AIサービスのprivate-endpoint-countをリクエストします。

  • 「プライベート・エンドポイント」リスト・ページで、「プライベート・エンドポイントの作成」を選択します。リスト・ページの検索に関するヘルプが必要な場合は、プライベート・エンドポイントのリストを参照してください。

    一般情報

    1. プライベート・エンドポイントを作成するコンパートメントを選択します。デフォルト・コンパートメントはリスト・ページと同じですが、作業する権限がある任意のコンパートメントを選択できます。
      プライベート・エンドポイントは、このエンドポイントを使用するモデルと同じコンパートメントに作成することをお薦めします。
    2. (オプション)エンドポイントの名前を入力します。名前は文字またはアンダースコアで開始し、その後に文字、数字、ハイフンまたはアンダースコアが続きます。長さは1 - 255文字です。名前を入力しないと、後で変更できる名前が生成されます。
      生成された名前の形式はgenerativeaiprivateendpoint<timestamp>です。例: generativeaiprivateendpoint20250929212918
    3. (オプション)モデルの説明を入力します。

    VCNとサブネット

    次の情報を選択します。

    • VCNコンパートメント
    • VCN
    • プライベート・サブネット・コンパートメント
    • プライベート・サブネット

    DNSおよびネットワーク・セキュリティ・グループ

    1. FQDNのドメイン・ネームスペース(DNS)接頭辞を入力します。
      プレビューには、このDNS接頭辞が付いたFQDNが表示されます。完全修飾ドメイン名は、ネットワーク・リソースの完全な一意名であり、特定のIPアドレスに解決されます。たとえば、 
      <DNS-prefix>.pe.inference.generativeai.us-chicago-1.oci.oraclecloud.com
    2. (オプション)追加するグループごとに「ネットワーク・セキュリティ・グループの追加」を選択して、1つ以上のネットワーク・セキュリティ・グループを追加するかどうかを選択します。
      セキュリティ・ルールについて学習します。
    3. (オプション)(オプション)ネットワーク・セキュリティ・グループを選択します。
    4. (オプション)ネットワーク・セキュリティ・グループを追加します。
    5. (オプション)「タグの追加」を選択し、このプライベート・エンドポイントにタグを割り当てます。リソース・タグを参照してください。
    6. 「作成」を選択します。

    このエンドポイントをオンデマンド・モデルに使用

    デフォルトでは、このプライベート・エンドポイントは専用AIクラスタでホストされているモデルで使用できます。生成AIサービスで提供されているオンデマンド・モデルでもこのエンドポイントを使用できるようにする場合は、このステップを実行します:
    1. 「オンデマンド・モードでの使用を許可」を選択します。
    2. オンデマンド・モデルに到達する方法については、この項の最後にあるヒントを参照してください。
    重要

    このプライベート・エンドポイントを介して生成AIモデルにアクセスするには、プライベート・エンドポイントへのモデルの追加を参照してください。

    エンドポイントを作成します

    1. (オプション)「タグの追加」を選択し、このプライベート・エンドポイントにタグを割り当てます。リソース・タグを参照してください。
    2. 「作成」を選択します。
    ヒント

    このプライベート・エンドポイントを使用してオンデマンド・モデルに到達するには、プライベート・エンドポイントに割り当てられたプライベート・サブネットにコンピュート・インスタンスを作成し、コンピュート・インスタンスにコードを追加し、プライベート・エンドポイントにFQDNを使用し、そのコンピュート・インスタンスからモデルにアクセスします。

  • プライベート・エンドポイントを作成するには、generative-ai-private-endpoint createコマンドおよび必須パラメータを使用します:

    oci generative-ai generative-ai-private-endpoint create [OPTIONS] 
[OPTIONS]

    CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。

    ノート

    事前トレーニング済モデルの場合、OCIDのかわりに、コンソールのプレイグラウンドにリストされているとおりにモデル名を使用できます。このOCIモデル名は、モデルの詳細ページの生成AIで提供される事前トレーニング済基礎モデルでも確認できます。

  • CreateGenerativeAiPrivateEndpoint操作を実行して、プライベート・エンドポイントを作成します。