Office365-REST-Python-Client 2.5.5__py3-none-any.whl → 2.5.7__py3-none-any.whl

office365/booking/virtualevents/root.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class VirtualEventsRoot(Entity):
+    """ """

office365/communications/calls/participant.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.communications.calls.invitation_participant_info import (
     InvitationParticipantInfo,
 )
@@ -68,9 +70,6 @@ class Participant(Entity):
 
     @property
     def metadata(self):
-        """
-        A blob of data provided by the participant in the roster.
-
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """A blob of data provided by the participant in the roster."""
         return self.properties.get("metadata", None)

office365/directory/administrative_unit.py

@@ -21,10 +21,17 @@ class AdministrativeUnit(DirectoryObject):
         return self.properties.get("displayName", None)
 
     @property
-    def members(self):
+    def visibility(self):
         """
-        Users and groups that are members of this administrative unit
+        Controls whether the administrative unit and its members are hidden or public. Can be set to HiddenMembership.
+        If not set (value is null), the default behavior is public. When set to HiddenMembership, only members of
+        the administrative unit can list other members of the administrative unit.
         """
+        return self.properties.get("visibility", None)
+
+    @property
+    def members(self):
+        """Users and groups that are members of this administrative unit"""
         from office365.directory.object_collection import DirectoryObjectCollection
 
         return self.properties.get(

office365/directory/applications/application.py

@@ -252,9 +252,7 @@ class Application(DirectoryObject):
 
     @property
     def public_client(self):
-        """
-        Specifies settings for installed clients such as desktop or mobile devices.
-        """
+        """Specifies settings for installed clients such as desktop or mobile devices."""
         return self.properties.get("publicClient", PublicClientApplication())
 
     @property
@@ -269,6 +267,7 @@ class Application(DirectoryObject):
 
     @property
     def created_on_behalf_of(self):
+        # type: () -> DirectoryObject
         """"""
         return self.properties.get(
             "createdOnBehalfOf",
@@ -279,6 +278,7 @@ class Application(DirectoryObject):
 
     @property
     def owners(self):
+        # type: () -> DirectoryObjectCollection
         """Directory objects that are owners of the application."""
         return self.properties.get(
             "owners",

office365/directory/applications/roles/assignment_collection.py

@@ -2,7 +2,7 @@ from office365.directory.applications.roles.assignment import AppRoleAssignment
 from office365.entity_collection import EntityCollection
 
 
-class AppRoleAssignmentCollection(EntityCollection):
+class AppRoleAssignmentCollection(EntityCollection[AppRoleAssignment]):
     def __init__(self, context, resource_path=None):
         super(AppRoleAssignmentCollection, self).__init__(
             context, AppRoleAssignment, resource_path

office365/directory/applications/roles/collection.py

@@ -8,6 +8,10 @@ class AppRoleCollection(ClientValueCollection[AppRole]):
     def __init__(self, initial_values=None):
         super(AppRoleCollection, self).__init__(AppRole, initial_values)
 
-    def __getitem__(self, name):
+    def __getitem__(self, key):
         # type: (str) -> AppRole
-        return next(iter([item for item in self._data if item.value == name]), None)
+        return self.get_by_value(key)
+
+    def get_by_value(self, value):
+        # type: (str) -> AppRole
+        return next(iter([item for item in self._data if item.value == value]), None)

office365/directory/applications/roles/role.py

@@ -38,4 +38,4 @@ class AppRole(ClientValue):
         return "{0}  {1}".format(self.allowedMemberTypes, self.value)
 
     def __repr__(self):
-        return "{0}".format(self.id)
+        return self.value or self.id or self.entity_type_name

office365/directory/audit/provisioning/object_summary.py

@@ -1,3 +1,6 @@
+from datetime import datetime
+from typing import Optional
+
 from office365.directory.audit.provisioning.service_principal import (
     ProvisioningServicePrincipal,
 )
@@ -7,6 +10,29 @@ from office365.entity import Entity
 class ProvisioningObjectSummary(Entity):
     """Represents an action performed by the Azure AD Provisioning service and its associated properties."""
 
+    @property
+    def activity_datetime(self):
+        """Represents date and time information using ISO 8601 format and is always in UTC time."""
+        return self.properties.get("activityDateTime", datetime.min)
+
+    @property
+    def change_id(self):
+        # type: () -> Optional[str]
+        """Unique ID of this change in this cycle. Supports $filter (eq, contains)."""
+        return self.properties.get("changeId", None)
+
+    @property
+    def cycle_id(self):
+        # type: () -> Optional[str]
+        """Unique ID per job iteration. Supports $filter (eq, contains)."""
+        return self.properties.get("cycleId", None)
+
+    @property
+    def duration_in_milliseconds(self):
+        # type: () -> Optional[int]
+        """Indicates how long this provisioning action took to finish. Measured in milliseconds."""
+        return self.properties.get("durationInMilliseconds", None)
+
     @property
     def service_principal(self):
         """Represents the service principal used for provisioning."""
@@ -14,6 +40,9 @@ class ProvisioningObjectSummary(Entity):
 
     def get_property(self, name, default_value=None):
         if default_value is None:
-            property_mapping = {"servicePrincipal": self.service_principal}
+            property_mapping = {
+                "activityDateTime": self.activity_datetime,
+                "servicePrincipal": self.service_principal,
+            }
             default_value = property_mapping.get(name, None)
         return super(ProvisioningObjectSummary, self).get_property(name, default_value)

office365/directory/authentication/method_configuration.py

@@ -0,0 +1,9 @@
+from office365.entity import Entity
+
+
+class AuthenticationMethodConfiguration(Entity):
+    """
+    This is an abstract type that represents the settings for each authentication method. It has the configuration
+    of whether a specific authentication method is enabled or disabled for the tenant and which users and groups
+    can register and use that method.
+    """

office365/directory/authentication/method_mode_detail.py

@@ -0,0 +1,8 @@
+from office365.entity import Entity
+
+
+class AuthenticationMethodModeDetail(Entity):
+    """
+    The details of the authenticationMethodModes objects that can be defined for the allowedCombinations property
+    of the authenticationstrengthpolicy.
+    """

office365/directory/authentication/method_target.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class AuthenticationMethodTarget(Entity):
+    """"""

office365/directory/authentication/methods/fido.py

@@ -1,5 +1,13 @@
+from typing import Optional
+
 from office365.directory.authentication.methods.method import AuthenticationMethod
 
 
 class Fido2AuthenticationMethod(AuthenticationMethod):
     """Representation of a FIDO2 security key registered to a user. FIDO2 is a sign-in authentication method."""
+
+    @property
+    def model(self):
+        # type: () -> Optional[str]
+        """The manufacturer-assigned model of the FIDO2 security key."""
+        return self.properties.get("model", None)

office365/directory/authentication/methods/password.py

@@ -1,6 +1,29 @@
+from datetime import datetime
+from typing import Optional
+
 from office365.directory.authentication.methods.method import AuthenticationMethod
 
 
 class PasswordAuthenticationMethod(AuthenticationMethod):
     """A representation of a user's password. For security, the password itself will never be returned in the object,
     but action can be taken to reset a password."""
+
+    @property
+    def created_datetime(self):
+        # type: () -> datetime
+        """The date and time when this password was last updated. This property is currently not populated."""
+        return self.properties.get("createdDateTime", datetime.min)
+
+    @property
+    def password(self):
+        # type: () -> Optional[str]
+        """For security, the password is always returned as null from a LIST or GET operation."""
+        return self.properties.get("password", None)
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {"createdDateTime": self.created_datetime}
+            default_value = property_mapping.get(name, None)
+        return super(PasswordAuthenticationMethod, self).get_property(
+            name, default_value
+        )

office365/directory/authentication/strength_root.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class AuthenticationStrengthRoot(Entity):
+    """The authenticationStrengthRoot resource is the entry point for the authentication strengths object model."""

office365/directory/certificates/auth_configuration.py

@@ -20,9 +20,7 @@ class CertificateBasedAuthConfiguration(Entity):
 
     @property
     def certificate_authorities(self):
-        """
-        Collection of certificate authorities which creates a trusted certificate chain.
-        """
+        """Collection of certificate authorities which creates a trusted certificate chain."""
         return self.properties.get(
             "certificateAuthorities", ClientValueCollection(CertificateAuthority)
         )

office365/directory/custom_security_attribute_definition.py

@@ -0,0 +1,7 @@
+from office365.entity import Entity
+
+
+class CustomSecurityAttributeDefinition(Entity):
+    """Represents the schema of a custom security attribute (key-value pair).
+    For example, the custom security attribute name, description, data type, and allowed values.
+    """

office365/directory/device_local_credential_info.py

@@ -0,0 +1,6 @@
+from office365.entity import Entity
+
+
+class DeviceLocalCredentialInfo(Entity):
+    """Represents local administrator credential information for all device objects in Azure Active Directory
+    that are enabled with Local Admin Password Solution (LAPS)."""

office365/directory/directory.py

@@ -1,4 +1,8 @@
 from office365.directory.administrative_unit import AdministrativeUnit
+from office365.directory.custom_security_attribute_definition import (
+    CustomSecurityAttributeDefinition,
+)
+from office365.directory.device_local_credential_info import DeviceLocalCredentialInfo
 from office365.directory.object_collection import DirectoryObjectCollection
 from office365.entity import Entity
 from office365.entity_collection import EntityCollection
@@ -10,6 +14,42 @@ class Directory(Entity):
     "container". Deleted items will remain available to restore for up to 30 days. After 30 days, the items are
     permanently deleted."""
 
