> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/~/revisions/bM7yG7XCmGE9IxWqMpBu/managed-services/s3-object-storage/how-tos/retrieve-user-ids.md).
# Retrieve User IDs
Depending on the selected S3 client, you have various options for sharing buckets, objects, or object versions with users of the Object Storage. In addition to roles and predefined profiles, you can share the content of your buckets with selected users by using their IONOS S3 Object Storage ID known as **Canonical user ID** using the [Access Control List](/cloud/~/revisions/bM7yG7XCmGE9IxWqMpBu/managed-services/s3-object-storage/settings/access-control-list.md) and Bucket Policies.
You can also share buckets and objects with other users by using their user IDs. User identification is possible through the **Canonical user ID**, and **Email address**. For more information, see [S3 Credentials](/cloud/~/revisions/bM7yG7XCmGE9IxWqMpBu/managed-services/s3-object-storage/concepts/key-management.md#s3-credentials).
## Retrieve Canonical user ID
Retrieving the Canonical user ID includes the following:
* [Retrieve your Canonical User ID](#retrieve-your-canonical-user-id)
* [Retrieve the Canonical User ID of a grantee](#retrieve-the-canonical-user-id-of-a-grantee)
* [Retrieve the Canonical User ID of a new user](#retrieve-the-canonical-user-id-of-a-new-user)
## Retrieve your Canonical User ID
For another user to share the content of their IONOS S3 Object Storage with you, they need your IONOS S3 Object Storage ID, which you will find in the Object Storage Key Manager.
{% hint style="info" %}
**Prerequisite:** Make sure you have the corresponding permission to create the Object Storage. Only contract owners and administrators with the Object-Storage-Key can set up the object storage.
{% endhint %}
1\. In the **DCD**, go to **Menu** > **Storage** and click the **IONOS S3 Object Storage**.
2\. Select the **Key management** tab.
3\. In the **S3 Credentials**, click **Copy** against the **Canonical User ID**. You can also copy the required user IDs and use them to get access to other buckets and objects.
{% hint style="success" %}
**Result:** Your Canonical user ID is successfully copied to the clipboard.
{% endhint %}
## Retrieve the Canonical User ID of a grantee
The grantee is the user under the same contract at IONOS, but it also could be the user under another contract. You need the user's Canonical user ID to share access to the bucket or object using ACL. For more information, see [Grant access](/cloud/~/revisions/bM7yG7XCmGE9IxWqMpBu/managed-services/s3-object-storage/concepts/access-management.md#grant-access).
To retrieve the Canonical user ID of a grantee, follow these steps:
**Prerequisites**:
* Make sure the grantee Object Storage account already exists. If not, then, begin with creating the grantee by following the steps in [Retrieve the Canonical User ID of a new user](#retrieve-the-canonical-user-id-of-a-new-user).
* Make sure you have the corresponding permission to create the IONOS S3 Object Storage. Only contract owners and administrators can retrieve the IONOS S3 Object Storage IDs of their IONOS account users.
1\. In the **DCD**, go to **Menu** > **Management** > **Users & Groups**.
2\. Select the user from the **Users** list and click the **Object Storage Keys** tab.
3\. Click the S3 link and copy the user's S3 Canonical User ID. This ID is used to share access to this user. You can also copy the required other user IDs and use them for sharing your objects with this user.
{% hint style="success" %}
**Result:** The Canonical user ID for the grantee is successfully retrieved.
{% endhint %}
## Retrieve the Canonical User ID of a new user
If the grantee’s user account does not already exist or if you want to assign a different set of permissions, then, the root user of the contract needs to create the user account and then retrieve the Canonical user ID to grant access to buckets and objects.
1\. In the **DCD**, go to **Menu** > **Management** > **Users & Groups**.
2\. In the **Users** tab, click **+ Create**.
3\. Enter the user details such as **First Name**, **Last Name**, **Email**, **Password**, and click **Create**.
{% hint style="info" %}
**Info:** The new user is created and shown in the **Users** list and their S3 access keys are automatically created but are disabled. When the user is added to a group with **Use Object Storage** privilege enabled, the access key is set to `active`.
{% endhint %}
4\. In the **Users** list, select the user and click the **Object Storage Keys** tab.
5\. Select the checkbox **Active** to activate the Key.
6\. Click the S3 link and copy the user's S3 Canonical User ID. This ID is used to share access to this user. You can also copy the required other user IDs and use them for sharing your objects with this user.
{% hint style="success" %}
**Result:** The new user is successfully created and the Canonical user ID is retrieved. You can now share access to the bucket with the new user using [Share access](/cloud/~/revisions/bM7yG7XCmGE9IxWqMpBu/managed-services/s3-object-storage/concepts/access-management.md#share-access).
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.ionos.com/cloud/~/revisions/bM7yG7XCmGE9IxWqMpBu/managed-services/s3-object-storage/how-tos/retrieve-user-ids.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.