ImportAdmins-阿里云帮助中心

Imports one or more admins to a specified instance. The caller must have the AliyunCCCFullAccess permission, which you can grant in the RAM console.

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
InstanceId	string	Yes	The instance ID.	ccc-test
RamIdList	string	Yes	A list of UIDs for Alibaba Cloud RAM accounts. The value must be a string-encoded JSON array. The array supports up to 20 UIDs.	["26972543893791****"]

Response elements

Element	Type	Description	Example
	object	The response object.
HttpStatusCode	integer	The HTTP status code.	200
RequestId	string	The request ID.	1CDB5C94-ACFB-59B5-85FE-C1DAF8049C63
Code	string	The response code.	OK
Message	string	The response message.	无
Data	array<object>	A list of imported admins.
	object
InstanceId	string	The instance ID.	ccc-test
UserId	string	The agent ID.	agent@ccc-test
RoleId	string	The role ID.	Admin@ccc-test
Extension	string	The agent extension.	8021****
RamId	string	The UID of the Alibaba Cloud RAM account.	26972543893791****

Examples

Success response

JSON format

{
  "HttpStatusCode": 200,
  "RequestId": "1CDB5C94-ACFB-59B5-85FE-C1DAF8049C63",
  "Code": "OK",
  "Message": "无",
  "Data": [
    {
      "InstanceId": "ccc-test",
      "UserId": "agent@ccc-test",
      "RoleId": "Admin@ccc-test",
      "Extension": "8021****",
      "RamId": "26972543893791****"
    }
  ]
}

Error codes

HTTP status code	Error code	Error message
400	Parameter.Enumeration	The parameter %s must be one of the value of enumeration %s.
400	Parameter.Maximum	The parameter %s must be less than or equal to %s.
400	Parameter.Minimum	The parameter %s must be greater than or equal to %s.
400	Parameter.Blank	The parameter %s may not be null or blank.
400	Parameter.Empty	The parameter %s may not be null or empty.
404	NotExists.InstanceId	The specified instance %s does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.