Skip to content

AzureadClient

Attributes

GetMemberGroupsResponse module-attribute

GetMemberGroupsResponse = List[str]

Classes

CreateOffice365GroupInput dataclass

CreateOffice365GroupInput(display_name: Optional[str] = None, description: Optional[str] = None, mail_nickname: Optional[str] = None, group_types: Optional[List[str]] = None, security_enabled: Optional[bool] = None, mail_enabled: Optional[bool] = None)

Create Office 365 group

Attributes

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

Display name of the new group.

description class-attribute instance-attribute
description: Optional[str] = None

Description of the new group.

mail_nickname class-attribute instance-attribute
mail_nickname: Optional[str] = field(default=None, metadata={'wire_name': 'mailNickname'})

The mail alias of the new group.

group_types class-attribute instance-attribute
group_types: Optional[List[str]] = field(default=None, metadata={'wire_name': 'groupTypes'})

For Office 365, group type is 'Unified'.

security_enabled class-attribute instance-attribute
security_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'securityEnabled'})

True if the new group is a security group.

mail_enabled class-attribute instance-attribute
mail_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'mailEnabled'})

True if the new group is a mailing group.

CreateGroupResponse dataclass

CreateGroupResponse(context: Optional[str] = None, id: Optional[str] = None, deleted_date_time: Optional[str] = None, classification: Optional[str] = None, created_date_time: Optional[str] = None, description: Optional[str] = None, display_name: Optional[str] = None, group_types: Optional[List[str]] = None, mail: Optional[str] = None, mail_enabled: Optional[bool] = None, mail_nickname: Optional[str] = None, on_premises_last_sync_date_time: Optional[str] = None, on_premises_security_identifier: Optional[str] = None, on_premises_sync_enabled: Optional[bool] = None, proxy_addresses: Optional[List[str]] = None, renewed_date_time: Optional[str] = None, security_enabled: Optional[bool] = None, visibility: Optional[str] = None)

Response for Create Office 365 group

Attributes

context class-attribute instance-attribute
context: Optional[str] = field(default=None, metadata={'wire_name': '@odata.context'})

@odata.context

id class-attribute instance-attribute
id: Optional[str] = None

id

deleted_date_time class-attribute instance-attribute
deleted_date_time: Optional[str] = field(default=None, metadata={'wire_name': 'deletedDateTime'})

deletedDateTime

classification class-attribute instance-attribute
classification: Optional[str] = None

classification

created_date_time class-attribute instance-attribute
created_date_time: Optional[str] = field(default=None, metadata={'wire_name': 'createdDateTime'})

createdDateTime

description class-attribute instance-attribute
description: Optional[str] = None

description

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

displayName

group_types class-attribute instance-attribute
group_types: Optional[List[str]] = field(default=None, metadata={'wire_name': 'groupTypes'})

groupTypes

mail class-attribute instance-attribute
mail: Optional[str] = None

mail

mail_enabled class-attribute instance-attribute
mail_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'mailEnabled'})

mailEnabled

mail_nickname class-attribute instance-attribute
mail_nickname: Optional[str] = field(default=None, metadata={'wire_name': 'mailNickname'})

mailNickname

on_premises_last_sync_date_time class-attribute instance-attribute
on_premises_last_sync_date_time: Optional[str] = field(default=None, metadata={'wire_name': 'onPremisesLastSyncDateTime'})

onPremisesLastSyncDateTime

on_premises_security_identifier class-attribute instance-attribute
on_premises_security_identifier: Optional[str] = field(default=None, metadata={'wire_name': 'onPremisesSecurityIdentifier'})

onPremisesSecurityIdentifier

on_premises_sync_enabled class-attribute instance-attribute
on_premises_sync_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'onPremisesSyncEnabled'})

onPremisesSyncEnabled

proxy_addresses class-attribute instance-attribute
proxy_addresses: Optional[List[str]] = field(default=None, metadata={'wire_name': 'proxyAddresses'})

proxyAddresses

