Work with instances
A Pulsar instance is a group of clusters that acts together as a single unit.
An instance is identified by a Uniform Resource Name (URN). The format of instance URN is "urn:sn:pulsar:pulsar-instance-namespace:pulsar-instance-name". You can get the organization name and the instance name through the snctl get organizations and snctl get pulsarinstance commands. When a Pulsar client connects to a Pulsar cluster through the OAuth2 authentication method, the URN is a required field for OAuth2 authentication.
After creating an organization, you can create one or more instances for the organization.
Create an instance
If you are a member of multiple organizations, navigate to the organization you want to create an instance for. In the upper-right corner of the StreamNative Cloud Console, click your Profile and select Organizations to check your created organizations.
Click the name of your organization.
On the Instances card of the Dashboard page, click the Add icon and a dialog box appears.
Click Deploy Hosted to start the instance creation process.
Configure the instance, as outlined in the following table and then click Continue.
Item Description Instance Name Enter a name for the instance. An instance name starts with a lowercase letter, contains any combination of lowercase letters (a-z), numbers (0-9), and hyphens (-), and must be 4-10 characters. Infrastructure Select an infrastructure pool. The infrastructure pool affects the configuration options for the cluster, network latency for clients accessing the cluster, the geographic location of the nodes in the cluster, and the cost of the running cluster. Currently, Google Cloud and AWS cloud platforms are available.
If you subscribed to the StreamNative Cloud service through AWS Marketplace, only AWS cloud provider is available.
If you subscribed to the StreamNative Cloud service through Google Cloud Marketplace, only Google cloud provider is available.Availability Zones (AZ) Select Multi AZ to deploy the instance on a Multi-AZ. In the Create Payment Method box, enter a valid credit card number, and then click Create Payment Method.
Click Continue.
You should continue your setup by creating a cluster. See work with clusters for more information.
Manage instances
To view instances created for an organization, follow these steps.
In the upper-right corner of the StreamNative Cloud Console, click your Profile and select Organizations.
Click the name of the organization you want to check.
On the Instances card of the Dashboard page, click the Setting icon to list all the instances available for the organization. You can also view detailed information about the instances, including clusters for the instance, instance status, instance name, cloud provider, availability zone, and instance type.
In addition, you can perform the following operations on this page.
Add more instances: click CREATE INSTANCE and go through steps for creating an instance. For details about how to create an instance, see create an instance.
Search an instance: enter the instance name in the Search Instances field and press Enter (only available for existing instances).
Delete an instance: click the ellipsis at the end of the row of the instance that you want to delete, and then click Delete. Enter the instance name and then click Confirm.
Note
You cannot delete an instance if there are resources associated with the instance.