Azure OpenAI モデルの操作

[アーティクル]
02/07/2025

Azure OpenAI Service では、さまざまな機能と価格ポイントを備えた多様なモデルセットが利用されています。モデルの可用性はリージョンごとに異なります。

Models List API を使用して、Azure OpenAI リソースによる推論と微調整の両方に使用できるモデルの一覧を取得できます。

モデルの更新

Azure OpenAI では、選択したモデルデプロイの自動更新がサポートされるようになりました。自動更新のサポートが利用可能なモデルでは、Azure AI Foundry ポータルの [デプロイ] と [編集] にモデルバージョンのドロップダウンが表示されます。

Azure OpenAI モデルのバージョンとその動作の詳細については、Azure OpenAI モデルのバージョンの記事を参照してください。

Note

モデルの自動更新は、標準のデプロイの種類でのみサポートされます。プロビジョニング済みデプロイの種類でのモデルの更新と移行を管理する方法の詳細については、プロビジョニング済みデプロイの種類でのモデルの管理に関するセクションを参照してください

既定値に自動更新

デプロイを [既定値に自動更新] に設定すると、モデルデプロイは、既定のバージョンの変更が行われてから 2 週間以内に自動的に更新されます。プレビューバージョンの場合、新しいプレビューバージョンがリリースされてから 2 週間後以降、新しいプレビューバージョンが使用可能になると自動的に更新されます。

まだ推論モデルの早期テストフェーズにある場合、[既定値に自動更新] が使用可能であれば常にこれを設定してモデルをデプロイすることをお勧めします。

特定のモデルバージョン

Azure OpenAI の使い方が徐々に発展し、アプリケーションを開発して組み込むようになったら、モデル更新の手動制御をお勧めします。アップグレードする前に、まずアプリケーションの動作がユースケースに対して一貫していることをテストして検証できます。

デプロイに特定のモデルバージョンを選択すると、自分で手動更新するか、モデルの提供終了日に達するまで、このバージョンは選択されたままになります。提供終了日に達すると、モデルは提供終了時に既定のバージョンに自動的にアップグレードされます。

提供終了日を表示する

現在デプロイされているモデルの場合は、Azure AI Foundry ポータルで [デプロイ] を選択します。

モデルデプロイのアップグレード構成

Azure AI Foundry ポータルで、以前にデプロイされたモデルに対して設定されているモデルアップグレードオプションを確認できます。 [デプロイ] を選択 > "デプロイ名" 列で青色に強調表示されているデプロイ名のいずれかを選択します。

デプロイ名を選択すると、モデルデプロイのプロパティが開きます。デプロイで設定されているアップグレードオプションは、[バージョン更新ポリシー] で確認できます。

対応するプロパティには、REST、Azure PowerShell、Azure CLI 経由でアクセスすることもできます。

オプション	既読	更新する
REST	はい。 `versionUpgradeOption` が返されない場合は、`null` です	はい
Azure PowerShell	はい。 `$null` に `VersionUpgradeOption` を確認できます	はい
Azure CLI	はい。 `versionUpgradeOption` が設定されていない場合は、`null` が表示されます。	不正解です。現在、バージョンアップグレードオプションを更新することはできません。

モデルデプロイのアップグレードには、次の 3 つのオプションがあります。

名前	説明
`OnceNewDefaultVersionAvailable`	新しいバージョンを既定として指定すると、モデルデプロイは、その指定変更が行われてから 2 週間以内に既定のバージョンに自動的にアップグレードされます。
`OnceCurrentVersionExpired`	廃止日になると、モデルデプロイは現在の既定のバージョンに自動的にアップグレードされます。
`NoAutoUpgrade`	モデルデプロイは自動的にアップグレードされません。廃止日になると、モデルデプロイは機能しなくなります。期限が切れていないモデルデプロイをポイントするには、そのデプロイを参照しているコードを更新する必要があります。

Note

null は OnceCurrentVersionExpired と等価です。モデルのアップグレードをサポートしているモデルのプロパティに [バージョン更新ポリシー] オプションがない場合、これは値が現在 null であることを示しています。この値を明示的に変更すると、プロパティは、スタジオのプロパティページに表示されるとともに、REST API を介して表示されます。

Azure PowerShell の概要ガイドを確認して Azure PowerShell をローカルにインストールするか、Azure Cloud Shell を使用できます。

次の手順では、VersionUpgradeOption オプションプロパティの確認と更新を示します:

// Step 1: Get Deployment
$deployment = Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName}
 
// Step 2: Show Deployment VersionUpgradeOption
$deployment.Properties.VersionUpgradeOption
 
