All Products
Search

This Product

    Data Lake Formation:GrantRoleToUsers

    Document Center

    Data Lake Formation:GrantRoleToUsers

    Last Updated:Dec 16, 2025

    Grants a role to one or more users.

    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 syntax

    POST /dlf/v1/auth/roles/grant HTTP/1.1

    Request parameters

    Parameter

    Type

    Required

    Description

    Example

    body

    object

    No

    The request body.

    userPrincipals

    array

    No

    The resource descriptors for users.

    string

    No

    The resource descriptor for a user.

    acs:ram::[accountId]:user/user_name

    rolePrincipal

    string

    No

    The resource descriptor for a role.

    acs:dlf::[accountId]:role/role_name

    Response elements

    Element

    Type

    Description

    Example

    None defined.

    Examples

    Success response

    JSON format

    {}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.