Namespace:Get Namespaces

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

Get Namespaces

GET /object/namespaces

Gets the list of all configured namespaces.

Query Parameters

limit	Number of objects requested in current fetch.
marker	Reference to last object returned.
name	Case sensitive prefix of the Namespace name with a wild card() Ex : any_prefix_string

Required Roles

Requires one of the following roles:

SYSTEM_ADMIN
SYSTEM_MONITOR

Response Body

List of all configured namespaces

Field	Description	Type	Notes
namespaces
namespace			0-* Elements
default_data_services_vpool	Default replication group identifier for this tenant when creating buckets	URI
allowed_vpools_list	List of replication group that are allowed access to namespace	URI	0-* Elements
disallowed_vpools_list	List of replication group that are not allowed access to namespace	URI	0-* Elements
namespace_admins	Comma separated list of namespace admins	String
is_encryption_enabled	encryption status of the namesapce	String
user_mapping			0-* Elements
domain	A single-valued attribute indicating the user's IDP domain	String	Valid Values: Examples: "emc.com" or "netapp.com"
attributes
attribute			0-* Elements
key	Lookup string for this key-value pair	String
value	Lookup result for this key-value pair	String	0-* Elements
groups
group		String	0-* Elements
default_bucket_block_size	Default bucket quota size.	Long
external_group_admins	List of groups from AD Server	String
is_stale_allowed	Namespace isStaleAllowed flag	Boolean
is_compliance_enabled	Namespace isComplianceEnabled flag	Boolean
notificationSize	Notification Size in GB.	Long
blockSize	Blocksize in GB	Long
retention_classes
retention_class			0-* Elements
name	Name of the retention class	String
period	Period of the retention class in seconds	Long
default_audit_delete_expiration	Default bucket audit delete expiration	Long
root_user_name		String
root_user_password		String
name	Name assigned to this resource in ECS. The resource name is set by a user and can be changed at any time. It is not a unique identifier.	String
id	Identifier that is generated by ECS when the resource is created. The resource Id is guaranteed to be unique and immutable across all virtual data centers for all time.	URI	Valid Values: urn:storageos:resource-type:UUID:
link	Hyperlink to the details for this resource
creation_time	Timestamp that shows when this resource was created in ECS	DateTime	Valid Values: YYYY-MM-DDTHH:mm:ssZ Unix timestamp
inactive	Indicates whether the resource is inactive. When a user removes a resource, the resource is put in this state before it is removed from the ECS database.	Boolean	Valid Values: true false
global	Indicates whether the resource is global.	Boolean	Valid Values: true false
remote	Indicates whether the resource is remote.	Boolean	Valid Values: true false
vdc
id	ECS Id of the related object	URI
link	Hyperlink to the related object
internal	Indicated whether the resource is an internal resource	Boolean	Valid Values: true false
MaxNamespaces	Number of Namespaces requested.	Integer
NextMarker	Reference object to retrieve next set of objects.	String
Filter	filter used to get the objects.	String
NextPageLink	link to get the next page.	String

Examples

Request

GET https://192.168.0.0:4443/object/namespaces HTTP/1.1

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP/1.1 200 OK 
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<namespaces>
  <namespace>
    <id>s3</id>
    <inactive>false</inactive>
    <link rel="self" href="/object/namespaces/namespace/s3"/>
    <name>s3</name>
    <default_bucket_block_size>-1</default_bucket_block_size>
    <is_compliance_enabled>false</is_compliance_enabled>
    <is_encryption_enabled>false</is_encryption_enabled>
    <is_stale_allowed>false</is_stale_allowed>
    <default_data_services_vpool>urn:storageos:ReplicationGroupInfo:4644a1d1-a299-4f37-b0de-84d637312665:global</default_data_services_vpool>
    <blockSize>-1</blockSize>
    <notificationSize>-1</notificationSize>
  </namespace>
</namespaces>

Request

GET https://192.168.0.0:4443/object/namespaces.json HTTP/1.1

Content-Type: application/json
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP/1.1 200 OK
Content-Type: application/json 

{
   "namespace" : [
      "name":"s3",
      "id":"s3",
      {
         "link" : {
            "rel" : "self",
            "href" : "href":"/object/namespaces/namespace/s3"
         },
      "inactive":false,
      "global":null,
      "remote":null,
      "vdc":null,
      "default_data_services_vpool":"urn:storageos:ReplicationGroupInfo:4644a1d1-a299-4f37-b0de-84d637312665:global",
      "allowed_vpools_list": [
           "urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76b:global"
      ],
      "disallowed_vpools_list":[],
      "user_mapping":[],
      "is_encryption_enabled":"false",
      "default_bucket_block_size":-1,
      "is_stale_allowed":false,
      "is_compliance_enabled":false,
      "blockSize": -1,
      "notificationSize": -1
      }
   ]
}