Brokers

Cloud brokers are virtual RemotiveBrokers ready to play your recording files whenever you need. A user can create any number of brokers needed. Each user also has their own broker in every project they are part of, this personal broker is used whenever a certain broker is not specified.

If you head over to Brokers you will see a list of all the brokers in the current project.

How-to list brokers

Console

Simply click the navigation path Brokers.

Cli

$ remotive cloud brokers list --project my-project

Manage brokers

---

Create

You can create brokers that everyone in the current project can use.

How-to create broker

Console

Step 1

To create a broker, click the plus icon in the top right corner or click the the outlined item at the bottom. The image below highlights the buttons that you can use. Click on any of the highlighted buttons to create a new broker

Step 2

When creating a broker you are required to provide a name of the broker, this will be displayed in the list of brokers and let's you identify your broker. You can also optionally set a specific version, this field is only intended for advanced users. The version tags are supplied by us at RemotiveLabs.

Cli

$ remotive cloud brokers create my-broker
--project my-project
[ --tag a-specific-tag ]

Use

For the most part you will probably access the broker application when you upload a recording session but it is possible to access all your brokers at any time.

How-to get broker details

Console

Step 1

To access the broker application to control a broker you simply head over to Brokers and click on a broker

Step 2

When you are on the broker details page you can copy the broker URL & API-key or go to the broker application directly

Cli

You can get all info you need using the describe command

$ remotive cloud brokers describe my-broker
--project my-project

{
    "name": "my-broker",
    "url": "https://my-broker-beamyhack-sglnqbpwoa-ez.a.run.app",
    "creator": {
        "displayName": "John Doe",
        "email": "johan.doe@remotivelabs.com"
    },
    "createTime": "2023-01-20T09:28:29.639385Z",
    "keys": [
        "0397C9BA-8201AE2D-94EB02B4-26465A8C"
    ]
}

Delete

Brokers can be deleted by anyone with the permission to do so in the project.

How-to delete brokers

Console

Assuming you have the right permissions, you can delete a cloud broker by using the trash can icon on the right side of a broker in the brokers list

Cli

$ remotive cloud brokers remove my-broker \
  --project my-project