renewed_date_time class-attribute instance-attribute
renewed_date_time: Optional[str] = field(default=None, metadata={'wire_name': 'renewedDateTime'})

renewedDateTime

security_enabled class-attribute instance-attribute
security_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'securityEnabled'})

securityEnabled

visibility class-attribute instance-attribute
visibility: Optional[str] = None

visibility

CreateSecurityGroupInput dataclass

CreateSecurityGroupInput(display_name: Optional[str] = None, description: Optional[str] = None, mail_nickname: Optional[str] = None, security_enabled: Optional[bool] = None, mail_enabled: Optional[bool] = None)

Create security group

Attributes

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

Display name of the new group.

description class-attribute instance-attribute
description: Optional[str] = None

Description of the new group.

mail_nickname class-attribute instance-attribute
mail_nickname: Optional[str] = field(default=None, metadata={'wire_name': 'mailNickname'})

The mail alias of the new group.

security_enabled class-attribute instance-attribute
security_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'securityEnabled'})

True if the new group is a security group.

mail_enabled class-attribute instance-attribute
mail_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'mailEnabled'})

True if the new group is a mailing group.

GetGroupResponse dataclass

GetGroupResponse(id: Optional[str] = None, deleted_date_time: Optional[str] = None, created_date_time: Optional[str] = None, description: Optional[str] = None, display_name: Optional[str] = None, mail: Optional[str] = None, mail_enabled: Optional[bool] = None, on_premises_last_sync_date_time: Optional[str] = None, on_premises_sync_enabled: Optional[bool] = None, security_enabled: Optional[bool] = None, visibility: Optional[str] = None)

Response for Get group

Attributes

id class-attribute instance-attribute
id: Optional[str] = None

The unique identifier for the group.

deleted_date_time class-attribute instance-attribute
deleted_date_time: Optional[str] = field(default=None, metadata={'wire_name': 'deletedDateTime'})

Date-time the group was deleted.

created_date_time class-attribute instance-attribute
created_date_time: Optional[str] = field(default=None, metadata={'wire_name': 'createdDateTime'})

Date-time the group was created.

description class-attribute instance-attribute
description: Optional[str] = None

An optional description for the group.

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

The display name for the group.

mail class-attribute instance-attribute
mail: Optional[str] = None

The SMTP address for the group.

mail_enabled class-attribute instance-attribute
mail_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'mailEnabled'})

True if the group is mail-enabled.

on_premises_last_sync_date_time class-attribute instance-attribute
on_premises_last_sync_date_time: Optional[str] = field(default=None, metadata={'wire_name': 'onPremisesLastSyncDateTime'})

A date-time indicating the last time at which the group was synced with the on-premises directory.

on_premises_sync_enabled class-attribute instance-attribute
on_premises_sync_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'onPremisesSyncEnabled'})

True if this group is synced from an on-premises directory.

security_enabled class-attribute instance-attribute
security_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'securityEnabled'})

True if the group is a security group.

visibility class-attribute instance-attribute
visibility: Optional[str] = None

Visibility of the group (public or private).

GetUserResponse dataclass

GetUserResponse(id: Optional[str] = None, business_phones: Optional[List[str]] = None, display_name: Optional[str] = None, given_name: Optional[str] = None, job_title: Optional[str] = None, mail: Optional[str] = None, mobile_phone: Optional[str] = None, office_location: Optional[str] = None, preferred_language: Optional[str] = None, surname: Optional[str] = None, user_principal_name: Optional[str] = None)

Response for Get user

Attributes

id class-attribute instance-attribute
id: Optional[str] = None

A unique identifier for the user.

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

The name displayed in the address book for the user.

given_name class-attribute instance-attribute
given_name: Optional[str] = field(default=None, metadata={'wire_name': 'givenName'})

The given name (first name) of the user.

job_title class-attribute instance-attribute
job_title: Optional[str] = field(default=None, metadata={'wire_name': 'jobTitle'})

The user's job title.