// VersionUpgradeOption can be null - one way to check is
$null -eq $deployment.Properties.VersionUpgradeOption
 
// Step 3: Update Deployment VersionUpgradeOption
$deployment.Properties.VersionUpgradeOption = "NoAutoUpgrade"
New-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName} -Properties $deployment.Properties -Sku $deployment.Sku
 
// repeat step 1 and 2 to confirm the change.
// If not sure about deployment name, use this command to show all deployments under an account
Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName}

// To update to a new model version

// Step 1: Get Deployment
$deployment = Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName}

// Step 2: Show Deployment Model properties
$deployment.Properties.Model.Version

// Step 3: Update Deployed Model Version
$deployment.Properties.Model.Version = "0613"
New-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName} -Properties $deployment.Properties -Sku $deployment.Sku

// repeat step 1 and 2 to confirm the change.

特定のリソースのデプロイアップグレード構成を含む現在のモデルデプロイ設定に対してクエリを実行するには、Deployments List を使用します。値が null の場合、versionUpgradeOption プロパティは表示されません。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments?api-version=2023-05-01

パスパラメーター

パラメーター	Type	必須	説明
`acountname`	string	必須	Azure OpenAI リソースの名前。
`resourceGroupName`	string	必須	このモデルデプロイに関連付けられているリソースグループの名前。
`subscriptionId`	string	必須	関連付けられているサブスクリプションの ID。
`api-version`	string	必須	この操作に使用する API バージョン。これは、YYYY-MM-DD 形式に従います。

サポートされているバージョン

2023-05-01 Swagger の仕様

応答の例

{
  "value": [
    {
      "id": "/subscriptions/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeeb/resourceGroups/az-test-openai/providers/Microsoft.CognitiveServices/accounts/aztestopenai001/deployments/gpt-35-turbo",
      "type": "Microsoft.CognitiveServices/accounts/deployments",
      "name": "gpt-35-turbo",
      "sku": {
        "name": "Standard",
        "capacity": 80
      },
      "properties": {
        "model": {
          "format": "OpenAI",
          "name": "gpt-35-turbo",
          "version": "0301"
        },
        "versionUpgradeOption": "OnceNewDefaultVersionAvailable",
        "capabilities": {
          "completion": "true",
          "chatCompletion": "true"
        },
        "raiPolicyName": "Microsoft.Default",
        "provisioningState": "Succeeded",
        "rateLimits": [
          {
            "key": "request",
            "renewalPeriod": 10,
            "count": 80
          },
          {
            "key": "token",
            "renewalPeriod": 60,
            "count": 80000
          }
        ]
      },
      "systemData": {
        "createdBy": "docs@contoso.com",
        "createdByType": "User",
        "createdAt": "2023-07-31T16:45:32.622404Z",
        "lastModifiedBy": "docs@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2023-10-31T13:59:34.4978286Z"
      },
      "etag": "\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\""
    }
  ]
}

次に、デプロイのアップグレード構成を変更する場合は、このリストから設定を取得して、以下で説明するようにモデル更新 REST API 呼び出しを作成できます。

API を使用したモデルの更新とデプロイ

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/deployments/{deploymentName}?api-version=2023-05-01

パスパラメーター

パラメーター	Type	必須	説明
`acountname`	string	必須	Azure OpenAI リソースの名前。
`deploymentName`	string	必須	既存のモデルをデプロイしたときに選択したデプロイ名、または新しいモデルデプロイに使用する名前。
`resourceGroupName`	string	必須	このモデルデプロイに関連付けられているリソースグループの名前。
`subscriptionId`	string	必須	関連付けられているサブスクリプションの ID。
`api-version`	string	必須	この操作に使用する API バージョン。これは、YYYY-MM-DD 形式に従います。

サポートされているバージョン

2023-05-01 Swagger の仕様

要求本文

これは、使用可能な要求本文パラメーターのサブセットにすぎません。すべてのパラメーターの一覧については、REST API リファレンスドキュメントをご覧ください。

パラメーター	型	説明
versionUpgradeOption	String	デプロイモデルバージョンのアップグレードオプション: `OnceNewDefaultVersionAvailable` `OnceCurrentVersionExpired` `NoAutoUpgrade`
capacity	整数 (integer)	このデプロイに割り当てるクォータの量を表します。値 1 は、1 分あたり 1,000 トークン (TPM) に相当します

要求の例

curl -X PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-35-turbo?api-version=2023-05-01 \
  -H "Content-Type: application/json" \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -d '{"sku":{"name":"Standard","capacity":120},"properties": {"model": {"format": "OpenAI","name": "gpt-35-turbo","version": "0613"},"versionUpgradeOption":"OnceCurrentVersionExpired"}}'

