Skip to content

EC2  >  Operations  >  describe_mac_modification_tasks

describe_mac_modification_tasks

Operation

describe_mac_modification_tasks async 

describe_mac_modification_tasks(input: DescribeMacModificationTasksInput, plugins: list[Plugin] | None = None) -> DescribeMacModificationTasksOutput

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:

Name Type Description Default
input DescribeMacModificationTasksInput

An instance of DescribeMacModificationTasksInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
DescribeMacModificationTasksOutput

An instance of DescribeMacModificationTasksOutput.

Input

DescribeMacModificationTasksInput dataclass

Bases: _SerdeShape

Dataclass for DescribeMacModificationTasksInput structure.

Attributes

dry_run class-attribute instance-attribute 
dry_run: bool | None = ...

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.

filters class-attribute instance-attribute 
filters: list[Filter] | None = ...

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).

mac_modification_task_ids class-attribute instance-attribute 
mac_modification_task_ids: list[str] | None = ...

The ID of task.

max_results class-attribute instance-attribute 
max_results: int | None = ...

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.

next_token class-attribute instance-attribute 
next_token: str | None = ...

The token to use to retrieve the next page of results.

Output

DescribeMacModificationTasksOutput dataclass

Bases: _SerdeShape

Dataclass for DescribeMacModificationTasksOutput structure.

Attributes

mac_modification_tasks class-attribute instance-attribute 
mac_modification_tasks: list[MacModificationTask] | None = ...

Information about the tasks.

next_token class-attribute instance-attribute 
next_token: str | None = ...

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

response_metadata class-attribute instance-attribute 
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.