A local account is used to access VMware Cloud Foundation APIs when the management vCenter Server is down. If you upgraded from a previous release or didn't configure the account when deploying using the API, you can set a password using VMware Cloud Foundation APIs.


  1. Log in to the SDDC Manager UI as a user with the ADMIN role.
    For more information about roles, see Managing Users and Groups in VMware Cloud Foundation.
  2. In the navigation pane, click Developer Center > API Explorer.
  3. To verify if the local account is configured, perform the following tasks:
    1. Expand APIs for managing Users.
    2. Expand GET /v1/users/local/admin and click EXECUTE.
    3. In the Response, click LocalUser (admin@local).
      API Response for LocalUser (admin@local).
      You can also download the response by clicking the download icon to the right of LocalUser (admin@local).
  4. If the local account is not configured, perform the following tasks to configure the local account:
    1. Expand PATCH /v1/users/local/admin.
    2. Enter a password for the local account and click EXECUTE.
      API Explorer for updating password for local account.

      Password requirements are described below:

      • Minimum length: 12
      • Maximum length: 127
      • At least one lowercase letter, one uppercase letter, a number, and one of the following special characters ! % @ $ ^ # ? *
      • A character cannot be repeated more than three times consecutively
      • Must not include three of the same consecutive characters
        Note: You must remember the password that you created because it cannot be retrieved. Local account passwords are used in password rotation.