Resource URL: /platform/<<version=1>>/auth/providers/summary

    Overview: This resource returns summary information for authentication
              providers.

     Methods: GET

********************************************************************************

Method GET: Retrieve the summary information.

       URL: GET /platform/<<version=1>>/auth/providers/summary

Query arguments:
zone=<string> Filter providers by zone.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "provider_instances": {
      "items": {
        "type": "object", 
        "description": "Specifies the summary information for an authentication provider.", 
        "properties": {
          "status": {
            "enum": [
              "offline", 
              "active", 
              "online", 
              "initializing", 
              "joining", 
              "disabled"
            ], 
            "type": "string", 
            "description": "Indicates the status of the provider."
          }, 
          "name": {
            "type": "string", 
            "description": "Specifies the name of the provider."
          }, 
          "site": {
            "type": [
              "string", 
              "null"
            ], 
            "description": "Specifies the Active Directory site name. Null if not applicable."
          }, 
          "connections": {
            "items": {
              "type": "object", 
              "properties": {
                "last_used": {
                  "type": "string", 
                  "description": "Specifies the last time the server was contacted."
                }, 
                "server": {
                  "type": "string", 
                  "description": "Specifies the fully qualified domain name of the server."
                }, 
                "address": {
                  "type": "string", 
                  "description": "Specifies the IP address of the provider."
                }
              }
            }, 
            "type": "array"
          }, 
          "active_server": {
            "type": [
              "string", 
              "null"
            ], 
            "description": "Specifies the server through which the provider serves authentication requests. Null if no server is set or is not applicable for that provider."
          }, 
          "forest": {
            "type": [
              "string", 
              "null"
            ], 
            "description": "Specifies the Active Directory forest. Null if not applicable."
          }, 
          "type": {
            "enum": [
              "file", 
              "ldap", 
              "local", 
              "nis", 
              "ads", 
              "krb5", 
              "unknown"
            ], 
            "type": "string", 
            "description": "Specifies the type of provider."
          }, 
          "id": {
            "type": "string", 
            "description": "Specifies the ID of the provider."
          }
        }
      }, 
      "type": "array"
    }
  }
}
