All Products
Search
Document Center

Resource Management:RegisterDelegatedAdministrator

Last Updated:Jun 25, 2024

Specifies a member in a resource directory as a delegated administrator account of a trusted service.

Operation description

The delegated administrator account can be used to access the information of the resource directory and view the structure and members of the resource directory. The delegated administrator account can also be used to perform service-related management operations in the trusted service on behalf of the management account of the resource directory. When you call this operation, you must take note of the following limits:

  • Only some trusted services support delegated administrator accounts. For more information, see Supported trusted services.
  • Only the management account of a resource directory or an authorized RAM user or RAM role of the management account can be used to call this operation.
  • The number of delegated administrator accounts that are allowed for a trusted service is defined by the trusted service.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
AccountIdstringYes

The Alibaba Cloud account ID of the member in the resource directory.

181761095690****
ServicePrincipalstringYes

The identifier of the trusted service.

For more information, see the Trusted service identifier column in Supported trusted services.

cloudfw.aliyuncs.com

Response parameters

ParameterTypeDescriptionExample
object

The returned result.

RequestIdstring

The ID of the request.

0A45FC8F-54D2-4A65-8338-25E5DEBDA304

Examples

Sample success responses

JSONformat

{
  "RequestId": "0A45FC8F-54D2-4A65-8338-25E5DEBDA304"
}

Error codes

HTTP status codeError codeError message
409InvalidParameter.ServicePrincipalThe specified ServicePrincipal is invalid.
409AccountAlreadyRegisteredThe specified account is already a delegated administrator for this service.
409DelegatedAccountNumberExceededThe maximum number of delegated administrators for the service principal is exceeded.
409CannotRegisterMasterAsDelegatedAdministratorYou attempted to register the enterprise management account as a delegated administrator for the service. You can designate only a member account as a delegated administrator.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history