quilt3.admin Python API

quilt3.admin.types

ManagedRole(id: str, name: str, arn: str, typename__: Literal['ManagedRole']) -> None

UnmanagedRole(id: str, name: str, arn: str, typename__: Literal['UnmanagedRole']) -> None

User(name: str, email: str, date_joined: datetime.datetime, last_login: datetime.datetime, is_active: bool, is_admin: bool, is_sso_only: bool, is_service: bool, role: Optional[Annotated[Union[quilt3.admin.types.ManagedRole, quilt3.admin.types.UnmanagedRole], FieldInfo(annotation=NoneType, required=True, discriminator='typename__')]], extra_roles: List[Annotated[Union[quilt3.admin.types.ManagedRole, quilt3.admin.types.UnmanagedRole], FieldInfo(annotation=NoneType, required=True, discriminator='typename__')]]) -> None

SSOConfig(text: str, timestamp: datetime.datetime, uploader: quilt3.admin.types.User) -> None

TabulatorTable(name: str, config: str) -> None

Bucket(name: str, title: str, icon_url: Optional[str], description: Optional[str], overview_url: Optional[str], tags: Optional[List[str]], relevance_score: int, last_indexed: Optional[datetime.datetime], sns_notification_arn: Optional[str], scanner_parallel_shards_depth: Optional[int], skip_meta_data_indexing: Optional[bool], file_extensions_to_index: Optional[List[str]], index_content_bytes: Optional[int], prefixes: List[str]) -> None

quilt3.admin.api_keys

Admin API for managing API keys.

list(email: Optional[str] = None, key_name: Optional[str] = None, fingerprint: Optional[str] = None, status: Optional[Literal['ACTIVE', 'EXPIRED']] = None) -> List[quilt3.api_keys.APIKey]

List API keys. Optionally filter by user email, key name, fingerprint, or status.

Arguments

• email: Filter by user email.

• key_name: Filter by key name.

• fingerprint: Filter by key fingerprint.

• status: Filter by "ACTIVE" or "EXPIRED". None returns all.

Returns

List of API keys matching the filters.

get(id: str) -> Optional[quilt3.api_keys.APIKey]

Get a specific API key by ID.

Arguments

• id: The API key ID.

Returns

The API key, or None if not found.

revoke(id: str) -> None

Revoke an API key.

Arguments

• id: The API key ID to revoke.

Raises

• Quilt3AdminError: If the operation fails.

quilt3.admin.buckets

get(name: str) -> Optional[quilt3.admin.types.Bucket]

Get a specific bucket configuration from the registry. Returns None if the bucket does not exist.

Arguments

• name: Name of the bucket to get.

list() -> list[quilt3.admin.types.Bucket]

List all bucket configurations in the registry.

add(name: str, title: str, *, description: Optional[str] = None, icon_url: Optional[str] = None, overview_url: Optional[str] = None, tags: Optional[List[str]] = None, relevance_score: Optional[int] = None, sns_notification_arn: Optional[str] = None, scanner_parallel_shards_depth: Optional[int] = None, skip_meta_data_indexing: Optional[bool] = None, file_extensions_to_index: Optional[List[str]] = None, index_content_bytes: Optional[int] = None, delay_scan: Optional[bool] = None, browsable: Optional[bool] = None, prefixes: Optional[List[str]] = None) -> quilt3.admin.types.Bucket

Add a new bucket to the registry.

Arguments

• name: S3 bucket name.

• title: Display title for the bucket.

• description: Optional description.

• icon_url: Optional URL for bucket icon.

• overview_url: Optional URL for bucket overview page.

• tags: Optional list of tags.

• relevance_score: Optional relevance score for bucket ordering.

• sns_notification_arn: Optional SNS topic ARN for notifications.

• scanner_parallel_shards_depth: Optional depth for parallel scanning.

• skip_meta_data_indexing: If True, skip metadata indexing.

• file_extensions_to_index: Optional list of file extensions to index content.

• index_content_bytes: Optional max bytes of content to index.

• delay_scan: If True, delay initial bucket scan.

• browsable: If True, bucket is browsable.

• prefixes: Optional list of S3 prefixes to scope bucket access to. If provided, only these prefixes will be indexed and verified for access.

