.. _GetCredentials: GetCredentials ============== List registered remote origins without exposing keys. Requires ``objects.read`` permission. No input or output blobs are used. Parameters ---------- * ``origins`` (array of strings, optional): restrict the result to these origins. Omit to list all; an empty array selects none. Behavior -------- Unknown origins are omitted. Results list registered origins without returning keys or tokens. Use the list to check which origins are registered, and :doc:`UpdateCredential` to replace a key. Response -------- Success returns ``status: 0``, ``origins`` (an array, empty when none match), and ``returned`` (its length). Failures return a negative ``status`` and an ``info`` message; see :doc:`../Responses` for error envelopes and retry guidance. Examples -------- .. TESTED_EXAMPLE: GetCredentials_1 .. code-block:: json [{ "GetCredentials": { "origins": ["s3://training-images"] } }] Response: .. TESTED_EXAMPLE: GetCredentials_1_response .. code-block:: json [{ "GetCredentials": { "status": 0, "origins": ["s3://training-images"], "returned": 1 } }]