Anywhere Cache のキャッシュを作成して管理する
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

このページでは、Anywhere Cache キャッシュインスタンスの作成方法と管理方法について説明します。

Anywhere Cache の非同期キャッシュオペレーションから開始される長時間実行オペレーションの使用方法と管理方法については、長時間実行オペレーションを使用するをご覧ください。

Anywhere Cache を使用する前に、制限事項をご確認ください。

始める前に

Anywhere Cache キャッシュの作成と管理に必要な権限を取得するには、キャッシュを作成するバケットに対するストレージ管理者（roles/storage.admin）IAM ロールを付与するよう管理者に依頼してください。

この事前定義ロールには、Anywhere Cache キャッシュの作成と管理に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

Anywhere Cache キャッシュを作成、管理するには、次の権限が必要です。

storage.anywhereCaches.disable（キャッシュを無効にするために必要）
storage.anywhereCaches.get（キャッシュの取得に必要）
storage.anywhereCaches.create（キャッシュの作成に必要）
storage.anywhereCaches.list（キャッシュの一覧表示に必要）
storage.anywhereCaches.pause（キャッシュの一時停止に必要）
storage.anywhereCaches.resume（キャッシュの再開に必要）
storage.anywhereCaches.update（キャッシュの更新に必要）

カスタムロールを使用して、これらの権限を取得することもできます。

バケットに対するロールの付与については、バケットで IAM を使用するをご覧ください。

Anywhere Cache メソッドから開始される長時間実行オペレーションを管理するには、追加のロールと権限が必要になる場合があります。詳細については、長時間実行オペレーションに必要なロールをご覧ください。

キャッシュを作成する

Console

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、データをキャッシュに保存するバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[Anywhere Cache] セクションで、[キャッシュを構成] をクリックします。

バケットの [<your_bucket_name> の構成を編集] ページが表示されます。
[キャッシュリージョン] セクションで、キャッシュを作成するゾーンを含むリージョンをクリックします。
[キャッシュゾーン] セクションで、キャッシュを作成するゾーンを選択します。選択したゾーンごとに、キャッシュの有効期間と取り込みオプションを指定します。
[構成を保存] をクリックします。
表示されるダイアログで [確認] をクリックします。

[バケットの詳細] ページの [オペレーション] タブが開き、キャッシュ作成オペレーションのジョブステータスが表示されます。

バケットのキャッシュのステータスは、[バケットリスト] ページから直接確認することもできます。手順は次のとおりです。

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
[列を表示] アイコン（）をクリックし、[キャッシュ] を選択して [OK] をクリックします。

コマンドライン

gcloud storage buckets anywhere-caches create コマンドを使用します。

gcloud storage buckets anywhere-caches create gs://BUCKET_NAME ZONE

次のように置き換えます。

BUCKET_NAME は、データをキャッシュに保存するバケットの名前に置き換えます。例: my-bucket
ZONE は、キャッシュを実行するゾーンに置き換えます。例: us-east1-b

複数のキャッシュを一度に作成するには、複数のゾーンを指定します。例: us-east1-b us-east1-c us-east1-d

次のオプションフラグを設定すると、キャッシュの作成をより細かくコントロールできます。

--ttl: キャッシュ内のデータの有効期間（TTL）を秒単位で指定します。指定しない場合、デフォルトは 86400s（24 時間）になります。
--admission-policy: データがキャッシュに取り込まれるタイミングを指定します。値は ADMIT_ON_FIRST_MISS または ADMIT_ON_SECOND_MISS です。指定されていない場合、デフォルトの ADMIT_ON_FIRST_MISS が使用されます。

成功すると、このコマンドは AnywhereCache の作成オペレーションに関連付けられた長時間実行オペレーションの ID を返します。長時間実行オペレーションの詳細を取得したり、AnywhereCaches 作成オペレーションの完了前に長時間実行オペレーションをキャンセルできます。

REST API

JSON API

gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセストークンを生成できます。

次の情報が含まれる JSON ファイルを作成します。

{
   "zone": "ZONE",
   "ttl": "TIME_TO_LIVE",
   "admissionPolicy": "ADMISSION_POLICY"
}

