Lexicon Garden

at.happyproto.server.stopInstance

Stop one of the caller's instances, and start a job that follows the stop. Customers only.

Repository @happyproto.at did:plc:mo7vq4jbioxwafy5zkcc3eux namespace authority
Details · procedure
Kindprocedure
Authorityserver.happyproto.at
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

id

requiredstring

The instance's UUID.

idempotencyKey

requiredstring

A UUID the client generates once per intended change and resends on every retry of it, so a retry gets the original reply instead of acting twice.

Output

application/json

jobId

requiredstring

The background job following the change. Poll it with at.happyproto.server.getJob.

Errors

AuthRequired

This endpoint requires an authenticated caller.

Forbidden

The caller is not a HappyProto customer, or the provisioner refused them.

InvalidRequest

id or idempotencyKey is missing or not a UUID.

NotFound

No such instance, or it is not the caller's. The two are indistinguishable.

InvalidSlug

Passed through from the provisioner: it reserves slugs by configuration as well.

SlugTaken

Passed through from the provisioner.

NotEntitled

Passed through from the provisioner.

InstanceLimit

Passed through from the provisioner.

NoCapacity

Passed through from the provisioner.

OperationInProgress

Passed through from the provisioner: the instance is already changing, or a request with this idempotencyKey is still running.

Upstream

The provisioner is unreachable, not configured, or answered with an error it does not explain to callers, or the job could not be started.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • at.happyproto.server.deleteInstance

    procedure

    Delete one of the caller's instances, and start a job that follows the deletion. Customers only.

  • at.happyproto.server.startInstance

    procedure

    Start one of the caller's instances, and start a job that follows the start. Customers only.

  • at.happyproto.server.updateInstance

    procedure

    Move one of the caller's instances to another plan or HappyView release, and start a job that follows the change. Customers only.

  • at.happyproto.server.upgradeInstance

    procedure

    Upgrade one of the caller's instances to the newer HappyView release its availableVersion offers, and start a job that follows the upgrade. The instance is offline for about 30 seconds; its database is snapshotted first, and a release that does not come up healthy is rolled back. Customers only.

  • at.happyproto.server.removeDomain

    procedure

    Remove a custom domain from one of the caller's instances. HappyProto stops serving it. Customers only.