Interface CreateSpaceRequest.Builder
- All Superinterfaces:
AwsRequest.Builder,Buildable,CopyableBuilder<CreateSpaceRequest.Builder,,CreateSpaceRequest> OpenSearchMemoryRequest.Builder,SdkBuilder<CreateSpaceRequest.Builder,,CreateSpaceRequest> SdkPojo,SdkRequest.Builder
- Enclosing class:
CreateSpaceRequest
-
Method Summary
Modifier and TypeMethodDescriptionclientToken(String clientToken) A unique, case-sensitive identifier that makes the request idempotent.default CreateSpaceRequest.BuilderencryptionConfiguration(Consumer<EncryptionConfiguration.Builder> encryptionConfiguration) The AWS KMS key that encrypts the space's data.encryptionConfiguration(EncryptionConfiguration encryptionConfiguration) The AWS KMS key that encrypts the space's data.eventExpiryDays(Integer eventExpiryDays) How many days the space keeps each event, from 1 to 365.extractionModelId(String extractionModelId) The model that extracts and consolidates memories for every strategy in the space, as an Amazon Bedrock model ID without an inference-profile prefix:anthropic.claude-opus-5-5oranthropic.claude-haiku-5-5.memoryExpiryDays(Integer memoryExpiryDays) How many days the space keeps each memory, from 0 to 3650, counted from when the service writes the memory.memoryStrategies(Collection<MemoryStrategy> memoryStrategies) The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.memoryStrategies(Consumer<MemoryStrategy.Builder>... memoryStrategies) The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.memoryStrategies(MemoryStrategy... memoryStrategies) The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.A name for the space, unique within your account in the Region.overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Add an optional request override configuration.overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Add an optional request override configuration.tags(Collection<Tag> tags) The tags to add to the space.tags(Consumer<Tag.Builder>... tags) The tags to add to the space.The tags to add to the space.Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder
overrideConfigurationMethods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copyMethods inherited from interface software.amazon.awssdk.services.opensearchmemory.model.OpenSearchMemoryRequest.Builder
buildMethods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, buildMethods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
Method Details
-
name
A name for the space, unique within your account in the Region. If another space already has the name, the request fails with
ConflictException.- Parameters:
name- A name for the space, unique within your account in the Region. If another space already has the name, the request fails withConflictException.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
memoryStrategies
The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.
Optional. Omit it, or send an empty list, to create a space with no memory strategies. Such a space stores the conversation events you send it and returns them through
SearchEventsandListEvents, but extracts no memories and has none to search. You can add strategies later withUpdateSpace.The serialized list can be at most 384 KiB.
- Parameters:
memoryStrategies- The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.Optional. Omit it, or send an empty list, to create a space with no memory strategies. Such a space stores the conversation events you send it and returns them through
SearchEventsandListEvents, but extracts no memories and has none to search. You can add strategies later withUpdateSpace.The serialized list can be at most 384 KiB.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
memoryStrategies
The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.
Optional. Omit it, or send an empty list, to create a space with no memory strategies. Such a space stores the conversation events you send it and returns them through
SearchEventsandListEvents, but extracts no memories and has none to search. You can add strategies later withUpdateSpace.The serialized list can be at most 384 KiB.
- Parameters:
memoryStrategies- The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.Optional. Omit it, or send an empty list, to create a space with no memory strategies. Such a space stores the conversation events you send it and returns them through
SearchEventsandListEvents, but extracts no memories and has none to search. You can add strategies later withUpdateSpace.The serialized list can be at most 384 KiB.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
memoryStrategies
The memory strategies that extract memories from the space's events: up to 10 strategies, each with a name that is unique within the space.
Optional. Omit it, or send an empty list, to create a space with no memory strategies. Such a space stores the conversation events you send it and returns them through
SearchEventsandListEvents, but extracts no memories and has none to search. You can add strategies later withUpdateSpace.The serialized list can be at most 384 KiB.
This is a convenience method that creates an instance of theMemoryStrategy.Builderavoiding the need to create one manually viaMemoryStrategy.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tomemoryStrategies(List<MemoryStrategy>).- Parameters:
memoryStrategies- a consumer that will call methods onMemoryStrategy.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
eventExpiryDays
How many days the space keeps each event, from 1 to 365. The default is 90.
- Parameters:
eventExpiryDays- How many days the space keeps each event, from 1 to 365. The default is 90.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
memoryExpiryDays
How many days the space keeps each memory, from 0 to 3650, counted from when the service writes the memory. Updating a memory with
UpdateMemorydoesn't restart the count. 0 means memories never expire. If you omit it, memories never expire.Searches and lists leave out a memory past its expiry, and reading, updating, or deleting it returns
ResourceNotFoundException.- Parameters:
memoryExpiryDays- How many days the space keeps each memory, from 0 to 3650, counted from when the service writes the memory. Updating a memory withUpdateMemorydoesn't restart the count. 0 means memories never expire. If you omit it, memories never expire.Searches and lists leave out a memory past its expiry, and reading, updating, or deleting it returns
ResourceNotFoundException.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
extractionModelId
The model that extracts and consolidates memories for every strategy in the space, as an Amazon Bedrock model ID without an inference-profile prefix:
anthropic.claude-opus-5-5oranthropic.claude-haiku-5-5. Another value fails withValidationException, and the message lists the supported IDs. Omit it to use the service default, which can change over time and isn't returned byGetSpace. Setting a value pins the model.- Parameters:
extractionModelId- The model that extracts and consolidates memories for every strategy in the space, as an Amazon Bedrock model ID without an inference-profile prefix:anthropic.claude-opus-5-5oranthropic.claude-haiku-5-5. Another value fails withValidationException, and the message lists the supported IDs. Omit it to use the service default, which can change over time and isn't returned byGetSpace. Setting a value pins the model.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
encryptionConfiguration
The AWS KMS key that encrypts the space's data. Omit it, or omit its
kmsKeyArn, to use an AWS owned key. You can't change the key after you create the space.- Parameters:
encryptionConfiguration- The AWS KMS key that encrypts the space's data. Omit it, or omit itskmsKeyArn, to use an AWS owned key. You can't change the key after you create the space.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
encryptionConfiguration
default CreateSpaceRequest.Builder encryptionConfiguration(Consumer<EncryptionConfiguration.Builder> encryptionConfiguration) The AWS KMS key that encrypts the space's data. Omit it, or omit its
This is a convenience method that creates an instance of thekmsKeyArn, to use an AWS owned key. You can't change the key after you create the space.EncryptionConfiguration.Builderavoiding the need to create one manually viaEncryptionConfiguration.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toencryptionConfiguration(EncryptionConfiguration).- Parameters:
encryptionConfiguration- a consumer that will call methods onEncryptionConfiguration.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
tags
The tags to add to the space.
- Parameters:
tags- The tags to add to the space.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The tags to add to the space.
- Parameters:
tags- The tags to add to the space.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The tags to add to the space.
This is a convenience method that creates an instance of theTag.Builderavoiding the need to create one manually viaTag.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed totags(List<Tag>).- Parameters:
tags- a consumer that will call methods onTag.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
clientToken
A unique, case-sensitive identifier that makes the request idempotent. A retry with the same token and the same parameters within 2 hours returns the space that the first request created, instead of creating another. Reusing the token with different parameters, or while the first request is still in progress, fails with
ConflictException.- Parameters:
clientToken- A unique, case-sensitive identifier that makes the request idempotent. A retry with the same token and the same parameters within 2 hours returns the space that the first request created, instead of creating another. Reusing the token with different parameters, or while the first request is still in progress, fails withConflictException.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
overrideConfiguration
CreateSpaceRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Description copied from interface:AwsRequest.BuilderAdd an optional request override configuration.- Specified by:
overrideConfigurationin interfaceAwsRequest.Builder- Parameters:
overrideConfiguration- The override configuration.- Returns:
- This object for method chaining.
-
overrideConfiguration
CreateSpaceRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Description copied from interface:AwsRequest.BuilderAdd an optional request override configuration.- Specified by:
overrideConfigurationin interfaceAwsRequest.Builder- Parameters:
builderConsumer- AConsumerto which an emptyAwsRequestOverrideConfiguration.Builderwill be given.- Returns:
- This object for method chaining.
-