Skip to content

Commit 1c5ffa6

Browse files
authored
Update aws.md with errors (#2226)
added couple more error messages #### Reference Issues/PRs <!--Example: Fixes #1234. See also #3456.--> #### What does this implement or fix? #### Any other comments? #### Checklist <details> <summary> Checklist for code changes... </summary> - [ ] Have you updated the relevant docstrings, documentation and copyright notice? - [ ] Is this contribution tested against [all ArcticDB's features](../docs/mkdocs/docs/technical/contributing.md)? - [ ] Do all exceptions introduced raise appropriate [error messages](https://docs.arcticdb.io/error_messages/)? - [ ] Are API changes highlighted in the PR description? - [ ] Is the PR labelled as enhancement or bug so it appears in autogenerated release notes? </details> <!-- Thanks for contributing a Pull Request to ArcticDB! Please ensure you have taken a look at: - ArcticDB's Code of Conduct: https://github.com/man-group/ArcticDB/blob/master/CODE_OF_CONDUCT.md - ArcticDB's Contribution Licensing: https://github.com/man-group/ArcticDB/blob/master/docs/mkdocs/docs/technical/contributing.md#contribution-licensing -->
1 parent 7f6f44c commit 1c5ffa6

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

docs/mkdocs/docs/aws.md

+14-1
Original file line numberDiff line numberDiff line change
@@ -110,8 +110,21 @@ Use the configuration in ArcticDB:
110110
>>> arctic = adb.Arctic('s3://s3.REGION.amazonaws.com:BUCKET?aws_auth=sts&aws_profile=PROFILE')
111111
```
112112

113+
## Common Errors When Working with STS
114+
113115
Due to limitations in the AWS C++ SDK, if ArcticDB fails to obtain the temporary token by assuming a role, an assertion error similar to the one below will occur:
114116
```
115117
virtual void Aws::Auth::STSProfileCredentialsProvider::Reload(): Assertion `!profileIt->second.GetCredentials().IsEmpty()' failed.
116118
```
117-
This is usually due to an incorrect IAM account setup or an incorrect configuration file.
119+
This is usually due to an incorrect IAM account setup or an incorrect configuration file.
120+
121+
```
122+
arcticdb_ext.exceptions.PermissionException: E_PERMISSION Permission error: S3Error#15 AccessDenied: Access Denied for object '_arctic_cfg/cref/'
123+
```
124+
This error suggests problems with configuration file. Check Role Arn and base source profile in the file.
125+
126+
127+
```
128+
arcticdb_ext.exceptions.StorageException: E_S3_RETRYABLE Retry-able error: S3Error#99 : Encountered network error when sending http request for object '_arctic_cfg/cref/'
129+
```
130+
A loss of network connectivity could trigger such an error. Note, that this error will appear after several attempts to re-establish the connection

0 commit comments

Comments
 (0)