Time Series Database:Manage accounts

Manage accounts

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

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

   

2. On the page that appears, specify the account name and the account password.

   • Create a super account.

   • Create a standard account.

   Parameters:

   • Account Name: The account name must be 1 to 10 characters in length and can contain letters, digits, and underscores (_). The first character of the account name must be a letter and the last character must be a letter or a digit.

   • Password: The password must be 6 to 20 characters in length andcan contain only letters, digits, underscores (_), at signs (@), number signs (#), and periods (.).

3. View the account that you created, as shown in the following figure. In this example, the account test is created.

   

On the Accounts page, find the account that you want to delete and click Delete, as shown in the following figure.

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

Authenticate an account to perform read or write operations on the TSDB instance

After you create an account based on the preceding procedure, you can use the account to perform read or write operations on the TSDB instance. If you enable account management, you must authenticate your account each time you send HTTP API requests to access the TSDB instance. The policies used to define permissions on HTTP API requests vary based on the account types. For more information, see Permission policies for common API requests.

To check whether an account is available, use curl to send an api/put or api/query request based on the permissions that are granted to the account. For example, you can run the following command to send an api/put request:

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"}}]'

Specify account information in non-Java applications

For applications that do not support TSDB SDK, such as Python or Go applications, you must add the Authorization field as a header to an HTTP request. The Authorization field contains a credential for basic authentication. The credential is organized in the format that is based on the RFC 2617 standard. Only the HTTP requests that contain the Authorization field can be processed by TSDB. If an HTTP request does not contain the Authorization field, the HTTP request is rejected.

Basic {Base64-encoded authentication information}

Format of Base64-encoded authentication information: %Authorization:Basic ${Account name}:${Account password}%. You must separate the fields with colons (:).

Permission policies for common API requests