スケジュールの作成

リソース・スケジューラを使用して、スケジュールを作成し、リソース、日付、開始時刻および終了時刻をスケジュールに追加し、スケジュールを保存する前にレビューおよび編集できます。

タスクの概要

  1. 前提条件を完了し、必要なポリシーを作成します。
  2. 基本的なスケジュール情報の追加(スケジュール名、説明、アクションおよび(オプション)タグ。
  3. コンパートメントおよびリソースを選択します
  4. スケジュールへの日時の追加
  5. スケジュールの確認と保存
  6. スケジュールのモニターと管理(必要に応じて編集、無効化、有効化、削除)

前提条件

スケジュールを作成する前に、ここにリストされている要件を確認し、ユーザーがスケジュールおよびスケジュールを作成してリソースを管理できるようにするために必要なポリシーを作成します。

  1. 管理者は、このページの次の項で説明する必要なポリシーを作成します。
  2. ユーザーは、アクセス権を確認し、管理者から必要な権限を取得してスケジュールを作成します。
  3. スケジュールを作成する前に、次の情報を用意してください。
    • リソースが属するテナンシ、コンパートメント、リージョンおよび組織の名前
    • スケジュールされたアクションの影響を受けるリソースのリスト
    • スケジュールに含まれる開始および停止処理の日時
  4. スケジュール競合の確認スケジューリング時にスケジューリングしているものと同じリソースを使用する既存のスケジュールを探します。

必要なポリシー

重要

スケジュールを作成または管理する前に、スケジュールにアクセスして変更する権限をユーザーに付与するポリシーを作成する必要があります(例1を参照)。また、リソースを管理する権限をスケジュールに付与するポリシーを作成する必要があります(例2を参照)。

例1.このポリシーは、テナンシ内のリソース・スケジュールを管理(作成、削除、アクティブ化など)する権限をユーザーに付与します。

General example
Allow group <groupname> to manage resource-schedule-family in tenancy

Specific example
Allow group ResourceScheduleAdmins to manage resource-schedule-family in tenancy

例2.このポリシーは、リソースに対してアクションを実行する権限をリソース・スケジュールに付与します。

リソース・スケジュールが作成されると、デフォルトでは、ターゲット・リソースに対してアクションを実行する権限がないため、リソース・スケジュールに権限を付与する必要があります。

このポリシーは、コンパートメント内のインスタンスなどの事前定義済リソースを管理するためのスケジュール権限を付与します。

General example
Allow any-user to manage <resource_type> 
in compartment id <compartment_ocid> where all
{request.principal.type='resourceschedule',
request.principal.id='<ocid_of_resourceschedule>'}

Specific example
Allow any-user to manage instance in
compartment id ocid.compartment.oc1...q7fa where all
{request.principal.type='resourceschedule',
request.principal.id='ocid.resourceschedule.oc1.iad.axgr...dt8zb'}
ノート

詳細は、認証および認可リソース・スケジューラ・ポリシーおよびポリシーの例を参照してください。

認証と認可

このページでは、リソース・スケジューラへのセキュアなアクセスを確保するために使用されるIdentity and Access Management IAMプロセスについて説明します。

Oracle Cloud Infrastructureの各サービスは、すべてのインタフェース(コンソール、SDKまたはCLI、およびREST API)で、認証および認可のためにIAMと統合されます。

組織の管理者は、グループコンパートメントおよびポリシーを設定して、どのユーザーがどのサービスおよびリソースにアクセスできるかと、そのアクセス権のタイプを制御する必要があります。たとえば、ポリシーは、新規ユーザーの作成、クラウド・ネットワークの作成と管理、インスタンスの起動、バケットの作成、オブジェクトのダウンロードなどを実行できるユーザーを制御します。詳細は、アイデンティティ・ドメインの管理を参照してください。異なる各サービスのポリシー作成の詳細は、ポリシー・リファレンスを参照してください。

サンプル・ポリシー

ResourceScheduleAdminsグループに、リソース・スケジュール(作成、更新、移動、削除など)を使用した管理操作の実行を許可します。

Allow group ResourceScheduleAdmins to manage resource-schedule in tenancy
ノート

ポリシーの例をポリシーの例に示します

会社所有のOracle Cloud Infrastructureリソースを使用する必要がある通常のユーザー(管理者以外)の場合は、ユーザーIDを設定するよう管理者に連絡してください。管理者は、ユーザーが使用する1つ以上のコンパートメントを承認できます。

リソース・スケジューラAPI操作を使用するには、IAMポリシーで認可されている必要があります。権限がない場合は、管理者に連絡してください。ユーザーにアクセス権を付与するポリシーを記述する必要がある管理者の場合は、アイデンティティ・ドメインの管理を参照してください。

  • 基本スケジュール情報の追加

    1. 「リソース・スケジューラ・スケジュール」ページで、「スケジュールの作成」を選択します。「スケジュールの作成」の「基本情報」ページが開きます。「基本情報」ページで:
      1. スケジュール名を入力します。
      2. オプション: スケジュールの説明を入力します
      3. 「実行するアクション」フィールドで、「開始」または「停止」を選択します。
      4. オプション: 「Show advanced options」を選択します。 リソースにタグを適用すると、ビジネス・ニーズに応じてそれらを整理しやすくなります。リソースの作成時にタグを適用するか、後でリソースをタグで更新できます。リソースへのタグの追加の詳細は、タグの追加を参照してください。タグの適用に関する一般情報は、リソース・タグを参照してください。

    リソースの追加

    重要

    リソース・スケジューラでは、コンピュート・インスタンスおよびAutonomous Databaseのみがサポートされます。将来のリリースでは、ほかのリソースがサポートされる可能性があります。サポートされているリソースのリストを表示するには、ListResourceTypes APIを使用します。「リソース・タイプ」フィルタを使用して、追加するリソースのタイプを選択できます。
    ノート

    リソース・スケジューラで処理できるのは、スケジュール当たり200リソースのみです。「動的」を選択すると、リソース・スケジューラによって、キューに表示される最初の200リソースが追加されます。リソースを手動で選択したり、動的に追加されるリソースの順序を設定することはできません。2つ目のスケジュールを作成して「動的」を選択すると、リソース・スケジューラによって、以前と同じ200個のリソース・セットが追加されます。200を超えるリソースをスケジュールするには、必要な数のスケジュールを作成し、「静的」リソースを選択し、必要な順序でスケジュールごとに最大200のリソースを追加します。詳細は、Dynamic Resource ManagementおよびStatic Resource Managementを参照してください。
    1. 「スケジュールの作成」ページの左ペインで、「リソース」を選択します。「リソース」ページおよび選択したコンパートメントの既存のリソースのリストが表示されます。
    2. リソースのリストから1つ以上のリソースを選択するか、次のステップの説明に従って選択基準を変更します。
      1. 「リソース選択方法」フィールドで、スケジュールで管理するリソースのタイプ(「静的」または「動的」)を選択します。リソースを検索すると、選択したタイプのみが表示されます。
      2. 「検索およびフィルタ」フィールドで、デフォルトの選択(「すべてコンパートメント」)を使用してリソースを検索するか、「コンパートメント」を選択してメニューを使用して別のコンパートメントを選択してリソースを検索します。次のリソース・タイプを検索できます。
        • コンパートメント
        • リソースの種類
        • ステータス
        • タグ
    3. 次の表に、それぞれのリソースタイプと説明を示します。
      リソース・タイプ
      フィルタ名 Description
      コンパートメント 選択したデフォルト設定(「すべて」)を使用するか、「コンパートメント」を選択して「コンパートメントの選択」メニューを表示します。「コンパートメントの選択」ダイアログ・ボックスで、「コンパートメントの検索」を選択し、メニューを使用して、スケジュールするリソースを含むコンパートメントを選択します。「フィルタの適用」を選択してコンパートメントを選択するか、「クリア」を選択して選択せずにダイアログ・ボックスを閉じます。
      表示名 リストで「表示名」を選択して、「表示名」ダイアログ・ボックスを開きます。検索するリソースの表示名を入力し、「フィルタの適用」を選択して選択します。表にリソースが表示されたら、チェック・ボックスを選択してスケジュールで使用するリソースを選択します。「フィルタの適用」を選択して表示名を選択するか、「クリア」を選択して選択せずにダイアログ・ボックスを閉じます。
      OCID 「検索するリソースのOCIDを入力します」で「OCID」を選択します。
      リソースの種類 リストで「リソース・タイプ」を選択して、「検索」ダイアログ・ボックスを開きます。「Autonomous Database」または(「コンピュート」)「インスタンス」(あるいはその両方)を選択します。選択したタイプのリソースのみがリストに表示されます。「フィルタの適用」を選択してリソース・タイプを選択するか、「クリア」を選択して選択せずにダイアログ・ボックスを閉じます。

      ノート少なくとも1つのリソース・タイプをリストする必要があります。すべての選択をクリアすると、リソースは一覧表示されず、検索は無効になります。

      ステータス デフォルト選択は「すべて」です。別のステータスのスケジュールを表示するには、「ステータス」を選択して「検索」メニューを開きます。「使用可能」、「作成中」、「更新中」、「削除済」、「削除済」、「失敗」、「非アクティブ」、「停止済」または「終了済」のいずれかまたはすべてのステータスを選択します。

      ノートステータスを選択しない場合、ダイアログ・ボックスは選択を保存せずに閉じます。

      作成時間 リソース作成時のUTC時間を入力します
    4. 「フィルタの適用」を選択して検索を実行し、見つかったリソースのリストを表示します。

    スケジュール情報の追加

    スケジュール ページを使用して、スケジュールを開始および停止する日時を追加します。UIフォームまたはCron式を使用して情報を手動で入力するか、CLIまたはAPIを使用してスケジュール情報を追加できます。

    UIフォームの使用
    UIフォームを使用して、スケジュールに時間情報を追加できます。Cronを使用したスケジュールの設定の詳細は、Cron式の使用を参照してください。
    1. スケジュールの間隔を入力します。
    2. 「間隔」フィールドで、メニューを使用してスケジュールの時間間隔を選択します。選択肢は次のとおりです:
      • 1回限り
      • 時間ごと
      • 毎日

    ワンタイム・スケジュールの作成

    1. 「間隔」フィールドを選択してメニューを表示します。
    2. 「1回限り」を選択します。1回かぎりのダイアログ・ボックスが表示されます。
    3. 「時間」フィールドに、UTC時間を24時間形式で入力します。
    4. [カレンダー]アイコンを選択して、スケジュールで指定されたアクションを開始する日時を選択します。
    5. 「次へ」を選択して、基本情報、リソースおよびスケジュール情報を含むスケジュールを確認します。
    6. スケジュールを確認した後、「作成」を選択してスケジュールを保存します。アクション(開始/停止)は、選択した日時で選択したリソースに対して実行されます。

    毎時スケジュールの作成

    1. 「間隔」フィールドを選択してメニューを表示します。
    2. 「毎時」を選択します。「時間」ダイアログ・ボックスが開きます。
    3. 「時間」フィールドに、UTC時間を24時間形式で入力します。
    4. 「開始日」フィールドで、開始日をMM/DD/YYYY形式で入力するか、カレンダ・アイコンを使用して日時を選択します。
    5. 終了日を設定するには、「終了日」フィールドを選択し、カレンダを使用して終了日時を入力します。
    6. 「前」を選択して「リソース」画面に戻るか、「次」を選択して「レビューおよび保存」画面に移動するか、「閉じる」を選択してスケジュールを保存せずに削除します。

    日次スケジュールの作成

    1. 「間隔」フィールドを選択してメニューを表示します。
    2. 「日次」を選択します。「日次」ダイアログ・ボックスが開きます。
    3. 「繰返し間隔」フィールドに、スケジュールを実行する頻度を入力するか、メニューを使用して間隔を選択します。最小値は1です。最大値は99です。
    4. [曜日]フィールドで、[選択]を選択してスケジュールを実行する曜日を選択します。1つまたは複数の曜日を1つずつ選択できます。表示された名前の横にある「X」を選択して、選択した曜日のリストから削除します。
    5. 「開始時間」フィールドに、時間を24時間形式で時間および分単位で入力します。
    6. 「開始日」フィールドで、開始日をMM/DD/YYYY形式で入力するか、カレンダ・アイコンを使用して日時を選択します。
    7. 終了日を設定するには、「終了日」フィールドを選択し、カレンダを使用して終了日時を入力します。
    8. 「前」を選択して「リソース」画面に戻るか、「次」を選択して「レビューおよび保存」画面に移動するか、「取消」を選択してスケジュールを保存せずに削除します。

    週次スケジュールの作成

    1. 「間隔」フィールドを選択してメニューを表示します。
    2. 「週」を選択します。「週次」ダイアログ・ボックスが開きます。
    3. 「繰返し間隔」フィールドに、スケジュールを繰り返す頻度を入力します。たとえば、1 = 毎週、2 = 2週間ごと、3 = 3週間ごとなどです。最小週数は1です。最大週数は99です。
    4. 「曜日」フィールドで、スケジュールを実行する曜日を選択します。1つ以上の日を1つずつ選択できます。日を削除するには、その日の横にある「X」を選択します。
    5. 「開始日」フィールドで、「カレンダ」を使用してスケジュールを開始する日時を選択します。
    6. オプション: 「終了日」フィールドで、「カレンダ」を使用してスケジュールが終了する日時を選択します。
    7. 「前」を選択して「リソース」画面に戻るか、「次」を選択して「レビューおよび保存」画面に移動するか、「閉じる」を選択してスケジュールを保存せずに削除します。

    月次スケジュールの作成

    1. 「間隔」フィールドを選択してメニューを表示します。
    2. 「月次」を選択します。「月次」ダイアログ・ボックスが開きます。
    3. 「繰返し間隔」フィールドに、スケジュールを繰り返す頻度を入力します。たとえば、1 = 毎月、2 = 2か月毎、3 = 3か月毎です。最小月数は1です。最大月数は99です。
    4. 「月の日」フィールドで、スケジュールを実行する日の番号を選択します。たとえば、1は月の最初の日、17は月の17日です。1つ以上の日を1つずつ選択できます。日を削除するには、その日の横にある「X」を選択します。
    5. 「開始時間」フィールドで、カレンダを使用してスケジュールを開始する日時を選択します。
    6. 「終了日」フィールドで、「カレンダ」を使用してスケジュールが終了する日時を選択します。
    7. 「前」を選択して「リソース」ウィンドウに戻るか、「次」を選択して「レビューおよび保存」ウィンドウに移動するか、「取消」を選択してスケジュールを保存せずにスケジュール・ウィンドウをクローズします。
    Cron式の使用

    このページでは、Cron式を使用してスケジュールを設定する方法について説明します。UIフォームを使用したスケジュールの設定の詳細は、UIフォームの使用を参照してください。

    1. 「スケジュール」ウィンドウで、「Cron」を選択して「Cron」ウィンドウを表示します。
    2. 有効なCron式を入力して、スケジュール間隔、開始日時および終了日時を設定します。例:
      30 13 * * mon-fri 
      この式は、毎週月曜日、火曜日、水曜日、木曜日および金曜日の13:30 UTCを意味します。
      0 */2 15 * *
      この式では、任意の月の15日目に2時間ごとにスケジュールが実行されます。
    3. 「開始日」フィールドに開始日を手動で入力するか、カレンダを使用して日付を選択します。
    4. オプション: 「終了日」フィールドに終了日を手動で入力するか、カレンダを使用して日付を選択します。
    Cron式の詳細

    cron式は、5つのフィールドの文字列で、それぞれ空白で区切られます。

    次の形式でcron式を入力します:

    cron式で次の値を使用できます。

    • <minute>: 0から59
    • <hour>: 0から23
    • <days of month>: 1から31
    • <months>: 1から12 (1月から12月)
    • <曜日>:1~7(月曜日~日曜日)

    たとえば、すべての月の15日の23:00にスケジュールを実行するには、次の式を入力します: 0 23 15 * *

    フィールドには、次の特殊文字を含めることもできます:
    特殊文字
    文字 内容
    * アスタリスク: 任意の値を表します。
    , カンマ: 複数の値のセパレータ。たとえば、<days of week>の場合、2,3は火曜日と水曜日を表します。
    - ダッシュ: 値の範囲。たとえば、<days of week>の場合、1から3は月曜日から水曜日までを表します。
    / スラッシュ: ステップ値。たとえば、<hour>の場合、*/3は3時間ごとに表されます。
    ノート

    1時間未満の間隔でトリガーするスケジュールは作成できません。1時間以上の間隔のみが許可されます。たとえば、式0 * 15 * * を使用してスケジュールを作成すると、任意の月の15日に1時間ごとにスケジュールを実行できます。月の15日目に15分ごとにスケジュールを */15 * 15 * *で定義することはできません。

    Cron式の作成の詳細は、「Cron式スケジュールの作成」を参照してください。

    スケジュールの確認

    スケジュールの確認と編集、または既存のスケジュールからの新規スケジュールの作成は、スケジュールを作成するプロセスの最終ステップです。

    重要

    リソース・スケジューラ・スケジュールを管理するには、アクセスおよび変更する権限が必要です。詳細は、認証と認可リソース・スケジューラ・ポリシーおよびポリシーの例を参照してください。
    1. 主なステップ(「基本」、「リソース」および「スケジュール」)を完了してスケジュールを作成した後、「レビュー」を選択します。「レビュー」ウィンドウには、スケジュールを作成するための主要ステップごとに個別のセクションがあります。各セクションには、スケジュールを作成するためにプロセスのその部分で入力または選択したすべての情報が表示されます。
    2. 必要に応じて、各セクションの情報を確認および編集します。
    3. 終了すると、ウィンドウが閉じ、スケジュールのリストに戻ります。リソース・スケジューラによってスケジュールが作成される間、スケジュールの作業リクエスト・ステータスには「作成中」と表示されます。作業リクエストが完了すると、ステータスは「成功」になります。新規または更新されたスケジュールの情報が無効な場合、リソーススケジューラはエラー400 (不正なリクエスト、無効な入力)を返します。更新要求は失敗し、変更はスケジュールに適用されません。
  • スケジュールを作成するには、リソーススケジューラの Create Schedule CLIコマンドと必要なパラメータを使用します。

    oci resource-scheduler schedule create --action, --compartment-id | -c, --recurrence-details,
          --defined-tags, --description, --display-name, --freeform-tags, -? | -h | --help,
          --resource-filters, --resources, --time-starts

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

  • リソース・スケジューラCreateSchedule APIを使用して、スケジュールを作成します。

    リソース・スケジューラAPIの完全なリストは、リソース・スケジューラAPIを参照してください。