Skip to content

Latest commit

 

History

History
125 lines (87 loc) · 4.07 KB

examples-iam-users.rst

File metadata and controls

125 lines (87 loc) · 4.07 KB

Managing |IAM| Users

Creating a User

Create a new |IAM| user by providing the user name to the |iamclient|'s :methodname:`createUser` method, either directly or using a :aws-java-class:`CreateUserRequest <services/identitymanagement/model/CreateUserRequest>` object containing the user name.

Imports

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/CreateUser.java
   :lines: 16-19
   :language: java

Code

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/CreateUser.java
   :lines: 39-45
   :dedent: 8
   :language: java

See the :sdk-examples-java-iam:`complete example <CreateUser.java>` on GitHub.

Listing Users

To list the |IAM| users for your account, create a new :aws-java-class:`ListUsersRequest <services/identitymanagement/model/ListUsersRequest>` and pass it to the |iamclient|'s :methodname:`listUsers` method. You can retrieve the list of users by calling :methodname:`getUsers` on the returned :aws-java-class:`ListUsersResponse <services/identitymanagement/model/ListUsersResponse>` object.

The list of users returned by :methodname:`listUsers` is paged. You can check to see there are more results to retrieve by calling the response object's :methodname:`getIsTruncated` method. If it returns :code-java:`true`, then call the request object's :methodname:`setMarker()` method, passing it the return value of the response object's :methodname:`getMarker()` method.

Imports

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/ListUsers.java
   :lines: 16-20
   :language: java

Code

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/ListUsers.java
   :lines: 28-46
   :dedent: 8
   :language: java

See the :sdk-examples-java-iam:`complete example <ListUsers.java>` on GitHub.

Updating a User

To update a user, call the |iamclient| object's :methodname:`updateUser` method, which takes a :aws-java-class:`UpdateUserRequest <services/identitymanagement/model/UpdateUserRequest>` object that you can use to change the user's name or path.

Imports

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/UpdateUser.java
   :lines: 16-19
   :language: java

Code

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/UpdateUser.java
   :lines: 40-47
   :dedent: 8
   :language: java

See the :sdk-examples-java-iam:`complete example <UpdateUser.java>` on GitHub.

Deleting a User

To delete a user, call the |iamclient|'s :methodname:`deleteUser` request with a :aws-java-class:`UpdateUserRequest <services/identitymanagement/model/UpdateUserRequest>` object set with the user name to delete.

Imports

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/DeleteUser.java
   :lines: 16-19
   :language: java

Code

.. literalinclude:: example_code/iam/src/main/java/aws/example/iam/DeleteUser.java
   :lines: 39-51
   :dedent: 8
   :language: java

See the :sdk-examples-java-iam:`complete example <DeleteUser.java>` on GitHub.

More Information