Skip to main content

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 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 Responses for error envelopes and retry guidance.

Examples​

[{
    "GetCredentials": {
        "origins": ["s3://training-images"]
    }
}]

Response:

[{
    "GetCredentials": {
        "status": 0,
        "origins": ["s3://training-images"],
        "returned": 1
    }
}]