POST SessionMachineCatalogs({id})/SessionMachines

Create new session machines within a session machine catalog.

Request Information

Parameters

NameDescriptionAdditional information
id

ID of the session machine catalog.

Type:

Request body type

CreateSessionMachineModel

Request body formats

application/json, text/json

Sample:
{
  "DataCenterId": "af1fc9c4-dee5-4b0d-836c-9e1c5b57a88a",
  "DomainId": "241b45cc-261d-47d0-81d7-a0a41c54c760",
  "Servers": [
    "vda1",
    "vda2"
  ],
  "NetworkName": "Shared Delivery Group Management Network",
  "Tags": [
    "tag"
  ],
  "CustomProperties": [
    {
      "Name": "myProperty",
      "Value": "myValue"
    }
  ]
}

Response Information

The newly created session machines.

Response type

CollectionResultModel<SessionMachineModel>

Response body formats

application/json, text/json

Sample:
{
  "Href": "[api:SessionMachineCatalogs(628fa898-0c36-4024-8fe4-d7e9a9bfbcfa)/SessionMachines]",
  "Count": 1,
  "TotalMatchingFilter": 1,
  "Items": [
    {
      "Href": "[api:SessionMachines(77b50020-4252-453c-815b-ce9b9412d543)]",
      "Id": "77b50020-4252-453c-815b-ce9b9412d543",
      "ChangeId": "12",
      "Name": "machine1",
      "DeleteState": "NotDeleted",
      "State": "Allocated",
      "IsShared": false,
      "VersionUpdatePending": false,
      "SessionMachineCatalogVersion": 2,
      "SessionMachineCatalog": {
        "Href": "[api:SessionMachineCatalogs(628fa898-0c36-4024-8fe4-d7e9a9bfbcfa)]",
        "Name": "catalog 1",
        "Id": "628fa898-0c36-4024-8fe4-d7e9a9bfbcfa"
      },
      "MachineDetail": {
        "Href": "[api:MachineDetails(bff69e21-c280-488b-ad9e-74b674ffb7c9)]",
        "Name": "machine1",
        "Id": "bff69e21-c280-488b-ad9e-74b674ffb7c9"
      },
      "DeliveryGroup": {
        "Href": "[api:DeliveryGroups(c004375e-a96d-4368-96ba-c80702d7e80f)]",
        "Name": "dg1",
        "Id": "c004375e-a96d-4368-96ba-c80702d7e80f"
      },
      "DeliverySite": {
        "Href": "[api:DeliverySites(0ef3e68d-bb8e-4b69-9c30-ae3fac533996)]",
        "Name": "site1",
        "Id": "0ef3e68d-bb8e-4b69-9c30-ae3fac533996"
      },
      "Tenant": {
        "Href": "[api:Tenants(91ade655-feb5-47d3-9585-a5827ad50132)]",
        "Name": "Tenant 1",
        "Id": "91ade655-feb5-47d3-9585-a5827ad50132"
      },
      "Tags": [
        "tag"
      ],
      "CustomProperties": [
        {
          "Name": "myProperty",
          "Value": "myValue"
        }
      ],
      "HealthSummary": {
        "ActiveCount": 0,
        "ErrorCount": 0,
        "WarningCount": 0,
        "InfoCount": 1,
        "Messages": [
          {
            "Text": "Attempting to reach desired capacity",
            "IsError": false,
            "IsWarning": false,
            "IsInfo": false,
            "IsActive": true,
            "Type": "Allocation"
          }
        ]
      },
      "Domain": {
        "Href": "[api:Domains(241b45cc-261d-47d0-81d7-a0a41c54c760)]",
        "Name": "domain1.local",
        "Id": "241b45cc-261d-47d0-81d7-a0a41c54c760"
      },
      "Network": "network1",
      "DataCenter": {
        "Href": "[api:DataCenters(af1fc9c4-dee5-4b0d-836c-9e1c5b57a88a)]",
        "Name": "datacenter1",
        "Id": "af1fc9c4-dee5-4b0d-836c-9e1c5b57a88a"
      },
      "UserName": "DOMAIN\\user1",
      "UserTenant": {
        "Href": "[api:Tenants(91ade655-feb5-47d3-9585-a5827ad50132)]",
        "Name": "Tenant 1",
        "Id": "91ade655-feb5-47d3-9585-a5827ad50132"
      }
    }
  ]
}