Namespace:Get Namespace

Search (SHIFT+S)

Get Namespace

GET /object/namespaces/namespace/{id}

Gets the details for the given namespace.

id	Namespace identifier for which details needs to be retrieved.

Required Roles

Requires one of the following roles:

SYSTEM_ADMIN
SYSTEM_MONITOR
NAMESPACE_ADMIN

Response Body

Namespace details

Field	Description	Type	Notes
namespace
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

Examples

Request

GET https://192.168.0.0:4443/object/namespaces/namespace/s3 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"?>
<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>

Request

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

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

Response

HTTP/1.1 200 OK
Content-Type: application/json
{  
   "name":"s3",
   "id":"s3",
   "link":{  
      "rel":"self",
      "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
}