[Документация Yandex Cloud](../../../index.md) > [Yandex Cloud Postbox](../../index.md) > [Справочник API](../index.md) > [REST](index.md) > Выделенные IP-адреса > Метод CreateDedicatedIpPool

# Метод CreateDedicatedIpPool

Создает [пул выделенных IP-адресов](../../concepts/glossary.md#dedicated-ip-pool) в каталоге. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.

## Запрос {#request}

```http
POST /v2/email/dedicated-ip-pools HTTP/2
```

### Заголовки запроса {#request-headers}

Используйте в запросе [общие заголовки](request-headers.md).

### Тело запроса {#request-body}

```json
{
  "PoolName": "<имя_пула>",
  "ScalingMode": "STANDARD",
  "Tags": [
    {
      "Key": "<ключ_метки>",
      "Value": "<значение_метки>"
    }
  ]
}
```

#|
|| **Параметр** | **Описание** ||
|| `PoolName` | **Тип**: string.

Имя пула. Должно быть уникальным в рамках облака.

Допустимые символы — строчные латинские буквы, цифры, символы подчеркивания `_` и дефисы `-`. Длина имени — от 1 до 64 символов.

Нельзя указывать имена, [зарезервированные](../../concepts/dedicated-ip.md#reserved-pools) сервисом. ||
|| `ScalingMode` | **Тип**: string.

Режим масштабирования пула. Возможные значения: `STANDARD`.

Необязательный параметр. ||
|| `Tags` | **Тип**: array.

Массив меток для пула.

Необязательный параметр. ||
|| `Key` | **Тип**: string.

Ключ метки. ||
|| `Value` | **Тип**: string.

Значение метки. ||
|#

## Ответы {#responses}

### 200 OK {#200}

Ответ `200 OK` возвращается в случае успешного выполнения запроса.

### Ошибки {#errors}

Для всех ошибок тело ответа представлено в одинаковом формате:

```json
{
   "Code": "<название_ошибки>",
   "message": "<пояснение_к_ошибке>"
}
```

Название ошибки заимствуется из ее кода, например `BadRequestException`.

Возможные ошибки:

#|
|| **Код ошибки** | **Описание** ||
|| `400 BadRequestException` | В запросе неправильно указаны заголовки или параметры. Также возвращается, если имя пула не соответствует требованиям, указано зарезервированное имя пула или параметр `ScalingMode` не равен `STANDARD`. ||
|| `409 AlreadyExistsException` | Пул с таким именем уже существует, выберите другое имя. ||
|| `429 TooManyRequestsException` | При вызове запроса превышена [квота](../../concepts/limits.md#postbox-quotas). ||
|#