Удаление правил маршрутизации

Удаляет правила маршрутизации для указанных доменов организации.

Для выполнения запроса требуется право ya360_admin:mail_write_domain_routes.

Request

POST

https://cloud-api.yandex.net/v1/mail/organizations/{org_id}/routes/remove

Path parameters

Name

Description

org_id

Type: integer

Идентификатор организации, для которой настраиваются правила маршрутизации.

Min value: 1

Body

application/json

{
  "items": [
    {
      "recipient_domain": "example.com"
    }
  ]
}

Name

Description

items

Type: RemoveItems

Список доменов для удаления. Среди доменов в теле запроса не должно быть некорректных и одинаковых.

Возможное количество доменов в запросе: от 1 до 1000.

Example

[
  {
    "recipient_domain": "example.com"
  }
]

RoutingRecipientDomain

Информация о домене получателя письма.

Name

Description

recipient_domain

Type: string

Домен получателя письма.

Example: example.com

Example

{
  "recipient_domain": "example.com"
}

RemoveItems

Список доменов для удаления. Среди доменов в теле запроса не должно быть некорректных и одинаковых.

Возможное количество доменов в запросе: от 1 до 1000.

Type: RoutingRecipientDomain[]

Example

[
  {
    "recipient_domain": "example.com"
  }
]

Responses

200 OK

Правила маршрутизации удалены.

Body

application/json

{
  "message": "Правила маршрутизации удалены."
}

Name

Description

message

Type: string

Подробное описание статуса выполнения операции.

Example: Правила маршрутизации удалены.

400 Bad Request

Некорректный запрос.

Body

application/json

{
  "error": "bad_request",
  "description": "Bad request",
  "message": "Bad request",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Bad request

error

Type: string

Код ошибки

Example: bad_request

message

Type: string

Сообщение об ошибке.

Example: Bad request

details

Type: object

Дополнительные детали ошибки

Example

{}

401 Unauthorized

Пользователь не авторизован.

Body

application/json

{
  "error": "unauthorized",
  "description": "Unauthorized",
  "message": "Unauthorized",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Unauthorized

error

Type: string

Код ошибки

Example: unauthorized

message

Type: string

Сообщение об ошибке.

Example: Unauthorized

details

Type: object

Дополнительные детали ошибки

Example

{}

403 Forbidden

Доступ к ресурсу запрещен. У пользователя или приложения недостаточно прав.

Body

application/json

{
  "error": "forbidden",
  "description": "Forbidden",
  "message": "Forbidden",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Forbidden

error

Type: string

Код ошибки

Example: forbidden

message

Type: string

Сообщение об ошибке.

Example: Forbidden

details

Type: object

Дополнительные детали ошибки

Example

{}

422 Unprocessable Entity

Business logic error

Body

application/json

{
  "error": "business_logic_error",
  "description": "Business logic error",
  "message": "Business logic error",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Business logic error

error

Type: string

Код ошибки

Example: business_logic_error

message

Type: string

Сообщение об ошибке.

Example: Business logic error

details

Type: object

Дополнительные детали ошибки

Example

{}

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json

{
  "error": "internal_server_error",
  "description": "Internal server error",
  "message": "Internal server error",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Internal server error

error

Type: string

Код ошибки

Example: internal_server_error

message

Type: string

Сообщение об ошибке.

Example: Internal server error

details

Type: object

Дополнительные детали ошибки

Example

{}

Была ли статья полезна?

Создание и обновление правил маршрутизации

Обзор