There are more AWS SDK examples available in the AWS Doc SDK Examples GitHub repo.
Code examples for Amazon Keyspaces using AWS SDKs
The following code examples show you how to use Amazon Keyspaces (for Apache Cassandra) with an AWS software development kit (SDK).
Basics are code examples that show you how to perform the essential operations within a service.
Actions are code excerpts from larger programs and must be run in context. While actions
show you how to call individual service functions, you can see actions in context in their related scenarios.
Get started
The following code examples show how to get started using Amazon Keyspaces.
- .NET
-
- AWS SDK for .NET
-
namespace KeyspacesActions;
public class HelloKeyspaces
{
private static ILogger logger = null!;
static async Task Main(string[] args)
{
// Set up dependency injection for Amazon Keyspaces (for Apache Cassandra).
using var host = Host.CreateDefaultBuilder(args)
.ConfigureLogging(logging =>
logging.AddFilter("System", LogLevel.Debug)
.AddFilter<DebugLoggerProvider>("Microsoft", LogLevel.Information)
.AddFilter<ConsoleLoggerProvider>("Microsoft", LogLevel.Trace))
.ConfigureServices((_, services) =>
services.AddAWSService<IAmazonKeyspaces>()
.AddTransient<KeyspacesWrapper>()
)
.Build();
logger = LoggerFactory.Create(builder => { builder.AddConsole(); })
.CreateLogger<HelloKeyspaces>();
var keyspacesClient = host.Services.GetRequiredService<IAmazonKeyspaces>();
var keyspacesWrapper = new KeyspacesWrapper(keyspacesClient);
Console.WriteLine("Hello, Amazon Keyspaces! Let's list your keyspaces:");
await keyspacesWrapper.ListKeyspaces();
}
}
- Java
-
- SDK for Java 2.x
-
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.keyspaces.KeyspacesClient;
import software.amazon.awssdk.services.keyspaces.model.KeyspaceSummary;
import software.amazon.awssdk.services.keyspaces.model.KeyspacesException;
import software.amazon.awssdk.services.keyspaces.model.ListKeyspacesRequest;
import software.amazon.awssdk.services.keyspaces.model.ListKeyspacesResponse;
import java.util.List;
/**
* Before running this Java (v2) code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class HelloKeyspaces {
public static void main(String[] args) {
Region region = Region.US_EAST_1;
KeyspacesClient keyClient = KeyspacesClient.builder()
.region(region)
.build();
listKeyspaces(keyClient);
}
public static void listKeyspaces(KeyspacesClient keyClient) {
try {
ListKeyspacesRequest keyspacesRequest = ListKeyspacesRequest.builder()
.maxResults(10)
.build();
ListKeyspacesResponse response = keyClient.listKeyspaces(keyspacesRequest);
List<KeyspaceSummary> keyspaces = response.keyspaces();
for (KeyspaceSummary keyspace : keyspaces) {
System.out.println("The name of the keyspace is " + keyspace.keyspaceName());
}
} catch (KeyspacesException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
- Kotlin
-
- SDK for Kotlin
-
/**
Before running this Kotlin code example, set up your development environment, including your credentials.
For more information, see the following documentation topic:
https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/setup.html
*/
suspend fun main() {
listKeyspaces()
}
suspend fun listKeyspaces() {
val keyspacesRequest =
ListKeyspacesRequest {
maxResults = 10
}
KeyspacesClient { region = "us-east-1" }.use { keyClient ->
val response = keyClient.listKeyspaces(keyspacesRequest)
response.keyspaces?.forEach { keyspace ->
println("The name of the keyspace is ${keyspace.keyspaceName}")
}
}
}
- Python
-
- SDK for Python (Boto3)
-
import boto3
def hello_keyspaces(keyspaces_client):
"""
Use the AWS SDK for Python (Boto3) to create an Amazon Keyspaces (for Apache Cassandra)
client and list the keyspaces in your account.
This example uses the default settings specified in your shared credentials
and config files.
:param keyspaces_client: A Boto3 Amazon Keyspaces Client object. This object wraps
the low-level Amazon Keyspaces service API.
"""
print("Hello, Amazon Keyspaces! Let's list some of your keyspaces:\n")
for ks in keyspaces_client.list_keyspaces(maxResults=5).get("keyspaces", []):
print(ks["keyspaceName"])
print(f"\t{ks['resourceArn']}")
if __name__ == "__main__":
hello_keyspaces(boto3.client("keyspaces"))