--- title: "User CLI reference" description: "Customer-hosted cloud features" --- # User CLI reference #### Customer-hosted cloud features :::note Some features are only available on customer-hosted clouds. Reach out to [support@anyscale.com](mailto:support@anyscale.com) for info. ::: ## User CLI ### `anyscale user batch-create` **Usage** `anyscale user batch-create [OPTIONS]` Batch create, as an admin, users without email verification. **Options** - **`--users-file/-f`**: Path to a YAML file that contains the information for user accounts to be created. #### Examples ::::tabs :::tab[CLI] ```bash $ anyscale user batch-create --users-file users.yaml (anyscale +0.5s) Creating users... (anyscale +0.8s) 2 users created. $ cat users_file.yaml create_users: - name: name1 email: test1@anyscale.com password: '' is_sso_user: false lastname: lastname1 title: title1 - name: name2 email: test2@anyscale.com password: '' is_sso_user: false lastname: lastname2 title: title2 ``` ::: :::: ### `anyscale user list` **Usage** `anyscale user list [OPTIONS]` List users within your organization. **Options** - **`--email`**: Filter users by email. - **`--name`**: Filter users by display name. - **`--collaborator-type`**: Filter users by collaborator type. - **`--service-account`**: Only show service accounts. - **`--user-account`**: Only show user accounts (non-service accounts). - **`--max-items`**: Maximum number of users to display when running non-interactively. - **`--page-size`**: Items per page (max 50). - **`--json/--no-json`**: Render output as JSON instead of a table. - **`--interactive/--no-interactive`**: Enable or disable interactive pagination. #### Examples ::::tabs :::tab[CLI] ```bash $ anyscale user list --page-size 5 --no-interactive Output USERS: EMAIL ID NAME ROLE CREATED AT owner@anyscale.com usr_owner Owner Name owner 2024-01-01 12:00 service@anyscale.com Service Bot collaborator 2024-02-01 08:30 ``` ::: :::: ### `anyscale user get` **Usage** `anyscale user get [OPTIONS]` Get details for a single user in your organization. **Options** - **`--email`**: Email address of the user. - **`--name`**: Display name of the user. - **`--collaborator-type`**: Optional collaborator type constraint. - **`--service-account`**: Restrict to service accounts. - **`--user-account`**: Restrict to individual user accounts. - **`--json/--no-json`**: Output JSON instead of YAML. #### Examples ::::tabs :::tab[CLI] ```bash $ anyscale user get --email owner@anyscale.com --json Output { "name": "Owner Name", "email": "owner@anyscale.com", "created_at": "2024-01-01T12:00:00+00:00", "permission_level": "owner", "user_id": "usr_owner" } ``` ::: :::: ### `anyscale user list-permissions` **Usage** `anyscale user list-permissions [OPTIONS]` List users and their effective cloud/project permissions across the organization. Shows each user's access to clouds and projects, combining both individually granted permissions and permissions inherited from user groups. Also lists the current organization owners. Output is JSON. Use --output to save to a file. **Options** - **`--user-id`**: Filter to a specific user ID. If not provided, lists permissions for all users. - **`--output/-o`**: Write JSON output to a file instead of stdout. #### Examples ::::tabs :::tab[CLI] ```bash # List all users' effective cloud & project permissions $ anyscale user list-permissions (anyscale +0.6s) Listing users and their effective permissions... { "organization_id": "org_p72", "org_owners": [ { "user_email": "admin1@p72.com", "user_id": "usr_aaa" } ], "users": [ { "clouds": [ { "cloud_id": "cld_111", "cloud_name": "prod-cloud", "role": "collaborator", "projects": [ { "project_id": "prj_111", "project_name": "prod-project", "role": "readonly" } ] } ], "user_email": "alice@p72.com", "user_id": "usr_abc" } ] } # List permissions for a specific user $ anyscale user list-permissions --user-id usr_abc (anyscale +0.4s) Listing users and their effective permissions... { "organization_id": "org_p72", "org_owners": [ { "user_email": "admin1@p72.com", "user_id": "usr_aaa" } ], "users": [ { "clouds": [ { "cloud_id": "cld_111", "cloud_name": "prod-cloud", "role": "collaborator" } ], "user_email": "alice@p72.com", "user_id": "usr_abc" } ] } ``` ::: :::: ## User models ### `AdminCreateUser` User to be created by an admin. #### Fields - **`name` (str)**: First name of the user to be created. - **`email` (str)**: Email of the user to be created. - **`password` (str | None)**: Password for the user account being created. - **`is_sso_user` (bool)**: Whether the user is an SSO user. SSO users can log in using SSO. - **`lastname` (str | None)**: Optional last name of the user to be created. - **`title` (str | None)**: Optional title of the user to be created. #### Python Methods ```python def to_dict(self) -> Dict[str, Any] """Return a dictionary representation of the model.""" ``` #### Examples ::::tabs :::tab[Python] ```python import anyscale from anyscale.user.models import AdminCreateUser admin_create_user = AdminCreateUser( # First name of the user to be created. name="name", # Email of the user to be created. email="test@anyscale.com", # Password for the user account being created. password="", # Whether the user is an SSO user. SSO users can log in using SSO. is_sso_user=False, # Optional last name of the user to be created. lastname="lastname", # Optional title of the user to be created. title="title", ) ``` ::: :::: ### `AdminCreateUsers` Users to be created by an admin. #### Fields - **`create_users` (List\[Dict\[str, Any\]\])**: Users to be created by an admin. #### Python Methods ```python def to_dict(self) -> Dict[str, Any] """Return a dictionary representation of the model.""" ``` #### Examples ::::tabs :::tab[Python] ```python import anyscale from anyscale.user.models import AdminCreateUser admin_create_user = AdminCreateUser( # First name of the user to be created. name="name", # Email of the user to be created. email="test@anyscale.com", # Password for the user account being created. password="", # Whether the user is an SSO user. SSO users can log in using SSO. is_sso_user=False, # Optional last name of the user to be created. lastname="lastname", # Optional title of the user to be created. title="title", ) admin_create_users = AdminCreateUsers( # Users to be created by an admin. create_users=[admin_create_user] ) ``` ::: :::: ### `AdminCreatedUser` User account created by an admin that has organization collaborator permissions. #### Fields - **`user_id` (str)**: ID of the user that has been created. - **`name` (str)**: First name of the user that has been created. - **`email` (str)**: Email of the user that has been created. - **`created_at` (datetime)**: The timestamp of when the user is created. - **`is_sso_user` (bool)**: Whether the user is an SSO user. SSO users can log in using SSO. - **`lastname` (str | None)**: Optional last name of the user that has been created. - **`title` (str | None)**: Optional title of the user that has been created. #### Python Methods ```python def to_dict(self) -> Dict[str, Any] """Return a dictionary representation of the model.""" ``` #### Examples ::::tabs :::tab[Python] ```python import anyscale from anyscale.user.models import AdminCreatedUser admin_create_user = AdminCreateUser( # First name of the user to be created. name="name", # Email of the user to be created. email="test@anyscale.com", # Password for the user account being created. password="", # Whether the user is an SSO user. SSO users can log in using SSO. is_sso_user=False, # Optional last name of the user to be created. lastname="lastname", # Optional title of the user to be created. title="title", ) admin_created_users: List[AdminCreatedUser] = anyscale.user.admin_batch_create([admin_create_user]) ``` ::: :::: ### `User` Collaborator returned by `anyscale.user` APIs. #### Fields - **`email` (str)**: Email address associated with the collaborator. - **`name` (str)**: Display name of the collaborator. - **`created_at` (datetime)**: Timestamp for when the collaborator was created. - **`permission_level` (str)**: Organization permission level for the collaborator. - **`user_id` (str | None)**: Optional user ID backing the collaborator (may be absent for service accounts). #### Python Methods ```python def to_dict(self) -> Dict[str, Any] """Return a dictionary representation of the model.""" ``` #### Examples ::::tabs :::tab[Python] ```python import anyscale for user in anyscale.user.list(max_items=5): print(f"{user.email} ({user.permission_level})") ``` ::: :::: --- Previous: [User group](/reference/cli/user-group.md) | Next: [Workspaces](/reference/cli/workspaces.md)