OS Config の割り当て

このドキュメントでは、プロジェクトの VM Manager スイートツールの OS Config API に対して発行できる最大リクエスト数の割り当てについて説明します。また、OS Config リソースの数量に基づく割り当てについても説明します。

割り当ては、Google Cloud プロジェクトで使用できる共有 Google Cloud リソース（ハードウェア、ソフトウェア、ネットワーク コンポーネントなど）の量を制限します。つまり、割り当てはシステムの一部で、次の機能があります。

  • Google Cloud のプロダクトとサービスの使用量や消費量をモニタリングする。
  • 公平性の確保や使用量急増の抑制などのため、これらのリソースの消費量を制限する。
  • 規定の制限を自動的に適用する構成を維持する。
  • 割り当てをリクエストまたは変更する手段を提供する。

ほとんどの場合、割り当てを超過すると、システムは関連する Google リソースへのアクセスをすぐにブロックするため、ユーザーが試行しているタスクは失敗します。ほとんどの場合、割り当ては各 Google Cloud プロジェクトに適用され、その Google Cloud プロジェクトを使用するすべてのアプリケーションと IP アドレスで共有されます。

リクエストの割り当て

Google Cloud CLI または Google Cloud コンソールを使用する場合、API へのリクエストも行われ、これらのリクエストはリクエストの割り当てに加算されます。また、サービス アカウントを使用して API にアクセスする場合も、割り当てに加算されます。

割り当ては 60 秒単位で適用されます。つまり、60 秒間のうちのある時点で特定の上限に達した場合、割り当てバケットが更新されるまで待たないと、それ以上のリクエストを実行できません。

ユーザーあたりの割り当て

割り当てグループ 詳細 デフォルトの割り当て
読み取りリクエスト
  • 説明: *.get、*.describe、*.list メソッドの割り当て。
  • 指標: osconfig.googleapis.com/read_requests

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 1 ユーザー、1 分あたり 60 回のリクエスト
書き込みリクエスト
  • 説明: *.create、*.update、*.exec、*.cancel、*.delete メソッドの割り当て。
  • 指標: osconfig.googleapis.com/write_requests

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 1 ユーザー、1 分あたり 60 回のリクエスト
検索リクエスト（以前のベータ版）
  • 説明: *.lookupEffectiveGuestPolicy メソッドの割り当て。
  • 指標: osconfig.googleapis.com/lookup_requests

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 1 ユーザー、1 分あたり 600 回のリクエスト

リージョンごとの割り当て

割り当てグループ 詳細 デフォルトの割り当て
読み取りリクエスト
  • 説明: *.get、*.describe、*.list メソッドの割り当て。
  • 指標: osconfig.googleapis.com/regional_zonal_read_requests

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 1 リージョン、1 分あたり 100 回のリクエスト
書き込みリクエスト
  • 説明: *.create、*.update、*.patch、*.cancel、*.delete メソッドの割り当て。
  • 指標: osconfig.googleapis.com/regional_zonal_write_requests

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 1 リージョン、1 分あたり 60 回のリクエスト

数量に基づく割り当て

数量に基づく割り当ては、そのリソースタイプで作成できるリソースの最大数です。OS Config リソースには、パッチデプロイ、OS ポリシーの割り当て、ゲストポリシーが含まれます。

次の割り当ては、時間が経過してもリセットされず、代わりにリソースを解放すると解放されます。

リソース 詳細 デフォルトの割り当て
パッチジョブ
  • 説明: プロジェクトで作成できるパッチジョブ数の割り当て。
  • 指標: osconfig.googleapis.com/patch_deployment_count

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 プロジェクトあたり 100 個のパッチジョブ
OS ポリシーの割り当て
  • 説明: プロジェクト内の各ゾーンに作成できる OS ポリシー数の割り当て。
  • 指標: osconfig.googleapis.com/os_policy_assignment_count

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 ゾーンごとにプロジェクトあたり 20 件の OS ポリシー割り当て
ゲストポリシー（以前のベータ版）
  • 説明: プロジェクトで作成できるゲストポリシー数の割り当て。
  • 指標: osconfig.googleapis.com/guest_policy_count

    この割り当ては、Google Cloud コンソールで確認できます。

    [割り当て] に移動

 プロジェクトあたり 100 のゲストポリシー

リクエストと数量に基づく割り当ての管理

プロジェクトのリクエストと数量に基づく割り当てを管理するには、次のようにします。

  • API レート制限を保持するためのベスト プラクティスに従います。

  • Google Cloud コンソールを使用して、リクエストの割り当てを表示および編集します。

    [割り当て] に移動

    • リクエストの割り当てを減らす場合は、使用量の上限を設定するをご覧ください。
    • デフォルトの割り当てよりも高いリクエスト割り当てが必要な場合は、割り当て上限の引き上げをリクエストします。リクエストには、お使いの環境における消費率を示す情報を追加します。これには、VM Manager の監査ログや、レート制限を超えたことを示す他のエラー メッセージが含まれます。また、今後の拡張プラン、リージョンまたはゾーンの範囲、追加の要件や依存関係などの情報を含めておくと便利です。

次のステップ