mail class-attribute instance-attribute
mail: Optional[str] = None

The SMTP address for the user.

mobile_phone class-attribute instance-attribute
mobile_phone: Optional[str] = field(default=None, metadata={'wire_name': 'mobilePhone'})

The primary cellular telephone number for the user.

office_location class-attribute instance-attribute
office_location: Optional[str] = field(default=None, metadata={'wire_name': 'officeLocation'})

The office location in the user's place of business.

preferred_language class-attribute instance-attribute
preferred_language: Optional[str] = field(default=None, metadata={'wire_name': 'preferredLanguage'})

The preferred language for the user. Should follow ISO 639-1 Code; for example 'en-US'.

surname class-attribute instance-attribute
surname: Optional[str] = None

The user's surname (family name or last name).

user_principal_name class-attribute instance-attribute
user_principal_name: Optional[str] = field(default=None, metadata={'wire_name': 'userPrincipalName'})

The user principal name (UPN) of the user.

GetGroupMembersResponse dataclass

GetGroupMembersResponse(next_link: Optional[str] = None, value: Optional[List[GetUserResponse]] = None)

Response for Get group members

Attributes

next_link: Optional[str] = field(default=None, metadata={'wire_name': '@odata.nextLink'})

Link to get next page of results

value class-attribute instance-attribute
value: Optional[List[GetUserResponse]] = None

Array of users that are members of the group.

CreateGroupInput dataclass

CreateGroupInput(display_name: Optional[str] = None, description: Optional[str] = None, mail_nickname: Optional[str] = None, group_types: Optional[List[str]] = None, security_enabled: Optional[bool] = None, mail_enabled: Optional[bool] = None)

Create group

Attributes

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

Display name of the new group.

description class-attribute instance-attribute
description: Optional[str] = None

Description of the new group.

mail_nickname class-attribute instance-attribute
mail_nickname: Optional[str] = field(default=None, metadata={'wire_name': 'mailNickname'})

The mail alias of the new group.

group_types class-attribute instance-attribute
group_types: Optional[List[str]] = field(default=None, metadata={'wire_name': 'groupTypes'})

Choose 'Unified' for an O365 group. Choose 'None' for a security group.

security_enabled class-attribute instance-attribute
security_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'securityEnabled'})

True if the new group is a security group.

mail_enabled class-attribute instance-attribute
mail_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'mailEnabled'})

True if the new group is a mailing group.

GetMemberGroupsResponseV2 dataclass

GetMemberGroupsResponseV2(value: Optional[GetMemberGroupsResponse] = None)

Response for Check group membership (V2)

GetGroupRequest dataclass

GetGroupRequest(id: Optional[str] = None)

Definition: GetGroup_Request

Attributes

id class-attribute instance-attribute
id: Optional[str] = field(default=None, metadata={'wire_name': '@odata.id'})

Unique identifier of a user (Ex. '5e6cf5c7-b511-4842-6aae-3f6b8ae5e95b').

AssignManagerRequest dataclass

AssignManagerRequest(id: Optional[str] = None)

Definition: AssignManager_Request

Attributes

id class-attribute instance-attribute
id: Optional[str] = field(default=None, metadata={'wire_name': '@odata.id'})

Unique identifier of a manager (Ex. '5f6cf5c7-a561-4842-9aae-3e6d8ce5e95b').

UpdateUserRequest dataclass

UpdateUserRequest(user_principal_name: Optional[str] = None, display_name: Optional[str] = None, mail_nickname: Optional[str] = None, given_name: Optional[str] = None, surname: Optional[str] = None, account_enabled: Optional[bool] = None, job_title: Optional[str] = None, department: Optional[str] = None, mobile_phone: Optional[str] = None, office_location: Optional[str] = None, preferred_language: Optional[str] = None, business_phones: Optional[List[str]] = None, other_mails: Optional[List[str]] = None, custom_properties: Optional[Dict[str, Any]] = None, on_premises_extension_attributes: Optional[Dict[str, Any]] = None)