次のように置き換えます。

ZONE は、キャッシュを実行するゾーンに置き換えます。例: us-east1-b
TIME_TO_LIVE は、キャッシュ内のデータの有効期間（TTL）に置き換えます。値は 1 時間～ 7 日の範囲で、秒単位で指定します。指定しない場合、デフォルトは 86400s（24 時間）になります。
ADMISSION_POLICY は、データの取り込みタイミングを指定するキャッシュのアドミッションポリシーに置き換えます。値は admit-on-first-miss または admit-on-second-miss です。指定されていない場合、デフォルトの admit-on-first-miss が使用されます。

cURL を使用して、キャッシュの作成リクエストで JSON API を呼び出します。
```
curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"
```
次のように置き換えます。
- JSON_FILE_NAME は、手順 2 で作成した JSON ファイルの名前に置き換えます。
- BUCKET_NAME は、データをキャッシュに保存するバケットの名前に置き換えます。例: my-bucket

成功した場合、オペレーションは google.longrunning.Operation を返します。長時間実行オペレーションの詳細を取得したり、AnywhereCaches 作成オペレーションの完了前に長時間実行オペレーションをキャンセルできます。

キャッシュを表示する

Console

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、表示するキャッシュに関連付けられているバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[Anywhere Cache] セクションで、[キャッシュ] フィールドの横にある [編集] をクリックします。
表示された [構成を編集] ページで、リージョンを選択して、リージョンのゾーン内のすべてのキャッシュを表示します。

[キャッシュゾーン] ペインで、使用可能な各キャッシュの詳細を確認できます。

コマンドライン

gcloud storage buckets anywhere-caches describe コマンドを使用します。

gcloud storage buckets anywhere-caches describe ID

次のように置き換えます。

ID は、BUCKET_NAME/ANYWHERE_CACHE_ID として記述されたキャッシュインスタンスの ID に置き換えます。例: my-bucket/us-east1-b。

オプションの raw フラグを使用して、標準化された API レスポンスではなく、未加工の API レスポンスを出力します。

成功すると、コマンドは AnywhereCache リソースを返します。

REST API

JSON API

gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセストークンを生成できます。

cURL を使用して、キャッシュの取得リクエストで JSON API を呼び出します。
```
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"
```
次のように置き換えます。
- BUCKET_NAME は、取得するキャッシュに関連付けられているバケットの名前に置き換えます。例: my-bucket
- ANYWHERE_CACHE_ID は、キャッシュが配置されているゾーンに置き換えます。例: us-east1-b

成功すると、このオペレーションは AnywhereCache リソースを返します。

キャッシュの一覧表示

Console

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、表示するキャッシュに関連付けられているバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[Anywhere Cache] セクションで、[キャッシュ] フィールドの横にある [編集] をクリックします。
表示された [構成を編集] ページで、リージョンを選択して、リージョンのゾーン内のすべてのキャッシュを表示します。

リージョン内のゾーンで使用可能なすべてのキャッシュが [キャッシュゾーン] ペインに表示されます。

コマンドライン

gcloud storage buckets anywhere-caches list コマンドを使用します。

gcloud storage buckets anywhere-caches list gs://BUCKET_NAME

次のように置き換えます。

BUCKET_NAME は、一覧表示するキャッシュに関連付けられているバケットの名前に置き換えます。例: my-bucket

成功すると、コマンドは AnywhereCache リソースのリストを返します。

必要に応じて --raw フラグを使用し、標準化されたレスポンスではなく未加工の API レスポンスを返すことができます。結果のページネーションなど、表示動作を制御する方法については、gcloud storage ls のドキュメントをご覧ください。

REST API

JSON API

gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセストークンを生成できます。

cURL を使用して、キャッシュを一覧表示するリクエストで JSON API を呼び出します。
```
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"
```
次のように置き換えます。
- BUCKET_NAME は、取得するキャッシュに関連付けられているバケットの名前に置き換えます。例: my-bucket
複数のキャッシュを一覧表示する場合は、結果をページネーションできます。