+    @property
+    def device_local_credentials(self):
+        """Conceptual container for user and group directory objects."""
+        return self.properties.get(
+            "deviceLocalCredentials",
+            EntityCollection(
+                self.context,
+                DeviceLocalCredentialInfo,
+                ResourcePath("deviceLocalCredentials", self.resource_path),
+            ),
+        )
+
+    @property
+    def administrative_units(self):
+        """Conceptual container for user and group directory objects."""
+        return self.properties.get(
+            "administrativeUnits",
+            EntityCollection(
+                self.context,
+                AdministrativeUnit,
+                ResourcePath("administrativeUnits", self.resource_path),
+            ),
+        )
+
+    @property
+    def custom_security_attribute_definitions(self):
+        """Conceptual container for customSecurityAttributeDefinition objects and their properties."""
+        return self.properties.get(
+            "customSecurityAttributeDefinitions",
+            EntityCollection(
+                self.context,
+                CustomSecurityAttributeDefinition,
+                ResourcePath("customSecurityAttributeDefinitions", self.resource_path),
+            ),
+        )
+
     def deleted_items(self, entity_type=None):
         """Recently deleted items. Read-only. Nullable."""
         if entity_type:
@@ -27,18 +67,6 @@ class Directory(Entity):
                 ),
             )
 
