Time Series Database:User management

Activate account management

On the Accounts page in the TSDB console, click Activate User Management.

Account management must be activated before you can create or delete accounts.

Create an account

1. On the Accounts page in the TSDB console, click Create.

   

2. Specify the account name and password, then choose the account type:

   • Super account

   • Standard account

   Field	Rules
   Account name	1–10 characters. Allowed: letters, digits, and underscores (_). Must start with a letter and end with a letter or digit.
   Password	6–20 characters. Allowed: letters, digits, underscores (_), at signs (@), number signs (#), and periods (.).

3. Verify that the account appears in the list on the Accounts page.

   

Delete an account

On the Accounts page, find the account and click Delete.

Deactivate account management

On the Accounts page in the TSDB console, click Deactivate User Management.

Verify that an account works

Use curl to send a test request. The following example sends an api/put request, which requires write-only or higher permissions:

curl -X POST \
  -u ${Account name}:${Account password in the plaintext format} \
  http://ts-xxxxxxx.hitsdb.tsdb.aliyuncs.com:8242/api?summary \
  -d '[{"metric":"sys.cpu.nice","timestamp":1346846400,"value":18,"tags":{"host":"web01","dc":"lga"}}]'

Replace ${Account name} and ${Account password in the plaintext format} with your actual account credentials.

Authenticate with TSDB SDK

Use TSDB SDK V0.2.7 or later to access an instance with account management enabled.

When creating a TSDBConfig object, call the basicAuth() method with your account name and plaintext password. All connections that use this TSDBConfig object carry the credentials automatically.

Authenticate from non-Java applications

For applications that don't use TSDB SDK (such as Python or Go), add an Authorization header to each HTTP request. TSDB uses RFC 2617 basic authentication. Requests without a valid Authorization header are rejected.

The header format is:

Authorization: Basic {Base64-encoded authentication information}

The Base64-encoded string is derived from {Account name}:{Account password}, with fields separated by a colon (:).