New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Unclear documentation for Restoring Object from Glacier #246
Comments
Actually, please change this to a Bug. Adding val restoreRequest = RestoreRequest.builder()
.days(retrievalDuration)
.glacierJobParameters(GlacierJobParameters.builder().tier(retrievalTier).build())
.description("PV Restore Request") // <-- this will throw XML exception
.build()
val restoreObjectRequest = RestoreObjectRequest.builder()
.bucket(bucket)
.key(key)
.restoreRequest(restoreRequest)
.build() here's the printed variable from debugger:
|
|
Just checked, the internal ticket is still open in the Glacier team's backlog. For visibility to other SDKs, I'm moving this to the |
Correct, I am also facing this issue. Any possible solutions to set description in a RestoreRequest would be helpful. |
Documentation is sorely lacking for
restoreObject()
. There are multiple issues here.Describe the issue
Issue aws/aws-sdk-java-v2#1: - There is a strongly typed
Tier.SELECT
but not "restore an archive" is not? I don't want to do a SELECT just a regular object retrieval. "Restore an Object" appears to be it's own method. Maybe these need to be separated?Issue aws/aws-sdk-java-v2#2: Documentation is unclear wether you specify
Tier
in theGlacierJobParameters
orRestoreRequest
. It turns out it needs to be in theGlacierJobParameters
but why is it even an option inRestoreRequest
?If you don't provide the correct format you can a super unhelpful error:
software.amazon.awssdk.services.s3.model.S3Exception: The XML you provided was not well-formed or did not validate against our published schema (Service: S3, Status Code: 400
Issue aws/aws-sdk-java-v2#3: The builders are not doing any sort of validation to provide helpful warnings. For instance. I can specify output location and get no warning that applies to SELECT only.
The only example I could find is for Version 1 SDK. So I lot a lot of time trying to figure out what I was doing wrong. I'm not sure but it could have even been I wasn't using valid IAM permissions. Still same XML error.
Links
https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
The text was updated successfully, but these errors were encountered: