objects¶
drpcli store_objects¶
Access raw DRP data store_objects from the backing data store
Synopsis¶
Provides direct access to raw objects in the DRP backing data store.
store_objects represent the low-level persistent storage layer of DRP,
exposing objects from the underlying key-value store. This is primarily useful
for advanced inspection, debugging, and internal tooling.
Warning: Modifying store objects directly can corrupt DRP state. Use the
dedicated resource commands (machines, bootenvs, etc.) for normal operations.
Common operations:
drpcli store_objects list- list all objects in the backing storedrpcli store_objects show <key>- retrieve a specific store object by keydrpcli store_objects create <json>- create a new raw store objectdrpcli store_objects update <key> <json>- update an existing store objectdrpcli store_objects destroy <key>- remove an object from the store
Examples¶
# List all objects in the backing store
drpcli store_objects list
# Show a specific store object by key
drpcli store_objects show my-object-key
# Create a store object from JSON
drpcli store_objects create - < object.json
# Update a store object
drpcli store_objects update my-object-key '{"Field":"value"}'
# Destroy a store object
drpcli store_objects destroy my-object-key
Options¶
Options inherited from parent commands¶
--ca-cert string CA certificate used to verify the server certs (with the system set)
-c, --catalog string The catalog file to use to get product information (default "https://repo.rackn.io")
--catalog-path string The path to where the catalog file exists on the drp server. By default and historically this has been /files/rebar-catalog. For example, if no catalog urls are provided, the complete path will be https://drp-ip:8090/files/rebar-catalog (default "/files/rebar-catalog")
-S, --catalog-source string A location from which catalog items can be downloaded. For example, in airgapped mode it would be the local catalog
--client-cert string Client certificate to use for communicating to the server - replaces RS_KEY, RS_TOKEN, RS_USERNAME, RS_PASSWORD
--client-key string Client key to use for communicating to the server - replaces RS_KEY, RS_TOKEN, RS_USERNAME, RS_PASSWORD
-C, --colors string The colors for JSON and Table/Text colorization. 8 values in the for 0=val,val;1=val,val2... (default "0=32;1=33;2=36;3=90;4=34,1;5=35;6=95;7=32;8=92")
-d, --debug Whether the CLI should run in debug mode
-D, --download-proxy string HTTP Proxy to use for downloading catalog and content
-E, --endpoint string The Digital Rebar Provision API endpoint to talk to (default "https://127.0.0.1:8092")
-X, --exit-early Cause drpcli to exit if a command results in an object that has errors
--fetch-catalogs all Determines which catalog urls to use to fetch the catalog. If set to all, all the catalog urls defined with catalog_url and catalog_urls as well as the default catalog will be used. If set to server, only the catalog urls defined on the server will be used. If set to cli, then the specific url specified with the -c flag will be used. It defaults to `all`. Allowed values `all, `server`, `cli`. (default "all")
-f, --force When needed, attempt to force the operation - used on some update/patch calls
--force-new-session Should the client always create a new session
-F, --format string The serialization we expect for output. Can be "json" or "yaml" or "text" or "table" (default "json")
--http-request-retry-count int Specifies the number of retries for downloads in case of failure
--http-request-retry-delay-max int Specifies the maximum delay (in seconds) between HTTP/HTTPS retry attempts (default 60)
--ignore-unix-proxy Should the client ignore unix proxies
-N, --no-color Whether the CLI should output colorized strings
-H, --no-header Should header be shown in "text" or "table" mode
-x, --no-token Do not use token auth or token cache
-P, --password string password of the Digital Rebar Provision user (default "r0cketsk8ts")
-p, --platform string Platform to filter details by. Defaults to current system. Format: arch/os
-J, --print-fields string The fields of the object to display in "text" or "table" mode. Comma separated
-r, --ref string A reference object for update commands that can be a file name, yaml, or json blob
--server-verify Should the client verify the server cert
-G, --show-global-help-flags Show global flags in help message
-T, --token string token of the Digital Rebar Provision access
-t, --trace string The log level API requests should be logged at on the server side
-Z, --trace-token string A token that individual traced requests should report in the server logs
-j, --truncate-length int Truncate columns at this length (default 40)
-u, --url-proxy string URL Proxy for passing actions through another DRP
-U, --username string Name of the Digital Rebar Provision user to talk to (default "rocketskates")
SEE ALSO¶
- drpcli - A CLI application for interacting with the DigitalRebar Provision API
- drpcli store_objects action - Show details for a specific action on the store_object
- drpcli store_objects actions - List all available actions for the store_object
- drpcli store_objects await - Wait for a store_object's field to become a value within a number of seconds
- drpcli store_objects count - Count all store_objects
- drpcli store_objects create - Create a new store_object with the passed-in JSON or string key
- drpcli store_objects destroy - Destroy store_object by id
- drpcli store_objects etag - Get the etag for a store_objects by id
- drpcli store_objects exists - See if a store_objects exists by id
- drpcli store_objects fieldinfo - Return the documentation for all the fields or the provided field
- drpcli store_objects generate - Generate an object of store_objects type in the content directory
- drpcli store_objects indexes - Get indexes for store_objects
- drpcli store_objects list - List all store_objects
- drpcli store_objects meta - Get all metadata key/value pairs for a store_object
- drpcli store_objects patch - Patch store_object by ID using the passed-in JSON Patch
- drpcli store_objects runaction - Run a plugin action on a store_object
- drpcli store_objects show - Show a single store_objects by id
- drpcli store_objects update - Unsafely update store_object by id with the passed-in JSON
- drpcli store_objects wait - Wait for a store_object's field to become a value within a number of seconds