Developing applications with Momento SDKs

ようこそ このページでは、MomentoのすべてのSDKでMomentoクライアントをアセンブルするために必要な一般的な構成に関する情報を提供します。このページでは、Momentoの認証情報（APIキーと呼ばれます）の提供方法、クライアントの設定方法、エラー処理と本番環境への準備に関する基本的な情報について説明します。

Constructing a Storage Client

StorageClient は、Momento のサービスとやり取りする際に使用するメインのオブジェクトである。インスタンスを作成するには、 CredentialProvider と Configuration を渡す必要があります。

以下に StorageClient の作成例を示します：

JavaScript

return new PreviewStorageClient({
  configuration: StorageConfigurations.Laptop.latest(),
  credentialProvider: CredentialProvider.fromEnvironmentVariable('MOMENTO_API_KEY'),
});

備考

Full example code and imports can be found here

Java

try (PreviewStorageClient storageClient =
    new PreviewStorageClient(
        CredentialProvider.fromEnvVar("MOMENTO_API_KEY"),
        StorageConfigurations.Laptop.latest())) {
  // ...
}

備考

Full example code and imports can be found here

Go

credentialProvider, err := auth.NewEnvMomentoTokenProvider("MOMENTO_API_KEY")
if err != nil {
	panic(err)
}

storageClient, err = momento.NewPreviewStorageClient(config.StorageLaptopLatest(), credentialProvider)
if err != nil {
	panic(err)
}

備考

Full example code and imports can be found here

Rust

  let _storage_client = PreviewStorageClient::builder()
      .configuration(momento::storage::configurations::Laptop::latest())
      .credential_provider(CredentialProvider::from_env_var(
          "MOMENTO_API_KEY".to_string(),
      )?)
      .build()?;

備考

Full example code and imports can be found here

Instantiating credential providers using Momento API keys

Momentoクライアントをインスタンス化する際に、Momento APIキーを提供する必要があります。まだ持っていない場合は、Momento Web Console から取得できます。トークンを取得したら、CredentialProvider のインスタンスを作成する際に Momento SDK にトークンを渡す。環境変数または文字列から CredentialProvider オブジェクトを作成するための便利なファクトリメソッドが用意されています。以下は、環境変数から CredentialProvider のインスタンスを生成する方法の例です：

JavaScript

CredentialProvider.fromEnvironmentVariable('MOMENTO_API_KEY');

備考

Full example code and imports can be found here

Python

CredentialProvider.from_environment_variable("MOMENTO_API_KEY")

備考

Full example code and imports can be found here

Java

CredentialProvider.fromEnvVar("MOMENTO_API_KEY");

備考

Full example code and imports can be found here

Kotlin

CredentialProvider.fromEnvVar("MOMENTO_API_KEY")

備考

Full example code and imports can be found here

Go

credentialProvider, err = auth.NewEnvMomentoTokenProvider("MOMENTO_API_KEY")
if err != nil {
	panic(err)
}

備考

Full example code and imports can be found here

PHP

CredentialProvider::fromEnvironmentVariable("MOMENTO_API_KEY");

備考

Full example code and imports can be found here

Rust

  let _credential_provider = CredentialProvider::from_env_var("MOMENTO_API_KEY".to_string());


allow(non_snake_case)]
b fn example_API_ConfigurationLaptop() {
  let _config = momento::cache::configurations::Laptop::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationInRegionDefaultLatest() {
  let _config = momento::cache::configurations::InRegion::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationInRegionLowLatency() {
  let _config = momento::cache::configurations::LowLatency::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationLambdaLatest() {
  let _config = momento::cache::configurations::Lambda::latest();


allow(non_snake_case)]
b fn example_API_InstantiateCacheClient() -> Result<(), MomentoError> {
  let _cache_client = CacheClient::builder()
      .default_ttl(Duration::from_secs(60))
      .configuration(Laptop::latest())
      .credential_provider(CredentialProvider::from_env_var(
          "MOMENTO_API_KEY".to_string(),
      )?)
      .build()?;

備考

Full example code and imports can be found here

Elixir

Momento.Auth.CredentialProvider.from_env_var!("MOMENTO_AUTH_TOKEN")

備考

Full example code and imports can be found here

Momentoの認証トークンをAWS Secret ManagerやGCP Secret Managerなどのシークレットマネージャやローカルの設定ファイルに保存している場合は、まずそこから認証情報を取得し、次のように文字列からCredentialProviderをインスタンス化する必要があります：

JavaScript

const apiKey = retrieveApiKeyFromYourSecretsManager();
CredentialProvider.fromString({apiKey: apiKey});

備考

Full example code and imports can be found here

Java

final String authToken = retrieveAuthTokenFromYourSecretsManager();
CredentialProvider.fromString(authToken);

備考

Full example code and imports can be found here

Kotlin

val authToken = retrieveAuthTokenFromYourSecretsManager()
CredentialProvider.fromString(authToken)

備考

Full example code and imports can be found here

Go

apiKey := RetrieveApiKeyFromYourSecretsManager()
credentialProvider, err = auth.NewStringMomentoTokenProvider(apiKey)
if err != nil {
	fmt.Println("Error parsing API key:", err)
}

備考

Full example code and imports can be found here

Rust

  let _credential_provider = CredentialProvider::from_string("my-api-key".to_string());


allow(non_snake_case)]
b fn example_API_CredentialProviderFromEnvVar() {
  let _credential_provider = CredentialProvider::from_env_var("MOMENTO_API_KEY".to_string());


allow(non_snake_case)]
b fn example_API_ConfigurationLaptop() {
  let _config = momento::cache::configurations::Laptop::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationInRegionDefaultLatest() {
  let _config = momento::cache::configurations::InRegion::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationInRegionLowLatency() {
  let _config = momento::cache::configurations::LowLatency::latest();


allow(non_snake_case)]
b fn example_API_ConfigurationLambdaLatest() {
  let _config = momento::cache::configurations::Lambda::latest();


allow(non_snake_case)]
b fn example_API_InstantiateCacheClient() -> Result<(), MomentoError> {
  let _cache_client = CacheClient::builder()
      .default_ttl(Duration::from_secs(60))
      .configuration(Laptop::latest())
      .credential_provider(CredentialProvider::from_env_var(
          "MOMENTO_API_KEY".to_string(),
      )?)
      .build()?;

備考

Full example code and imports can be found here

Elixir

auth_token = retrieve_auth_token_from_your_secrets_manager()
Momento.Auth.CredentialProvider.from_string!(auth_token)

備考

Full example code and imports can be found here

AWS Secrets Managerから認証情報を取得する方法の例については、Retrieving a Momento auth token from AWS Secrets Manager を参照してください。

詳細については、APIリファレンスページや、使用している特定のSDKのドキュメントを参照してください。