成功すると、このオペレーションは AnywhereCache リソースのリストを返します。このレスポンスの構造の詳細については、AnywhereCaches リストのドキュメント内のレスポンスをご覧ください。

キャッシュを更新する

Console

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、更新するキャッシュに関連付けられているバケットの名前をクリックします。
[バケットの詳細] ページで [オブザーバビリティ] タブをクリックし、ナビゲーションメニューで [キャッシュ] をクリックします。
[構成を編集] をクリックします。
表示された [構成を編集] ページで、キャッシュのプロパティを更新し、[保存] をクリックします。

コマンドライン

gcloud storage buckets anywhere-caches update コマンドを使用します。

gcloud storage buckets anywhere-caches update ID

次のように置き換えます。

ID は、BUCKET_NAME/ANYWHERE_CACHE_ID として記述されたキャッシュインスタンスの ID に置き換えます。例: my-bucket/us-east1-b。

複数のキャッシュを一度に更新するには、複数の ID を指定します。例: my-bucket/us-east1-b my-bucket/us-east1-c

次のフラグを使用して、キャッシュの構成を更新します。フラグが指定されていない場合、値は変更されません。

--ttl: キャッシュ内のデータの有効期間（TTL）を秒単位で指定します。
--admission-policy: データがキャッシュに取り込まれるタイミングを指定します。値は ADMIT_ON_FIRST_MISS または ADMIT_ON_SECOND_MISS です。

成功すると、このコマンドは AnywhereCache 更新オペレーションに関連付けられた未加工の長時間実行オペレーションの ID を返します。長時間実行オペレーションの詳細を取得できます。

REST API

JSON API

gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセストークンを生成できます。

更新するキャッシュプロパティへの変更を含む JSON ファイルを作成します。

{
   "ttl": "TIME_TO_LIVE",
   "admissionPolicy": "ADMISSION_POLICY"
}

次のように置き換えます。

TIME_TO_LIVE は、キャッシュ内のデータの TTL に置き換えます。値は 1 時間～ 7 日の範囲で、秒単位で指定します。指定しない場合、現在の値が引き続き使用されます。
ADMISSION_POLICY は、データの取り込みタイミングを指定するキャッシュのアドミッションポリシーに置き換えます。値は admit-on-first-miss または admit-on-second-miss です。指定しない場合、現在の値が引き続き使用されます。

次の例では、キャッシュの TTL を 2 日に更新し、2 回目のミス時にデータを取り込むようにアドミッションポリシーを更新します。

{
   "ttl": "172800s",
   "admissionPolicy": "admit-on-second-miss"
}

新しいプロパティを適用するには、 cURL を使用して、キャッシュを更新するリクエストで JSON API を呼び出します。
```
curl -X PATCH --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"
```
次のように置き換えます。
- JSON_FILE_NAME は、手順 2 で作成した JSON ファイルの名前に置き換えます。
- BUCKET_NAME は、更新するキャッシュに関連付けられているバケットの名前に置き換えます。例: my-bucket
- ANYWHERE_CACHE_ID は、キャッシュの ID に置き換えます。例: us-east1-b

成功した場合、オペレーションは google.longrunning.Operation を返します。長時間実行オペレーションの詳細を取得できます。

キャッシュの一時停止

Console

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、一時停止するキャッシュに関連付けられているバケットの名前をクリックします。
[バケットの詳細] ページで [オブザーバビリティ] タブをクリックし、ナビゲーションメニューで [キャッシュ] をクリックします。
[キャッシュを一時停止/再開] をクリックします。
表示されたペインで、[キャッシュの一時停止] 切り替えボタンをクリックします。
[一時停止/再開] をクリックします。
表示されるダイアログで [確認] をクリックします。

コマンドライン

gcloud storage buckets anywhere-caches pause コマンドを使用します。

gcloud storage buckets anywhere-caches pause ID

次のように置き換えます。

ID は、BUCKET_NAME/ANYWHERE_CACHE_ID として記述されたキャッシュインスタンスの ID に置き換えます。例: my-bucket/us-east1-b。

複数のキャッシュを一度に一時停止するには、複数の ID を指定します。例: my-bucket/us-east1-b my-bucket/us-east1-c