注意

認証トークンを生成するには、複数の方法があります。初期テストの最も簡単な方法は、Azure portal から Cloud Shell を起動することです。次に、az account get-access-token を実行します。このトークンは、API テストの一時的な認証トークンとして使用できます。

応答の例

 {
  "id": "/subscriptions/{subscription-id}/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-35-turbo",
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "name": "gpt-35-turbo",
  "sku": {
    "name": "Standard",
    "capacity": 120
  },
  "properties": {
    "model": {
      "format": "OpenAI",
      "name": "gpt-35-turbo",
      "version": "0613"
    },
    "versionUpgradeOption": "OnceCurrentVersionExpired",
    "capabilities": {
      "chatCompletion": "true"
    },
    "provisioningState": "Succeeded",
    "rateLimits": [
      {
        "key": "request",
        "renewalPeriod": 10,
        "count": 120
      },
      {
        "key": "token",
        "renewalPeriod": 60,
        "count": 120000
      }
    ]
  },
  "systemData": {
    "createdBy": "docs@contoso.com",
    "createdByType": "User",
    "createdAt": "2023-02-28T02:57:15.8951706Z",
    "lastModifiedBy": "docs@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-10-31T15:35:53.082912Z"
  },
  "etag": "\"GUID\""
}

プロビジョニング済みデプロイの種類でのモデルの管理

プロビジョニング済みデプロイでは、個別のモデル管理プラクティスがサポートされます。プロビジョニング済みデプロイモデル管理プラクティスは、モデルバージョンとモデルファミリの間で移行するタイミングと方法を最大限に制御することを目的としています。現在、プロビジョニング済みデプロイでモデルを管理するには、(1) インプレース移行と (2) 複数デプロイ移行の 2 つの方法があります。

前提条件

既存のデプロイの種類でターゲットモデルのバージョンまたはモデルファミリがサポートされていることを確認します。移行は、同じデプロイの種類のプロビジョニング済みデプロイ間でのみ行うことができます。デプロイの種類の詳細については、デプロイの種類に関するドキュメントを参照してください。
移行を試みる前に、ターゲットモデルのバージョンまたはモデルファミリの容量の可用性を検証します。容量の可用性を決定する方法の詳細については、容量の透明性に関するドキュメントを参照してください。
複数デプロイ移行の場合は、複数のデプロイを同時にサポートするのに十分なクォータがあることを確認します。それぞれのプロビジョニング済みデプロイの種類のクォータを検証する方法の詳細については、プロビジョニング済みクォータに関するドキュメントを参照してください。

プロビジョニング済みデプロイのインプレース移行

インプレース移行を使用すると、プロビジョニング済みデプロイの名前とサイズを同じに維持しながら、そのデプロイに割り当てられているモデルのバージョンまたはモデルファミリを変更できます。インプレース移行では、Azure OpenAI Service は、20 分から 30 分の期間で、移行全体を通じてモデルバージョンまたはモデルファミリ間で既存のトラフィックを移行します。移行期間全体を通して、プロビジョニング済みデプロイには、"更新中" のプロビジョニング済み状態が表示されます。通常どおり、プロビジョニング済みデプロイを引き続き使用できます。インプレース移行が完了すると、プロビジョニング済み状態が "成功" に更新され、すべてのトラフィックがターゲットモデルのバージョンまたはモデルファミリに移行されたことを示します。

インプレース移行: モデルバージョンの更新

同じモデルファミリ内の新しいモデルバージョンへの既存のプロビジョニング済みデプロイの更新を対象とするインプレース移行は、Azure AI Foundry、REST API、Azure CLI を通じてサポートされます。 Azure AI Foundry 内でモデルバージョンの更新を対象とするインプレース移行を実行するには、[デプロイ名] 列で [デプロイ]> を選択し、移行するプロビジョニング済みデプロイのデプロイ名を選択します。

デプロイ名を選択すると、モデルデプロイのプロパティが開きます。このビューから、[編集] ボタンを選択すると、[デプロイの更新] ダイアログボックスが表示されます。モデルバージョンドロップダウンを選択して、プロビジョニング済みデプロイの新しいモデルバージョンを設定します。前述のように、移行中にプロビジョニングの状態が "更新中" に変わり、移行が完了すると "成功" に戻ります。

モデルバージョンフィールドセレクターが開かれているデプロイの更新ダイアログボックスのスクリーンショット。選択可能なモデルバージョンオプションが表示されています。

インプレース移行: モデルファミリの変更

