mac_modification_tasks

Creates, updates, deletes, gets or lists a mac_modification_tasks resource.

Overview

Name	mac_modification_tasks
Type	Resource
Id	aws.ec2.mac_modification_tasks

Fields

The following fields are returned by SELECT queries:

describe_mac_modification_tasks

Name	Datatype	Description
instance_id	string	The ID of the Amazon EC2 Mac instance.
mac_modification_task_id	string	The ID of task.
mac_system_integrity_protection_config	string	[SIP modification tasks only] Information about the SIP configuration.
start_time	string	The date and time the task was created, in the UTC timezone (YYYY-MM-DDThh:mm:ss.sssZ).
tags	string	The tags assigned to the task.
task_state	string	The state of the task.
task_type	string	The type of task.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
describe_mac_modification_tasks	select	region	DryRun, Filter, MacModificationTaskId, MaxResults, NextToken	Describes a System Integrity Protection (SIP) modification task or volume ownership delegation task for an Amazon EC2 Mac instance. For more information, see Configure SIP for Amazon EC2 instances in the Amazon EC2 User Guide.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)
DryRun	boolean	Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Filter	array	Specifies one or more filters for the request: instance-id - The ID of the instance for which the task was created. task-state - The state of the task (successful | failed | in-progress | pending). mac-system-integrity-protection-configuration.sip-status - The overall SIP state requested in the task (enabled | disabled). start-time - The date and time the task was created. task-type - The type of task (sip-modification | volume-ownership-delegation).
MacModificationTaskId	array	The ID of task.
MaxResults	integer	The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500. If maxResults is given a larger value than 500, you receive an error.
NextToken	string	The token to use to retrieve the next page of results.

SELECT examples

describe_mac_modification_tasks

Describes a System Integrity Protection (SIP) modification task or volume ownership delegation task for an Amazon EC2 Mac instance. For more information, see Configure SIP for Amazon EC2 instances in the Amazon EC2 User Guide.

SELECT
instance_id,
mac_modification_task_id,
mac_system_integrity_protection_config,
start_time,
tags,
task_state,
task_type
FROM aws.ec2.mac_modification_tasks
WHERE region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
AND Filter = '{{ Filter }}'
AND MacModificationTaskId = '{{ MacModificationTaskId }}'
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;