予約されたタスクを使用した保護の維持

• ScheduledTasksApi: Workload Security上のスケジュールされたタスクにアクセスできます。スケジュールされたタスクの作成、説明、変更、削除、検索、および一覧表示が可能です
• 予約タスク: 予約タスクを表します
• ScheduleDetails: 予約タスクを実行するスケジュールを定義します
• タスクパラメータークラス: 予約タスクが実行するタスクを定義します。クラスの一覧については、タスクの構成を参照してください。

1. ScheduledTaskオブジェクトを作成し、一般プロパティを構成します。
2. タスクが実行されるスケジュールを定義するためにScheduleDetailsオブジェクトを作成し、それをScheduledTaskオブジェクトに追加します。
3. タスクパラメータクラスを作成して実行するタスクを定義し、ScheduledTaskオブジェクトに追加します。タスクの種類ごとに異なるタスクパラメータクラスが用意されています。なお、ユーザの同期とソフトウェア更新の確認タスクにはタスクパラメータクラスは必要ありません。
4. ScheduledTasksApiオブジェクトを使用して、Workload Securityで予約タスクを作成します。

• 名前
• スケジュールするタスクの種類
• タスクが有効かどうか
• 作成後にタスクが実行されるかどうか

discover_computer_task = api.ScheduledTask()
discover_computer_task.name = "Discover Computers - Daily"
discover_computer_task.type = "discover-computers"
discover_computer_task.run_now = False

• 繰り返しの種類 - 月次、週次、日次、時間ごと、またはなし (1回のみ実行) のいずれかです。
• 日次、週次、および月次のスケジュールに対する実行の繰り返し。日次および週次の再帰は、間隔（2日ごとなど）で表されます。月次再発の場合は、特定の月を指定します。
• タスクが実行された回数（繰り返し回数）。タスクは、タスクが指定された回数だけ実行されると自動的に削除されます。これは、予約タスクを1回だけ実行する場合に便利です。
• 毎日、毎週、および毎月の繰り返しタイプの開始時刻によって、タスクが実行される時刻がミリ秒単位で決まります (エポックタイム)。日次および週次のスケジュールで繰り返しが間隔で表される場合、後続の実行が実行される日または週は開始時刻から計算されます。たとえば、繰り返しが隔日である場合、開始時刻が月曜日の場合は、タスクの次の実行日が水曜日であることを意味します。
• 開始時刻の解釈に使用するタイムゾーンです。

1. ScheduleDetailsオブジェクトを作成し、繰り返しタイプを設定します。
2. ScheduleParametersオブジェクトを作成し、繰り返しタイプに対応させ、実行の繰り返しと開始時間を設定して、ScheduledTaskオブジェクトに追加します。利用可能なScheduleParametersオブジェクトには、DailyScheduleParameters、HourlyScheduleParameters、MonthlyScheduleParameters、およびOnceOnlyScheduleParametersがあります。
3. オプションで、ScheduledTaskオブジェクトのタイムゾーンを設定します。

daily_schedule = api.ScheduleDetails()
daily_schedule.recurrence_type = "daily"

daily_schedule_parameters = api.DailyScheduleParameters()

daily_schedule_parameters.frequency_type = "custom"
daily_schedule_parameters.custom_interval = custom_interval
daily_schedule_parameters.start_time = start_time

daily_schedule.daily_schedule_parameters = daily_schedule_parameters

# Create a ScheduleDetails object and set the recurrence type
daily_schedule = api.ScheduleDetails()
daily_schedule.recurrence_type = "daily"

# Specify when the task runs
daily_schedule_parameters = api.DailyScheduleParameters()

# Use a custom frequency type to run the task at daily intervals.
# Every day and only weekdays are other available frequency types.
daily_schedule_parameters.frequency_type = "custom"
daily_schedule_parameters.custom_interval = custom_interval
daily_schedule_parameters.start_time = start_time

# Add the schedule parameters to the schedule details
daily_schedule.daily_schedule_parameters = daily_schedule_parameters

# Create a ScheduleDetails object and set the recurrence type
quarterly_schedule = api.ScheduleDetails()
quarterly_schedule.recurrence_type = "monthly"

# Specify when the task runs
monthly_schedule_parameters = api.MonthlyScheduleParameters()

# Set the schedule to run on a specific day of the month.
# Other options are the last day of the month, or a specific weekday of a specific week
monthly_schedule_parameters.frequency_type = "day-of-month"

# Set the day
monthly_schedule_parameters.day_of_month = day

# Set the months to be quarterly
monthly_schedule_parameters.months = ["january", "april", "july", "october"]

# Add the schedule parameters to the schedule details
quarterly_schedule.monthly_schedule_parameters = monthly_schedule_parameters

• CheckForSecurityUpdatesTaskParameters
• DiscoverComputersTaskParameters
• GenerateReportTaskParameters
• RunScriptTaskParameters
• ScanForIntegrityChangesTaskParameters
• ScanForMalwareTaskParameters
• ScanForOpenPortsScanParameters
• 推奨事項のスキャンパラメータをスキャン
• SendAlertSummaryScanParameters
• SendPolicyTaskParameters
• SynchronizeCloudAccountTaskParameters
• SynchronizeDirectoryTaskParameters
• SynchronizeVCenterTaskParameters
• UpdateSuspiciousObjectsListTaskParameters

