---
title: "PATCH /memberships/{membershipIdentifier}/protectedJobs/{protectedJobIdentifier}"
method: PATCH
path: "/memberships/{membershipIdentifier}/protectedJobs/{protectedJobIdentifier}"
---

# PATCH /memberships/{membershipIdentifier}/protectedJobs/{protectedJobIdentifier}

`PATCH /memberships/{membershipIdentifier}/protectedJobs/{protectedJobIdentifier}`

Updates the processing of a currently running job.

## Path parameters

- `membershipIdentifier` string, required
- `protectedJobIdentifier` string, required

## Request body

- object
  - `targetStatus` 'CANCELLED', required — The target status of a protected job. Used to update the execution status of a currently running job.

## Response `200`

Success

- UpdateProtectedJobOutput
  - `protectedJob` object, required — The protected job output.
    - `id` string, required — The identifier for a protected job instance.
    - `membershipId` string, required — he identifier for the membership.
    - `membershipArn` string, required — The ARN of the membership.
    - `createTime` string, date-time, required — The creation time of the protected job.
    - `jobParameters` object — The job parameters for the protected job.
      - `analysisTemplateArn` string, required — The ARN of the analysis template.
      - `parameters` object — Runtime configuration values passed to the PySpark analysis script. Parameter names and types must match those defined in the analysis template.
    - `status` 'SUBMITTED' | 'STARTED' | 'CANCELLED' | 'CANCELLING' | 'FAILED' | 'SUCCESS', required — The status of the protected job.
    - `resultConfiguration` object — Contains any details needed to write the job results.
      - `outputConfiguration` object, required — The output configuration.
        - `s3` object — If present, the output for a protected job with an `S3` output type.
          - `bucket` string, required — The S3 bucket for job output.
          - `keyPrefix` string — The S3 prefix to unload the protected job results.
        - `member` object — The member output configuration for a protected job.
          - `accountId` string, required — The account ID.
    - `statistics` object — The statistics of the protected job.
      - `totalDurationInMillis` integer — The duration of the protected job, from creation until job completion, in milliseconds.
      - `billedResourceUtilization` object — The billed resource utilization for the protected job.
        - `units` number, double, required — The number of Clean Rooms Processing Unit (CRPU) hours that have been billed.
    - `result` object — The result of the protected job.
      - `output` object, required — The output of the protected job.
        - `s3` object — If present, the output for a protected job with an `S3` output type.
          - `location` string, required — The S3 location for the protected job output.
        - `memberList` ProtectedJobSingleMemberOutput[] — The list of member Amazon Web Services account(s) that received the results of the job.
          - `accountId` string, required — The Amazon Web Services account ID of the member in the collaboration who can receive results from analyses.
    - `error` object — The error from the protected job.
      - `message` string, required — The message for the protected job error.
      - `code` string, required — The error code for the protected job.
    - `computeConfiguration` object — The compute configuration for the protected job.
      - `worker` object — The worker configuration for the compute environment.
        - `type` 'CR.1X' | 'CR.4X', required — The worker compute configuration type.
        - `number` integer, required — The number of workers for a PySpark job.
        - `properties` unknown
    - `jobComputePayerAccountId` string — The account ID of the member that pays for the job compute costs.

## Other responses

- `480` — ConflictException
- `481` — ResourceNotFoundException
- `482` — InternalServerException
- `483` — ValidationException
- `484` — ThrottlingException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/cleanrooms.md) · [All operations](https://skmtc.net/aws/apis/cleanrooms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cleanrooms/versions/17ce59ba806e/schema)