Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . workdocs ]

describe-comments

Description

List all the comments for the specified document version.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  describe-comments
[--authentication-token <value>]
--document-id <value>
--version-id <value>
[--limit <value>]
[--marker <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--authentication-token (string)

Amazon WorkDocs authentication token. Do not set this field when using administrative API actions, as in accessing the API using AWS credentials.

--document-id (string)

The ID of the document.

--version-id (string)

The ID of the document version.

--limit (integer)

The maximum number of items to return.

--marker (string)

The marker for the next set of results. This marker was received from a previous call.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

Comments -> (list)

The list of comments for the specified document version.

(structure)

Describes a comment.

CommentId -> (string)

The ID of the comment.

ParentId -> (string)

The ID of the parent comment.

ThreadId -> (string)

The ID of the root comment in the thread.

Text -> (string)

The text of the comment.

Contributor -> (structure)

The details of the user who made the comment.

Id -> (string)

The ID of the user.

Username -> (string)

The login name of the user.

EmailAddress -> (string)

The email address of the user.

GivenName -> (string)

The given name of the user.

Surname -> (string)

The surname of the user.

OrganizationId -> (string)

The ID of the organization.

RootFolderId -> (string)

The ID of the root folder.

RecycleBinFolderId -> (string)

The ID of the recycle bin folder.

Status -> (string)

The status of the user.

Type -> (string)

The type of user.

CreatedTimestamp -> (timestamp)

The time when the user was created.

ModifiedTimestamp -> (timestamp)

The time when the user was modified.

TimeZoneId -> (string)

The time zone ID of the user.

Locale -> (string)

The locale of the user.

Storage -> (structure)

The storage for the user.

StorageUtilizedInBytes -> (long)

The amount of storage used, in bytes.

StorageRule -> (structure)

The storage for a user.

StorageAllocatedInBytes -> (long)

The amount of storage allocated, in bytes.

StorageType -> (string)

The type of storage.

CreatedTimestamp -> (timestamp)

The time that the comment was created.

Status -> (string)

The status of the comment.

Visibility -> (string)

The visibility of the comment. Options are either PRIVATE, where the comment is visible only to the comment author and document owner and co-owners, or PUBLIC, where the comment is visible to document owners, co-owners, and contributors.

RecipientId -> (string)

If the comment is a reply to another user's comment, this field contains the user ID of the user being replied to.

Marker -> (string)

The marker for the next set of results. This marker was received from a previous call.