Update IAM Role

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://openapi-v2.exoscale.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
"Exoscale APIv2 MCP server": {
  "url": "https://openapi-v2.exoscale.com/mcp"
}
Close
PUT /iam-role/{id}

Path parameters

  • id string(uuid) Required
application/json

Body Required

  • description string

    IAM Role description

    Minimum length is 1, maximum length is 255.

  • permissions array[string]

    IAM Role permissions

    Values are bypass-governance-retention or reset-iam-organization-policy.

  • labels object
    Hide labels attribute Show labels attribute object
    • * string Additional properties
  • max-session-ttl integer(int64)

    Maximum TTL requester is allowed to ask for when assuming a role

    Minimum value is 0.

  • assume-role-policy object

    Assume Role Policy

    Hide assume-role-policy attribute Show assume-role-policy attribute object
    • rules array[object]

      IAM Assume Role Policy rules

      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

      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 /iam-role/{id} 
curl \
 --request PUT 'https://api-ch-gva-2.exoscale.com/v2/iam-role/{id}' \
 --header "Content-Type: application/json" \
 --data '{"description":"string","permissions":["bypass-governance-retention"],"labels":{"additionalProperty1":"string","additionalProperty2":"string"},"max-session-ttl":42,"assume-role-policy":{"rules":[{"action":"allow","expression":"string","resources":["string"]}]}}'
Request examples 
{
  "description": "string",
  "permissions": [
    "bypass-governance-retention"
  ],
  "labels": {
    "additionalProperty1": "string",
    "additionalProperty2": "string"
  },
  "max-session-ttl": 42,
  "assume-role-policy": {
    "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"
}