Amazon DynamoDB Namespace

This topic gives you reference information about the Amazon DynamoDB (csb-aws-dynamodb-namespace) service.

Plans

The Amazon DynamoDB Namespace service offering provides a prefix and credentials for managing DynamoDB tables with that prefix in the default region set for Cloud Service Broker for AWS. Currently the service does not support any additional plans, and there is no additional configuration available.

Provisioning

Provision an Amazon DynamoDB Namespace by running:

cf create-service csb-aws-dynamodb-namespace PLAN-NAME SERVICE-INSTANCE-NAME

For example:

$ cf create-service csb-aws-dynamodb-namespace default my-service

Binding

Bind a service by running:

cf bind-service APP-NAME SERVICE-INSTANCE --binding-name BINDING-NAME

Configuration parameters are not necessary for creating bindings and service keys.

Binding Credentials

The format for binding credentials for DynamoDB is as follows:

{
    "region" : "AWS-REGION",
    "prefix": "DYNAMODB-TABLE-NAME-PREFIX",
    "access_key_id" : "IAM-USER-KEY-ID",
    "secret_access_key" : "IAM-USER-SECRET-KEY"
}

The bound application can use an IAM user with the supplied credentials to create, update, or delete any DynamoDB with names starting with the DYNAMODB-TABLE-NAME-PREFIX within the AWS-REGION region.

The prefix is of the form csb-GUID-, where GUID is the globally unique identifier of the service instance that you can obtain by running:

cf service SERVICE-INSTANCE-NAME --guid

To ensure that every service instance has a unique prefix, the prefix cannot be configured. This prevents access to tables created by any other service instance.

Caution

All the tables created in the designated namespace are destroyed when the service instance is deleted.