Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Empty Status Operations
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Fanout (Cloud DVR)
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Lock Configuration Operations
- S3 Bucket Object Lock Operations
- S3 Bucket Policy
- S3 Bucket Versioning
- S3 Bucket Versions
- S3 Data Node
- S3 Metadata Key List
- S3 Metadata Key System List
- S3 Metadata Search
- S3 Multi Object Delete
- S3 Object
- S3 Object ACL
- S3 Object Detailed Replication Status Operations
- S3 Object Init Uploads
- S3 Object Legal Hold Operations
- S3 Object Replication Info Operations
- S3 Object Retention Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- S3 Select Operations
- EMC Atmos
- OpenStack Swift
ECS API Changes
Get Cas Gc Buckets
GET /dashboard/zones/localzone/cas
Gets the local VDC CAS GC buckets details
Required Roles
Requires one of the following roles:
SYSTEM_MONITOR
SYSTEM_ADMIN
Response Body
Local VDC CAS GC buckets details
Examples
Request
GET https://192.168.0.0:4443/dashboard/zones/localzone/cas HTTP/1.1 Content-Type: application/json X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"apiChange" : "1",
"title" : "cas List",
"_links" : {
"self" : {
"href" : "/dashboard/zones/localzone/cas"
}
},
"_embedded" : {
"_instances" : [ {
"_links" : {
"self" : {
"href" : "/dashboard/cas/casns.casbucket-d15cba5495ffabb7293b88df8ce93883501c8846785479539b258b943be6c300"
}
},
"id" : "casns.casbucket-d15cba5495ffabb7293b88df8ce93883501c8846785479539b258b943be6c300",
"bucketId" : "casbucket",
"bucketNamespace" : "casns",
"casGcBlobDataDetected" : [ { "t" : "1522076400", "Space" : "2048000" }, { "t" : "1522080000", "Space" : "2048000" } ],
"casGcReflectionObjectsDetected" : [ { "t" : "1522076400", "Count" : "0" }, { "t" : "1522080000", "Count" : "0" } ],
"casGcReflectionDataDetected" : [ { "t" : "1522076400", "Space" : "2314000" }, { "t" : "1522080000", "Space" : "2314000" } ],
"casGcBlobObjectsDetected" : [ { "t" : "1522076400", "Count" : "2000" }, { "t" : "1522080000", "Count" : "2000" } ]
}, {
"_links" : {
"self" : {
"href" : "/dashboard/cas/casns.casbuck2-acc2dc8dfaa0ca7600dedac980743ee8ac3e397cdc789e15928e64e01ef6bb84"
}
},
"id" : "casns.casbuck2-acc2dc8dfaa0ca7600dedac980743ee8ac3e397cdc789e15928e64e01ef6bb84",
"bucketId" : "casbuck2",
"bucketNamespace" : "casns",
"casGcBlobDataDetected" : [ { "t" : "1522076400", "Space" : "2048000" }, { "t" : "1522080000", "Space" : "2048000" } ],
"casGcReflectionObjectsDetected" : [ { "t" : "1522076400", "Count" : "0" }, { "t" : "1522080000", "Count" : "0" } ],
"casGcReflectionDataDetected" : [ { "t" : "1522076400", "Space" : "2314000" }, { "t" : "1522080000", "Space" : "2314000" } ],
"casGcBlobObjectsDetected" : [ { "t" : "1522076400", "Count" : "2000" }, { "t" : "1522080000", "Count" : "2000" } ]
...
}
}],
},
}
ATTRIBUTES DESCRIPTION
======================
a. All Time Stamps are GMT Epoch time in seconds.
b. Numbers can be reported in different formats, including without decimal point (e.g. 23000000), with decimal point
(23000000.0) or exponential (2.3e7)
c. <Attribute>Current: The most recent value of an attribute. The attribute is returned in the form of a single snapshot
{"t":12345678, " 'value tag' ":10} where 'value tag' reports the most recently known value of the attribute
and timestamp 't' reports time for which this value is available. The value tag is the same as used for the original
historical attribute. Units of the reported current value are the same as units of the corresponding historical attribute.
d. <Attribute>Summary: (Historical attributes only) The summary values for a historical attribute which includes
Min (lowest), Max (highest) and Avg (average) values across all snapshots. The attribute is returned in the form of
{"Min": {"t":"12345678", "Percent":10}, "Max": {"t":"23435455", "Percent": "43"}, "Avg": "30.67" }.
The value tag is the same as used for the original historical attribute. Units of the reported current value are the
same as units of the corresponding historical attribute.
e. 'dataType' filter: The client can use this filter to indicate which data needs to be returned in the feed. If not supplied,
both current and historical data will be returned.
dataType=current: return only the Current values, as detailed in Point C.
dataType=historical&startTime=<Time>&endTime=<Time>&interval=<Interval in seconds>: return historical series data
and summary for the period specified. Start and End Times are in Epoch Time in Seconds.
f. 'category' filter: as of ECS 3.2.1, the only category supported for this API (CAS) is
"category=gc_buckets" (garbage collection, by bucket)
this is required in order to see any output
g. Starting from ECS 2.2 a new attribute named "apiChange' is returned. This attribute may be removed in future versions
of the API, and currently always has the value "1".
------------------------------------+-----------+-------------------------------------------------------------------+------------
Attribute |Historical?|Category| Description |Units
------------------------------------+-----------+-------------------------------------------------------------------+------------
title | | | Name of resource |
------------------------------------+-----------+-------------------------------------------------------------------+------------
url.self | | | URL to this resource |
------------------------------------+-----------+-------------------------------------------------------------------+------------
id | |gc_buckets| The ID of the resource in the format: |
| | <namespace>.<bucketId>-<bucketHashId> |
------------------------------------+-----------+-------------------------------------------------------------------+------------
bucketId | |gc_buckets| The bucket ID (bucket name) |
------------------------------------+-----------+-------------------------------------------------------------------+------------
bucketNamespace | |gc_buckets| The namespace that the bucket belongs to. |
| | | NOTE: You can filter by namespace by including the |
| | | special query parameter "namespace=<namespace>". This |
| | | parameter is only available for this (cas) API. |
| | | example: |
| | | GET /.../cas?category=gc_buckets&namespace=casns |
------------------------------------+-----------+-------------------------------------------------------------------+------------
casGcBlobDataDetected |historical |gc_buckets| Total size of Blob swept by CAS GC given bucket |Bytes
------------------------------------+-----------+-------------------------------------------------------------------+------------
casGcReflectionObjectsDetected |historical |gc_buckets| Total number of Blobs swept by CAS GC for given bucket |Count
------------------------------------+-----------+-------------------------------------------------------------------+------------
casGcReflectionDataDetected |historical |gc_buckets| Total size of Reflections swept by CAS GC for given |Bytes
| | | bucket |
------------------------------------+-----------+-------------------------------------------------------------------+------------
casGcBlobObjectsDetected |historical |gc_buckets| Total number of Reflections swept by CAS GC for given |Count
| | | bucket |
------------------------------------+-----------+-------------------------------------------------------------------+------------