Number status and usage#

Overview#

Values in the Status and Usage columns in the number inventory allow administrators to understand how numbers are used at a specific hierarchy level.

Status and Usage columns in the number inventory#

The table describes values in the Status and Usage columns in the Number Inventory:

Number Use

Device

Status

Usage

Vendor [1]

Not used by anything

-

Available

blank

blank

Phone Line [2]

device/cucm/Phone (line instance)

Used

Device

blank

Device Profile Line

device/cucm/DeviceProfile (line instance)

Used

Device

blank

Remote Destination Profile Line

device/cucm/RemoteDestinationProfile (line instance)

Used

Device

blank

Hunt Pilot [2]

device/cucm/HuntPilot

Used-Utility

Hunt_Pilot

blank

Pickup Group Pilot

device/cucm/CallPickupGroup

Used-Utility

Pickup_Group_Pilot

blank

System Call Handler

device/cuc/Callhandler (System only)

Used-Utility

Call_Handler_Pilot

blank

Voicemail Pilot

device/cucm/VoicemailPilot

Used-Utility

Voicemail_Pilot

blank

Meet Me

device/cucm/MeetMe

Used-Utility

Meet_Me

blank

CTI Route Point

device/cucm/CtiRoutePoint

Used-Utility

CTI_RoutePoint

blank

Call Park

device/cucm/CallPark

Used-Utility

Call_Park

blank

Directed Call Park

device/cucm/DirectedCallPark

Used-Utility

Directed_Call_Park

blank

VOSS Phone

data/PRS_MultiVendorPhone_DAT

Used-Utility

VOSS_Phone

phoneVendor

MS Teams Line URI

device/msteamsonline/CsOnlineUser (LineURI)

Used

User

Microsoft

Webex User

device/spark/Number

Used

User

Webex Calling

Number inactive

Inactive [3]

blank

Webex Calling

AudioCodes devices

device/audiocodes

Used

Device

AudioCodes [4]

Not used by anything

Available

blank

blank, Microsoft, Webex Calling

Number Use

Device

Status

Usage

Vendor [1]

Number in cooling [5]

Cooling

-

blank, Microsoft, Webex Calling

Number reserved [6]

Reserved

-

blank, Microsoft, Webex Calling

Webex Calling ownerType is unset

device/spark/Number

Available

-

Webex Calling

Webex Calling ownerType is PEOPLE

device/spark/Number

Used

User

Webex Calling

Webex Calling ownerType is not unset or PEOPLE

device/spark/Number

Used-Utility

Matches the ownerType:

Usage: Matches the Webex ownerType (for example: Hunt_Group, Auto_Attendant, Call_Queue, Paging_Group, Voice_Messaging, Voicemail_Group)

Webex Calling

For further details on Vendor and Internal Number Type fields – see UC vendor guidelines for numbers.

Footnotes

Related Topics

For details on call handlers and shared numbers, see Auto-Attendant Call Handler.

Webex Calling owner type mapping behavior#

For Webex Calling numbers (device/spark/Number), VOSS determines the Status and Usage values based on the Webex number ownerType.

This evaluation occurs:

  • When numbers are first discovered during sync

  • When an existing number changes ownership in the Webex Control Hub

Related topics

  • For details on how these values are populated during synchronization, see Add VOSS over an existing Webex organization

Owner type mappings#

  • PEOPLE

    • Status: Used

    • Usage: User

  • PLACE

    • Status: Used

    • Usage: Device

  • VIRTUAL_LINE

    • Status: Used

    • Usage: User

  • HUNT_GROUP

    • Status: Used-Utility

    • Usage: Hunt_Group

  • AUTO_ATTENDANT

    • Status: Used-Utility

    • Usage: Auto_Attendant

  • CALL_QUEUE

    • Status: Used-Utility

    • Usage: Call_Queue

  • PAGING_GROUP

    • Status: Used-Utility

    • Usage: Paging_Group

  • OFFICE_ANYWHERE

    • Status: Used-Utility

    • Usage: Office_Anywhere

  • VOICE_MESSAGING

    • Status: Used-Utility

    • Usage: Voice_Messaging

  • VOICEMAIL_GROUP

    • Status: Used-Utility

    • Usage: Voicemail_Group

Update behavior during synchronization#

If the owner type of a Webex Calling number changes (for example, a number is reassigned from a user to a Hunt Group), VOSS recalculates the Status and Usage values during the next Webex synchronization.

This ensures the Internal Number Inventory always reflects the current functional role of the number.