-    @property
-    def administrative_units(self):
-        """Conceptual container for user and group directory objects."""
-        return self.properties.get(
-            "administrativeUnits",
-            EntityCollection(
-                self.context,
-                AdministrativeUnit,
-                ResourcePath("administrativeUnits", self.resource_path),
-            ),
-        )
-
     @property
     def deleted_groups(self):
         """Recently deleted groups"""

office365/directory/groups/group.py

@@ -380,9 +380,7 @@ class Group(DirectoryObject):
     @property
     def permission_grants(self):
         # type: () -> EntityCollection[ResourceSpecificPermissionGrant]
-        """
-        List permissions that have been granted to apps to access the group.
-        """
+        """List permissions that have been granted to apps to access the group."""
         return self.properties.setdefault(
             "permissionGrants",
             EntityCollection(
@@ -394,9 +392,7 @@ class Group(DirectoryObject):
 
     @property
     def photo(self):
-        """
-        The group's profile photo
-        """
+        """The group's profile photo"""
         return self.properties.get(
             "photo",
             ProfilePhoto(self.context, ResourcePath("photo", self.resource_path)),

office365/directory/identities/conditional_access_root.py

@@ -1,8 +1,17 @@
 from office365.entity import Entity
+from office365.runtime.paths.resource_path import ResourcePath
 
 
 class ConditionalAccessRoot(Entity):
     """The conditionalAccessRoot resource is the entry point for the Conditional Access (CA) object model.
     It doesn't contain any usable properties."""
 
-    pass
+    @property
+    def authentication_strength(self):
+        """The entry point for the Conditional Access (CA) object model."""
+        return self.properties.get(
+            "authenticationStrength",
+            ConditionalAccessRoot(
+                self.context, ResourcePath("authenticationStrength", self.resource_path)
+            ),
+        )

office365/directory/identities/container.py

@@ -18,9 +18,7 @@ class IdentityContainer(Entity):
 
     @property
     def api_connectors(self):
-        """
-        Represents entry point for API connectors.
-        """
+        """Represents entry point for API connectors."""
         return self.properties.get(
             "apiConnectors",
             EntityCollection(
@@ -52,9 +50,7 @@ class IdentityContainer(Entity):
 
     @property
     def b2x_user_flows(self):
-        """
-        Represents entry point for B2X/self-service sign-up identity userflows.
-        """
+        """Represents entry point for B2X/self-service sign-up identity userflows."""
         return self.properties.get(
             "b2xUserFlows",
             EntityCollection(
@@ -66,9 +62,7 @@ class IdentityContainer(Entity):
 
     @property
     def user_flow_attributes(self):
-        """
-        Represents entry point for identity userflow attributes.
-        """
+        """Represents entry point for identity userflow attributes."""
         return self.properties.get(
             "userFlowAttributes",
             EntityCollection(

office365/directory/identities/providers/builtin_identity.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.identities.providers.base import IdentityProviderBase
 
 
@@ -8,9 +10,8 @@ class BuiltInIdentityProvider(IdentityProviderBase):
 
     @property
     def identity_provider_type(self):
+        # type: () -> Optional[str]
         """
         The identity provider type. For a B2B scenario, possible values: AADSignup, MicrosoftAccount, EmailOTP.
-
-        :rtype: str
         """
         return self.properties.get("identityProviderType", None)

office365/directory/identities/providers/saml_or_wsfed.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.identities.providers.base import IdentityProviderBase
 
 
@@ -7,9 +9,6 @@ class SamlOrWsFedProvider(IdentityProviderBase):
 
     @property
     def issuer_uri(self):
-        """
-        Issuer URI of the federation server.
-
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """Issuer URI of the federation server."""
         return self.properties.get("issuerUri", None)

office365/directory/identitygovernance/appconsent/request_collection.py

@@ -3,7 +3,7 @@ from office365.entity_collection import EntityCollection
 from office365.runtime.queries.function import FunctionQuery
 
 
-class AppConsentRequestCollection(EntityCollection):
+class AppConsentRequestCollection(EntityCollection[AppConsentRequest]):
     """AppConsentRequest's collection"""
 
     def __init__(self, context, resource_path=None):

office365/directory/identitygovernance/governance.py

@@ -2,6 +2,9 @@ from office365.directory.identitygovernance.accessreview.set import AccessReview
 from office365.directory.identitygovernance.appconsent.approval_route import (
     AppConsentApprovalRoute,
 )
+from office365.directory.identitygovernance.privilegedaccess.root import (
+    PrivilegedAccessRoot,
+)
 from office365.directory.identitygovernance.termsofuse.container import (
     TermsOfUseContainer,
 )
@@ -35,9 +38,7 @@ class IdentityGovernance(Entity):
 
     @property
     def access_reviews(self):
-        """
-        Container for the base resources that expose the access reviews API and features.
-        """
+        """Container for the base resources that expose the access reviews API and features."""
         return self.properties.get(
             "accessReviews",
             AccessReviewSet(
@@ -45,6 +46,16 @@ class IdentityGovernance(Entity):
             ),
         )
 
+    @property
+    def privileged_access(self):
+        """Container for the base resources that expose the access reviews API and features."""
+        return self.properties.get(
+            "privilegedAccess",
+            PrivilegedAccessRoot(
+                self.context, ResourcePath("privilegedAccess", self.resource_path)
+            ),
+        )
+
     @property
     def terms_of_use(self):
         """

office365/directory/identitygovernance/privilegedaccess/root.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class PrivilegedAccessRoot(Entity):
+    """Represents the entry point for resources related to Privileged Identity Management (PIM)."""

office365/directory/identitygovernance/termsofuse/agreement_acceptance.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 
 
@@ -6,3 +8,9 @@ class AgreementAcceptance(Entity):
     Represents the current status of a user's response to a company's customizable terms of use agreement powered by
     Azure Active Directory (Azure AD).
     """
+
+    @property
+    def user_principal_name(self):
+        # type: () -> Optional[str]
+        """UPN of the user when the acceptance was recorded."""
+        return self.properties.get("userPrincipalName", None)

office365/directory/identitygovernance/userconsent/request_collection.py

@@ -4,7 +4,7 @@ from office365.directory.identitygovernance.userconsent.request import (
 from office365.entity_collection import EntityCollection
 
 
-class UserConsentRequestCollection(EntityCollection):
+class UserConsentRequestCollection(EntityCollection[UserConsentRequest]):
     """AppConsentRequest's collection"""
 
     def __init__(self, context, resource_path=None):

office365/directory/insights/resource_reference.py

@@ -15,7 +15,7 @@ class ResourceReference(ClientValue):
         self.webUrl = web_url
 
     def __str__(self):
-        return self.type
+        return self.type or ""
 
     def __repr__(self):
         return "{0}:{1}".format(self.type, self.webUrl)

office365/directory/key_credential.py

@@ -44,3 +44,6 @@ class KeyCredential(ClientValue):
         self.startDateTime = start_datetime
         self.type = key_type
         self.usage = usage
+
+    def __str__(self):
+        return self.displayName or self.entity_type_name

office365/directory/licenses/assignment_state.py

@@ -1,4 +1,5 @@
 from office365.runtime.client_value import ClientValue
+from office365.runtime.types.collections import StringCollection
 
 
 class LicenseAssignmentState(ClientValue):
@@ -12,8 +13,31 @@ class LicenseAssignmentState(ClientValue):
         - Error details if the assignment state is Error
     """
 
-    def __init__(self, assigned_by_group=None):
+    def __init__(
+        self,
+        assigned_by_group=None,
+        disabled_plans=None,
+        error=None,
+        lastUpdatedDateTime=None,
+        skuId=None,
+        state=None,
+    ):
         """
-        :param str assigned_by_group:
+        :param str assigned_by_group: ndicates whether the license is directly assigned or inherited from a group.
+             If directly assigned, this field is null; if inherited through a group membership, this field contains
+             the ID of the group.
+        :param list[str] disabled_plans: The service plans that are disabled in this assignment
+        :param str error: License assignment failure error. If the license is assigned successfully, this field is Null.
+             The possible values are CountViolation, MutuallyExclusiveViolation, DependencyViolation,
+             ProhibitedInUsageLocationViolation, UniquenessViolation, and Other.
+             For more information on how to identify and resolve license assignment errors, see here.
+        :param str skuId: The unique identifier for the SKU. Read-Only.
+        :param str state: Indicate the current state of this assignment. Read-Only.
+             The possible values are Active, ActiveWithError, Disabled, and Error.
         """
         self.assignedByGroup = assigned_by_group
+        self.disabledPlans = StringCollection(disabled_plans)
+        self.error = error
+        self.lastUpdatedDateTime = lastUpdatedDateTime
+        self.skuId = skuId
+        self.state = state

office365/directory/licenses/details.py

@@ -8,11 +8,12 @@ from office365.runtime.client_value_collection import ClientValueCollection
 class LicenseDetails(Entity):
     """Contains information about a license assigned to a user."""
 
+    def __repr__(self):
+        return self.sku_part_number or self.entity_type_name
+
     @property
     def service_plans(self):
-        """
-        Information about the service plans assigned with the license. Read-only, Not nullable
-        """
+        """Information about the service plans assigned with the license. Read-only, Not nullable"""
         return self.properties.get(
             "servicePlans", ClientValueCollection(ServicePlanInfo)
         )

office365/directory/licenses/subscribed_sku.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.licenses.service_plan_info import ServicePlanInfo
 from office365.directory.licenses.units_detail import LicenseUnitsDetail
 from office365.entity import Entity
@@ -9,35 +11,31 @@ class SubscribedSku(Entity):
 
     @property
     def account_id(self):
-        """
-        The unique ID of the account this SKU belongs to.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """The unique ID of the account this SKU belongs to."""
         return self.properties.get("accountId", None)
 
     @property
     def applies_to(self):
+        # type: () -> Optional[str]
         """
         The target class for this SKU. Only SKUs with target class User are assignable.
         Possible values are: "User", "Company".
-        :rtype: str
         """
         return self.properties.get("appliesTo", None)
 
     @property
     def sku_id(self):
-        """
-        The unique identifier (GUID) for the service SKU.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """The unique identifier (GUID) for the service SKU."""
         return self.properties.get("skuId", None)
 
     @property
     def sku_part_number(self):
+        # type: () -> Optional[str]
         """
         The SKU part number; for example: "AAD_PREMIUM" or "RMSBASIC".
         To get a list of commercial subscriptions that an organization has acquired, see List subscribedSkus.
-        :rtype: str
         """
         return self.properties.get("skuPartNumber", None)