All Products
Search
Document Center

Resource Management:GetServiceLinkedRoleDeletionStatus

Last Updated:Aug 28, 2026

Queries the status of a service-linked role deletion task.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

DeletionTaskId

string

No

The ID of the deletion task.

task/acs-service-role/hdr.aliyuncs.com/AliyunServiceRoleForHdr/c4d22c52-247f-4ee1-83a2-6c0460bd****

Response elements

Element

Type

Description

Example

object

Reason

object

The cause of the deletion task failure.

Message

string

The failure information.

Service-Linked Role acs:ram::196813227629****:role/aliyunserviceroleforhdr cannot be deleted as it is in use by hdr.aliyuncs.com.

RoleUsages

object

RoleUsage

array<object>

Resources that the service-linked role can use.

array<object>

Resources that the service-linked role can use.

Region

string

The region.

global

Resources

object

Resource

array

Resource details.

string

Resource details.

acs:hdr::196813227629****:sitepair/s-000h0y6kld0zwk8l****

RequestId

string

The request ID.

07194EB1-DB50-4513-A51D-99B30D635AEF

Status

string

The task status. Valid values:

  • SUCCEEDED

  • IN_PROGRESS

  • FAILED

  • NOT_STARTED

  • INTERNAL_ERROR

FAILED

Examples

Success response

JSON format

{
  "Reason": {
    "Message": "Service-Linked Role acs:ram::196813227629****:role/aliyunserviceroleforhdr cannot be deleted as it is in use by hdr.aliyuncs.com.",
    "RoleUsages": {
      "RoleUsage": [
        {
          "Region": "global",
          "Resources": {
            "Resource": [
              "acs:hdr::196813227629****:sitepair/s-000h0y6kld0zwk8l****"
            ]
          }
        }
      ]
    }
  },
  "RequestId": "07194EB1-DB50-4513-A51D-99B30D635AEF",
  "Status": "FAILED"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter.DeletionTaskId The DeletionTaskId is invalid. The DeletionTaskId is invalid.
400 InvalidParameter.DeletionTaskId.Length The length of DeletionTaskId must be between 26 and 255 characters. The length of DeletionTaskId must be between 26 and 255 characters.
404 EntityNotExist.ServiceLinkedRole.DeletionTask The deletion task for the given ID does not exist. The deletion task for the given ID does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.