Returns drift information for resources in a stack instance¶

Description¶

Returns drift information for resources in a stack instance.

list_stack_instance_resource_drifts returns drift information for the most recent drift detection operation. If an operation is in progress, it may only return partial results.

Usage¶

cloudformation_list_stack_instance_resource_drifts(StackSetName,
  NextToken, MaxResults, StackInstanceResourceDriftStatuses,
  StackInstanceAccount, StackInstanceRegion, OperationId, CallAs)

Arguments¶

• StackSetName

  [required] The name or unique ID of the StackSet that you want to list drifted resources for.

• NextToken

  The token for the next set of items to return. (You received this token from a previous call.)

• MaxResults

  The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

• StackInstanceResourceDriftStatuses

  The resource drift status of the stack instance.

  • DELETED: The resource differs from its expected template configuration in that the resource has been deleted.
  • MODIFIED: One or more resource properties differ from their expected template values.
  • IN_SYNC: The resource's actual configuration matches its expected template configuration.
  • NOT_CHECKED: CloudFormation doesn't currently return this value.

• StackInstanceAccount

  [required] The name of the Amazon Web Services account that you want to list resource drifts for.

• StackInstanceRegion

  [required] The name of the Region where you want to list resource drifts.

• OperationId

  [required] The unique ID of the drift operation.

• CallAs

  [Service-managed permissions] Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.

  By default, SELF is specified. Use SELF for StackSets with self-managed permissions.

  • If you are signed in to the management account, specify SELF.

  • If you are signed in to a delegated administrator account, specify DELEGATED_ADMIN.

    Your Amazon Web Services account must be registered as a delegated administrator in the management account. For more information, see Register a delegated administrator in the CloudFormation User Guide.

Value¶

A list with the following syntax:

list(
  Summaries = list(
    list(
      StackId = "string",
      LogicalResourceId = "string",
      PhysicalResourceId = "string",
      PhysicalResourceIdContext = list(
        list(
          Key = "string",
          Value = "string"
        )
      ),
      ResourceType = "string",
      PropertyDifferences = list(
        list(
          PropertyPath = "string",
          ExpectedValue = "string",
          ActualValue = "string",
          DifferenceType = "ADD"|"REMOVE"|"NOT_EQUAL"
        )
      ),
      StackResourceDriftStatus = "IN_SYNC"|"MODIFIED"|"DELETED"|"NOT_CHECKED"|"UNKNOWN"|"UNSUPPORTED",
      Timestamp = as.POSIXct(
        "2015-01-01"
      )
    )
  ),
  NextToken = "string"
)

Request syntax¶

svc$list_stack_instance_resource_drifts(
  StackSetName = "string",
  NextToken = "string",
  MaxResults = 123,
  StackInstanceResourceDriftStatuses = list(
    "IN_SYNC"|"MODIFIED"|"DELETED"|"NOT_CHECKED"|"UNKNOWN"|"UNSUPPORTED"
  ),
  StackInstanceAccount = "string",
  StackInstanceRegion = "string",
  OperationId = "string",
  CallAs = "SELF"|"DELEGATED_ADMIN"
)