From: Casey Bodley Date: Thu, 9 Jan 2025 17:52:03 +0000 (-0500) Subject: doc/rgw: document UserName requirements for account migration X-Git-Tag: v19.2.3~421^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=7389e74145541eb6834471aa6c3c8e48a77331aa;p=ceph.git doc/rgw: document UserName requirements for account migration clarify the following error when migrating a user into an account: > could not modify user: unable to modify user, UserName contains invalid characters Fixes: https://tracker.ceph.com/issues/69470 Signed-off-by: Casey Bodley (cherry picked from commit afa2b83687de96bfe9ae90c73744f71217dabcbe) --- diff --git a/doc/radosgw/account.rst b/doc/radosgw/account.rst index 6dab997d93e67..0e4ede5a50a79 100644 --- a/doc/radosgw/account.rst +++ b/doc/radosgw/account.rst @@ -174,6 +174,11 @@ An existing user can be adopted into an account with ``user modify``:: .. note:: Account membership is permanent. Once added, users cannot be removed from their account. +.. note:: The IAM User API imposes additional requirements on the format + of ``UserName``, which is enforced when migrating users into an account. + If migration fails with "UserName contains invalid characters", the + ``--display-name`` should be modified to match ``[\w+=,.@-]+``. + .. warning:: Ownership of the user's notification topics will not be transferred to the account. Notifications will continue to work, but the topics will no longer be visible to SNS Topic APIs. Topics and