Phone Numbers - Update Capabilities

Služba:

Communication

Verze rozhraní API:

2021-03-07

Aktualizace funkce telefonního čísla.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Komunikační prostředek, například https://resourcename.communication.azure.com.
phoneNumber	path	True	string	ID telefonního čísla ve formátu E.164. Počáteční plus může být buď + nebo kódovaný jako %2B, například +11234567890.
api-version	query	True	string	Verze rozhraní API, která se má vyvolat.

Text požadavku

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

Name	Typ	Description
calling	PhoneNumberCapabilityType	Hodnota schopnosti pro volání.
sms	PhoneNumberCapabilityType	Hodnota schopnosti pro SMS.

Odpovědi

Name	Typ	Description
202 Accepted	PurchasedPhoneNumber	Služba žádost přijala a začne se zpracovávat později. Okamžitě vrátí přijato a bude obsahovat hlavičky Operation-Location a Location. Na straně klienta by se měl stav operace dále dotazovat pomocí adresy URL zadané v hlavičce Operation-Location. Po úspěšném dokončení operace odešlete dotaz na konečný výsledek pomocí adresy URL zadané v hlavičce Location. Hlavičky Location: string Operation-Location: string operation-id: string capabilities-id: string
Other Status Codes	CommunicationErrorResponse	Selhání

Příklady

Update phoneNumber capabilities

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:

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

{
  "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"
  }
}

Definice

Name	Description
BillingFrequency	Frekvence, s jakou se náklady účtují.
CommunicationError	Chyba komunikačních služeb.
CommunicationErrorResponse	Chyba komunikačních služeb.
PhoneNumberAssignmentType	Typ zadání telefonních čísel, která chcete vyhledat. Telefonní číslo lze přiřadit osobě nebo aplikaci.
PhoneNumberCapabilities	Možnosti telefonního čísla
PhoneNumberCapabilitiesRequest	Možnosti telefonního čísla
PhoneNumberCapabilityType	Hodnota schopnosti pro volání.
PhoneNumberCost	Vzniklé náklady na jedno telefonní číslo
PhoneNumberType	Typ telefonních čísel, která chcete vyhledat, například zeměpisná nebo tollFree.
PurchasedPhoneNumber	Představuje zakoupené telefonní číslo.

BillingFrequency

Frekvence, s jakou se náklady účtují.

Name	Typ	Description
monthly	string

CommunicationError

Chyba komunikačních služeb.

Name	Typ	Description
code	string	Kód chyby
details	CommunicationError[]	Další podrobnosti o konkrétních chybách, které k této chybě vedly.
innererror	CommunicationError	Vnitřní chyba, pokud existuje.
message	string	Chybová zpráva
target	string	Cíl chyby.

CommunicationErrorResponse

Chyba komunikačních služeb.

Name	Typ	Description
error	CommunicationError	Chyba komunikačních služeb.

PhoneNumberAssignmentType

Typ zadání telefonních čísel, která chcete vyhledat. Telefonní číslo lze přiřadit osobě nebo aplikaci.

Name	Typ	Description
application	string
person	string

PhoneNumberCapabilities

Možnosti telefonního čísla

Name	Typ	Description
calling	PhoneNumberCapabilityType	Hodnota schopnosti pro volání.
sms	PhoneNumberCapabilityType	Hodnota schopnosti pro SMS.

PhoneNumberCapabilitiesRequest

Možnosti telefonního čísla

Name	Typ	Description
calling	PhoneNumberCapabilityType	Hodnota schopnosti pro volání.
sms	PhoneNumberCapabilityType	Hodnota schopnosti pro SMS.

PhoneNumberCapabilityType

Hodnota schopnosti pro volání.

Name	Typ	Description
inbound	string
inbound+outbound	string
none	string
outbound	string

PhoneNumberCost

Vzniklé náklady na jedno telefonní číslo

Name	Typ	Description
amount	number	Částka nákladů.
billingFrequency	BillingFrequency	Frekvence, s jakou se náklady účtují.
currencyCode	string	Kód měny ISO 4217 pro částku nákladů, např. USD.

PhoneNumberType

Typ telefonních čísel, která chcete vyhledat, například zeměpisná nebo tollFree.

Name	Typ	Description
geographic	string
tollFree	string

PurchasedPhoneNumber

Představuje zakoupené telefonní číslo.

Name	Typ	Description
assignmentType	PhoneNumberAssignmentType	Typ zadání telefonního čísla. Telefonní číslo lze přiřadit osobě nebo aplikaci.
capabilities	PhoneNumberCapabilities	Možnosti telefonního čísla
cost	PhoneNumberCost	Vzniklé náklady na jedno telefonní číslo
countryCode	string	Kód ISO 3166-2 země telefonního čísla, např. USA.
id	string	ID telefonního čísla, například 11234567890.
phoneNumber	string	Řetězec telefonního čísla ve formátu E.164, například +11234567890.
phoneNumberType	PhoneNumberType	Typ telefonního čísla, např. Zeměpisné číslo, TollFree.
purchaseDate	string	Datum a čas zakoupení telefonního čísla.