import type * as cloudcontrol from "@distilled.cloud/aws/cloudcontrol";
import * as Binding from "alchemy/Binding";
import type * as Effect from "effect/Effect";
import type { CloudControlBindingOptions } from "./BindingOptions.ts";
/**
* Runtime binding for `cloudformation:UpdateResource`.
*
* Applies an RFC 6902 JSON Patch to an existing resource's properties. The
* call is asynchronous: poll the returned `RequestToken` with
* {@link GetResourceRequestStatus} until the operation settles. Because Cloud
* Control invokes the resource type's update handler with the caller's
* credentials, pass the handler's underlying permissions via
* {@link CloudControlBindingOptions.handlerPolicyStatements}.
* ### Provisioning Resources
* **Example:** Patch an SSM Parameter's value
* ```typescript
* const updateResource = yield* CloudControl.UpdateResource({
* handlerPolicyStatements: [
* {
* Effect: "Allow",
* Action: ["ssm:PutParameter", "ssm:GetParameters"],
* Resource: ["*"],
* },
* ],
* });
*
* // runtime
* const updated = yield* updateResource({
* TypeName: "AWS::SSM::Parameter",
* Identifier: "/tenants/acme/greeting",
* PatchDocument: JSON.stringify([
* { op: "replace", path: "/Value", value: "howdy" },
* ]),
* });
* ```
*
* @binding
*/
export interface UpdateResource extends Binding.Service<
UpdateResource,
"AWS.CloudControl.UpdateResource",
(
options?: CloudControlBindingOptions,
) => Effect.Effect<
(
request: cloudcontrol.UpdateResourceInput,
) => Effect.Effect<cloudcontrol.UpdateResourceOutput, cloudcontrol.UpdateResourceError>
>
> {}
export const UpdateResource = Binding.Service<UpdateResource>("AWS.CloudControl.UpdateResource");