Listing accessible namespaces

You use the HTTP GET method to list the namespaces you can access. The list contains the namespaces owned by the specified tenant and for which you have any permissions.

Request headers

GET /proc HTTP/1.1

Response headers

This operation does not return any request-specific response headers.

Response body

If the user doesn’t have permissions for any of the tenant's namespaces, the namespaces element is empty.

ElementAttributeDescription
namespacestenantHostNameDomain and subdomain of the tenant host.
namespaceshttpSchemeType of http connection to the tenant. Either http or https.
namespacenameName of the namespace
namespacenameIDNAURL of the namespace
namespaceversioningEnabledBoolean. Specifies if versioning is enabled for the namespace.
namespacesearchEnabledBoolean. Specifies if search is enabled for the namespace.
namespaceretentionModeSpecifies the retention mode for the namespace. Values are either compliance or enterprise.
namespacedefaultShredValueBoolean. Specifies whether or not the objects in the namespace are shredded after deletion.
namespacedefaultIndexValueBoolean. Specifies whether or not the objects in the namespace are indexed.
namespacedefaultRetentionValueSpecifies the retention value for the namespace.
namespacehashSchemeSpecifies the hash algorithm of the namespace.
namespacedplSpecifies the data protection level of the namespace.
namespacedescriptionProvides the description of the namespace.

Return codes

This operation does not have any request-specific return codes.

Example: Listing accessible namespaces

Here’s a sample HTTP GET request that returns information about the namespaces that are owned by the europe tenant in the hcp.example.com system and that can be accessed by the user identified by the Authorization header.

Request with curl command line

curl -k -H "Authorization: HCP bXl1c2Vy:3f3c6784e97531774380db177774ac8d"
    "https://finance.europe.hcp.example.com/proc"

Request in Python using PycURL

import pycurl
curl = pycurl.Curl()
curl.setopt(pycurl.HTTPHEADER, ["Authorization: HCP
  bXl1c2Vy:3f3c6784e97531774380db177774ac8d"])
curl.setopt(pycurl.URL,
  "https://finance.europe.hcp.example.com/proc")
curl.setopt(pycurl.SSL_VERIFYPEER, 0)
curl.setopt(pycurl.SSL_VERIFYHOST, 0)
curl.perform()
print curl.getinfo(pycurl.RESPONSE_CODE)
curl.close()

Request headers

GET /proc HTTP/1.1
Host: /finance.europe.hcp.example.com
Authorization: HCP bXl1c2Vy:3f3c6784e97531774380db177774ac8d

Response headers

HTTP/1.1 200 OK
X-HCP-Time: 1334326410
Content-Length: 1275

Response body

<namespaces xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="/static/xsd/proc-namespaces.xsd"
    tenantHostName="europe.hcp.example.com"
    httpScheme="https">
    <namespace name="finance"
         nameIDNA="finance"
         versioningEnabled="true"
         searchEnabled="true"
         retentionMode="enterprise"
         defaultShredValue="false"
         defaultIndexValue="true"
         defaultRetentionValue="0"
         hashScheme="SHA-256"
         dpl="2"
         >
        <description><![CDATA[
             Finance department
        ]]></description>
    </namespace>
    <namespace name="support"
         nameIDNA="support"
         versioningEnabled="true"
         searchEnabled="true"
        retentionMode="enterprise"
         defaultShredValue="false"
         defaultIndexValue="true"
         defaultRetentionValue="0"
         hashScheme="SHA-256"
         dpl="2"
         >
        <description><![CDATA[
             Technical Support department
        ]]></description>
    </namespace>
</namespaces>