Skip to content

Describe Mac Modification Tasks

ec2_describe_mac_modification_tasks R Documentation

Describes a System Integrity Protection (SIP) modification task or volume ownership delegation task for an Amazon EC2 Mac instance

Description

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.

Usage

ec2_describe_mac_modification_tasks(DryRun, Filters,
  MacModificationTaskIds, MaxResults, NextToken)

Arguments

DryRun

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

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

MacModificationTaskIds

The ID of task.

MaxResults

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

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

Value

A list with the following syntax:

list(
  MacModificationTasks = list(
    list(
      InstanceId = "string",
      MacModificationTaskId = "string",
      MacSystemIntegrityProtectionConfig = list(
        AppleInternal = "enabled"|"disabled",
        BaseSystem = "enabled"|"disabled",
        DebuggingRestrictions = "enabled"|"disabled",
        DTraceRestrictions = "enabled"|"disabled",
        FilesystemProtections = "enabled"|"disabled",
        KextSigning = "enabled"|"disabled",
        NvramProtections = "enabled"|"disabled",
        Status = "enabled"|"disabled"
      ),
      StartTime = as.POSIXct(
        "2015-01-01"
      ),
      Tags = list(
        list(
          Key = "string",
          Value = "string"
        )
      ),
      TaskState = "successful"|"failed"|"in-progress"|"pending",
      TaskType = "sip-modification"|"volume-ownership-delegation"
    )
  ),
  NextToken = "string"
)

Request syntax

svc$describe_mac_modification_tasks(
  DryRun = TRUE|FALSE,
  Filters = list(
    list(
      Name = "string",
      Values = list(
        "string"
      )
    )
  ),
  MacModificationTaskIds = list(
    "string"
  ),
  MaxResults = 123,
  NextToken = "string"
)