Resource URL: /platform/<<version=3>>/cloud/access

    Overview: This resource applies the standard collection pattern to
              accessible clusters.

     Methods: GET, POST

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

Method GET: List all accessible cluster identifiers.

       URL: GET /platform/<<version=3>>/cloud/access

Query arguments:
  sort=<string> The field that will be used for sorting.
limit=<integer> Return no more than this many results at once (see resume).
     dir=<enum> Where <enum> is one of ASC, DESC.  The direction of the sort.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "clusters": {
      "items": {
        "type": "object", 
        "description": "Accessible cloud storage information", 
        "properties": {
          "name": {
            "type": "string", 
            "description": "The name of the cluster from which the above guid originated"
          }, 
          "current": {
            "type": "boolean", 
            "description": "Whether the guid is that of the current (local) cluster"
          }, 
          "state": {
            "enum": [
              "permitted", 
              "pending enable", 
              "pending disable", 
              "not permitted"
            ], 
            "type": "string", 
            "description": "Whether the guid has access to the cloud"
          }, 
          "accounts": {
            "items": {
              "type": "string"
            }, 
            "type": "array", 
            "description": "A list of accounts created on the cluster with this guid"
          }, 
          "policies": {
            "items": {
              "type": "string"
            }, 
            "type": "array", 
            "description": "A list of policies created on the cluster with this guid"
          }, 
          "synced_from": {
            "type": "string", 
            "description": "The name of the cluster from which the above guid was synced"
          }, 
          "guid": {
            "type": "string", 
            "description": "A cluster guid indicating the birth place of one or more accounts or policies on this cluster"
          }, 
          "id": {
            "type": "string", 
            "description": "A cluster guid indicating the birth place of one or more accounts or policies on this cluster"
          }
        }
      }, 
      "type": "array"
    }, 
    "total": {
      "type": "integer", 
      "description": "Total number of items available."
    }, 
    "resume": {
      "type": [
        "string", 
        "null"
      ], 
      "description": "Continue returning results from previous call using this token (token should come from the previous call, resume cannot be used with other options)."
    }
  }
}

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

Method POST: Add a cluster identifier to access list.

        URL: POST /platform/<<version=3>>/cloud/access

There are no query arguments for this method.

Required POST request body fields:
guid

POST request body schema:
{
  "type": "object", 
  "description": "Accessible cloud storage information", 
  "properties": {
    "guid": {
      "required": true, 
      "type": "string", 
      "description": "A cluster guid indicating the birth place of one or more accounts or policies on this cluster"
    }
  }
}

There is no response body for this method.
