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 |
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.
PatchOperation' | |
|
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"
.