Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Synopsis
- data Document = Document' {}
- newDocument :: Text -> Document
- document_accessControlConfigurationId :: Lens' Document (Maybe Text)
- document_accessControlList :: Lens' Document (Maybe [Principal])
- document_attributes :: Lens' Document (Maybe [DocumentAttribute])
- document_blob :: Lens' Document (Maybe ByteString)
- document_contentType :: Lens' Document (Maybe ContentType)
- document_hierarchicalAccessControlList :: Lens' Document (Maybe (NonEmpty HierarchicalPrincipal))
- document_s3Path :: Lens' Document (Maybe S3Path)
- document_title :: Lens' Document (Maybe Text)
- document_id :: Lens' Document Text
Documentation
A document in an index.
See: newDocument
smart constructor.
Document' | |
|
Instances
Create a value of Document
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:accessControlConfigurationId:Document'
, document_accessControlConfigurationId
- The identifier of the access control configuration that you want to
apply to the document.
$sel:accessControlList:Document'
, document_accessControlList
- Information on principals (users and/or groups) and which documents
they should have access to. This is useful for user context filtering,
where search results are filtered based on the user or their group
access to documents.
$sel:attributes:Document'
, document_attributes
- Custom attributes to apply to the document. Use the custom attributes to
provide additional information for searching, to provide facets for
refining searches, and to provide additional information in the query
response.
For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.
$sel:blob:Document'
, document_blob
- The contents of the document.
Documents passed to the Blob
parameter must be base64 encoded. Your
code might not need to encode the document file bytes if you're using
an Amazon Web Services SDK to call Amazon Kendra APIs. If you are
calling the Amazon Kendra endpoint directly using REST, you must base64
encode the contents before sending.--
-- Note: This Lens
automatically encodes and decodes Base64 data.
-- The underlying isomorphism will encode to Base64 representation during
-- serialisation, and decode from Base64 representation during deserialisation.
-- This Lens
accepts and returns only raw unencoded data.
$sel:contentType:Document'
, document_contentType
- The file type of the document in the Blob
field.
$sel:hierarchicalAccessControlList:Document'
, document_hierarchicalAccessControlList
- The list of
principal
lists that define the hierarchy for which documents users should have
access to.
$sel:s3Path:Document'
, document_s3Path
- Undocumented member.
$sel:title:Document'
, document_title
- The title of the document.
$sel:id:Document'
, document_id
- A identifier of the document in the index.
Note, each document ID must be unique per index. You cannot create a
data source to index your documents with their unique IDs and then use
the BatchPutDocument
API to index the same documents, or vice versa.
You can delete a data source and then use the BatchPutDocument
API to
index the same documents, or vice versa.
document_accessControlConfigurationId :: Lens' Document (Maybe Text) Source #
The identifier of the access control configuration that you want to apply to the document.
document_accessControlList :: Lens' Document (Maybe [Principal]) Source #
Information on principals (users and/or groups) and which documents they should have access to. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.
document_attributes :: Lens' Document (Maybe [DocumentAttribute]) Source #
Custom attributes to apply to the document. Use the custom attributes to provide additional information for searching, to provide facets for refining searches, and to provide additional information in the query response.
For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.
document_blob :: Lens' Document (Maybe ByteString) Source #
The contents of the document.
Documents passed to the Blob
parameter must be base64 encoded. Your
code might not need to encode the document file bytes if you're using
an Amazon Web Services SDK to call Amazon Kendra APIs. If you are
calling the Amazon Kendra endpoint directly using REST, you must base64
encode the contents before sending.--
-- Note: This Lens
automatically encodes and decodes Base64 data.
-- The underlying isomorphism will encode to Base64 representation during
-- serialisation, and decode from Base64 representation during deserialisation.
-- This Lens
accepts and returns only raw unencoded data.
document_contentType :: Lens' Document (Maybe ContentType) Source #
The file type of the document in the Blob
field.
document_hierarchicalAccessControlList :: Lens' Document (Maybe (NonEmpty HierarchicalPrincipal)) Source #
The list of principal lists that define the hierarchy for which documents users should have access to.
document_id :: Lens' Document Text Source #
A identifier of the document in the index.
Note, each document ID must be unique per index. You cannot create a
data source to index your documents with their unique IDs and then use
the BatchPutDocument
API to index the same documents, or vice versa.
You can delete a data source and then use the BatchPutDocument
API to
index the same documents, or vice versa.