(->ex-info result & {:as extra-ex-data})Returns an [[ex-info]] that represents a failed AWS API response.
Returns an [[ex-info]] that represents a failed AWS API response.
(anomaly? response)Returns true when the response (from cognitect.aws.client.api) indicates an anomalous condition, such as an error.
Returns true when the response (from cognitect.aws.client.api) indicates an anomalous condition, such as an error.
(aws-error-code response)Returns the error code, if present, of an AWS API response.
Returns the error code, if present, of an AWS API response.
(aws-error-message response)Returns the error message, if present, of an AWS API response.
Returns the error message, if present, of an AWS API response.
(b64-decode s)Decodes a base64-encoded string to a byte array.
Decodes a base64-encoded string to a byte array.
(client opts)Returns an AWS client, like [[cognitect.aws.client.api/client]],
but defaults :retriable? to retriable?.
Returns an AWS client, like [[cognitect.aws.client.api/client]], but defaults `:retriable?` to [[retriable?]].
(full-name x)Returns a string representing a symbol or keyword's full name and namespace, if any. If given a string, returns the string unchanged.
Returns a string representing a symbol or keyword's full name and namespace, if any. If given a string, returns the string unchanged.
(invoke! client op-map)Calls the AWS API and returns a response, or throws an [[ex-info]] if the operation fails.
See [cognitect.aws.client.api/invoke].
Calls the AWS API and returns a response, or throws an [[ex-info]] if the operation fails. See [cognitect.aws.client.api/invoke].
(invoke-with-timeout client op-map)(invoke-with-timeout client op-map timeout-msec)Like [[cognitect.aws.client.api/invoke]], but sends the request
again when an attempt takes longer than timeout-msec (default
30000), up to 3 attempts in all. Returns an
:cognitect.anomalies/interrupted anomaly if every attempt times out.
aws-api's HTTP client has no read timeout, so a request on a stalled connection can otherwise hang indefinitely. Only use this for requests that are safe to send more than once, such as reads.
Like [[cognitect.aws.client.api/invoke]], but sends the request again when an attempt takes longer than `timeout-msec` (default 30000), up to 3 attempts in all. Returns an :cognitect.anomalies/interrupted anomaly if every attempt times out. aws-api's HTTP client has no read timeout, so a request on a stalled connection can otherwise hang indefinitely. Only use this for requests that are safe to send more than once, such as reads.
(pages-seq client op-map & [next-token])Returns a lazy-seq of AWS API responses from invoke!.
Lazily throws an [[ex-info]] if an operation fails.
Returns a lazy-seq of AWS API responses from [[invoke!]]. Lazily throws an [[ex-info]] if an operation fails.
(resource type
properties
&
{:keys [creation-policy deletion-policy depends-on metadata
update-policy update-replace-policy]})Returns a map representing a CloudFormation resource definition.
Resource attributes are documented at https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-product-attribute-reference.html
Returns a map representing a CloudFormation resource definition. Resource attributes are documented at https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-product-attribute-reference.html
(retriable? response)Returns true when an AWS API response (from cognitect.aws.client.api) is an anomaly that is safe and useful to retry.
This includes everything [[cognitect.aws.retry/default-retriable?]] retries, plus faults caused by an IOException. aws-api reports all I/O errors as faults, including the common case where a request is sent on a pooled connection that the server already closed. The official AWS SDKs retry these errors.
Also retries requests that AWS rejected because they arrived more than 5 minutes after they were signed, such as after a stalled connection. aws-api signs each retry again.
Returns true when an AWS API response (from cognitect.aws.client.api) is an anomaly that is safe and useful to retry. This includes everything [[cognitect.aws.retry/default-retriable?]] retries, plus faults caused by an IOException. aws-api reports all I/O errors as faults, including the common case where a request is sent on a pooled connection that the server already closed. The official AWS SDKs retry these errors. Also retries requests that AWS rejected because they arrived more than 5 minutes after they were signed, such as after a stalled connection. aws-api signs each retry again.
(tags map-or-xs)Returns a vector representing a list of CloudFormation tag
key-value pairs. If given a map, the map's key-value pairs are
translated to the CloudFormation format. If given a vector or
other sequential type, returns a vector of the unchanged items.
Returns nil if map-or-xs is empty.
(tags {:a "A", :b "B"})
;; => [{:Key "a", :Value "A"} {:Key "b", :Value "B"}]
(tags [{:Key "a", :Value "A"} {:Key "b", :Value "B"}])
;; => [{:Key "a", :Value "A"} {:Key "b", :Value "B"}]
Returns a vector representing a list of CloudFormation tag
key-value pairs. If given a map, the map's key-value pairs are
translated to the CloudFormation format. If given a vector or
other sequential type, returns a vector of the unchanged items.
Returns nil if `map-or-xs` is empty.
```clojure
(tags {:a "A", :b "B"})
;; => [{:Key "a", :Value "A"} {:Key "b", :Value "B"}]
(tags [{:Key "a", :Value "A"} {:Key "b", :Value "B"}])
;; => [{:Key "a", :Value "A"} {:Key "b", :Value "B"}]
```cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |