To send an Identity Management Service (IMS) API request, you must send an HTTPS GET or POST request to the IMS endpoint. You must add the request parameters that correspond to the API operation being called. After you call the API operation, the system returns a response. The request and response are encoded in UTF-8.

Request syntax

IMS API operations use the RPC protocol. You can call IMS API operations by sending HTTP GET or POST requests.

The request syntax is as follows:
https://Endpoint/?Action=xx&Parameters
where:
  • Endpoint

    The endpoint of the IMS API is ims.aliyuncs.com.

  • Action

    The name of the operation being performed. For example, to create a RAM user, you must set the Action parameter to CreateUser.

  • Parameters

    The request parameters for the operation. Separate multiple parameters with ampersands (&).

    Request parameters include both common parameters and operation-specific parameters. Common parameters include the API version and authentication information. For more information, see Common parameters.

The following example demonstrates how to call the CreateUser operation in IMS:
Note The sample requests in this topic are formatted for better readability.
https://ims.aliyuncs.com/?Action=CreateUser
&UserPrincipalName=test@example.onaliyun.com
&DisplayName=test
&Version=2019-08-15
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dg****
&SignatureMethod=HMAC-SHA1
&SignatureNonce=1521552885****
&SignatureVersion=1.0
&AccessKeyId=LTAI4GENiH2u8MVj7Khh****
&Timestamp=2020-06-01T12:00:00Z