Server types
Server types are an important concept in MetalSoft. They are server ‘profiles’ or SKUs that users will operate on. A user will ‘ask’ for a specific ‘server_type’ and the system will match the exact server type if available or suggest an alternative.
Server types are also used to verify a registration of a server. The server_type-to-server match is done at register time.
Server classes are used to filter the server types available to certain users.
Creating a new server type
Section titled “Creating a new server type”Server types are best created from a registered server. Click on a server and select the Create server type button:
Most fields should be pre-filled in except the server name if you copy from a server ID (top of form).
Click create server type
Allocating a server type to a server
Section titled “Allocating a server type to a server”This is typically not required as it’s configured automatically at register time. However it can be overwritten by using the Change server type button on the respective server.
Managing server types via the API
Section titled “Managing server types via the API”Listing server types
Section titled “Listing server types”curl "https://<your-server>/api/v2/server-types" \ -H "Authorization: Bearer <API_KEY>"Getting a specific server type
Section titled “Getting a specific server type”curl "https://<your-server>/api/v2/server-types/{serverTypeId}" \ -H "Authorization: Bearer <API_KEY>"Getting server type statistics
Section titled “Getting server type statistics”curl -X POST "https://<your-server>/api/v2/server-types/statistics" \ -H "Authorization: Bearer <API_KEY>"Cleaning unused server types
Section titled “Cleaning unused server types”Removes server types that are not assigned to any server:
curl -X POST "https://<your-server>/api/v2/server-types/actions/clean-unused" \ -H "Authorization: Bearer <API_KEY>"