成功した場合、コマンドは成功メッセージを返します。

REST API

JSON API

gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセストークンを生成できます。

cURL を使用して、キャッシュの一時停止リクエストで JSON API を呼び出します。
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/pause"
```
次のように置き換えます。
- BUCKET_NAME は、一時停止するキャッシュに関連付けられているバケットの名前に置き換えます。例: my-bucket
- ANYWHERE_CACHE_ID は、キャッシュの ID に置き換えます。例: us-east1-b

成功すると、このオペレーションはフォーマットされた AnywhereCache リソースを返します。

キャッシュを再開する

Console

一時停止したキャッシュを再開する手順は次のとおりです。

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、再開するキャッシュに関連付けられているバケットの名前をクリックします。
[バケットの詳細] ページで [オブザーバビリティ] タブをクリックし、ナビゲーションメニューで [キャッシュ] をクリックします。
[キャッシュを一時停止/再開] をクリックします。
表示されたペインで、[キャッシュの一時停止] 切り替えボタンをクリックします。
[一時停止/再開] をクリックします。
表示されるダイアログで [確認] をクリックします。

無効になっているキャッシュを再開する手順は、次の通りです。

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、再開するキャッシュに関連付けられているバケットの名前をクリックします。
[バケットの詳細] ページで [オブザーバビリティ] タブをクリックし、ナビゲーションメニューで [キャッシュ] をクリックします。
[キャッシュを無効化/再開] をクリックします。
表示されたペインで、[キャッシュを無効にする] 切り替えボタンをクリックします。
[無効/再開] をクリックします。
表示されるダイアログで [確認] をクリックします。

コマンドライン

gcloud storage buckets anywhere-caches resume コマンドを使用します。

gcloud storage buckets anywhere-caches resume ID

次のように置き換えます。

ID は、BUCKET_NAME/ANYWHERE_CACHE_ID として記述されたキャッシュインスタンスの ID に置き換えます。例: my-bucket/us-east1-b。

複数のキャッシュを一度に再開するには、複数の ID を指定します。例: my-bucket/us-east1-b my-bucket/us-east1-c

成功すると、コマンドはフォーマットされた AnywhereCache リソースを返します。

REST API

JSON API

gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセストークンを生成できます。

cURL を使用して、キャッシュの再開リクエストで JSON API を呼び出します。
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/resume"
```
次のように置き換えます。
- BUCKET_NAME は、再開するキャッシュに関連付けられているバケットの名前に置き換えます。例: my-bucket
- ANYWHERE_CACHE_ID は、キャッシュの ID に置き換えます。例: us-east1-b

成功すると、このオペレーションはフォーマットされた AnywhereCache リソースを返します。

キャッシュを無効にする

Console

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、無効にするキャッシュに関連付けられているバケットの名前をクリックします。
[バケットの詳細] ページで [オブザーバビリティ] タブをクリックし、ナビゲーションメニューで [キャッシュ] をクリックします。
[キャッシュを無効化/再開] をクリックします。
表示されたペインで、[キャッシュを無効にする] 切り替えボタンをクリックします。
[無効/再開] をクリックします。
表示されるダイアログで [確認] をクリックします。

コマンドライン

gcloud storage buckets anywhere-caches disable コマンドを使用します。

gcloud storage buckets anywhere-caches disable ID

次のように置き換えます。

ID は、BUCKET_NAME/ANYWHERE_CACHE_ID として記述されたキャッシュインスタンスの ID に置き換えます。例: my-bucket/us-east1-b。

複数のキャッシュを一度に無効にするには、複数の ID を指定します。例: my-bucket/us-east1-b my-bucket/us-east1-c

成功すると、コマンドはフォーマットされた AnywhereCache リソースを返します。

REST API

JSON API

gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセストークンを生成できます。

