A new platform for documentation and tutorials is launching soon.

We are migrating Vault documentation into HashiCorp Developer, our new developer experience.

Join Now
Type '/' to Search

»/sys/config/control-group

Enterprise Only – These endpoints require Vault Enterprise.

The /sys/config/control-group endpoint is used to configure Control Group settings.

»Read Control Group Settings

This endpoint returns the current Control Group configuration.

MethodPath
GET/sys/config/control-group

»Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    http://127.0.0.1:8200/v1/sys/config/control-group

$ curl \
    --header "X-Vault-Token: ..." \
    http://127.0.0.1:8200/v1/sys/config/control-group

»Sample Response

{
  "max_ttl": "4h"
}

{
  "max_ttl": "4h"
}

»Configure Control Group Settings

This endpoint allows configuring control groups.

MethodPath
POST/sys/config/control-group

»Parameters

  • max_ttl int – The maximum ttl for a control group wrapping token. This can be provided in seconds or duration (2h).

»Sample Payload

{
  "max_ttl": "4h"
}

{
  "max_ttl": "4h"
}

»Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    --request POST \
    --data @payload.json \
    http://127.0.0.1:8200/v1/sys/config/control-group

$ curl \
    --header "X-Vault-Token: ..." \
    --request POST \
    --data @payload.json \
    http://127.0.0.1:8200/v1/sys/config/control-group

»Delete Control Group Settings

This endpoint removes any control group configuration.

MethodPath
DELETE/sys/config/control-group

»Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    --request DELETE \
    http://127.0.0.1:8200/v1/sys/config/control-group

$ curl \
    --header "X-Vault-Token: ..." \
    --request DELETE \
    http://127.0.0.1:8200/v1/sys/config/control-group