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: testing/wip-vshankar-testing-20250115.164543-debug~40^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=afa2b83687de96bfe9ae90c73744f71217dabcbe;p=ceph-ci.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 --- diff --git a/doc/radosgw/account.rst b/doc/radosgw/account.rst index 6dab997d93e..0e4ede5a50a 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