Skip to content

Retrieves the status of your service-linked role deletion

Description

Retrieves the status of your service-linked role deletion. After you use delete_service_linked_role to submit a service-linked role for deletion, you can use the DeletionTaskId parameter in get_service_linked_role_deletion_status to check the status of the deletion. If the deletion fails, this operation returns the reason that it failed, if that information is returned by the service.

Usage

iam_get_service_linked_role_deletion_status(DeletionTaskId)

Arguments

  • DeletionTaskId

    [required] The deletion task identifier. This identifier is returned by the delete_service_linked_role operation in the format task/aws-service-role/<service-principal-name>/<role-name>/<task-uuid>.

Value

A list with the following syntax:

list(
  Status = "SUCCEEDED"|"IN_PROGRESS"|"FAILED"|"NOT_STARTED",
  Reason = list(
    Reason = "string",
    RoleUsageList = list(
      list(
        Region = "string",
        Resources = list(
          "string"
        )
      )
    )
  )
)

Request syntax

svc$get_service_linked_role_deletion_status(
  DeletionTaskId = "string"
)