Phone Numbers - Update Capabilities

Service:

Communication

API-versie:

2022-12-01

Hiermee worden de mogelijkheden van een telefoonnummer bijgewerkt.

PATCH {endpoint}/phoneNumbers/{phoneNumber}/capabilities?api-version=2022-12-01

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string url	De communicatieresource, bijvoorbeeld https://resourcename.communication.azure.com
phoneNumber	path	True	string	De telefoonnummer-id in E.164-indeling. De voorloop plus kan + of gecodeerd worden als %2B, bijvoorbeeld +11234567890.
api-version	query	True	string	Versie van API die moet worden aangeroepen

Aanvraagbody

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

Name	Type	Description
calling	PhoneNumberCapabilityType	Mogelijkheidswaarde voor aanroepen.
sms	PhoneNumberCapabilityType	Mogelijkheidswaarde voor sms.

Antwoorden

Name	Type	Description
202 Accepted	PurchasedPhoneNumber	De service heeft de aanvraag geaccepteerd en wordt later verwerkt. Het retourneert 'Geaccepteerd' onmiddellijk en bevat een header 'Operation-Location' en 'Location'. Clientzijde moet de bewerkingsstatus verder opvragen met behulp van de URL die is opgegeven in de header Operation-Location. Wanneer de bewerking is voltooid, wordt het uiteindelijke resultaat van de query uitgevoerd met behulp van de URL die is opgegeven in de header Locatie. Kopteksten Location: string Operation-Location: string operation-id: string capabilities-id: string
Other Status Codes	CommunicationErrorResponse	Mislukking

Voorbeelden

Update phoneNumber capabilities

Voorbeeldaanvraag

HTTP

PATCH https://resourcename.communication.azure.com//phoneNumbers/+14792000102/capabilities?api-version=2022-12-01

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
BillingFrequency	De frequentie waarmee de kosten worden gefactureerd.
CommunicationError	De Communication Services-fout.
CommunicationErrorResponse	De Communication Services-fout.
PhoneNumberAssignmentType	Vertegenwoordigt het toewijzingstype van het aanbod.
PhoneNumberCapabilities	Mogelijkheden van een telefoonnummer.
PhoneNumberCapabilitiesRequest	Mogelijkheden van een telefoonnummer.
PhoneNumberCapabilityType	Mogelijkheidswaarde voor aanroepen.
PhoneNumberCost	De gemaakte kosten voor één telefoonnummer.
PhoneNumberType	Vertegenwoordigt het nummertype van het aanbod.
PurchasedPhoneNumber	Vertegenwoordigt een gekocht telefoonnummer.

BillingFrequency

De frequentie waarmee de kosten worden gefactureerd.

Name	Type	Description
monthly	string

CommunicationError

De Communication Services-fout.

Name	Type	Description
code	string	De foutcode.
details	CommunicationError[]	Meer informatie over specifieke fouten die tot deze fout hebben geleid.
innererror	CommunicationError	De interne fout indien aanwezig.
message	string	Het foutbericht.
target	string	Het foutdoel.

CommunicationErrorResponse

De Communication Services-fout.

Name	Type	Description
error	CommunicationError	De Communication Services-fout.

PhoneNumberAssignmentType

Vertegenwoordigt het toewijzingstype van het aanbod.

Name	Type	Description
application	string
person	string

PhoneNumberCapabilities

Mogelijkheden van een telefoonnummer.

Name	Type	Description
calling	PhoneNumberCapabilityType	Mogelijkheidswaarde voor aanroepen.
sms	PhoneNumberCapabilityType	Mogelijkheidswaarde voor sms.

PhoneNumberCapabilitiesRequest

Mogelijkheden van een telefoonnummer.

Name	Type	Description
calling	PhoneNumberCapabilityType	Mogelijkheidswaarde voor aanroepen.
sms	PhoneNumberCapabilityType	Mogelijkheidswaarde voor sms.

PhoneNumberCapabilityType

Mogelijkheidswaarde voor aanroepen.

Name	Type	Description
inbound	string
inbound+outbound	string
none	string
outbound	string

PhoneNumberCost

De gemaakte kosten voor één telefoonnummer.

Name	Type	Description
amount	number	Het kostenbedrag.
billingFrequency	BillingFrequency	De frequentie waarmee de kosten worden gefactureerd.
currencyCode	string	De ISO 4217-valutacode voor het kostenbedrag, bijvoorbeeld USD.

PhoneNumberType

Vertegenwoordigt het nummertype van het aanbod.

Name	Type	Description
geographic	string
tollFree	string

PurchasedPhoneNumber

Vertegenwoordigt een gekocht telefoonnummer.

Name	Type	Description
assignmentType	PhoneNumberAssignmentType	Het toewijzingstype van het telefoonnummer. Een telefoonnummer kan worden toegewezen aan een persoon of aan een toepassing.
capabilities	PhoneNumberCapabilities	Mogelijkheden van een telefoonnummer.
cost	PhoneNumberCost	De gemaakte kosten voor één telefoonnummer.
countryCode	string	De ISO 3166-2-code van het land van het telefoonnummer, bijvoorbeeld VS.
id	string	De id van het telefoonnummer, bijvoorbeeld 11234567890.
phoneNumber	string	Tekenreeks van de E.164-notatie van het telefoonnummer, bijvoorbeeld +11234567890.
phoneNumberType	PhoneNumberType	Het type telefoonnummer, bijvoorbeeld geografisch, tollFree.
purchaseDate	string	De datum en tijd waarop het telefoonnummer is gekocht.