Counts

Summary

Return counts of distinct values for dimension keys for a given timeframe.

End Point

/containers/counts

Query Arguments

Parameter	Description	Default	Allowed
start/end	Start/End date for the window of usage results.	Required	Format YYYY-MM-DD
dimensions	The dimensions to get counts for. The result will have a count for each dimension key specified. Comma-separated value	Required	cluster daemonset deployment job namespace pod replicaset replication_controller service `cldy:labels:*` (i.e. labels)
group	Group the reported data by the given dimensions. Comma-separated value	None	cluster daemonset deployment job namespace pod replicaset replication_controller service `cldy:labels:*` (i.e. labels)
filters	Filter the reported data to the given dimension values.	N/A
pretty	Pretty-print the JSON response	None	true

Example Request

curl "https://api.cloudability.com/v3/containers/counts?pretty=true&start=2018-11-01&end=2018-11-05&dimensions=namespace,service&group=cluster" -u "${API_KEY}:"

{
  "result": {
    "groups": [
      {
        "group": [
          {
            "key": "cluster",
            "value": "e5ad2c07-2bd4-4e8f-afdf-6dbbcddc8cea"
          }
        ],
        "counts": [
          {
            "key": "namespace",
            "value": 9
          },
          {
            "key": "service",
            "value": 18
          }
        ]
      },
      {
        "group": [
          {
            "key": "cluster",
            "value": "0be6790f-e810-4f2e-a056-aa3f64c14504"
          }
        ],
        "counts": [
          {
            "key": "namespace",
            "value": 7
          },
          {
            "key": "service",
            "value": 12
          }
        ]
      },
      {
        "group": [
          {
            "key": "cluster",
            "value": "0be6790f-e810-4f2e-a056-aa3f64c14504"
          }
        ],
        "counts": [
          {
            "key": "namespace",
            "value": 11
          },
          {
            "key": "service",
            "value": 23
          }
        ]
      },
      {
        "group": [
          {
            "key": "cluster",
            "value": "642622c9-9dce-4789-bbdb-f0e002f0763b"
          }
        ],
        "counts": [
          {
            "key": "namespace",
            "value": 9
          },
          {
            "key": "service",
            "value": 11
          }
        ]
      },
      {
        "group": [
          {
            "key": "cluster",
            "value": "dfd2581f-480f-11e8-b253-42010a80003a"
          }
        ],
        "counts": [
          {
            "key": "namespace",
            "value": 7
          },
          {
            "key": "service",
            "value": 3
          }
        ]
      },
      {
        "group": [
          {
            "key": "cluster",
            "value": "8970c8f4-e7cd-46c2-b9e2-efa8e922fdeb "
          }
        ],
        "counts": [
          {
            "key": "namespace",
            "value": 6
          },
          {
            "key": "service",
            "value": 12
          }
        ]
      }
    ]
  }
}