cURL を使用して、キャッシュを無効にするリクエストで JSON API を呼び出します。
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/disable"
```
次のように置き換えます。
- BUCKET_NAME は、無効にするキャッシュに関連付けられているバケットの名前に置き換えます。例: my-bucket
- ANYWHERE_CACHE_ID は、キャッシュの ID に置き換えます。例: us-east1-b

成功すると、コマンドはフォーマットされた AnywhereCache リソースを返します。

キャッシュパフォーマンスのモニタリング

Google Cloud コンソールの Cloud Storage には、指標を使用してキャッシュのパフォーマンスを追跡できるモニタリンググラフがあります。これらのモニタリンググラフは、Cloud Monitoring を使用して表示することもできます。

使用できるグラフ

グラフ	リソース階層レベル	説明
バイトの強制排除率	バケット	キャッシュから強制排除されたバイト数のレート。1 時間ごとにサンプリングされます。このデータは、後処理に時間がかかるため、1 時間に複数回更新されます。
バイトの強制排除率	プロジェクト	バケットのすべてのキャッシュから強制排除されたバイト数のレート。1 時間ごとにサンプリングされます。このデータは、後処理に時間がかかるため、1 時間に複数回更新されます。
キャッシュ内のバイト数	バケット	キャッシュ内のバイト数のレート。1 時間ごとにサンプリングされます。このデータは、後処理に時間がかかるため、1 時間に複数回更新されます。
キャッシュ内のバイト数	プロジェクト	バケットのすべてのキャッシュのバイト数のレート。1 時間ごとにサンプリングされます。このデータは、後処理に時間がかかるため、1 時間に複数回更新されます。
キャッシュスループットのメリット	プロジェクト	リージョンのデータ転送帯域幅の割り当てのレート、割り当ての使用量、キャッシュによって提供される追加のスループット。キャッシュによって提供される追加のスループットは割り当てにカウントされないため、キャッシュを使用すると、割り当てでプロジェクトに許可されている以上のスループットを実現できます。
オペレーションのヒット率	バケット	キャッシュからリクエストされたデータを提供するキャッシュオペレーションの、キャッシュ対象のオペレーションの合計に対する割合。60 秒ごとにサンプリングされます。読み取りがキャッシュから完全に返された場合、オペレーションはヒットとしてカウントされます。読み取りがキャッシュから返されなかった場合、またはキャッシュから部分的にしか返されなかった場合、オペレーションはミスとしてカウントされます。
オペレーションのヒット率	プロジェクト	バケットのすべてのキャッシュからリクエストされたデータを提供するキャッシュオペレーションの、キャッシュ対象の合計オペレーションに対する割合。60 秒ごとにサンプリングされます。読み取りがキャッシュから完全に返された場合、そのオペレーションはヒットとしてカウントされます。読み取りがキャッシュから返されなかった場合、またはキャッシュから部分的にしか返されなかった場合、オペレーションはミスとしてカウントされます。
ヒット率（バイト数）	バケット	キャッシュ対象の合計バイト数に対する、キャッシュから提供されたバイト数の割合。60 秒ごとにサンプリングされます。
ヒット率（バイト数）	プロジェクト	キャッシュ対象の合計バイト数に対して、バケットのすべてのキャッシュから提供されたバイト数の割合。60 秒ごとにサンプリングされます。
取り込み率（未加工のバイト数）	バケット	各キャッシュに取り込まれた未加工のバイト数のレート。60 秒ごとにサンプリングされます。この指標の値の計算には、課金対象外のバイトを含む、取り込まれたすべてのバイトが使用されます。この指標はリアルタイムで報告されます。
取り込み率（未加工のバイト数）	プロジェクト	バケットのすべてのキャッシュに取り込まれた未加工のバイト数のレート。60 秒ごとにサンプリングされます。この指標の値の計算には、課金対象外バイトを含む、取り込まれたすべてのバイトが使用されます。この指標はリアルタイムで報告されます。
スループット - キャッシュヒット	バケット	キャッシュから提供されたスループット。60 秒ごとにサンプリングされます。
スループット - キャッシュヒット	プロジェクト	バケットのすべてのキャッシュから提供されたスループット。60 秒ごとにサンプリングされます。
スループット - キャッシュミス	バケット	キャッシュから提供されていないスループット。60 秒ごとにサンプリングされます。
スループット - キャッシュミス	プロジェクト	バケットのどのキャッシュからも提供されていないスループット。60 秒ごとにサンプリングされます。

グラフにアクセスする

モニタリンググラフは、個々のバケットまたはプロジェクト内のすべてのバケットのデータをキャプチャします。グラフがキャプチャするリソース階層レベルによって、グラフにアクセスできる場所が決まります。

バケットレベルのグラフにアクセスする

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
バケットのリストで、モニタリンググラフを表示するバケットの名前をクリックします。
[バケットの詳細] ページで、[オブザーバビリティ] タブをクリックします。
ナビゲーションメニューで [Anywhere Cache] を選択します。

モニタリンググラフが表示されます。

プロジェクトレベルのグラフにアクセスする

Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
[バケット] に移動
[Cloud Storage] ナビゲーションパネルで、[モニタリング] をクリックします。
メニューバーで [Anywhere Cache] をクリックします。

モニタリンググラフが表示されます。

長時間実行オペレーションを使用する

正常に実行されると、AnywhereCaches 作成オペレーションと更新オペレーションが長時間実行オペレーションを開始します。基盤となる AnywhereCaches オペレーションの詳細とステータスを確認するために、長時間実行オペレーションを取得して一覧表示できます。また、長時間実行オペレーションをキャンセルして、基盤となる AnywhereCaches オペレーションを実行中にキャンセルすることもできます。

Anywhere Cache で長時間実行オペレーションを使用する手順については、長時間実行オペレーションを使用するをご覧ください。

次の例は、AnywhereCaches 作成オペレーションから開始される長時間実行オペレーションを示しています。

done: false
kind: storage#operation
metadata:
  '@type': type.googleapis.com/google.storage.control.v2.CreateAnywhereCacheMetadata
  anywhereCacheId: us-central1-c
  zone: us-central1-c
  ttl: 172800s
  admissionPolicy: admit-on-first-miss
  commonMetadata:
    createTime: '2023-12-14T20:52:00.032Z'
    progressPercent: -1
    requestedCancellation: false
    type: create-anywhere-cache
    updateTime: '2023-12-14T20:52:00.032Z'
name: projects/_/buckets/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig
selfLink: https://www.googleapis.com/storage/v1/b/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig

再試行数

非同期の AnywhereCaches API は、デフォルトでべき等性を備えています。つまり、意図しないリソースの変更を心配することなく、非同期の AnywhereCaches API 呼び出しを安全に再試行できます。

たとえば、AnywhereCaches 作成オペレーションを実行して us-central1-a にキャッシュを作成すると、成功します。成功したゾーンと同じゾーンを使用して、その後の AnywhereCaches 作成オペレーションを実行すると、リクエストは前のリクエストと同じ長時間実行オペレーションを返します。この動作は、キャッシュ作成リクエストの一部として request_id を含める場合にのみ発生します。request_id が含まれていない場合、すでに存在するキャッシュを作成しようとすると、ANYWHERE_CACHE_ALREADY_EXISTS エラーが発生します。request_id を含める方法については、リクエストの重複をご覧ください。

次のステップ

キャッシュを作成するバケットとゾーンに関する推奨事項を取得します。

Anywhere Cache のキャッシュを作成して管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要な権限

キャッシュを作成する

Console

コマンドライン

REST API

JSON API

キャッシュを表示する

Console

コマンドライン

REST API

JSON API

キャッシュの一覧表示

Console

コマンドライン

REST API

JSON API

キャッシュを更新する

Console

コマンドライン

REST API

JSON API

キャッシュの一時停止

Console

コマンドライン

REST API

JSON API

キャッシュを再開する

Console

コマンドライン

REST API

JSON API

キャッシュを無効にする

Console

コマンドライン

REST API

JSON API

キャッシュ パフォーマンスのモニタリング

使用できるグラフ

グラフにアクセスする

バケットレベルのグラフにアクセスする

プロジェクト レベルのグラフにアクセスする

長時間実行オペレーションを使用する

再試行数

次のステップ

Anywhere Cache のキャッシュを作成して管理する
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

キャッシュパフォーマンスのモニタリング

プロジェクトレベルのグラフにアクセスする