Skip to main content

RemoveCredential

Remove the credential registered for an origin.

Requires objects.delete permission. No input or output blobs are used.

Parameters​

  • origin (string, required): the existing origin.

Behavior​

The origin must exist. Removal commits or rolls back with the query and does not delete remote objects or their database records. Later media reads from the origin fail until a credential is registered again; requests already underway may still finish. See Remote credentials for timing in a cluster.

Response​

Success returns status: 0. Failures return a negative status and an info message; see Responses for error envelopes and retry guidance.

Examples​

[{
    "RemoveCredential": {
        "origin": "s3://training-images"
    }
}]

Response:

[{
    "RemoveCredential": {
        "status": 0
    }
}]