Storage name rules

Storage name rules can be used to enforce a specific naming scheme for files created on a specific storage.

Working with storage name rules

List all storage name rules applied on a shape

GET /item/(item-id)/shape/(shape-id)/filename

Retrieves a list of URIs to all storage name rules that are contained within a shape.

Produces:
  • application/xml, application/jsonURIListDocument
  • text/plain – CRLF-delimited list of URIs
Role:

_storage_rule_read

Create a new storage name rule

PUT /item/(item-id)/shape/(shape-id)/filename/(storage-id)

Creates a new storage name rule that attempts enforce the filename on a certain storage. This operation does not rename the file, it merely creates a rule for it. The file will then be renamed at a later time, if the file is located on that storage.

Query Parameters:
  • filename (string) – Required. The desired filename of the file.
Status Codes:
  • 200 OK – Rule added successfully.
  • 400 Bad request – A conflicting rule exists.
Role:

_storage_rule_write

Delete a storage name rule

DELETE /item/(item-id)/shape/(shape-id)/filename/(storage-id)

Deletes a storage name rule that matches the (item id, shape id, storage id, filename) quadruple. Note that this does not change any existing filenames a file might have.

Query Parameters:
  • filename (string) – Required. The filename of the rule.
Status Codes:
  • 200 OK – Rule removed successfully.
Role:

_storage_rule_write