Actions34
- Devices Actions
- Endpoints Actions
- Guest Users Actions
- Local Users Actions
Endpoints → Create
AI-generatedOverview
This node interacts with the Aruba ClearPass API to create a new endpoint within the Identities domain. It is useful for network administrators who want to programmatically add endpoint devices to their ClearPass system, specifying details such as MAC address, description, status, randomized MAC flag, device insight tags, and additional attributes. For example, it can be used to automate the onboarding of new devices into the network with specific metadata and status settings.
Use Case Examples
- Automate adding new endpoint devices to Aruba ClearPass with predefined attributes.
- Create endpoints with specific MAC addresses and descriptions for network management.
- Set endpoint status and tags programmatically during device registration.
Properties
| Name | Meaning |
|---|---|
| Domain | API domain to access, fixed to 'Identities' for this operation. |
| MAC Address | The MAC address of the endpoint to create. |
| Description | Description of the endpoint. |
| Status | Status of the endpoint, e.g., Known, Unknown, Disabled. |
| Randomized MAC | Boolean flag indicating whether the MAC address is randomized. |
| Device Insight Tags | List of device insight tags associated with the endpoint. |
| Attributes | Additional key/value pair attributes for the endpoint in JSON format. |
Output
JSON
macAddress- The MAC address of the created endpoint.description- Description of the created endpoint.status- Status of the created endpoint.randomizedMac- Indicates if the MAC address is randomized.deviceInsightTags- Tags associated with the endpoint for device insight.attributes- Additional attributes of the endpoint as key/value pairs.
Dependencies
- Aruba ClearPass API with appropriate credentials
Troubleshooting
- Common issues include invalid or missing MAC address, incorrect domain or resource selection, and API authentication failures.
- Error messages may indicate network connectivity problems, invalid input data, or permission issues with the ClearPass API.
- Ensure the MAC address format is correct and all required fields are provided.
- Verify that the API credentials are valid and have sufficient permissions.
Links
- Aruba ClearPass Documentation - Official documentation for Aruba ClearPass API and usage.