API Guide

Overview

Introduction

• What’s New
  • API Guide: Release 20.1.1
  • API Guide: Release 21.1
• API Introduction
• API System Concepts
• Hierarchy
• Basic REST
• API Traversal
• Request and Response Patterns

Anatomy of an API Request

• General Structure of the API
• Format
• Authentication
• Authorization
• HTTP Methods
• PUT Versus PATCH
• API Parameters
  • Format
  • Configuration Template and Template Name
  • Field Display Policy
  • Cached
  • Resource instance
  • Schema and Schema Rules
  • List pagination
  • List format
  • Filter
  • Synchronous and Asynchronous
  • Tags
  • Version Tags
• Filter Parameters for Choices
• API Request Headers
• Login and Authorization Tokens
• Non-interactive Login
• Access Profiles
• Time to Live (TTL)
• Account Endpoint
  • Logged-in User Details
  • Password Change

Anatomy of an API Response

• API Response Overview
• API Response Header
• Single Resource Response
• Resource List Response
• POST/PUT/DELETE/PATCH Response
• Asynchronous Mutator Transaction Status Callback
• Example of an Asynchronous Mutator Transaction with nowait=true
• Correlation Identifiers
• Example Of A Simple HTTP Server

Using the API

• Developer Guidelines
• Workflow Tasks
• Developer Tools

Handling API Fault Responses

• Fault Responses
• Error Messages

Tool APIs

• Introduction to Tool APIs
• Search and Search Result Export
• Bulk Load API
• Move and Bulk Move
• Data Extract
• Custom Workflows

Transactions

• List Transactions
• Get Instance Transactions
• Poll Transactions
• Replay Transactions
• Edit and Replay Transactions
• Sub Transactions
• Log Transactions
• Transaction Choices
• Transaction Filters

API Examples

• API Examples Overview and Conventions
• POST
• GET
• PUT
• DELETE
• Bulk Load Example
• Export Example
• Example Transaction

Backward Compatibility

• Backwards Compatibility Exceptions
• API Version Differences
• API Backward Compatibility and Import

General API Reference

• Using the API Reference
• API Schema
• Notifications

Meta data

• Metadata
• References
• Summary Attributes
• Path
• Model Type
• Actions
• Singleton

Generic Actions

• Choices
• Add
• Bulk Update
• Clone
• Configuration Template
• Create
• Delete
• Execute
• Export
• Export BulkLoad Template
• Field Display Policy
• Help
• List
• Update

Custom Device Connection Actions

• Import
• Test Connect

Custom Device Actions

• Apply
• Assign
• Do
• Lock
• Promote
• Reset
• Vendor Config
• Wipe
• Update LDAP Authentication
• Update LDAP System

Other elements

• Data
• Resources
• Schema
• Pagination