RAM provides three API sets for different use cases: IMS (identity management), RAM (policies and roles), and STS (temporary security tokens). For more information about Alibaba Cloud APIs, see Overview.
Overview
RAM provides three API sets: IMS, RAM, and STS.
Select an API based on your scenario.
|
Scenario |
Description |
API selection |
Difference |
|
User management |
Manage RAM users, AccessKey pairs, logon passwords, and MFA devices. |
|
|
|
User group management |
Manage RAM user groups and their members. |
||
|
Security settings |
Manage password policies, global security preferences, default domain names, user credential reports, and account security reports. |
||
|
Policy management |
Manage policies and grant or revoke permissions for RAM users, roles, and user groups. |
|
|
|
Role management |
Manage RAM roles. |
||
|
Role usage |
Obtain STS tokens by assuming roles. |
None. |
|
|
Single sign-on (SSO) management |
Manage identity providers (IdPs) for user-based and role-based SSO. |
None. |
|
|
Role-based SSO usage |
Obtain STS tokens by using role-based SSO. |
None. |
|
|
Open authorization (OAuth) management |
Manage applications and application secrets. |
None. |
IMS API
API versions
|
API version |
Description |
|
Recommended. |
Endpoints
For more information, see Endpoints.
User identities
|
User identity |
Supported |
|
Yes |
|
|
RAM user (recommended) |
Yes |
|
RAM role (recommended) |
Yes |
We recommend that you use a RAM user or RAM role to call operations. Grant the required permissions before making API calls.
Format
Call methods
|
Call method |
Supported |
Description |
|
Alibaba Cloud SDK (recommended) |
Yes |
Supported languages and dependencies:IMS SDKs. |
|
Yes |
None. |
|
|
Partially supported |
Supported resources: Terraform Registry. |
|
|
Partially supported |
For more information, see Resource type index. |
|
|
Yes |
None. |
RAM API
API versions
|
API version |
Description |
|
Recommended. |
Endpoints
For more information, see Endpoints.
User identities
|
User identity |
Supported |
|
Yes |
|
|
RAM user (recommended) |
Yes |
|
RAM role (recommended) |
Yes |
We recommend that you use a RAM user or RAM role to call operations. Grant the required permissions before making API calls.
Format
RPC API
Call methods
|
Call method |
Supported |
Description |
|
Alibaba Cloud SDK (recommended) |
Yes |
Supported languages and dependencies:RAM SDKs. |
|
Yes |
None. |
|
|
Partially supported |
Supported resources: Terraform Registry. |
|
|
Partially supported |
For more information, see Resource type index. |
|
|
Yes |
None. |
STS API
API versions
|
API version |
Description |
|
Recommended. |
Endpoints
For more information, see Endpoints.
User identities
|
Interface |
Supported user identity |
|
Authenticated via SAML assertions. Anonymous access supported. |
|
|
Authenticated via OIDC tokens. Anonymous access supported. |
|
Format
RPC API
Call methods
|
Call method |
Supported |
Description |
|
Alibaba Cloud SDK (recommended) |
Yes |
Supported languages and dependencies:STS SDKs. |
|
Yes |
None. |
|
|
Yes |
None. |
|
|
Not supported. |
None. |
|
|
Yes |
None. |