Update a User's IAM role

PUT /user/{id}

Path parameters

id string(uuid) Required

application/json

Body Required

role object

IAM Role

Additional properties are allowed.
Hide role attributes Show role attributes object
- name string
  
  IAM Role name
  
  Minimum length is 1, maximum length is 255.
- description string
  
  IAM Role description
  
  Minimum length is 1, maximum length is 255.
- permissions array[string]
  
  IAM Role permissions
  
  Value is bypass-governance-retention.
- labels object
  
  Resource labels
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
- editable boolean
  
  IAM Role mutability
- policy object
  
  IAM Role Policy
  
  Additional properties are allowed.
  Hide policy attributes Show policy attributes object
  
  default-service-strategy string Required
  
  IAM default service strategy
  
  Values are allow or deny.
  
  services object Required
  
  IAM services
  
  Hide services attribute Show services attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  Hide * attributes Show * attributes object
  
  type string
  
  Values are rules, allow, or deny.
  
  rules array[object]
  
  Hide rules attributes Show rules attributes object
  
  action string
  
  Values are allow or deny.
  
  expression string
  
  resources array[string]

Responses

200 application/json

200
Hide response attributes Show response attributes object
- id string(uuid)
  
  Operation ID
- reason string
  
  Operation failure reason
  
  Values are incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, or conflict.
- reference object
  
  Related resource reference
  
  Additional properties are allowed.
  
  Hide reference attributes Show reference attributes object
  
  id string(uuid)
  
  Reference ID
  
  link string
  
  Link to the referenced resource
  
  command string
  
  Command name
- message string
  
  Operation message
- state string
  
  Operation status
  
  Values are failure, pending, success, or timeout.

PUT /user/{id}

curl \
 -X PUT https://api-ch-gva-2.exoscale.com/v2/user/{id} \
 -H "Content-Type: application/json" \
 -d '{"role":{"name":"string","description":"string","permissions":["bypass-governance-retention"],"labels":{"additionalProperty1":"string","additionalProperty2":"string"},"editable":true,"policy":{"default-service-strategy":"allow","services":{"additionalProperty1":{"type":"rules","rules":[{"action":"allow","expression":"string","resources":["string"]}]},"additionalProperty2":{"type":"rules","rules":[{"action":"allow","expression":"string","resources":["string"]}]}}}}}'

Request examples

{
  "role": {
    "name": "string",
    "description": "string",
    "permissions": [
      "bypass-governance-retention"
    ],
    "labels": {
      "additionalProperty1": "string",
      "additionalProperty2": "string"
    },
    "editable": true,
    "policy": {
      "default-service-strategy": "allow",
      "services": {
        "additionalProperty1": {
          "type": "rules",
          "rules": [
            {
              "action": "allow",
              "expression": "string",
              "resources": [
                "string"
              ]
            }
          ]
        },
        "additionalProperty2": {
          "type": "rules",
          "rules": [
            {
              "action": "allow",
              "expression": "string",
              "resources": [
                "string"
              ]
            }
          ]
        }
      }
    }
  }
}

Response examples (200)

{
  "id": "string",
  "reason": "incorrect",
  "reference": {
    "id": "string",
    "link": "string",
    "command": "string"
  },
  "message": "string",
  "state": "failure"
}