Поделиться через

Phone Numbers - Purchase Reservation

Служба:
Communication
Версия API:
2025-06-01

Начинает покупку всех номеров телефонов в резервировании.
Запускает длинную операцию, чтобы приобрести все номера телефонов в резервировании. Покупка может быть запущена только для активных резервирований, которые по крайней мере один номер телефона. Если любой из номеров телефонов в резервировании находится в стране, где перепродажа не разрешена, не следует перепродать соглашение. Ответ будет содержать заголовок Operation-Location, который можно использовать для запроса состояния операции.

POST {endpoint}/availablePhoneNumbers/reservations/{reservationId}/:purchase?api-version=2025-06-01

Параметры URI

Имя В Обязательно Тип Описание
endpoint
 path True

string (url)

Ресурс связи, например https://resourcename.communication.azure.com
reservationId
 path True

string (uuid)

Идентификатор резервирования.
api-version
 query True

string

Версия API для вызова

Текст запроса

Имя Тип Описание
agreeToNotResell

boolean

Соглашение не перепродать номера телефонов. По умолчанию значение false, если оно не указано.

Ответы

Имя Тип Описание
202 Accepted

Служба приняла запрос и начнет обработку позже. Он возвращает "Принято" немедленно и включает заголовок Operation-Location. Клиентская сторона должна дополнительно запрашивать состояние операции с помощью URL-адреса, указанного в заголовке Operation-Location.

Заголовки

  • Operation-Location: string
  • operation-id: string
  • reservation-purchase-id: string
Other Status Codes

CommunicationErrorResponse

Неудача

Примеры

Start reservation purchase

Образец запроса

POST https://resourcename.communication.azure.com/availablePhoneNumbers/reservations/65c18c7f-8074-4efb-a572-e0df127a9964/:purchase?api-version=2025-06-01

Пример ответа

Код состояния:
202 
Operation-Location: https://resourcename.communication.azure.comoperations/reservationPurchase_65c18c7f-8074-4efb-a572-e0df127a9964?api-version=2023-11-01-preview
operation-id: reservationPurchase_65c18c7f-8074-4efb-a572-e0df127a9964
reservation-purchase_id: 65c18c7f-8074-4efb-a572-e0df127a9964

Определения

Имя Описание
CommunicationError

Ошибка служб коммуникации.
CommunicationErrorResponse

Ошибка служб коммуникации.
PhoneNumbersReservationPurchaseRequest

Запрос на покупку номера телефона.

CommunicationError

Object

Ошибка служб коммуникации.

Имя Тип Описание
code

string

Код ошибки.
details

CommunicationError[]

Дополнительные сведения об определенных ошибках, которые привели к этой ошибке.
innererror

CommunicationError

Внутренняя ошибка, если она есть.
message

string

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

string

Целевой объект ошибки.

CommunicationErrorResponse

Object

Ошибка служб коммуникации.

Имя Тип Описание
error

CommunicationError

Ошибка служб коммуникации.

PhoneNumbersReservationPurchaseRequest

Object

Запрос на покупку номера телефона.

Имя Тип Описание
agreeToNotResell

boolean

Соглашение не перепродать номера телефонов. По умолчанию значение false, если оно не указано.