WorkMail / Client / describe_resource

describe_resource

WorkMail.Client.describe_resource(**kwargs)

Returns the data available for the resource.

See also: AWS API Documentation

Request Syntax

response = client.describe_resource(
    OrganizationId='string',
    ResourceId='string'
)

Parameters:

• OrganizationId (string) –

  [REQUIRED]

  The identifier associated with the organization for which the resource is described.

• ResourceId (string) –

  [REQUIRED]

  The identifier of the resource to be described.

  The identifier can accept ResourceId, Resourcename, or email. The following identity formats are available:

  • Resource ID: r-0123456789a0123456789b0123456789

  • Email address: resource@domain.tld

  • Resource name: resource

Return type:

dict

Returns:

Response Syntax

{
    'ResourceId': 'string',
    'Email': 'string',
    'Name': 'string',
    'Type': 'ROOM'|'EQUIPMENT',
    'BookingOptions': {
        'AutoAcceptRequests': True|False,
        'AutoDeclineRecurringRequests': True|False,
        'AutoDeclineConflictingRequests': True|False
    },
    'State': 'ENABLED'|'DISABLED'|'DELETED',
    'EnabledDate': datetime(2015, 1, 1),
    'DisabledDate': datetime(2015, 1, 1),
    'Description': 'string',
    'HiddenFromGlobalAddressList': True|False
}

Response Structure

• (dict) –

  • ResourceId (string) –

    The identifier of the described resource.

  • Email (string) –

    The email of the described resource.

  • Name (string) –

    The name of the described resource.

  • Type (string) –

    The type of the described resource.

  • BookingOptions (dict) –

    The booking options for the described resource.

    • AutoAcceptRequests (boolean) –

      The resource’s ability to automatically reply to requests. If disabled, delegates must be associated to the resource.

    • AutoDeclineRecurringRequests (boolean) –

      The resource’s ability to automatically decline any recurring requests.

    • AutoDeclineConflictingRequests (boolean) –

      The resource’s ability to automatically decline any conflicting requests.

  • State (string) –

    The state of the resource: enabled (registered to WorkMail), disabled (deregistered or never registered to WorkMail), or deleted.

  • EnabledDate (datetime) –

    The date and time when a resource was enabled for WorkMail, in UNIX epoch time format.

  • DisabledDate (datetime) –

    The date and time when a resource was disabled from WorkMail, in UNIX epoch time format.

  • Description (string) –

    Description of the resource.

  • HiddenFromGlobalAddressList (boolean) –

    If enabled, the resource is hidden from the global address list.

Exceptions

• WorkMail.Client.exceptions.EntityNotFoundException

• WorkMail.Client.exceptions.InvalidParameterException

• WorkMail.Client.exceptions.OrganizationNotFoundException

• WorkMail.Client.exceptions.OrganizationStateException

• WorkMail.Client.exceptions.UnsupportedOperationException