1. 作成中の予約タスクの種類に対応するクラスからタスクパラメータオブジェクトを作成します。
   [ユーザの同期]および[ソフトウェアアップデートの確認]タスクでは、設定は必要ありません。これらのタスクの場合は、タスクパラメータクラスを作成しないでください。
2. タスクパラメータオブジェクトを設定して、タスクの動作を定義します。
   • 各クラスは、設定が必要なさまざまなプロパティを定義します。
   • いくつかのタスクパラメータークラスは、操作対象のコンピューターを識別するためにComputerFilterオブジェクトを必要とします。
   • タスクパラメータオブジェクトの種類によっては、Recipients、TagFilter、またはTimeRangeオブジェクトを追加する必要がある場合があります。

discover_computer_task = api.ScheduledTask()
discover_computer_task.type = "discover-computers"

task_parameters = api.DiscoverComputersTaskParameters()
task_parameters.discovery_type = "range"
task_parameters.iprange_low = "192.168.60.0"
task_parameters.iprange_high = "192.168.60.255"
task_parameters.scan_discovered_computers = True

discover_computer_task.discover_computers_task_parameters = task_parameters

scheduled_tasks_api = api.ScheduledTasksApi(api.ApiClient(configuration))
scheduled_task = scheduled_tasks_api.create_scheduled_task(discover_computer_task, api_version)

# Create the ScheduledTask object and set the name and type. Do not run now.
discover_computer_task = api.ScheduledTask()
discover_computer_task.name = "Discover Computers - Daily"
discover_computer_task.type = "discover-computers"
discover_computer_task.run_now = False

# Call the createDailyScheduleDetails method to obtain a daily ScheduleDetails object.
# Set the start time to 03:00 DST.
discover_computer_task.schedule_details = create_daily_schedule_details(api, api_exception, 2, 1536030000000);

# Create a DiscoverComputersTaskParameters object.
# The scan applies to a range of IP addresses, and scans discovered computers for open ports.
task_parameters = api.DiscoverComputersTaskParameters()
task_parameters.discovery_type = "range"
task_parameters.iprange_low = "192.168.60.0"
task_parameters.iprange_high = "192.168.60.255"
task_parameters.scan_discovered_computers = True
discover_computer_task.discover_computers_task_parameters = task_parameters

# Create the scheduled task on Workload Security
scheduled_tasks_api = api.ScheduledTasksApi(api.ApiClient(configuration))
scheduled_task = scheduled_tasks_api.create_scheduled_task(discover_computer_task, api_version)

return scheduled_task.id

1. ScheduledTaskオブジェクトを作成および構成する:
   • スケジュールされたタスクを今すぐ実行するように設定します。
   • 一度実行するタスクを設定して、後続の実行が実行されないようにします。
   • 必要に応じてタスクの詳細を作成および設定します。
2. ScheduledTasksApiオブジェクトを作成し、それを使用してWorkload Securityで予約タスクを作成します。
3. ScheduledTasksApiオブジェクトを使用して、Workload Securityの予約タスクを削除します。

# Set the name and task type
check_for_security_updates = api.ScheduledTask()
check_for_security_updates.name = "Check For Security Updates"
check_for_security_updates.type = "check-for-security-updates"

# Run when the scheduled task is created
check_for_security_updates.run_now = True

# Use a once-only recurrence
schedule_details = api.ScheduleDetails()
schedule_details.recurrence_type = 'none'

# Set the recurrence count to 1 so that the task is deleted after running
schedule_details.recurrence_count = 1
schedule_parameters = api.OnceOnlyScheduleParameters()

# The start time is not important because it is deleted after running
schedule_parameters.start_time = 0
schedule_details.once_only_schedule_parameters = schedule_parameters
check_for_security_updates.schedule_details = schedule_details

# Scan all computers
computer_filter = api.ComputerFilter()
computer_filter.type = "all-computers"

# Create the task parameters object and add the computer filter
task_parameters = api.CheckForSecurityUpdatesTaskParameters()
task_parameters.computer_filter = computer_filter

check_for_security_updates.check_for_security_updates_task_parameters = task_parameters

# Create the scheduled task on Workload Security
scheduled_tasks_api = api.ScheduledTasksApi(api.ApiClient(configuration))
scheduled_task = scheduled_tasks_api.create_scheduled_task(check_for_security_updates, api_version)

return scheduled_task.id

1. ScheduledTaskオブジェクトを作成し、runNowプロパティをtrueに設定します。他のプロパティは設定しないでください。
2. 実行する既存の予約タスクのIDを取得します。
3. ScheduledTasksApiオブジェクトを作成し、それを使用して作成したScheduledTaskオブジェクトに従って既存の予約タスクを変更します。

# Create the ScheduledTask object and set to run now
scheduled_task = api.ScheduledTask()
scheduled_task.run_now = True

# Modify the scheduled task on Workload Security
scheduled_tasks_api = api.ScheduledTasksApi(api.ApiClient(configuration))
scheduled_tasks_api.modify_scheduled_task(scheduled_task_id, scheduled_task, api_version)