Definition: UpdateUser_Request

Attributes

user_principal_name class-attribute instance-attribute
user_principal_name: Optional[str] = field(default=None, metadata={'wire_name': 'userPrincipalName'})

The user principal name (UPN) of the user.

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

The name displayed in the address book for the user.

mail_nickname class-attribute instance-attribute
mail_nickname: Optional[str] = field(default=None, metadata={'wire_name': 'mailNickname'})

The mail alias for the user.

given_name class-attribute instance-attribute
given_name: Optional[str] = field(default=None, metadata={'wire_name': 'givenName'})

The given name (first name) of the user.

surname class-attribute instance-attribute
surname: Optional[str] = None

The user's surname (family name or last name).

account_enabled class-attribute instance-attribute
account_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'accountEnabled'})

True if the new account should be enabled.

job_title class-attribute instance-attribute
job_title: Optional[str] = field(default=None, metadata={'wire_name': 'jobTitle'})

The user's job title.

department class-attribute instance-attribute
department: Optional[str] = None

The name for the department in which the user works.

mobile_phone class-attribute instance-attribute
mobile_phone: Optional[str] = field(default=None, metadata={'wire_name': 'mobilePhone'})

The mobile phone number for the user in any format such as '1 (234) 567-8910'.

office_location class-attribute instance-attribute
office_location: Optional[str] = field(default=None, metadata={'wire_name': 'officeLocation'})

The office location in the user's place of business.

preferred_language class-attribute instance-attribute
preferred_language: Optional[str] = field(default=None, metadata={'wire_name': 'preferredLanguage'})

The preferred language for the user. Should follow ISO 639-1 Code; for example 'en-US'.

custom_properties class-attribute instance-attribute
custom_properties: Optional[Dict[str, Any]] = field(default=None, metadata={'wire_name': 'customProperties'})

Free form property name and value for this user.

GetMemberGroupsRequest dataclass

GetMemberGroupsRequest(security_enabled_only: Optional[bool] = None)

Definition: GetMemberGroups_Request

Attributes

security_enabled_only class-attribute instance-attribute
security_enabled_only: Optional[bool] = field(default=None, metadata={'wire_name': 'securityEnabledOnly'})

Determines if only security enabled groups should be fetched.

CreateUserRequest dataclass

CreateUserRequest(account_enabled: Optional[bool] = None, display_name: Optional[str] = None, mail_nickname: Optional[str] = None, password_profile: Optional[Dict[str, Any]] = None, user_principal_name: Optional[str] = None, given_name: Optional[str] = None, surname: Optional[str] = None, business_phones: Optional[List[str]] = None, department: Optional[str] = None, job_title: Optional[str] = None, mobile_phone: Optional[str] = None, office_location: Optional[str] = None, preferred_language: Optional[str] = None)

Definition: CreateUser_Request

Attributes

account_enabled class-attribute instance-attribute
account_enabled: Optional[bool] = field(default=None, metadata={'wire_name': 'accountEnabled'})

True if the new account should be enabled when it is created.

display_name class-attribute instance-attribute
display_name: Optional[str] = field(default=None, metadata={'wire_name': 'displayName'})

The name displayed in the address book for the user.

mail_nickname class-attribute instance-attribute
mail_nickname: Optional[str] = field(default=None, metadata={'wire_name': 'mailNickname'})

The mail alias for the user.

password_profile class-attribute instance-attribute
password_profile: Optional[Dict[str, Any]] = field(default=None, metadata={'wire_name': 'passwordProfile'})

passwordProfile

user_principal_name class-attribute instance-attribute
user_principal_name: Optional[str] = field(default=None, metadata={'wire_name': 'userPrincipalName'})

The user principal name (UPN) of the user.

given_name class-attribute instance-attribute
given_name: Optional[str] = field(default=None, metadata={'wire_name': 'givenName'})

The user's given name (first name).

surname class-attribute instance-attribute
surname: Optional[str] = None

