---
title: "Update Roll"
method: PUT
path: "/ocean/aws/k8s/cluster/{oceanClusterId}/roll/{ROLL_ID}"
tags: ["Ocean AWS"]
---

# Update Roll

`PUT /ocean/aws/k8s/cluster/{oceanClusterId}/roll/{ROLL_ID}`

## Request

- Base URL: `https://api.spotinst.io`
- URL: `https://api.spotinst.io/ocean/aws/k8s/cluster/{oceanClusterId}/roll/{ROLL_ID}`
- Auth: HTTP bearer

Update a roll of an Ocean cluster.

*Performing the request will stop the next batch in a roll.*

## Path parameters

- `oceanClusterId` string, required
- `ROLL_ID` string, required

## Parameters

- `#/paths/~1azure~1costs/get/parameters/0` (unresolved $ref)

## Request body

- object
  - `roll` object, required: Object that specifies the parameters required to initiate a roll (also called a deployment).
    - `status` 'STOPPED', required: Set status of a roll. Valid values: "STOPPED"

## Response `200`

Cluster Roll Response

- object
  - `id` string
  - `scope` 'Cluster' | 'Vngs' | 'Vng' | 'Instances' | 'Instance'
  - `status` 'STOPPED'
  - `currentBatch` integer
  - `numOfBatches` integer
  - `progress` object
    - `unit` string
    - `value` integer
    - `detailedStatus` object
      - `oldInstances` object[]
        - `instanceId` string
        - `status` string
  - `oceanId` string
  - `respectPdb` boolean
  - `batchMinHealthyPercentage` integer
  - `createdAt` string
  - `updatedAt` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/spot/apis/spot-by-flexera-api.md) - [All operations](https://skmtc.dev/spot/apis/spot-by-flexera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spot/apis/spot-by-flexera-api/revisions/f7e206fa6474?raw)