Phone Numbers - Update Capabilities

Service:

Communication

API Version:

2021-03-07

전화 번호의 기능을 업데이트.

PATCH {endpoint}/phoneNumbers/{phoneNumber}/capabilities?api-version=2021-03-07

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	통신 리소스(예 https://resourcename.communication.azure.com: )입니다.
phoneNumber	path	True	string	E.164 형식의 전화 번호 ID입니다. 선행 더하기는 + 또는 %2B로 인코딩할 수 있습니다(예: +11234567890).
api-version	query	True	string	호출할 API의 버전입니다.

요청 본문

Media Types: "application/merge-patch+json"

Name	형식	Description
calling	PhoneNumberCapabilityType	호출에 대한 기능 값입니다.
sms	PhoneNumberCapabilityType	SMS의 기능 값입니다.

응답

Name	형식	Description
202 Accepted	PurchasedPhoneNumber	서비스가 요청을 수락했으며 나중에 처리를 시작합니다. 즉시 '수락됨'을 반환하고 'Operation-Location' 및 'Location' 헤더를 포함합니다. 클라이언트 쪽에서는 'Operation-Location' 헤더에 지정된 URL을 사용하여 작업 상태 추가로 쿼리해야 합니다. 작업이 완료되면 'Location' 헤더에 지정된 URL을 사용하여 최종 결과를 쿼리합니다. Headers Location: string Operation-Location: string operation-id: string capabilities-id: string
Other Status Codes	CommunicationErrorResponse	실패

예제

Update phoneNumber capabilities

Sample Request

HTTP

PATCH https://resourcename.communication.azure.com//phoneNumbers/+14792000102/capabilities?api-version=2021-03-07

{
  "calling": "inbound+outbound",
  "sms": "none"
}

Sample Response

Status code:

202

Operation-Location: /phoneNumbers/operations/capabilities_378ddf60-81be-452a-ba4f-613198ea6c28
Location: /phoneNumbers/%2b14792000102
operation-id: capabilities_378ddf60-81be-452a-ba4f-613198ea6c28
capabilities-id: 378ddf60-81be-452a-ba4f-613198ea6c28

Response Body

{
  "id": "14792000102",
  "phoneNumber": "+14792000102",
  "countryCode": "US",
  "assignmentType": "person",
  "phoneNumberType": "geographic",
  "capabilities": {
    "calling": "inbound+outbound",
    "sms": "none"
  },
  "purchaseDate": "2020-11-19T16:31:49.048Z",
  "cost": {
    "amount": 0.8,
    "currencyCode": "USD",
    "billingFrequency": "monthly"
  }
}

정의

Name	Description
BillingFrequency	비용이 청구되는 빈도입니다.
CommunicationError	Communication Services 오류입니다.
CommunicationErrorResponse	Communication Services 오류입니다.
PhoneNumberAssignmentType	검색할 전화 번호의 할당 유형입니다. 전화 번호는 개인 또는 애플리케이션에 할당할 수 있습니다.
PhoneNumberCapabilities	전화 번호의 기능입니다.
PhoneNumberCapabilitiesRequest	전화 번호의 기능입니다.
PhoneNumberCapabilityType	호출에 대한 기능 값입니다.
PhoneNumberCost	단일 전화 번호에 대해 발생하는 비용입니다.
PhoneNumberType	검색할 전화 번호 유형(예: 지리적 또는 tollFree)입니다.
PurchasedPhoneNumber	구매한 전화 번호를 나타냅니다.

BillingFrequency

비용이 청구되는 빈도입니다.

Name	형식	Description
monthly	string

CommunicationError

Communication Services 오류입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	CommunicationError[]	이 오류로 이어진 특정 오류에 대한 자세한 내용입니다.
innererror	CommunicationError	내부 오류(있는 경우)입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

CommunicationErrorResponse

Communication Services 오류입니다.

Name	형식	Description
error	CommunicationError	Communication Services 오류입니다.

PhoneNumberAssignmentType

검색할 전화 번호의 할당 유형입니다. 전화 번호는 개인 또는 애플리케이션에 할당할 수 있습니다.

Name	형식	Description
application	string
person	string

PhoneNumberCapabilities

전화 번호의 기능입니다.

Name	형식	Description
calling	PhoneNumberCapabilityType	호출에 대한 기능 값입니다.
sms	PhoneNumberCapabilityType	SMS의 기능 값입니다.

PhoneNumberCapabilitiesRequest

전화 번호의 기능입니다.

Name	형식	Description
calling	PhoneNumberCapabilityType	호출에 대한 기능 값입니다.
sms	PhoneNumberCapabilityType	SMS의 기능 값입니다.

PhoneNumberCapabilityType

호출에 대한 기능 값입니다.

Name	형식	Description
inbound	string
inbound+outbound	string
none	string
outbound	string

PhoneNumberCost

단일 전화 번호에 대해 발생하는 비용입니다.

Name	형식	Description
amount	number	비용 금액입니다.
billingFrequency	BillingFrequency	비용이 청구되는 빈도입니다.
currencyCode	string	비용 금액(예: USD)에 대한 ISO 4217 통화 코드입니다.

PhoneNumberType

검색할 전화 번호 유형(예: 지리적 또는 tollFree)입니다.

Name	형식	Description
geographic	string
tollFree	string

PurchasedPhoneNumber

구매한 전화 번호를 나타냅니다.

Name	형식	Description
assignmentType	PhoneNumberAssignmentType	전화 번호의 할당 유형입니다. 전화 번호는 개인 또는 애플리케이션에 할당할 수 있습니다.
capabilities	PhoneNumberCapabilities	전화 번호의 기능입니다.
cost	PhoneNumberCost	단일 전화 번호에 대해 발생하는 비용입니다.
countryCode	string	전화 번호 국가(예: 미국)의 ISO 3166-2 코드입니다.
id	string	전화 번호의 ID(예: 11234567890)입니다.
phoneNumber	string	전화 번호의 E.164 형식(예: +11234567890)의 문자열입니다.
phoneNumberType	PhoneNumberType	전화 번호 유형(예: 지리적, TollFree)입니다.
purchaseDate	string	전화 번호를 구매한 날짜 및 시간입니다.