Sites
ras_infra_get_sitesRead-onlyIdempotent
Retrieve all configured sites and their status in a Parallels RAS farm to check connectivity, verify configurations, or audit deployment topology.
Instructions
List all sites configured in the RAS farm and their status. Multi-site deployments distribute infrastructure across locations. Use this to check site connectivity, verify site configuration, or audit the farm topology.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/infrastructure.ts:264-283 (registration)Tool registration for ras_infra_get_sites with schema definition (title, description, annotations, inputSchema) and handler function
server.registerTool( "ras_infra_get_sites", { title: "Sites", description: "List all sites configured in the RAS farm and their status. Multi-site " + "deployments distribute infrastructure across locations. Use this to check " + "site connectivity, verify site configuration, or audit the farm topology.", annotations: READ_ONLY_ANNOTATIONS, inputSchema: {}, }, async () => { try { const data = await rasClient.get("/api/infrastructure/sites/status"); return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] }; } catch (err) { return { content: [{ type: "text" as const, text: sanitiseError(err, "Failed to retrieve sites") }], isError: true }; } } ); - src/tools/infrastructure.ts:275-282 (handler)Handler function that executes the tool logic - makes API call to /api/infrastructure/sites/status and formats the response with error handling
async () => { try { const data = await rasClient.get("/api/infrastructure/sites/status"); return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] }; } catch (err) { return { content: [{ type: "text" as const, text: sanitiseError(err, "Failed to retrieve sites") }], isError: true }; } } - src/client.ts:128-166 (helper)RasClient.get() method used by the handler to make authenticated HTTP GET requests to the RAS API with automatic retry on 401 errors
async get(path: string): Promise<unknown> { // Ensure we have a valid session if (!this.authToken) { await this.login(); } const fetchOptions = { method: "GET" as const, headers: { ...this.headers, auth_token: this.authToken!, }, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), }; let response = await fetch(`${this.baseUrl}${path}`, fetchOptions); // Token may have expired — re-authenticate once and retry if (response.status === 401) { await this.login(); response = await fetch(`${this.baseUrl}${path}`, { ...fetchOptions, headers: { ...this.headers, auth_token: this.authToken!, }, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), }); } if (!response.ok) { const body = await response.text(); throw new Error( `RAS API error (HTTP ${response.status}) on ${path}: ${body.substring(0, 300)}` ); } return response.json(); } - src/client.ts:43-54 (helper)sanitiseError() function used to sanitize error messages by removing auth tokens, passwords, and truncating long responses
function sanitiseError(err: unknown, context: string): string { const raw = err instanceof Error ? err.message : String(err); // Remove anything that looks like a token or password value let sanitised = raw .replace(/auth_token[=:]\s*\S+/gi, "auth_token=[REDACTED]") .replace(/password[=:]\s*\S+/gi, "password=[REDACTED]"); // Truncate excessively long API response bodies if (sanitised.length > 500) { sanitised = sanitised.substring(0, 500) + "... (truncated)"; } return `${context}: ${sanitised}`; }