次の方法で共有

Azure PowerShell を使用して Azure Front Door でキャッシュを消去する

適用対象: ✔️ Front Door Standard ✔️ Front Door Premium

Azure Front Door は、資産の Time-to-Live (TTL) が期限切れになるまで、その資産をキャッシュします。 クライアントが TTL が期限切れになった資産に対して要求を行うと、Azure Front Door は、その資産の新しいコピーを取得してキャッシュします。

ユーザーが常に最新の資産を取得できるようにするには、更新ごとに資産にバージョンを付け、それを新しい URL で発行します。 Azure Front Door は、後続のクライアント要求に対して新しい資産をフェッチします。 ただし、更新された資産が強制的に取得されるように、キャッシュされたコンテンツをすべてのエッジ ノードから消去しなければならない場合があります (特に、更新を行った後、または誤った情報を修正した後)。

前提条件

  • アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
  • ローカルにインストールされた Azure PowerShell または Azure Cloud Shell。

注意

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。 作業を始めるには、「Azure PowerShell をインストールする」を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション 例とリンク
コードまたはコマンド ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。 Azure Cloud Shell の [使ってみる] の例を示すスクリーンショット。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。 Azure Cloud Shell を起動するボタン。
Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。 Azure portal の [Cloud Shell] ボタンを示すスクリーンショット

Azure Cloud Shell を使用するには、以下のようにします。

  1. Cloud Shell を開始します。

  2. コード ブロック (またはコマンド ブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。

  3. Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。

  4. Enter キーを選択して、コードまたはコマンドを実行します。

キャッシュの消去を構成する

Clear-AzFrontDoorCdnEndpointContent コマンドレットを使用して、次のようなパラメーターを指定してキャッシュを消去します。

  • リソース グループ名。
  • リソース グループ内の Azure Front Door プロファイル名。
  • 消去する資産を含むエンドポイント。
  • 消去する資産を含むドメイン/サブドメイン。

重要

ワイルドカード ドメインのキャッシュ消去はサポートされていません。 ワイルドカード ドメインのキャッシュ消去のサブドメインを指定します。 たとえば、ワイルドカード ドメイン *.afdxgatest.azfdtest.xyz の場合は、contoso.afdxgatest.azfdtest.xyz や cart.afdxgatest.azfdtest.xyz などのサブドメインを使用します。 詳細については、Azure Front Door のワイルドカード ドメインに関する記事を参照してください。

  • 消去するコンテンツへのパス:
    • 単一パス消去: ファイル拡張子を含む、アセットの完全なパスを指定します (プロトコルとドメインを除く)。例: /pictures/strasbourg.png
    • ルート ドメインの消去: パスに "/*" を付けてエンドポイントのルートを削除します。
Clear-AzFrontDoorCdnEndpointContent `
    -ResourceGroupName myRGFD `
    -ProfileName contosoafd `
    -EndpointName myendpoint `
    -Domain www.contoso.com `
    -ContentPath /scripts/*

Azure Front Door プロファイルのキャッシュの消去では、大文字と小文字が区別されず、クエリ文字列に依存しません。つまり、ある URL を消去すると、そのクエリ文字列のすべてのバリエーションが消去されます。

注意

キャッシュの消去は、ネットワーク全体およびすべてのエッジの場所に反映されるまでに最大 10 分かかる場合があります。

次のステップ

Azure Front Door プロファイルを作成する方法について学習します。