Skip to main content

service_linked_role_deletion_status

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

Overview

Nameservice_linked_role_deletion_status
TypeResource
Idaws.iam.service_linked_role_deletion_status

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
reasonstringAn object that contains details about the reason the deletion failed.
statusstringThe status of the deletion.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_service_linked_role_deletion_statusselectDeletionTaskId, regionRetrieves the status of your service-linked role deletion. After you use DeleteServiceLinkedRole to submit a service-linked role for deletion, you can use the DeletionTaskId parameter in GetServiceLinkedRoleDeletionStatus 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.

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.

NameDatatypeDescription
DeletionTaskIdstringThe deletion task identifier. This identifier is returned by the DeleteServiceLinkedRole operation in the format task/aws-service-role/<service-principal-name>/<role-name>/<task-uuid>.
regionstringAWS region (default: us-east-1)

SELECT examples

Retrieves the status of your service-linked role deletion. After you use DeleteServiceLinkedRole to submit a service-linked role for deletion, you can use the DeletionTaskId parameter in GetServiceLinkedRoleDeletionStatus 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.

SELECT
reason,
status
FROM aws.iam.service_linked_role_deletion_status
WHERE DeletionTaskId = '{{ DeletionTaskId }}' -- required
AND region = '{{ region }}' -- required
;