Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

get_resources

get_resources(**kwargs)

Retrieves a collection of resources, including folders and documents. The only CollectionType supported is SHARED_WITH_ME .

See also: AWS API Documentation

Request Syntax

response = client.get_resources(
    AuthenticationToken='string',
    UserId='string',
    CollectionType='SHARED_WITH_ME',
    Limit=123,
    Marker='string'
)
Parameters
  • AuthenticationToken (string) -- The Amazon WorkDocs authentication token. Not required when using Amazon Web Services administrator credentials to access the API.
  • UserId (string) -- The user ID for the resource collection. This is a required field for accessing the API operation using IAM credentials.
  • CollectionType (string) -- The collection type.
  • Limit (integer) -- The maximum number of resources to return.
  • Marker (string) -- The marker for the next set of results. This marker was received from a previous call.
Return type

dict

Returns

Response Syntax

{
    'Folders': [
        {
            'Id': 'string',
            'Name': 'string',
            'CreatorId': 'string',
            'ParentFolderId': 'string',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'ModifiedTimestamp': datetime(2015, 1, 1),
            'ResourceState': 'ACTIVE'|'RESTORING'|'RECYCLING'|'RECYCLED',
            'Signature': 'string',
            'Labels': [
                'string',
            ],
            'Size': 123,
            'LatestVersionSize': 123
        },
    ],
    'Documents': [
        {
            'Id': 'string',
            'CreatorId': 'string',
            'ParentFolderId': 'string',
            'CreatedTimestamp': datetime(2015, 1, 1),
            'ModifiedTimestamp': datetime(2015, 1, 1),
            'LatestVersionMetadata': {
                'Id': 'string',
                'Name': 'string',
                'ContentType': 'string',
                'Size': 123,
                'Signature': 'string',
                'Status': 'INITIALIZED'|'ACTIVE',
                'CreatedTimestamp': datetime(2015, 1, 1),
                'ModifiedTimestamp': datetime(2015, 1, 1),
                'ContentCreatedTimestamp': datetime(2015, 1, 1),
                'ContentModifiedTimestamp': datetime(2015, 1, 1),
                'CreatorId': 'string',
                'Thumbnail': {
                    'string': 'string'
                },
                'Source': {
                    'string': 'string'
                }
            },
            'ResourceState': 'ACTIVE'|'RESTORING'|'RECYCLING'|'RECYCLED',
            'Labels': [
                'string',
            ]
        },
    ],
    'Marker': 'string'
}

Response Structure

  • (dict) --

    • Folders (list) --

      The folders in the specified folder.

      • (dict) --

        Describes a folder.

        • Id (string) --

          The ID of the folder.

        • Name (string) --

          The name of the folder.

        • CreatorId (string) --

          The ID of the creator.

        • ParentFolderId (string) --

          The ID of the parent folder.

        • CreatedTimestamp (datetime) --

          The time when the folder was created.

        • ModifiedTimestamp (datetime) --

          The time when the folder was updated.

        • ResourceState (string) --

          The resource state of the folder.

        • Signature (string) --

          The unique identifier created from the subfolders and documents of the folder.

        • Labels (list) --

          List of labels on the folder.

          • (string) --
        • Size (integer) --

          The size of the folder metadata.

        • LatestVersionSize (integer) --

          The size of the latest version of the folder metadata.

    • Documents (list) --

      The documents in the specified collection.

      • (dict) --

        Describes the document.

        • Id (string) --

          The ID of the document.

        • CreatorId (string) --

          The ID of the creator.

        • ParentFolderId (string) --

          The ID of the parent folder.

        • CreatedTimestamp (datetime) --

          The time when the document was created.

        • ModifiedTimestamp (datetime) --

          The time when the document was updated.

        • LatestVersionMetadata (dict) --

          The latest version of the document.

          • Id (string) --

            The ID of the version.

          • Name (string) --

            The name of the version.

          • ContentType (string) --

            The content type of the document.

          • Size (integer) --

            The size of the document, in bytes.

          • Signature (string) --

            The signature of the document.

          • Status (string) --

            The status of the document.

          • CreatedTimestamp (datetime) --

            The timestamp when the document was first uploaded.

          • ModifiedTimestamp (datetime) --

            The timestamp when the document was last uploaded.

          • ContentCreatedTimestamp (datetime) --

            The timestamp when the content of the document was originally created.

          • ContentModifiedTimestamp (datetime) --

            The timestamp when the content of the document was modified.

          • CreatorId (string) --

            The ID of the creator.

          • Thumbnail (dict) --

            The thumbnail of the document.

            • (string) --
              • (string) --
          • Source (dict) --

            The source of the document.

            • (string) --
              • (string) --
        • ResourceState (string) --

          The resource state.

        • Labels (list) --

          List of labels on the document.

          • (string) --
    • Marker (string) --

      The marker to use when requesting the next set of results. If there are no additional results, the string is empty.

Exceptions

  • WorkDocs.Client.exceptions.UnauthorizedResourceAccessException
  • WorkDocs.Client.exceptions.UnauthorizedOperationException
  • WorkDocs.Client.exceptions.InvalidArgumentException
  • WorkDocs.Client.exceptions.FailedDependencyException
  • WorkDocs.Client.exceptions.ServiceUnavailableException