update(name: str, title: str, *, description: Optional[str] = None, icon_url: Optional[str] = None, overview_url: Optional[str] = None, tags: Optional[List[str]] = None, relevance_score: Optional[int] = None, sns_notification_arn: Optional[str] = None, scanner_parallel_shards_depth: Optional[int] = None, skip_meta_data_indexing: Optional[bool] = None, file_extensions_to_index: Optional[List[str]] = None, index_content_bytes: Optional[int] = None, browsable: Optional[bool] = None, prefixes: Optional[List[str]] = None) -> quilt3.admin.types.Bucket

Update an existing bucket configuration.

Arguments

• name: S3 bucket name.

• title: Display title for the bucket.

• description: Optional description.

• icon_url: Optional URL for bucket icon.

• overview_url: Optional URL for bucket overview page.

• tags: Optional list of tags.

• relevance_score: Optional relevance score for bucket ordering.

• sns_notification_arn: Optional SNS topic ARN for notifications.

• scanner_parallel_shards_depth: Optional depth for parallel scanning.

• skip_meta_data_indexing: If True, skip metadata indexing.

• file_extensions_to_index: Optional list of file extensions to index content.

• index_content_bytes: Optional max bytes of content to index.

• browsable: If True, bucket is browsable.

• prefixes: Optional list of S3 prefixes to scope bucket access to. If provided, only these prefixes will be indexed and verified for access. Changing prefixes will trigger permission re-verification.

remove(name: str) -> None

Remove a bucket from the registry.

Arguments

• name: Name of the bucket to remove.

quilt3.admin.roles

list() -> List[Union[quilt3.admin.types.ManagedRole, quilt3.admin.types.UnmanagedRole]]

Get a list of all roles in the registry.

quilt3.admin.users

get(name: str) -> Optional[quilt3.admin.types.User]

Get a specific user from the registry. Return None if the user does not exist.

Arguments

• name: Username of user to get.

list() -> List[quilt3.admin.types.User]

Get a list of all users in the registry.

create(name: str, email: str, role: str, extra_roles: Optional[List[str]] = None) -> quilt3.admin.types.User

Create a new user in the registry.

Arguments

• name: Username of user to create.

• email: Email of user to create.

• role: Active role of the user.

• extra_roles: Additional roles to assign to the user.

delete(name: str) -> None

Delete user from the registry.

Arguments

• name: Username of user to delete.

set_email(name: str, email: str) -> quilt3.admin.types.User

Set the email for a user.

Arguments

• name: Username of user to update.

• email: Email to set for the user.

set_admin(name: str, admin: bool) -> quilt3.admin.types.User

Set the admin status for a user.

Arguments

• name: Username of user to update.

• admin: Admin status to set for the user.

set_active(name: str, active: bool) -> quilt3.admin.types.User

Set the active status for a user.

Arguments

• name: Username of user to update.

• active: Active status to set for the user.

reset_password(name: str) -> None

Reset the password for a user.

Arguments

• name: Username of user to update.

set_role(name: str, role: str, extra_roles: Optional[List[str]] = None, *, append: bool = False) -> quilt3.admin.types.User

Set the active and extra roles for a user.

Arguments

• name: Username of user to update.

• role: Role to be set as the active role.

• extra_roles: Additional roles to assign to the user.

• append: If True, append the extra roles to the existing roles. If False, replace the existing roles.

add_roles(name: str, roles: List[str]) -> quilt3.admin.types.User

Add roles to a user.

Arguments

• name: Username of user to update.

• roles: Roles to add to the user.

remove_roles(name: str, roles: List[str], fallback: Optional[str] = None) -> quilt3.admin.types.User

Remove roles from a user.

Arguments

• name: Username of user to update.

• roles: Roles to remove from the user.

• fallback: If set, the role to assign to the user if the active role is removed.

quilt3.admin.sso_config

get() -> Optional[quilt3.admin.types.SSOConfig]

Get the current SSO configuration.

set(config: Optional[str]) -> Optional[quilt3.admin.types.SSOConfig]

Set the SSO configuration. Pass None to remove SSO configuration.

quilt3.admin.tabulator

list_tables(bucket_name: str) -> list[quilt3.admin.types.TabulatorTable]

List all tabulator tables in a bucket.

set_table(bucket_name: str, table_name: str, config: Optional[str]) -> None

Set the tabulator table configuration. Pass None to remove the table.

rename_table(bucket_name: str, table_name: str, new_table_name: str) -> None

Rename tabulator table.

get_open_query() -> bool

Get the open query status.

set_open_query(enabled: bool) -> None

Set the open query status.