| Copyright | (c) 2013-2021 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | None |
Amazonka.APIGateway.Types.PatchOperation
Description
Synopsis
Documentation
data PatchOperation Source #
A single patch operation to apply to the specified resource. Please refer to http://tools.ietf.org/html/rfc6902#section-4 for an explanation of how each operation is used.
See: newPatchOperation smart constructor.
Constructors
| PatchOperation' | |
Fields
| |
Instances
newPatchOperation :: PatchOperation Source #
Create a value of PatchOperation with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:op:PatchOperation', patchOperation_op - An update operation to be performed with this PATCH request. The valid
value can be add, remove, replace or copy. Not all valid
operations are supported for a given resource. Support of the operations
depends on specific operational contexts. Attempts to apply an
unsupported operation on a resource will return an error message.
$sel:path:PatchOperation', patchOperation_path - The op operation's target, as identified by a
JSON Pointer
value that references a location within the targeted resource. For
example, if the target resource has an updateable property of
{"name":"value"}, the path for this property is /name. If the
name property value is a JSON object (e.g.,
{"name": {"child/name": "child-value"}}), the path for the
child/name property will be /name/child~1name. Any slash ("/")
character appearing in path names must be escaped with "~1", as shown
in the example above. Each op operation can have only one path
associated with it.
$sel:value:PatchOperation', patchOperation_value - The new target value of the update operation. It is applicable for the
add or replace operation. When using AWS CLI to update a property of
a JSON value, enclose the JSON object with a pair of single quotes in a
Linux shell, e.g., '{"a": ...}'. In a Windows shell, see
Using JSON for Parameters.
$sel:from:PatchOperation', patchOperation_from - The copy update operation's source as identified by a JSON-Pointer
value referencing the location within the targeted resource to copy the
value from. For example, to promote a canary deployment, you copy the
canary deployment ID to the affiliated deployment ID by calling a PATCH
request on a Stage resource with "op":"copy",
"from":"/canarySettings/deploymentId" and
"path":"/deploymentId".
patchOperation_op :: Lens' PatchOperation (Maybe Op) Source #
An update operation to be performed with this PATCH request. The valid
value can be add, remove, replace or copy. Not all valid
operations are supported for a given resource. Support of the operations
depends on specific operational contexts. Attempts to apply an
unsupported operation on a resource will return an error message.
patchOperation_path :: Lens' PatchOperation (Maybe Text) Source #
The op operation's target, as identified by a
JSON Pointer
value that references a location within the targeted resource. For
example, if the target resource has an updateable property of
{"name":"value"}, the path for this property is /name. If the
name property value is a JSON object (e.g.,
{"name": {"child/name": "child-value"}}), the path for the
child/name property will be /name/child~1name. Any slash ("/")
character appearing in path names must be escaped with "~1", as shown
in the example above. Each op operation can have only one path
associated with it.
patchOperation_value :: Lens' PatchOperation (Maybe Text) Source #
The new target value of the update operation. It is applicable for the
add or replace operation. When using AWS CLI to update a property of
a JSON value, enclose the JSON object with a pair of single quotes in a
Linux shell, e.g., '{"a": ...}'. In a Windows shell, see
Using JSON for Parameters.
patchOperation_from :: Lens' PatchOperation (Maybe Text) Source #
The copy update operation's source as identified by a JSON-Pointer
value referencing the location within the targeted resource to copy the
value from. For example, to promote a canary deployment, you copy the
canary deployment ID to the affiliated deployment ID by calling a PATCH
request on a Stage resource with "op":"copy",
"from":"/canarySettings/deploymentId" and
"path":"/deploymentId".