Documentation
¶
Index ¶
- func KendraGenAiIndexBase_IsConstruct(x interface{}) *bool
- func KendraGenAiIndexBase_IsOwnedResource(construct constructs.IConstruct) *bool
- func KendraGenAiIndexBase_IsResource(construct constructs.IConstruct) *bool
- func KendraGenAiIndex_IsConstruct(x interface{}) *bool
- func KendraGenAiIndex_IsOwnedResource(construct constructs.IConstruct) *bool
- func KendraGenAiIndex_IsResource(construct constructs.IConstruct) *bool
- func NewKendraGenAiIndexBase_Override(k KendraGenAiIndexBase, scope constructs.Construct, id *string, ...)
- func NewKendraGenAiIndex_Override(k KendraGenAiIndex, scope constructs.Construct, id *string, ...)
- type IKendraGenAiIndex
- type KendraEdition
- type KendraGenAiIndex
- type KendraGenAiIndexAttributes
- type KendraGenAiIndexBase
- type KendraGenAiIndexProps
- type KendraIndexFieldTypes
- type KendraUserContextPolicy
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func KendraGenAiIndexBase_IsConstruct ¶
func KendraGenAiIndexBase_IsConstruct(x interface{}) *bool
Checks if `x` is a construct.
Use this method instead of `instanceof` to properly detect `Construct` instances, even when the construct library is symlinked.
Explanation: in JavaScript, multiple copies of the `constructs` library on disk are seen as independent, completely different libraries. As a consequence, the class `Construct` in each copy of the `constructs` library is seen as a different class, and an instance of one class will not test as `instanceof` the other class. `npm install` will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the `constructs` library can be accidentally installed, and `instanceof` will behave unpredictably. It is safest to avoid using `instanceof`, and using this type-testing method instead.
Returns: true if `x` is an object created from a class which extends `Construct`. Experimental.
func KendraGenAiIndexBase_IsOwnedResource ¶
func KendraGenAiIndexBase_IsOwnedResource(construct constructs.IConstruct) *bool
Returns true if the construct was created by CDK, and false otherwise. Experimental.
func KendraGenAiIndexBase_IsResource ¶
func KendraGenAiIndexBase_IsResource(construct constructs.IConstruct) *bool
Check whether the given construct is a Resource. Experimental.
func KendraGenAiIndex_IsConstruct ¶
func KendraGenAiIndex_IsConstruct(x interface{}) *bool
Checks if `x` is a construct.
Use this method instead of `instanceof` to properly detect `Construct` instances, even when the construct library is symlinked.
Explanation: in JavaScript, multiple copies of the `constructs` library on disk are seen as independent, completely different libraries. As a consequence, the class `Construct` in each copy of the `constructs` library is seen as a different class, and an instance of one class will not test as `instanceof` the other class. `npm install` will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the `constructs` library can be accidentally installed, and `instanceof` will behave unpredictably. It is safest to avoid using `instanceof`, and using this type-testing method instead.
Returns: true if `x` is an object created from a class which extends `Construct`. Experimental.
func KendraGenAiIndex_IsOwnedResource ¶
func KendraGenAiIndex_IsOwnedResource(construct constructs.IConstruct) *bool
Returns true if the construct was created by CDK, and false otherwise. Experimental.
func KendraGenAiIndex_IsResource ¶
func KendraGenAiIndex_IsResource(construct constructs.IConstruct) *bool
Check whether the given construct is a Resource. Experimental.
func NewKendraGenAiIndexBase_Override ¶
func NewKendraGenAiIndexBase_Override(k KendraGenAiIndexBase, scope constructs.Construct, id *string, props *awscdk.ResourceProps)
Experimental.
func NewKendraGenAiIndex_Override ¶
func NewKendraGenAiIndex_Override(k KendraGenAiIndex, scope constructs.Construct, id *string, props *KendraGenAiIndexProps)
Experimental.
Types ¶
type IKendraGenAiIndex ¶
type IKendraGenAiIndex interface {
awscdk.IResource
// The Amazon Resource Name (ARN) of the index.
// Experimental.
IndexArn() *string
// The identifier of the index.
// Experimental.
IndexId() *string
// An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics.
//
// This is also the
// role used when you use the BatchPutDocument operation to index
// documents from an Amazon S3 bucket.
// Experimental.
Role() awsiam.IRole
}
Represents a Kendra Index, either created with CDK or imported. Experimental.
func KendraGenAiIndex_FromAttrs ¶
func KendraGenAiIndex_FromAttrs(scope constructs.Construct, id *string, attrs *KendraGenAiIndexAttributes) IKendraGenAiIndex
Import a guardrail given its attributes. Experimental.
type KendraEdition ¶
type KendraEdition string
Represents an Amazon Kendra Index Edition. Experimental.
const ( // Experimental. KendraEdition_DEVELOPER_EDITION KendraEdition = "DEVELOPER_EDITION" // Experimental. KendraEdition_ENTERPRISE_EDITION KendraEdition = "ENTERPRISE_EDITION" // Experimental. KendraEdition_GEN_AI_ENTERPRISE_EDITION KendraEdition = "GEN_AI_ENTERPRISE_EDITION" )
type KendraGenAiIndex ¶
type KendraGenAiIndex interface {
KendraGenAiIndexBase
// The document capacity units used for the Gen AI index.
// Experimental.
DocumentCapacityUnits() *float64
// The edition of the Gen AI index.
// Experimental.
Edition() KendraEdition
// The environment this resource belongs to.
//
// For resources that are created and managed in a Stack (those created by
// creating new class instances like `new Role()`, `new Bucket()`, etc.), this
// is always the same as the environment of the stack they belong to.
//
// For referenced resources (those obtained from referencing methods like
// `Role.fromRoleArn()`, `Bucket.fromBucketName()`, etc.), they might be
// different than the stack they were imported into.
// Experimental.
Env() *interfaces.ResourceEnvironment
// The Amazon Resource Name (ARN) of the index.
// Experimental.
IndexArn() *string
// The identifier of the index.
// Experimental.
IndexId() *string
// The AWS KMS key (CMK) used to encrypt data.
// Experimental.
KmsKey() awskms.IKey
// The name of the Gen AI index.
// Experimental.
Name() *string
// The tree node.
// Experimental.
Node() constructs.Node
// Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.
//
// This value will resolve to one of the following:
// - a concrete value (e.g. `"my-awesome-bucket"`)
// - `undefined`, when a name should be generated by CloudFormation
// - a concrete name generated automatically during synthesis, in
// cross-environment scenarios.
// Experimental.
PhysicalName() *string
// The query capacity units used for the Gen AI index.
// Experimental.
QueryCapacityUnits() *float64
// An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics.
//
// This is also the
// role used when you use the BatchPutDocument operation to index
// documents from an Amazon S3 bucket.
// Experimental.
Role() awsiam.IRole
// The stack in which this resource is defined.
// Experimental.
Stack() awscdk.Stack
// Apply the given removal policy to this resource.
//
// The Removal Policy controls what happens to this resource when it stops
// being managed by CloudFormation, either because you've removed it from the
// CDK application or because you've made a change that requires the resource
// to be replaced.
//
// The resource can be deleted (`RemovalPolicy.DESTROY`), or left in your AWS
// account for data recovery and cleanup later (`RemovalPolicy.RETAIN`).
// Experimental.
ApplyRemovalPolicy(policy awscdk.RemovalPolicy)
// Experimental.
GeneratePhysicalName() *string
// Returns an environment-sensitive token that should be used for the resource's "ARN" attribute (e.g. `bucket.bucketArn`).
//
// Normally, this token will resolve to `arnAttr`, but if the resource is
// referenced across environments, `arnComponents` will be used to synthesize
// a concrete ARN with the resource's physical name. Make sure to reference
// `this.physicalName` in `arnComponents`.
// Experimental.
GetResourceArnAttribute(arnAttr *string, arnComponents *awscdk.ArnComponents) *string
// Returns an environment-sensitive token that should be used for the resource's "name" attribute (e.g. `bucket.bucketName`).
//
// Normally, this token will resolve to `nameAttr`, but if the resource is
// referenced across environments, it will be resolved to `this.physicalName`,
// which will be a concrete name.
// Experimental.
GetResourceNameAttribute(nameAttr *string) *string
// Returns a string representation of this construct.
// Experimental.
ToString() *string
}
Class to create a Kendra GenAI Index with CDK. Experimental.
func NewKendraGenAiIndex ¶
func NewKendraGenAiIndex(scope constructs.Construct, id *string, props *KendraGenAiIndexProps) KendraGenAiIndex
Experimental.
type KendraGenAiIndexAttributes ¶
type KendraGenAiIndexAttributes struct {
// The Id of the index.
// Experimental.
IndexId *string `field:"required" json:"indexId" yaml:"indexId"`
// An IAM role that gives your Amazon Kendra index permissions.
// Experimental.
Role awsiam.IRole `field:"required" json:"role" yaml:"role"`
}
Properties needed for importing an existing Kendra Index. Experimental.
type KendraGenAiIndexBase ¶
type KendraGenAiIndexBase interface {
awscdk.Resource
IKendraGenAiIndex
// The environment this resource belongs to.
//
// For resources that are created and managed in a Stack (those created by
// creating new class instances like `new Role()`, `new Bucket()`, etc.), this
// is always the same as the environment of the stack they belong to.
//
// For referenced resources (those obtained from referencing methods like
// `Role.fromRoleArn()`, `Bucket.fromBucketName()`, etc.), they might be
// different than the stack they were imported into.
// Experimental.
Env() *interfaces.ResourceEnvironment
// The Amazon Resource Name (ARN) of the index.
// Experimental.
IndexArn() *string
// The identifier of the index.
// Experimental.
IndexId() *string
// The tree node.
// Experimental.
Node() constructs.Node
// Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.
//
// This value will resolve to one of the following:
// - a concrete value (e.g. `"my-awesome-bucket"`)
// - `undefined`, when a name should be generated by CloudFormation
// - a concrete name generated automatically during synthesis, in
// cross-environment scenarios.
// Experimental.
PhysicalName() *string
// An IAM role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics.
//
// This is also the
// role used when you use the BatchPutDocument operation to index
// documents from an Amazon S3 bucket.
// Experimental.
Role() awsiam.IRole
// The stack in which this resource is defined.
// Experimental.
Stack() awscdk.Stack
// Apply the given removal policy to this resource.
//
// The Removal Policy controls what happens to this resource when it stops
// being managed by CloudFormation, either because you've removed it from the
// CDK application or because you've made a change that requires the resource
// to be replaced.
//
// The resource can be deleted (`RemovalPolicy.DESTROY`), or left in your AWS
// account for data recovery and cleanup later (`RemovalPolicy.RETAIN`).
// Experimental.
ApplyRemovalPolicy(policy awscdk.RemovalPolicy)
// Experimental.
GeneratePhysicalName() *string
// Returns an environment-sensitive token that should be used for the resource's "ARN" attribute (e.g. `bucket.bucketArn`).
//
// Normally, this token will resolve to `arnAttr`, but if the resource is
// referenced across environments, `arnComponents` will be used to synthesize
// a concrete ARN with the resource's physical name. Make sure to reference
// `this.physicalName` in `arnComponents`.
// Experimental.
GetResourceArnAttribute(arnAttr *string, arnComponents *awscdk.ArnComponents) *string
// Returns an environment-sensitive token that should be used for the resource's "name" attribute (e.g. `bucket.bucketName`).
//
// Normally, this token will resolve to `nameAttr`, but if the resource is
// referenced across environments, it will be resolved to `this.physicalName`,
// which will be a concrete name.
// Experimental.
GetResourceNameAttribute(nameAttr *string) *string
// Returns a string representation of this construct.
// Experimental.
ToString() *string
}
Abstract base class for a Kendra GenAI index.
Contains methods and attributes valid for Kendra GenAI Indexes either created with CDK or imported. Experimental.
type KendraGenAiIndexProps ¶
type KendraGenAiIndexProps struct {
// The document capacity units.
//
// Every unit increases the baseline capacity by 20,000 documents.
// E.g. `documentCapacityUnits: 1` means Baseline + 20,000 documents = 40,000 documents
// Default: 0 - baseline capacity of 20,000 documents.
//
// Experimental.
DocumentCapacityUnits *float64 `field:"optional" json:"documentCapacityUnits" yaml:"documentCapacityUnits"`
// The identifier of the AWS KMS customer managed key (CMK) to use to encrypt data indexed by Amazon Kendra.
//
// Amazon Kendra doesn't support
// asymmetric CMKs.
// Default: - AWS managed encryption key is used.
//
// Experimental.
KmsKey awskms.IKey `field:"optional" json:"kmsKey" yaml:"kmsKey"`
// The name of the index.
// Default: - A name is generated by CDK.
//
// Experimental.
Name *string `field:"optional" json:"name" yaml:"name"`
// The query capacity units.
//
// Every unit increases the baseline capacity by 0.1 QPS.
// E.g. `queryCapacityUnits: 7` means Baseline + 0.1 QPS * 7 = 0.8 QPS
// Default: 0 - baseline capacity of 0.1 QPS
//
// Experimental.
QueryCapacityUnits *float64 `field:"optional" json:"queryCapacityUnits" yaml:"queryCapacityUnits"`
}
Properties for creating a GenAI Index. Experimental.
type KendraIndexFieldTypes ¶
type KendraIndexFieldTypes string
Represents an Amazon Kendra Index Field Type. Experimental.
const ( // Experimental. KendraIndexFieldTypes_STRING KendraIndexFieldTypes = "STRING" // Experimental. KendraIndexFieldTypes_STRING_LIST KendraIndexFieldTypes = "STRING_LIST" // Experimental. KendraIndexFieldTypes_LONG KendraIndexFieldTypes = "LONG" // Experimental. KendraIndexFieldTypes_DATE KendraIndexFieldTypes = "DATE" )
type KendraUserContextPolicy ¶
type KendraUserContextPolicy string
The different policies available to filter search results based on user context. Experimental.
const ( // All indexed content is searchable and displayable for all users. // // If you want to filter search results on user context, you can use // the attribute filters of _user_id and _group_ids or you can provide // user and group information in UserContext . // Experimental. KendraUserContextPolicy_ATTRIBUTE_FILTER KendraUserContextPolicy = "ATTRIBUTE_FILTER" // Enables token-based user access control to filter search results on user context. // // All documents with no access control and all documents // accessible to the user will be searchable and displayable. // Experimental. KendraUserContextPolicy_USER_TOKEN KendraUserContextPolicy = "USER_TOKEN" )