新しいモデルファミリへの既存のプロビジョニング済みデプロイの更新を対象とするインプレース移行は、REST API、Azure CLI を通じてサポートされます。モデルファミリの変更を対象とするインプレース移行を実行するには、以下の要求例をガイドとして使用します。要求では、移行先のターゲットモデルのモデル名とモデルバージョンを更新する必要があります。

curl -X PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-4o-ptu-deployment?api-version=2024-10-01 \
  -H "Content-Type: application/json" \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -d '{"sku":{"name":"GlobalProvisionedManaged","capacity":100},"properties": {"model": {"format": "OpenAI","name": "gpt-4o-mini","version": "2024-07-18"}}}'

応答の例

 {
  "id": "/subscriptions/{subscription-id}/resourceGroups/resource-group-temp/providers/Microsoft.CognitiveServices/accounts/docs-openai-test-001/deployments/gpt-4o-ptu-deployment",
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "name": "gpt-4o-ptu-deployment",
  "sku": {
    "name": "GlobalProvisionedManaged",
    "capacity": 100
  },
  "properties": {
    "model": {
      "format": "OpenAI",
      "name": "gpt-4o-mini",
      "version": "2024-07-18"
    },
    "versionUpgradeOption": "OnceCurrentVersionExpired",
    "currentCapacity": 100
    "capabilities": {
      "area": "EUR",
      "chatCompletion": "true"
      "jsonObjectResponse": "true",
      "maxContextToken": "128000",
      "maxOutputToken": "16834",
      "assistants": "true"
    },
    "provisioningState": "Updating",
    "rateLimits": [
      {
        "key": "request",
        "renewalPeriod": 10,
        "count": 300
      }
    ]
  },
  "systemData": {
    "createdBy": "docs@contoso.com",
    "createdByType": "User",
    "createdAt": "2025-01-28T02:57:15.8951706Z",
    "lastModifiedBy": "docs@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2025-01-29T15:35:53.082912Z"
  },
  "etag": "\"GUID\""
}

Note

プロビジョニング済みデプロイの複数デプロイ移行

複数デプロイ移行を使用すると、モデル移行プロセスをより詳細に制御できます。複数デプロイ移行では、新しいプロビジョニング済みデプロイで、既存のトラフィックをターゲットモデルのバージョンまたはモデルファミリに移行する速度を指定できます。複数デプロイ移行アプローチを使用して新しいモデルのバージョンまたはモデルファミリに移行するプロセスは次のとおりです。

新しいプロビジョニング済みデプロイを作成します。この新しいデプロイでは、既存のデプロイと同じプロビジョニング済みデプロイの種類を維持するか、必要に応じて新しいデプロイの種類を選択することができます。
すべてのトラフィックが元のデプロイからオフロードされるまで、既存のプロビジョニング済みデプロイから、ターゲットモデルのバージョンまたはモデルファミリを使用して新しく作成されたプロビジョニング済みデプロイにトラフィックを切り替えます。
トラフィックが新しいデプロイに移行されたら、Azure OpenAI 要求メトリックに、推論トラフィックが新しいデプロイに移行されてから 5 ~ 10 分以内に行われた API 呼び出しが表示されないようにすることで、前のプロビジョニング済みデプロイで処理される推論要求がないことを検証します。このメトリックの詳細については、Azure OpenAI の監視に関するドキュメントを参照してください。
推論呼び出しが行われなかったことを確認したら、元のプロビジョニング済みデプロイを削除します。

次の方法で共有

Azure OpenAI モデルの操作

モデルの更新

既定値に自動更新

特定のモデルバージョン

提供終了日を表示する

モデルデプロイのアップグレード構成

例

応答の例

API を使用したモデルの更新とデプロイ

要求の例

応答の例

プロビジョニング済みデプロイの種類でのモデルの管理

前提条件

プロビジョニング済みデプロイのインプレース移行

インプレース移行: モデルバージョンの更新

インプレース移行: モデルファミリの変更

応答の例

プロビジョニング済みデプロイの複数デプロイ移行

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure OpenAI モデルの操作

モデルの更新

既定値に自動更新

特定のモデル バージョン

提供終了日を表示する

モデル デプロイのアップグレード構成

例

API を使用したモデルの更新とデプロイ

要求の例

応答の例

プロビジョニング済みデプロイの種類でのモデルの管理

前提条件

プロビジョニング済みデプロイのインプレース移行

インプレース移行: モデル バージョンの更新

インプレース移行: モデル ファミリの変更

応答の例

プロビジョニング済みデプロイの複数デプロイ移行

次のステップ

フィードバック

その他のリソース

特定のモデルバージョン

モデルデプロイのアップグレード構成

インプレース移行: モデルバージョンの更新

インプレース移行: モデルファミリの変更