# Транспорты

## Запрос текущей конфигурации <a href="#get-config" id="get-config"></a>

Получение списка созданных транспортов:

**`GET /transports`**

Получение параметров транспорта:

**`GET /transports/{transport_id}`**

### Параметры path <a href="#path-parameters" id="path-parameters"></a>

`{transport_id}` - id транспорта

### Примеры <a href="#examples" id="examples"></a>

Пример ответа с параметрами транспорта (RDP direct):

```
{
    'id': 'b925c748-c3cc-585e-a8ec-9d7dd3a2c649',
    'name': 'rdp-direct',
    'tags': [],
    'comments': '',
    'priority': 1,
    'nets_positive': True,
    'label': '',
    'networks': [],
    'allowed_oss': [],
    'pools': [{'id': '4302fdcb-a692-5262-93d0-ab460bbd1f84'}, {'id': 'd1bd5dff-5287-5afd-9444-493a3528a535'}],
    'pools_count': 2,
    'deployed_count': 2,
    'type': 'RDPTransport',
    'type_name': 'RDP',
    'protocol': 'rdp',
    'permission': 96,
    'useEmptyCreds': False,
    'fixedName': '',
    'fixedPassword': '',
    'withoutDomain': False,
    'fixedDomain': '',
    'allowSmartcards': False,
    'allowPrinters': False,
    'allowDrives': False,
    'enforceDrives': '',
    'allowSerials': False,
    'allowClipboard': True,
    'allowAudio': True,
    'allowWebcam': False,
    'usbRedirection': False,
    'wallpaper': False,
    'multimon': False,
    'aero': False,
    'smooth': True,
    'showConnectionBar': True,
    'credssp': True,
    'rdpPort': '3389',
    'screenSize': '-1x-1',
    'colorDepth': '24',
    'alsa': False,
    'multimedia': False,
    'printerString': '',
    'smartcardString': '',
    'customParameters': '/sec:tls',
    'allowMacMSRDC': False,
    'customParametersMAC': ''
}
```

## Создание нового транспорта <a href="#create-transport" id="create-transport"></a>

Создание нового транспорта:

**`PUT /transports`**

### Параметры тела запроса <a href="#request-body-parameters" id="request-body-parameters"></a>

`name` - имя транспорта, тип: *string*

`tags` - тэги для этого элемента, тип: *list of strings*

`comments` - комментарии для этого элемента, тип: *string*

`priority` - приоритет транспорта, тип: *integer*

`nets_positive` - сетевой доступ, тип: *boolean*

`label` - метка, тип: *string*

`networks` - список id сетей, ассоциированных с транспортом, тип: *list of strings*

`allowed_oss` - список разрешенных устройств, тип: *list of strings*

Перечень значений параметра `allowed_oss` (допустимо указывать несколько значений, либо передать пустую строку(без ограничений по устройствам)):

* `WindowsPhone`
* `Android`
* `Linux`
* `Windows`
* `iPad`
* `iPhone`
* `Macintosh`
* `ChromeOS`
* `WYSE`

`pools` - список id сервис-пулов, в которые добавлен транспорт, тип: *list of strings*

`type` - тип транспорта, тип: *string*

Допустимые значения параметра `type`:

* `RDPTransport` - транспорт RDP direct
* `TSRDPTransport` - транспорт RDP tunnel
* `RATransport` - транспорт RemoteApp direct
* `TRATransport` - транспорт RemoteApp tunnel
* `HTML5RDPTransport` - транспорт HTML5 RDP
* `HTML5RATransport` - транспорт HTML5 RemoteApp
* `PCoIPTransport` - транспорт PCoIP Cloud Access
* `SPICETransport` - транспорт SPICE direct
* `TSSPICETransport` - транспорт SPICE tunnel
* `URLTransport` - транспорт URL Launcher
* `X2GOTransport` - транспорт X2Go direct
* `TX2GOTransport` - транспорт X2Go tunnel

**Важно:** в зависимости от выбранного типа транспорта, список дополнительно требуемых параметров будет отличаться. Описание см. в [приложении](/hostvm-vdi/rest-api-guide/3.5/appendix.md).

## Добавление сетей <a href="#add-network" id="add-network"></a>

Добавление сетей в транспорт:

**`PUT /transports/{transport_id}/networks`**

### Параметры path <a href="#path-parameters" id="path-parameters"></a>

`{transport_id}` - id транспорта

### Параметры тела запроса <a href="#request-body-parameters" id="request-body-parameters"></a>

**Обязательные:**

`id` - id добавляемой сети, тип: *string*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.pvhostvm.ru/hostvm-vdi/rest-api-guide/3.5/transports.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.