Accessing Inaccessible Objects with CID

A domain, bucket, or named object is accessible by ID using a Context Identifier (CID) query argument if it is inaccessible by name. The CID query argument syntax is: cid=

This troubleshooting process is helpful when:

Note

This procedure allows access to the object but not to recover it. To recover accidentally deleted domains and buckets, see Restoring Domains and Buckets.

The value of the object's Castor-System-CID header identifying the object's parent is needed to execute a cid= query argument. Locate the value of the Castor-System-CID header if an object named photo1.jpg is not accessible. 

This information can be located in one of two ways if it was not recorded or stored:

  • Review the debug-level system logs. These logs record the Castor-System-CID value every time you access the object.

  • Use the Content Router Enumerator. (Swarm 7.2 or prior only) This tool iterates through all objects in a cluster and returns information about each object. 
    To implement this tool:

    1. Add a Content Router filter rule to search for objects where the value of the CastorSystem-Name header is the name of the inaccessible object.

    2. Instantiate a metadata enumerator subscribed to the rule channel you created in the preceding bullet to obtain the object's metadata using the SDK.

    3. Look for the value of the Castor-System-CID header in the metadata returned for the object.

See the Enumerator setup in the https://perifery.atlassian.net/wiki/spaces/DOCS/pages/2443822872.

Access the object using the cid=CID-header-value query argument after locating the value of the object's Castor-System-CID header. Enter the following URL in the browser's address or location field to access a named object using a web browser: 

http://node-ip/object-name?cid=CID-header-value

Enter the following to access an object named file.html with a CID of 55aba17ad53c61782d7dd0afa8dd2f7d

http://node-ip/file.html?cid=55aba17ad53c61782d7dd0afa8dd2f7d



© DataCore Software Corporation. · https://www.datacore.com · All rights reserved.