The user's surname (family name or last name).

department class-attribute instance-attribute
department: Optional[str] = None

The name for the department in which the user works.

job_title class-attribute instance-attribute
job_title: Optional[str] = field(default=None, metadata={'wire_name': 'jobTitle'})

The user's job title.

mobile_phone class-attribute instance-attribute
mobile_phone: Optional[str] = field(default=None, metadata={'wire_name': 'mobilePhone'})

The mobile phone number for the user in any format such as '1 (234) 567-8910'.

office_location class-attribute instance-attribute
office_location: Optional[str] = field(default=None, metadata={'wire_name': 'officeLocation'})

The office location in the user's place of business.

preferred_language class-attribute instance-attribute
preferred_language: Optional[str] = field(default=None, metadata={'wire_name': 'preferredLanguage'})

The preferred language for the user. Should follow ISO 639-1 Code; for example 'en-US'.

CheckMemberGroupsRequest dataclass

CheckMemberGroupsRequest(group_ids: Optional[List[str]] = None)

Definition: CheckMemberGroups_Request

AzureadClient

AzureadClient(connection_runtime_url: str, token_provider: Optional[TokenProvider] = None, options: Optional[ConnectorClientOptions] = None)

Bases: ConnectorClientBase

Typed client for azuread connector.

Initialize a AzureadClient.

Parameters:

Name Type Description Default
connection_runtime_url str

The connection runtime URL from Azure Portal.

required
token_provider Optional[TokenProvider]

Optional token provider. Defaults to ManagedIdentityTokenProvider.

None
options Optional[ConnectorClientOptions]

Optional connector client options.

None

Methods:

create_office365_group_async async
create_office365_group_async(input: CreateOffice365GroupInput) -> dict[str, Any] | None

Create Office 365 group

Create an Office 365 group in your Microsoft Entra ID tenant.

create_security_group_async async
create_security_group_async(input: CreateSecurityGroupInput) -> dict[str, Any] | None

Create security group

Create a security group in your Microsoft Entra ID tenant.

get_group_async async
get_group_async(id: str) -> dict[str, Any] | None

Get group

Get details for a group.

get_user_async async
get_user_async(id: str) -> dict[str, Any] | None

Get user

Get details for a user.

update_user_async async
update_user_async(input: UpdateUserRequest, id: str) -> None

Update user

Update the info for a user.

refresh_tokens_async async
refresh_tokens_async(id: str) -> None

Refresh tokens

Invalidate all refresh tokens for a user

create_user_async async
create_user_async(input: CreateUserRequest) -> dict[str, Any] | None

Create user

Create a new user in your Microsoft Entra ID tenant.

get_group_members_async async
get_group_members_async(id: str, top: Optional[int] = None) -> dict[str, Any] | None

Get group members

Get the users who are members of a group. You can query up to 1000 items using the Top parameter. If you need to retrieve more than 1000 values, please turn on the Settings->Pagination feature and provide a Threshold limit.

remove_member_from_group_async async
remove_member_from_group_async(group_id: str, member_id: str) -> None

Remove Member From Group

Remove Member From Group

add_user_to_group_async async
add_user_to_group_async(input: GetGroupRequest, id: str) -> None

Add user to group

Add a user to a group in this Microsoft Entra ID tenant.

assign_manager_async async
assign_manager_async(input: AssignManagerRequest, id: str) -> None

Assign manager

Assign a manager for a user.

create_group_async async
create_group_async(input: CreateGroupInput) -> dict[str, Any] | None

Create group

Create a group in your Microsoft Entra ID tenant.

check_member_groups_async async
check_member_groups_async(input: CheckMemberGroupsRequest, id: str) -> dict[str, Any] | None

Check group membership

If the user is a member of the given group, the result will contain the given id. Otherwise the result will be empty.

get_member_groups_async async
get_member_groups_async(input: GetMemberGroupsRequest, id: str) -> dict[str, Any] | None

Get groups of a user

Get the groups a user is a member of.