Cisco Packet Tracer Extensions API 8.1.0
API for communication between Cisco Packet Tracer application and its extension applications and modules.
|
LogicalWorkspace is a graphics view. Network design using logical topology icons happens in this space. More...
Public Member Functions | |
int | getState () |
Returns the state of the Logical workspace. More... | |
vector< uuid > | getCanvasItemIds () const |
Returns the list of UUIDs of items on the Logical workspace. More... | |
vector< uuid > | getCanvasNoteIds () const |
Returns the list of UUIDs of note items on the Logical workspace. More... | |
vector< uuid > | getCanvasRectIds () const |
Returns the list of UUIDs of rectangle items on the Logical workspace. More... | |
vector< uuid > | getCanvasEllipseIds () const |
Returns the list of UUIDs of ellipse items on the Logical workspace. More... | |
vector< uuid > | getCanvasLineIds () const |
Returns the list of UUIDs of line items on the Logical workspace. More... | |
vector< uuid > | getCanvasPolygonIds () const |
Returns the list of UUIDs of polygon items on the Logical workspace. More... | |
vector< string > | getRectItemData (uuid) const |
Returns a vector of data for a rectangle workspace item. More... | |
vector< string > | getEllipseItemData (uuid) const |
Returns a vector of data for a ellipse workspace item. More... | |
vector< string > | getLineItemData (uuid) const |
Returns a vector of data for a line workspace item. More... | |
vector< string > | getPolygonItemData (uuid) const |
Returns a vector of data for a polygon workspace item. More... | |
int | getCanvasItemX (uuid) const |
Returns the x-coordinate of the Logical workspace item with the specified UUID. More... | |
int | getCanvasItemY (uuid) const |
Returns the y-coordinate of the Logical workspace item with the specified UUID. More... | |
int | getCanvasItemRealX (uuid) const |
Returns the real x-coordinate of the Logical workspace item with the specified UUID. More... | |
int | getCanvasItemRealY (uuid) const |
Returns the real y-coordinate of the Logical workspace item with the specified UUID. More... | |
void | setCanvasItemRealPos (uuid, int, int) |
Sets the x-coordinate of the Logical workspace item with the specified UUID. More... | |
void | setCanvasItemX (uuid, int) |
Sets the x-coordinate of the Logical workspace item with the specified UUID. More... | |
void | setCanvasItemY (uuid, int) |
Sets the y-coordinate of the Logical workspace item with the specified UUID. More... | |
void | moveCanvasItemBy (uuid, int, int) |
Moves the Logical workspace item with the specified UUID by the specified increments. More... | |
int | getComponentItemsCount () |
Returns the number of component items on the Logical workspace. More... | |
ComponentItem | getComponentItem (QString) |
Returns the component item with the specified device name. More... | |
int | getComponentChildCountFor (QString) |
ComponentItem | getComponentChildForAt (QString, int) |
ComponentItem | getComponentChildForByName (QString, QString) |
QString | addDevice (DeviceType, string, double, double) |
Adds a device to the Logical workspace. More... | |
bool | removeDevice (QString) |
Removes the specified device from the Logical workspace and network. More... | |
void | deviceAdded (QString, string, uuid) |
This event is emitted when a device is added to the Logical workspace. More... | |
void | deviceRemoved (QString, uuid) |
This event is emitted when a device is removed from the Logical workspace. More... | |
void | deviceRemoving (QString, uuid) |
This event is emitted when a device is about to be removed from the Logical workspace. More... | |
void | canvasNoteTextChanged (uuid, QString) |
This event is emitted when a canvas item note has it's text changed. More... | |
void | canvasNoteRemoved (uuid) |
This event is emitted when a canvas item note is removed from the Logical workspace. More... | |
void | canvasNoteAdded (uuid) |
This event is emitted when a canvas item note is added to the Logical workspace. More... | |
QString | addRemoteNetwork () |
Adds a Multiuser remote network to the Logical workspace. More... | |
bool | removeRemoteNetwork (QString) |
Removes the Multiuser remote network with the specified name from the Logical workspace. More... | |
void | remoteNetworkAdded (QString) |
This event is emitted when a Multiuser remote network is added to the Logical workspace. More... | |
void | remoteNetworkRemoved (QString) |
This event is emitted when a Multiuser remote network is removed from the Logical workspace. More... | |
bool | moveRemoteNetwork (QString, int, int) |
Moves the Multiuser remote network to the specified location. More... | |
bool | createLink (QString, string, QString, string, CONNECT_TYPES) |
Creates a link from one device's port to another device's port. More... | |
void | linkStarted (QString, string, CONNECT_TYPES) |
This event is emitted when a link starts (i.e. user connects the first end of a link) More... | |
void | linkCreated (QString, string, QString, string, CONNECT_TYPES) |
This event is emitted when a link has been created. More... | |
void | linkDeleted (QString, string, QString, string, CONNECT_TYPES) |
This event is emitted when a link has been deleted. More... | |
bool | deleteLink (QString, string) |
Deletes a link from the device connected to the specified port. More... | |
bool | clearLayer (double) |
Clears the specified layer. More... | |
uuid | drawLine (int, int, int, int, double, int, int, int, int) |
Draws a line on the Logical workspace. More... | |
uuid | drawCircle (int, int, double, int, int, int, int) |
Draws a circle on the Logical workspace. More... | |
uuid | addNote (int, int, double, QString) |
Adds a note on the Logical workspace. More... | |
QString | getCanvasNoteText (uuid) |
Gets text from a note on the Logical workspace. More... | |
double | getIncNoteZOrder () |
Gets and increments the current z order to use for a new note. More... | |
int | getMUItemCount () |
Gets how many multiuser items there are, if any. More... | |
bool | changeNoteText (uuid, QString) |
Changes text in a note on the logical workspace. More... | |
bool | removeCanvasItem (uuid) |
Removes the specified item from the Logical workspace. More... | |
double | getUnusedLayer () |
Returns the unused layer. More... | |
bool | isLayerUsed (double) |
Returns true if the specified layer is used, otherwise false. More... | |
double | getLayerInbetweenComponents (QString, QString) |
Returns the layer between the specified devices. More... | |
vector< byte > | getWorkspaceImage (QString) |
Returns the series of bytes of the Logical workspace image. More... | |
uuid | addTextPopup (int, int, double, int, QString) |
Adds a text popup to the Logical workspace. More... | |
bool | removeTextPopup (uuid) |
Removes the specified text popup from the Logical workspace. More... | |
void | showClusterContents (QString) |
Shows the content of the specified cluster. More... | |
void | showClusterContents (QString) |
Triggered when a cluster contents are shown. More... | |
void | addCluster () |
Creates new cluster object with the currently selected objects. More... | |
void | removeCluster (QString, bool) |
Removes csluter object with given id. More... | |
void | unCluster (QString) |
Unclusters cluster with the given clusterId. More... | |
void | clusterAdded (QString) |
This event is emitted when a cluster object is added. More... | |
void | clusterRemoved (QString) |
This event is emitted when a cluster is removed from the Logical workspace. More... | |
Cluster | getRootCluster () |
Returns root cluster. More... | |
Cluster | getCurrentCluster () |
Returns root cluster. More... | |
Cluster | getCluster (QString) |
Returns cluster object for a given cluster id. More... | |
uuid | getClusterItemId (QString) |
Returns uuid for the item associated with this cluster object. More... | |
Cluster | getClusterFromItem (uuid) |
Returns cluster object assosiatete with a given cluster item. More... | |
Cluster | getClusterForItem (uuid) |
Returns cluster object this item belongs to. More... | |
QString | getClusterIdForItem (uuid) |
Returns cluster id for a given workspace item. More... | |
void | moveItemToCluster (uuid, QString) |
Moves item from current cluster to a cluster with given clusterId. More... | |
void | autoConnectDevices (QString, QString) |
Auto connect function, connect the given devices with a default cable at default ports, if possible. More... | |
void | clusterForItemChanged (uuid, QString, QString) |
Sent when an item is moved from one cluster to another, etc. More... | |
void | onNoAutoConnectError (QString, QString) |
Sent when autoconnect occures and there isn't an error. More... | |
void | setDeviceCustomImage (QString, QString) |
Change Device image in logical workspace. More... | |
void | centerOn (double, double) |
void | centerOnComponentByName (QString) |
int | getCurrentZoom () |
LogicalWorkspace is a graphics view. Network design using logical topology icons happens in this space.
void LogicalWorkspace::addCluster | ( | ) |
Creates new cluster object with the currently selected objects.
QString LogicalWorkspace::addDevice | ( | DeviceType | , |
string | , | ||
double | , | ||
double | |||
) |
Adds a device to the Logical workspace.
type,the | type of the device. Device types: eRouter = 0, eSwitch = 1, eCloud = 2, eBridge = 3, eHub = 4, eRepeater = 5, eCoAxialSplitter = 6, eAccessPoint = 7, ePc = 8, eServer = 9, ePrinter = 10, eWirelessRouter = 11, eIpPhone = 12, eDslModem = 13, eCableModem = 14, eRemoteNetwork = 15, eMultiLayerSwitch = 16, eLaptop = 17, eTabletPC = 18, ePda = 19, eWirelessEndDevice = 20, eWiredEndDevice = 21, eTV = 22, eHomeVoip = 23, eAnalogPhone = 24, eMultiUser = 25, eASA = 26, eIoE = 27, eHomeGateway = 28, eCellTower = 29, eCentralOfficeServer = 30 eCiscoAccessPoint = 31, eEmbeddedCiscoAccessPoint = 32, eSniffer = 33, eMCU = 34, eSBC = 35, eThing = 36, eMCUComponent = 37, eEmbeddedServer = 38, eWirelessLanController = 39, eCluster = 40 |
model,the | model of the device. |
x,x | coord to add the device at. |
y,y | coord to add the device at. |
uuid LogicalWorkspace::addNote | ( | int | , |
int | , | ||
double | , | ||
QString | |||
) |
Adds a note on the Logical workspace.
x,the | x-coordinate for the note. |
y,the | y-coordinate for the note. |
layer,the | layer to add the note on. |
text,the | text for the note. |
QString LogicalWorkspace::addRemoteNetwork | ( | ) |
Adds a Multiuser remote network to the Logical workspace.
\brief This event is emitted when action bar button on a android device is pressed, or corresponding button on some other device. \arg id, .
\NOT APPLICABLE TO DESKTOP.
event: actionBarButtonPressed(QString id) - PrivGetNetwork;
uuid LogicalWorkspace::addTextPopup | ( | int | , |
int | , | ||
double | , | ||
int | , | ||
QString | |||
) |
Adds a text popup to the Logical workspace.
x,the | x-coordinate for the text popup. |
y,the | y-coordinate for the text popup. |
layer,the | layer to add the text popup to. |
width,the | width for the text popup. |
text,the | text for the text popup. |
void LogicalWorkspace::autoConnectDevices | ( | QString | , |
QString | |||
) |
Auto connect function, connect the given devices with a default cable at default ports, if possible.
device1 | The originating device |
device2 | the destination device |
void LogicalWorkspace::canvasNoteAdded | ( | uuid | ) |
This event is emitted when a canvas item note is added to the Logical workspace.
IPC event.
void LogicalWorkspace::canvasNoteRemoved | ( | uuid | ) |
This event is emitted when a canvas item note is removed from the Logical workspace.
IPC event.
void LogicalWorkspace::canvasNoteTextChanged | ( | uuid | , |
QString | |||
) |
This event is emitted when a canvas item note has it's text changed.
IPC event.
void LogicalWorkspace::centerOn | ( | double | , |
double | |||
) |
void LogicalWorkspace::centerOnComponentByName | ( | QString | ) |
bool LogicalWorkspace::changeNoteText | ( | uuid | , |
QString | |||
) |
Changes text in a note on the logical workspace.
id,ID | of the |
text,the | text for the note. |
bool LogicalWorkspace::clearLayer | ( | double | ) |
Clears the specified layer.
layerNumber,the | layer of interest. |
void LogicalWorkspace::clusterAdded | ( | QString | ) |
void LogicalWorkspace::clusterForItemChanged | ( | uuid | , |
QString | , | ||
QString | |||
) |
void LogicalWorkspace::clusterRemoved | ( | QString | ) |
This event is emitted when a cluster is removed from the Logical workspace.
IPC event.
bool LogicalWorkspace::createLink | ( | QString | , |
string | , | ||
QString | , | ||
string | , | ||
CONNECT_TYPES | |||
) |
Creates a link from one device's port to another device's port.
deviceName1,the | name of the first device. |
portName1,portName | can be one of the following plus a port number where appropriate: Console, Aux, Ethernet, FastEthernet, GigabitEthernet, Serial, Wireless, Loopback, Vlan, Modem, Coaxial, Rs232, Async. Example: FastEthernet0/0 |
deviceName2,the | name of the second device. |
portName2 | portName can be one of the following plus a port number where appropriate: Console, Aux, Ethernet, FastEthernet, GigabitEthernet, Serial, Wireless, Loopback, Vlan, Modem, Coaxial, Rs232, Async. Example: FastEthernet0/0 |
connType,the | connection type. Connection types: ETHERNET_STRAIGHT = 8100, ETHERNET_CROSS = 8101, ETHERNET_ROLL = 8102, FIBER = 8103, PHONE = 8104, CABLE = 8105, SERIAL = 8106, AUTO = 8107, CONSOLE = 8108, WIRELESS = 8109, COAXIAL = 8110, OCTAL = 8111, CELLULAR = 8112, USB = 8113, CUSTOM_IO = 8114, |
bool LogicalWorkspace::deleteLink | ( | QString | , |
string | |||
) |
Deletes a link from the device connected to the specified port.
deviceName1,the | name of the first device. |
portName1,portName | can be one of the following plus a port number where appropriate: Console, Aux, Ethernet, FastEthernet, GigabitEthernet, Serial, Wireless, Loopback, Vlan, Modem, Coaxial, Rs232, Async. Example: FastEthernet0/0 |
void LogicalWorkspace::deviceAdded | ( | QString | , |
string | , | ||
uuid | |||
) |
This event is emitted when a device is added to the Logical workspace.
IPC event.
void LogicalWorkspace::deviceRemoved | ( | QString | , |
uuid | |||
) |
This event is emitted when a device is removed from the Logical workspace.
IPC event.
void LogicalWorkspace::deviceRemoving | ( | QString | , |
uuid | |||
) |
This event is emitted when a device is about to be removed from the Logical workspace.
IPC event.
uuid LogicalWorkspace::drawCircle | ( | int | , |
int | , | ||
double | , | ||
int | , | ||
int | , | ||
int | , | ||
int | |||
) |
Draws a circle on the Logical workspace.
cx,the | x-coordinate of the center for the circle. |
cy,the | y-coordinate of the center for the circle. |
layer,the | layer to draw the circle on. |
radius,the | radius for the circle. |
r,the | red color value for the circle. |
g,the | green color value for the circle. |
b,the | blue color value for the circle. |
uuid LogicalWorkspace::drawLine | ( | int | , |
int | , | ||
int | , | ||
int | , | ||
double | , | ||
int | , | ||
int | , | ||
int | , | ||
int | |||
) |
Draws a line on the Logical workspace.
sx,the | x-coordinate to start drawing the line from. |
sy,the | y-coordinate to start drawing the line from. |
ex,the | x-coordinate to stop drawing the line at. |
ey,the | y-coordinate to stop drawing the line at. |
layer,the | layer to draw the line on. |
w,the | width for the line. |
r,the | red color value for the line. |
g,the | green color value for the line. |
b,the | blue color value for the line. |
vector< uuid > LogicalWorkspace::getCanvasEllipseIds | ( | ) | const |
Returns the list of UUIDs of ellipse items on the Logical workspace.
vector< uuid > LogicalWorkspace::getCanvasItemIds | ( | ) | const |
Returns the list of UUIDs of items on the Logical workspace.
int LogicalWorkspace::getCanvasItemRealX | ( | uuid | ) | const |
Returns the real x-coordinate of the Logical workspace item with the specified UUID.
item_id,the | UUID of the Logical workspace item of interest. |
int LogicalWorkspace::getCanvasItemRealY | ( | uuid | ) | const |
Returns the real y-coordinate of the Logical workspace item with the specified UUID.
item_id,the | UUID of the Logical workspace item of interest. |
int LogicalWorkspace::getCanvasItemX | ( | uuid | ) | const |
Returns the x-coordinate of the Logical workspace item with the specified UUID.
item_id,the | UUID of the Logical workspace item of interest. |
int LogicalWorkspace::getCanvasItemY | ( | uuid | ) | const |
Returns the y-coordinate of the Logical workspace item with the specified UUID.
item_id,the | UUID of the Logical workspace item of interest. |
vector< uuid > LogicalWorkspace::getCanvasLineIds | ( | ) | const |
Returns the list of UUIDs of line items on the Logical workspace.
vector< uuid > LogicalWorkspace::getCanvasNoteIds | ( | ) | const |
Returns the list of UUIDs of note items on the Logical workspace.
QString LogicalWorkspace::getCanvasNoteText | ( | uuid | ) |
Gets text from a note on the Logical workspace.
uuid,the | id of the canvas note. |
vector< uuid > LogicalWorkspace::getCanvasPolygonIds | ( | ) | const |
Returns the list of UUIDs of polygon items on the Logical workspace.
vector< uuid > LogicalWorkspace::getCanvasRectIds | ( | ) | const |
Returns the list of UUIDs of rectangle items on the Logical workspace.
Cluster LogicalWorkspace::getCluster | ( | QString | ) |
Returns cluster object for a given cluster id.
Cluster LogicalWorkspace::getClusterForItem | ( | uuid | ) |
Cluster LogicalWorkspace::getClusterFromItem | ( | uuid | ) |
Returns cluster object assosiatete with a given cluster item.
clusterItemUuid,the | uuid for the cluster item of interest. For non-cluster items this will return NULL. |
QString LogicalWorkspace::getClusterIdForItem | ( | uuid | ) |
uuid LogicalWorkspace::getClusterItemId | ( | QString | ) |
Returns uuid for the item associated with this cluster object.
clusterId,ID | of a cluster object for which we want to get an item. |
int LogicalWorkspace::getComponentChildCountFor | ( | QString | ) |
ComponentItem LogicalWorkspace::getComponentChildForAt | ( | QString | , |
int | |||
) |
ComponentItem LogicalWorkspace::getComponentChildForByName | ( | QString | , |
QString | |||
) |
ComponentItem LogicalWorkspace::getComponentItem | ( | QString | ) |
Returns the component item with the specified device name.
deviceName,the | name of the device of interest. |
int LogicalWorkspace::getComponentItemsCount | ( | ) |
Returns the number of component items on the Logical workspace.
Cluster LogicalWorkspace::getCurrentCluster | ( | ) |
Returns root cluster.
int LogicalWorkspace::getCurrentZoom | ( | ) |
vector< string > LogicalWorkspace::getEllipseItemData | ( | uuid | ) | const |
Returns a vector of data for a ellipse workspace item.
itemID,ID | of the ellipse to get information for. |
double LogicalWorkspace::getIncNoteZOrder | ( | ) |
Gets and increments the current z order to use for a new note.
double LogicalWorkspace::getLayerInbetweenComponents | ( | QString | , |
QString | |||
) |
Returns the layer between the specified devices.
deviceName1,the | name of the first device. |
deviceName2,the | name of the second device. |
vector< string > LogicalWorkspace::getLineItemData | ( | uuid | ) | const |
Returns a vector of data for a line workspace item.
itemID,ID | of the line to get information for. |
int LogicalWorkspace::getMUItemCount | ( | ) |
Gets how many multiuser items there are, if any.
vector< string > LogicalWorkspace::getPolygonItemData | ( | uuid | ) | const |
Returns a vector of data for a polygon workspace item.
itemID,ID | of the polygon to get information for. |
vector< string > LogicalWorkspace::getRectItemData | ( | uuid | ) | const |
Returns a vector of data for a rectangle workspace item.
itemID,ID | of the rectangle to retrieve information for. |
Cluster LogicalWorkspace::getRootCluster | ( | ) |
Returns root cluster.
int LogicalWorkspace::getState | ( | ) |
Returns the state of the Logical workspace.
double LogicalWorkspace::getUnusedLayer | ( | ) |
Returns the unused layer.
vector< byte > LogicalWorkspace::getWorkspaceImage | ( | QString | ) |
Returns the series of bytes of the Logical workspace image.
format,the | format of the image. Image formats: BMP, GIF, JPG, JPEG, PNG, PBM, PGM, PPM, XBM, XPM. |
bool LogicalWorkspace::isLayerUsed | ( | double | ) |
Returns true if the specified layer is used, otherwise false.
layer,the | layer of interest. |
void LogicalWorkspace::linkCreated | ( | QString | , |
string | , | ||
QString | , | ||
string | , | ||
CONNECT_TYPES | |||
) |
This event is emitted when a link has been created.
IPC event.
void LogicalWorkspace::linkDeleted | ( | QString | , |
string | , | ||
QString | , | ||
string | , | ||
CONNECT_TYPES | |||
) |
This event is emitted when a link has been deleted.
IPC event.
void LogicalWorkspace::linkStarted | ( | QString | , |
string | , | ||
CONNECT_TYPES | |||
) |
This event is emitted when a link starts (i.e. user connects the first end of a link)
IPC event.
void LogicalWorkspace::moveCanvasItemBy | ( | uuid | , |
int | , | ||
int | |||
) |
Moves the Logical workspace item with the specified UUID by the specified increments.
item_id,the | UUID of the Logical workspace item of interest. |
dx,the | value to move the item in the x-axis by. |
dy,the | value to move the item in the y-axis by. |
void LogicalWorkspace::moveItemToCluster | ( | uuid | , |
QString | |||
) |
bool LogicalWorkspace::moveRemoteNetwork | ( | QString | , |
int | , | ||
int | |||
) |
Moves the Multiuser remote network to the specified location.
name,the | name of the Multiuser remote network of interest. |
x,the | new x-coorindate for the Multiuser remote network. |
y,the | new y-coordinate for the Multiuser remote network. |
void LogicalWorkspace::onNoAutoConnectError | ( | QString | , |
QString | |||
) |
Sent when autoconnect occures and there isn't an error.
IPC event.
void LogicalWorkspace::remoteNetworkAdded | ( | QString | ) |
This event is emitted when a Multiuser remote network is added to the Logical workspace.
IPC event.
void LogicalWorkspace::remoteNetworkRemoved | ( | QString | ) |
This event is emitted when a Multiuser remote network is removed from the Logical workspace.
IPC event.
bool LogicalWorkspace::removeCanvasItem | ( | uuid | ) |
Removes the specified item from the Logical workspace.
id,the | UUID of the item of interest. |
void LogicalWorkspace::removeCluster | ( | QString | , |
bool | |||
) |
Removes csluter object with given id.
clusterId,The | cluster ID of the cluster of interest. |
uncluster,When | false - the cluster with everything inside will be killed. When true - is equivalent to unCluster. |
bool LogicalWorkspace::removeDevice | ( | QString | ) |
Removes the specified device from the Logical workspace and network.
deviceName,the | name of the device of interest. |
bool LogicalWorkspace::removeRemoteNetwork | ( | QString | ) |
Removes the Multiuser remote network with the specified name from the Logical workspace.
name,the | name of the Multiuser remote network to remove. |
bool LogicalWorkspace::removeTextPopup | ( | uuid | ) |
Removes the specified text popup from the Logical workspace.
id,the | UUID of the text popup of interest. |
void LogicalWorkspace::setCanvasItemRealPos | ( | uuid | , |
int | , | ||
int | |||
) |
Sets the x-coordinate of the Logical workspace item with the specified UUID.
item_id,the | UUID of the Logical workspace item of interest. |
x,the | x-coordinate for the Logical workspace item. |
y,the | y-coordinate for the Logical workspace item. |
void LogicalWorkspace::setCanvasItemX | ( | uuid | , |
int | |||
) |
Sets the x-coordinate of the Logical workspace item with the specified UUID.
item_id,the | UUID of the Logical workspace item of interest. |
x,the | x-coordinate for the Logical workspace item. |
void LogicalWorkspace::setCanvasItemY | ( | uuid | , |
int | |||
) |
Sets the y-coordinate of the Logical workspace item with the specified UUID.
item_id,the | UUID of the Logical workspace item of interest. |
y,the | y-coordinate for the Logical workspace item. |
void LogicalWorkspace::setDeviceCustomImage | ( | QString | , |
QString | |||
) |
Change Device image in logical workspace.
deviceName,the | name of the device to set the custom image for. |
path,path | to the image to use. |
void LogicalWorkspace::showClusterContents | ( | QString | ) |
Shows the content of the specified cluster.
clustid,the | cluster ID of the cluster of interest. |
void LogicalWorkspace::showClusterContents | ( | QString | ) |
Triggered when a cluster contents are shown.
clustid,the | cluster ID of the cluster of interest. |
IPC event.
void LogicalWorkspace::unCluster | ( | QString | ) |
Unclusters cluster with the given clusterId.