mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2024-05-11 05:55:12 +00:00
govendor: Update 5 github.com/aws/aws-sdk-go (#524)
* govendor: Update github.com/golang/protobuf * govendor: Update github.com/gobwas/glob github.com/google/go-github * govendor: Update 3 github.com/robertkrimen/otto * govendor: Update 4 golang.org/x golang.org/x/crypto golang.org/x/net golang.org/x/sys golang.org/x/text golang.org/x/time golang.org/x/crypto * govendor: Update 5 github.com/aws/aws-sdk-go
This commit is contained in:
Tom Limoncelli
committed by
Craig Peterson
Craig Peterson
parent
97934bd87c
commit
746fe9b3bb
6571
vendor/github.com/aws/aws-sdk-go/CHANGELOG.md
generated
vendored
Normal file
6571
vendor/github.com/aws/aws-sdk-go/CHANGELOG.md
generated
vendored
Normal file
File diff suppressed because it is too large
Load Diff
5
vendor/github.com/aws/aws-sdk-go/CHANGELOG_PENDING.md
generated
vendored
Normal file
5
vendor/github.com/aws/aws-sdk-go/CHANGELOG_PENDING.md
generated
vendored
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
### SDK Features
|
||||||
|
|
||||||
|
### SDK Enhancements
|
||||||
|
|
||||||
|
### SDK Bugs
|
||||||
4
vendor/github.com/aws/aws-sdk-go/CODE_OF_CONDUCT.md
generated
vendored
Normal file
4
vendor/github.com/aws/aws-sdk-go/CODE_OF_CONDUCT.md
generated
vendored
Normal file
@ -0,0 +1,4 @@
|
|||||||
|
## Code of Conduct
|
||||||
|
This project has adopted the [Amazon Open Source Code of Conduct](https://aws.github.io/code-of-conduct).
|
||||||
|
For more information see the [Code of Conduct FAQ](https://aws.github.io/code-of-conduct-faq) or contact
|
||||||
|
opensource-codeofconduct@amazon.com with any additional questions or comments.
|
||||||
127
vendor/github.com/aws/aws-sdk-go/CONTRIBUTING.md
generated
vendored
Normal file
127
vendor/github.com/aws/aws-sdk-go/CONTRIBUTING.md
generated
vendored
Normal file
@ -0,0 +1,127 @@
|
|||||||
|
Contributing to the AWS SDK for Go
|
||||||
|
|
||||||
|
We work hard to provide a high-quality and useful SDK, and we greatly value
|
||||||
|
feedback and contributions from our community. Whether it's a bug report,
|
||||||
|
new feature, correction, or additional documentation, we welcome your issues
|
||||||
|
and pull requests. Please read through this document before submitting any
|
||||||
|
issues or pull requests to ensure we have all the necessary information to
|
||||||
|
effectively respond to your bug report or contribution.
|
||||||
|
|
||||||
|
|
||||||
|
## Filing Bug Reports
|
||||||
|
|
||||||
|
You can file bug reports against the SDK on the [GitHub issues][issues] page.
|
||||||
|
|
||||||
|
If you are filing a report for a bug or regression in the SDK, it's extremely
|
||||||
|
helpful to provide as much information as possible when opening the original
|
||||||
|
issue. This helps us reproduce and investigate the possible bug without having
|
||||||
|
to wait for this extra information to be provided. Please read the following
|
||||||
|
guidelines prior to filing a bug report.
|
||||||
|
|
||||||
|
1. Search through existing [issues][] to ensure that your specific issue has
|
||||||
|
not yet been reported. If it is a common issue, it is likely there is
|
||||||
|
already a bug report for your problem.
|
||||||
|
|
||||||
|
2. Ensure that you have tested the latest version of the SDK. Although you
|
||||||
|
may have an issue against an older version of the SDK, we cannot provide
|
||||||
|
bug fixes for old versions. It's also possible that the bug may have been
|
||||||
|
fixed in the latest release.
|
||||||
|
|
||||||
|
3. Provide as much information about your environment, SDK version, and
|
||||||
|
relevant dependencies as possible. For example, let us know what version
|
||||||
|
of Go you are using, which and version of the operating system, and the
|
||||||
|
the environment your code is running in. e.g Container.
|
||||||
|
|
||||||
|
4. Provide a minimal test case that reproduces your issue or any error
|
||||||
|
information you related to your problem. We can provide feedback much
|
||||||
|
more quickly if we know what operations you are calling in the SDK. If
|
||||||
|
you cannot provide a full test case, provide as much code as you can
|
||||||
|
to help us diagnose the problem. Any relevant information should be provided
|
||||||
|
as well, like whether this is a persistent issue, or if it only occurs
|
||||||
|
some of the time.
|
||||||
|
|
||||||
|
|
||||||
|
## Submitting Pull Requests
|
||||||
|
|
||||||
|
We are always happy to receive code and documentation contributions to the SDK.
|
||||||
|
Please be aware of the following notes prior to opening a pull request:
|
||||||
|
|
||||||
|
1. The SDK is released under the [Apache license][license]. Any code you submit
|
||||||
|
will be released under that license. For substantial contributions, we may
|
||||||
|
ask you to sign a [Contributor License Agreement (CLA)][cla].
|
||||||
|
|
||||||
|
2. If you would like to implement support for a significant feature that is not
|
||||||
|
yet available in the SDK, please talk to us beforehand to avoid any
|
||||||
|
duplication of effort.
|
||||||
|
|
||||||
|
3. Wherever possible, pull requests should contain tests as appropriate.
|
||||||
|
Bugfixes should contain tests that exercise the corrected behavior (i.e., the
|
||||||
|
test should fail without the bugfix and pass with it), and new features
|
||||||
|
should be accompanied by tests exercising the feature.
|
||||||
|
|
||||||
|
4. Pull requests that contain failing tests will not be merged until the test
|
||||||
|
failures are addressed. Pull requests that cause a significant drop in the
|
||||||
|
SDK's test coverage percentage are unlikely to be merged until tests have
|
||||||
|
been added.
|
||||||
|
|
||||||
|
5. The JSON files under the SDK's `models` folder are sourced from outside the SDK.
|
||||||
|
Such as `models/apis/ec2/2016-11-15/api.json`. We will not accept pull requests
|
||||||
|
directly on these models. If you discover an issue with the models please
|
||||||
|
create a [GitHub issue][issues] describing the issue.
|
||||||
|
|
||||||
|
### Testing
|
||||||
|
|
||||||
|
To run the tests locally, running the `make unit` command will `go get` the
|
||||||
|
SDK's testing dependencies, and run vet, link and unit tests for the SDK.
|
||||||
|
|
||||||
|
```
|
||||||
|
make unit
|
||||||
|
```
|
||||||
|
|
||||||
|
Standard go testing functionality is supported as well. To test SDK code that
|
||||||
|
is tagged with `codegen` you'll need to set the build tag in the go test
|
||||||
|
command. The `make unit` command will do this automatically.
|
||||||
|
|
||||||
|
```
|
||||||
|
go test -tags codegen ./private/...
|
||||||
|
```
|
||||||
|
|
||||||
|
See the `Makefile` for additional testing tags that can be used in testing.
|
||||||
|
|
||||||
|
To test on multiple platform the SDK includes several DockerFiles under the
|
||||||
|
`awstesting/sandbox` folder, and associated make recipes to execute
|
||||||
|
unit testing within environments configured for specific Go versions.
|
||||||
|
|
||||||
|
```
|
||||||
|
make sandbox-test-go18
|
||||||
|
```
|
||||||
|
|
||||||
|
To run all sandbox environments use the following make recipe
|
||||||
|
|
||||||
|
```
|
||||||
|
# Optionally update the Go tip that will be used during the batch testing
|
||||||
|
make update-aws-golang-tip
|
||||||
|
|
||||||
|
# Run all SDK tests for supported Go versions in sandboxes
|
||||||
|
make sandbox-test
|
||||||
|
```
|
||||||
|
|
||||||
|
In addition the sandbox environment include make recipes for interactive modes
|
||||||
|
so you can run command within the Docker container and context of the SDK.
|
||||||
|
|
||||||
|
```
|
||||||
|
make sandbox-go18
|
||||||
|
```
|
||||||
|
|
||||||
|
### Changelog
|
||||||
|
|
||||||
|
You can see all release changes in the `CHANGELOG.md` file at the root of the
|
||||||
|
repository. The release notes added to this file will contain service client
|
||||||
|
updates, and major SDK changes.
|
||||||
|
|
||||||
|
[issues]: https://github.com/aws/aws-sdk-go/issues
|
||||||
|
[pr]: https://github.com/aws/aws-sdk-go/pulls
|
||||||
|
[license]: http://aws.amazon.com/apache2.0/
|
||||||
|
[cla]: http://en.wikipedia.org/wiki/Contributor_License_Agreement
|
||||||
|
[releasenotes]: https://github.com/aws/aws-sdk-go/releases
|
||||||
|
|
||||||
16
vendor/github.com/aws/aws-sdk-go/Gopkg.lock
generated
vendored
Normal file
16
vendor/github.com/aws/aws-sdk-go/Gopkg.lock
generated
vendored
Normal file
@ -0,0 +1,16 @@
|
|||||||
|
# This file is autogenerated, do not edit; changes may be undone by the next 'dep ensure'.
|
||||||
|
|
||||||
|
|
||||||
|
[[projects]]
|
||||||
|
digest = "1:13fe471d0ed891e8544eddfeeb0471fd3c9f2015609a1c000aefdedf52a19d40"
|
||||||
|
name = "github.com/jmespath/go-jmespath"
|
||||||
|
packages = ["."]
|
||||||
|
pruneopts = ""
|
||||||
|
revision = "c2b33e84"
|
||||||
|
|
||||||
|
[solve-meta]
|
||||||
|
analyzer-name = "dep"
|
||||||
|
analyzer-version = 1
|
||||||
|
input-imports = ["github.com/jmespath/go-jmespath"]
|
||||||
|
solver-name = "gps-cdcl"
|
||||||
|
solver-version = 1
|
||||||
43
vendor/github.com/aws/aws-sdk-go/Gopkg.toml
generated
vendored
Normal file
43
vendor/github.com/aws/aws-sdk-go/Gopkg.toml
generated
vendored
Normal file
@ -0,0 +1,43 @@
|
|||||||
|
|
||||||
|
# Gopkg.toml example
|
||||||
|
#
|
||||||
|
# Refer to https://github.com/golang/dep/blob/master/docs/Gopkg.toml.md
|
||||||
|
# for detailed Gopkg.toml documentation.
|
||||||
|
#
|
||||||
|
# required = ["github.com/user/thing/cmd/thing"]
|
||||||
|
# ignored = ["github.com/user/project/pkgX", "bitbucket.org/user/project/pkgA/pkgY"]
|
||||||
|
#
|
||||||
|
# [[constraint]]
|
||||||
|
# name = "github.com/user/project"
|
||||||
|
# version = "1.0.0"
|
||||||
|
#
|
||||||
|
# [[constraint]]
|
||||||
|
# name = "github.com/user/project2"
|
||||||
|
# branch = "dev"
|
||||||
|
# source = "github.com/myfork/project2"
|
||||||
|
#
|
||||||
|
# [[override]]
|
||||||
|
# name = "github.com/x/y"
|
||||||
|
# version = "2.4.0"
|
||||||
|
|
||||||
|
ignored = [
|
||||||
|
# Testing/Example/Codegen dependencies
|
||||||
|
"github.com/stretchr/testify",
|
||||||
|
"github.com/stretchr/testify/assert",
|
||||||
|
"github.com/stretchr/testify/require",
|
||||||
|
"github.com/go-sql-driver/mysql",
|
||||||
|
"github.com/gucumber/gucumber",
|
||||||
|
"github.com/pkg/errors",
|
||||||
|
"golang.org/x/net",
|
||||||
|
"golang.org/x/net/html",
|
||||||
|
"golang.org/x/net/http2",
|
||||||
|
"golang.org/x/text",
|
||||||
|
"golang.org/x/text/html",
|
||||||
|
"golang.org/x/tools",
|
||||||
|
"golang.org/x/tools/go/loader",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[constraint]]
|
||||||
|
name = "github.com/jmespath/go-jmespath"
|
||||||
|
revision = "c2b33e84"
|
||||||
|
#version = "0.2.2"
|
||||||
232
vendor/github.com/aws/aws-sdk-go/Makefile
generated
vendored
Normal file
232
vendor/github.com/aws/aws-sdk-go/Makefile
generated
vendored
Normal file
@ -0,0 +1,232 @@
|
|||||||
|
LINTIGNOREDOC='service/[^/]+/(api|service|waiters)\.go:.+(comment on exported|should have comment or be unexported)'
|
||||||
|
LINTIGNORECONST='service/[^/]+/(api|service|waiters)\.go:.+(type|struct field|const|func) ([^ ]+) should be ([^ ]+)'
|
||||||
|
LINTIGNORESTUTTER='service/[^/]+/(api|service)\.go:.+(and that stutters)'
|
||||||
|
LINTIGNOREINFLECT='service/[^/]+/(api|errors|service)\.go:.+(method|const) .+ should be '
|
||||||
|
LINTIGNOREINFLECTS3UPLOAD='service/s3/s3manager/upload\.go:.+struct field SSEKMSKeyId should be '
|
||||||
|
LINTIGNOREENDPOINTS='aws/endpoints/(defaults|dep_service_ids).go:.+(method|const) .+ should be '
|
||||||
|
LINTIGNOREDEPS='vendor/.+\.go'
|
||||||
|
LINTIGNOREPKGCOMMENT='service/[^/]+/doc_custom.go:.+package comment should be of the form'
|
||||||
|
UNIT_TEST_TAGS="example codegen awsinclude"
|
||||||
|
|
||||||
|
# SDK's Core and client packages that are compatable with Go 1.5+.
|
||||||
|
SDK_CORE_PKGS=./aws/... ./private/... ./internal/...
|
||||||
|
SDK_CLIENT_PKGS=./service/...
|
||||||
|
SDK_COMPA_PKGS=${SDK_CORE_PKGS} ${SDK_CLIENT_PKGS}
|
||||||
|
|
||||||
|
# SDK additional packages that are used for development of the SDK.
|
||||||
|
SDK_EXAMPLES_PKGS=./example/...
|
||||||
|
SDK_TESTING_PKGS=./awstesting/...
|
||||||
|
SDK_MODELS_PKGS=./models/...
|
||||||
|
SDK_ALL_PKGS=${SDK_COMPA_PKGS} ${SDK_TESTING_PKGS} ${SDK_EXAMPLES_PKGS} ${SDK_MODELS_PKGS}
|
||||||
|
|
||||||
|
all: generate unit
|
||||||
|
|
||||||
|
###################
|
||||||
|
# Code Generation #
|
||||||
|
###################
|
||||||
|
generate: cleanup-models gen-test gen-endpoints gen-services
|
||||||
|
|
||||||
|
gen-test: gen-protocol-test gen-codegen-test
|
||||||
|
|
||||||
|
gen-codegen-test:
|
||||||
|
@echo "Generating SDK API tests"
|
||||||
|
go generate ./private/model/api/codegentest/service
|
||||||
|
|
||||||
|
gen-services:
|
||||||
|
@echo "Generating SDK clients"
|
||||||
|
go generate ./service
|
||||||
|
|
||||||
|
gen-protocol-test:
|
||||||
|
@echo "Generating SDK protocol tests"
|
||||||
|
go generate ./private/protocol/...
|
||||||
|
|
||||||
|
gen-endpoints:
|
||||||
|
@echo "Generating SDK endpoints"
|
||||||
|
go generate ./models/endpoints
|
||||||
|
|
||||||
|
cleanup-models:
|
||||||
|
@echo "Cleaning up stale model versions"
|
||||||
|
go run -tags codegen ./private/model/cli/cleanup-models/* "./models/apis/*/*/api-2.json"
|
||||||
|
|
||||||
|
###################
|
||||||
|
# Unit/CI Testing #
|
||||||
|
###################
|
||||||
|
unit: verify
|
||||||
|
@echo "go test SDK and vendor packages"
|
||||||
|
go test -count=1 -tags ${UNIT_TEST_TAGS} ${SDK_ALL_PKGS}
|
||||||
|
|
||||||
|
unit-with-race-cover: verify
|
||||||
|
@echo "go test SDK and vendor packages"
|
||||||
|
go test -count=1 -tags ${UNIT_TEST_TAGS} -race -cpu=1,2,4 ${SDK_ALL_PKGS}
|
||||||
|
|
||||||
|
unit-old-go-race-cover:
|
||||||
|
@echo "go test SDK only packages for old Go versions"
|
||||||
|
go test -count=1 -race -cpu=1,2,4 ${SDK_COMPA_PKGS}
|
||||||
|
|
||||||
|
ci-test: generate unit-with-race-cover ci-test-generate-validate
|
||||||
|
|
||||||
|
ci-test-generate-validate:
|
||||||
|
@echo "CI test validate no generated code changes"
|
||||||
|
git update-index --assume-unchanged go.mod go.sum
|
||||||
|
git add . -A
|
||||||
|
gitstatus=`git diff --cached --ignore-space-change`; \
|
||||||
|
git update-index --no-assume-unchanged go.mod go.sum
|
||||||
|
echo "$$gitstatus"; \
|
||||||
|
if [ "$$gitstatus" != "" ] && [ "$$gitstatus" != "skipping validation" ]; then echo "$$gitstatus"; exit 1; fi
|
||||||
|
|
||||||
|
#######################
|
||||||
|
# Integration Testing #
|
||||||
|
#######################
|
||||||
|
integration: core-integ client-integ
|
||||||
|
|
||||||
|
core-integ:
|
||||||
|
@echo "Integration Testing SDK core"
|
||||||
|
AWS_REGION="" go test -count=1 -tags "integration" -v -run '^TestInteg_' ${SDK_CORE_PKGS} ./awstesting/...
|
||||||
|
|
||||||
|
client-integ:
|
||||||
|
@echo "Integration Testing SDK clients"
|
||||||
|
AWS_REGION="" go test -count=1 -tags "integration" -v -run '^TestInteg_' ./service/...
|
||||||
|
|
||||||
|
s3crypto-integ:
|
||||||
|
@echo "Integration Testing S3 Cyrpto utility"
|
||||||
|
AWS_REGION="" go test -count=1 -tags "s3crypto_integ integration" -v -run '^TestInteg_' ./service/s3/s3crypto
|
||||||
|
|
||||||
|
cleanup-integ-buckets:
|
||||||
|
@echo "Cleaning up SDK integraiton resources"
|
||||||
|
go run -tags "integration" ./awstesting/cmd/bucket_cleanup/main.go "aws-sdk-go-integration"
|
||||||
|
|
||||||
|
###################
|
||||||
|
# Sandbox Testing #
|
||||||
|
###################
|
||||||
|
sandbox-tests: sandbox-test-go1.5 sandbox-test-go1.6 sandbox-test-go1.7 sandbox-test-go1.8 sandbox-test-go1.9 sandbox-test-go1.10 sandbox-test-go1.11 sandbox-test-go1.12 sandbox-test-gotip
|
||||||
|
|
||||||
|
sandbox-build-go1.5:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.5 -t "aws-sdk-go-1.5" .
|
||||||
|
sandbox-go1.5: sandbox-build-go1.5
|
||||||
|
docker run -i -t aws-sdk-go-1.5 bash
|
||||||
|
sandbox-test-go1.5: sandbox-build-go1.5
|
||||||
|
docker run -t aws-sdk-go-1.5
|
||||||
|
|
||||||
|
sandbox-build-go1.5-novendorexp:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.5-novendorexp -t "aws-sdk-go-1.5-novendorexp" .
|
||||||
|
sandbox-go1.5-novendorexp: sandbox-build-go1.5-novendorexp
|
||||||
|
docker run -i -t aws-sdk-go-1.5-novendorexp bash
|
||||||
|
sandbox-test-go1.5-novendorexp: sandbox-build-go1.5-novendorexp
|
||||||
|
docker run -t aws-sdk-go-1.5-novendorexp
|
||||||
|
|
||||||
|
sandbox-build-go1.6:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.6 -t "aws-sdk-go-1.6" .
|
||||||
|
sandbox-go1.6: sandbox-build-go1.6
|
||||||
|
docker run -i -t aws-sdk-go-1.6 bash
|
||||||
|
sandbox-test-go1.6: sandbox-build-go1.6
|
||||||
|
docker run -t aws-sdk-go-1.6
|
||||||
|
|
||||||
|
sandbox-build-go1.7:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.7 -t "aws-sdk-go-1.7" .
|
||||||
|
sandbox-go1.7: sandbox-build-go17
|
||||||
|
docker run -i -t aws-sdk-go-1.7 bash
|
||||||
|
sandbox-test-go1.7: sandbox-build-go17
|
||||||
|
docker run -t aws-sdk-go-1.7
|
||||||
|
|
||||||
|
sandbox-build-go1.8:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.8 -t "aws-sdk-go-1.8" .
|
||||||
|
sandbox-go1.8: sandbox-build-go1.8
|
||||||
|
docker run -i -t aws-sdk-go-1.8 bash
|
||||||
|
sandbox-test-go1.8: sandbox-build-go1.8
|
||||||
|
docker run -t aws-sdk-go-1.8
|
||||||
|
|
||||||
|
sandbox-build-go1.9:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.9 -t "aws-sdk-go-1.9" .
|
||||||
|
sandbox-go1.9: sandbox-build-go1.9
|
||||||
|
docker run -i -t aws-sdk-go-1.9 bash
|
||||||
|
sandbox-test-go1.9: sandbox-build-go1.9
|
||||||
|
docker run -t aws-sdk-go-1.9
|
||||||
|
|
||||||
|
sandbox-build-go1.10:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.10 -t "aws-sdk-go-1.10" .
|
||||||
|
sandbox-go1.10: sandbox-build-go1.10
|
||||||
|
docker run -i -t aws-sdk-go-1.10 bash
|
||||||
|
sandbox-test-go1.10: sandbox-build-go1.10
|
||||||
|
docker run -t aws-sdk-go-1.10
|
||||||
|
|
||||||
|
sandbox-build-go1.11:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.11 -t "aws-sdk-go-1.11" .
|
||||||
|
sandbox-go1.11: sandbox-build-go1.11
|
||||||
|
docker run -i -t aws-sdk-go-1.11 bash
|
||||||
|
sandbox-test-go1.11: sandbox-build-go1.11
|
||||||
|
docker run -t aws-sdk-go-1.11
|
||||||
|
|
||||||
|
sandbox-build-go1.12:
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.go1.12 -t "aws-sdk-go-1.12" .
|
||||||
|
sandbox-go1.12: sandbox-build-go1.12
|
||||||
|
docker run -i -t aws-sdk-go-1.12 bash
|
||||||
|
sandbox-test-go1.12: sandbox-build-go1.12
|
||||||
|
docker run -t aws-sdk-go-1.12
|
||||||
|
|
||||||
|
sandbox-build-gotip:
|
||||||
|
@echo "Run make update-aws-golang-tip, if this test fails because missing aws-golang:tip container"
|
||||||
|
docker build -f ./awstesting/sandbox/Dockerfile.test.gotip -t "aws-sdk-go-tip" .
|
||||||
|
sandbox-gotip: sandbox-build-gotip
|
||||||
|
docker run -i -t aws-sdk-go-tip bash
|
||||||
|
sandbox-test-gotip: sandbox-build-gotip
|
||||||
|
docker run -t aws-sdk-go-tip
|
||||||
|
|
||||||
|
update-aws-golang-tip:
|
||||||
|
docker build --no-cache=true -f ./awstesting/sandbox/Dockerfile.golang-tip -t "aws-golang:tip" .
|
||||||
|
|
||||||
|
##################
|
||||||
|
# Linting/Verify #
|
||||||
|
##################
|
||||||
|
verify: lint vet
|
||||||
|
|
||||||
|
lint:
|
||||||
|
@echo "go lint SDK and vendor packages"
|
||||||
|
@lint=`golint ./...`; \
|
||||||
|
dolint=`echo "$$lint" | grep -E -v -e ${LINTIGNOREDOC} -e ${LINTIGNORECONST} -e ${LINTIGNORESTUTTER} -e ${LINTIGNOREINFLECT} -e ${LINTIGNOREDEPS} -e ${LINTIGNOREINFLECTS3UPLOAD} -e ${LINTIGNOREPKGCOMMENT} -e ${LINTIGNOREENDPOINTS}`; \
|
||||||
|
echo "$$dolint"; \
|
||||||
|
if [ "$$dolint" != "" ]; then exit 1; fi
|
||||||
|
|
||||||
|
vet:
|
||||||
|
go vet -tags "example codegen awsinclude integration" --all ${SDK_ALL_PKGS}
|
||||||
|
|
||||||
|
################
|
||||||
|
# Dependencies #
|
||||||
|
################
|
||||||
|
get-deps: get-deps-tests get-deps-x-tests get-deps-codegen get-deps-verify
|
||||||
|
|
||||||
|
get-deps-tests:
|
||||||
|
@echo "go get SDK testing dependencies"
|
||||||
|
go get github.com/stretchr/testify
|
||||||
|
|
||||||
|
get-deps-x-tests:
|
||||||
|
@echo "go get SDK testing golang.org/x dependencies"
|
||||||
|
go get golang.org/x/net/http2
|
||||||
|
|
||||||
|
get-deps-codegen: get-deps-x-tests
|
||||||
|
@echo "go get SDK codegen dependencies"
|
||||||
|
go get golang.org/x/net/html
|
||||||
|
|
||||||
|
get-deps-verify:
|
||||||
|
@echo "go get SDK verification utilities"
|
||||||
|
go get golang.org/x/lint/golint
|
||||||
|
|
||||||
|
##############
|
||||||
|
# Benchmarks #
|
||||||
|
##############
|
||||||
|
bench:
|
||||||
|
@echo "go bench SDK packages"
|
||||||
|
go test -count=1 -run NONE -bench . -benchmem -tags 'bench' ${SDK_ALL_PKGS}
|
||||||
|
|
||||||
|
bench-protocol:
|
||||||
|
@echo "go bench SDK protocol marshallers"
|
||||||
|
go test -count=1 -run NONE -bench . -benchmem -tags 'bench' ./private/protocol/...
|
||||||
|
|
||||||
|
#############
|
||||||
|
# Utilities #
|
||||||
|
#############
|
||||||
|
docs:
|
||||||
|
@echo "generate SDK docs"
|
||||||
|
$(AWS_DOC_GEN_TOOL) `pwd`
|
||||||
|
|
||||||
|
api_info:
|
||||||
|
@go run private/model/cli/api-info/api-info.go
|
||||||
2
vendor/github.com/aws/aws-sdk-go/NOTICE.txt
generated
vendored
2
vendor/github.com/aws/aws-sdk-go/NOTICE.txt
generated
vendored
@ -1,3 +1,3 @@
|
|||||||
AWS SDK for Go
|
AWS SDK for Go
|
||||||
Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
Copyright 2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
||||||
Copyright 2014-2015 Stripe, Inc.
|
Copyright 2014-2015 Stripe, Inc.
|
||||||
|
|||||||
503
vendor/github.com/aws/aws-sdk-go/README.md
generated
vendored
Normal file
503
vendor/github.com/aws/aws-sdk-go/README.md
generated
vendored
Normal file
@ -0,0 +1,503 @@
|
|||||||
|
[](https://docs.aws.amazon.com/sdk-for-go/api) [](https://gitter.im/aws/aws-sdk-go?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://travis-ci.org/aws/aws-sdk-go) [](https://github.com/aws/aws-sdk-go/blob/master/LICENSE.txt)
|
||||||
|
|
||||||
|
# AWS SDK for Go
|
||||||
|
|
||||||
|
aws-sdk-go is the official AWS SDK for the Go programming language.
|
||||||
|
|
||||||
|
Checkout our [release notes](https://github.com/aws/aws-sdk-go/releases) for
|
||||||
|
information about the latest bug fixes, updates, and features added to the SDK.
|
||||||
|
|
||||||
|
We [announced](https://aws.amazon.com/blogs/developer/aws-sdk-for-go-2-0-developer-preview/) the Developer Preview for the [v2 AWS SDK for Go](https://github.com/aws/aws-sdk-go-v2). The v2 SDK source is available at https://github.com/aws/aws-sdk-go-v2, and add it to your project with `go get github.com/aws/aws-sdk-go-v2`. Check out the v2 SDK's [changes and updates](https://github.com/aws/aws-sdk-go-v2/blob/master/CHANGELOG.md), and let us know what you think. We want your feedback.
|
||||||
|
|
||||||
|
We have a pilot redesign of the [AWS SDK for Go API reference documentation](https://docs.aws.amazon.com/sdk-for-go/v1/api/gosdk-apiref.html). Let us know what you think.
|
||||||
|
|
||||||
|
## Installing
|
||||||
|
|
||||||
|
Use `go get` to retrieve the SDK to add it to your `GOPATH` workspace, or
|
||||||
|
project's Go module dependencies.
|
||||||
|
|
||||||
|
go get github.com/aws/aws-sdk-go
|
||||||
|
|
||||||
|
To update the SDK use `go get -u` to retrieve the latest version of the SDK.
|
||||||
|
|
||||||
|
go get -u github.com/aws/aws-sdk-go
|
||||||
|
|
||||||
|
### Dependencies
|
||||||
|
|
||||||
|
The SDK includes a `vendor` folder containing the runtime dependencies of the
|
||||||
|
SDK. The metadata of the SDK's dependencies can be found in the Go module file
|
||||||
|
`go.mod` or Dep file `Gopkg.toml`.
|
||||||
|
|
||||||
|
### Go Modules
|
||||||
|
|
||||||
|
If you are using Go modules, your `go get` will default to the latest tagged
|
||||||
|
release version of the SDK. To get a specific release version of the SDK use
|
||||||
|
`@<tag>` in your `go get` command.
|
||||||
|
|
||||||
|
go get github.com/aws/aws-sdk-go@v1.15.77
|
||||||
|
|
||||||
|
To get the latest SDK repository change use `@latest`.
|
||||||
|
|
||||||
|
go get github.com/aws/aws-sdk-go@latest
|
||||||
|
|
||||||
|
### Go 1.5
|
||||||
|
|
||||||
|
If you are using Go 1.5 without vendoring enabled, (`GO15VENDOREXPERIMENT=1`),
|
||||||
|
you will need to use `...` when retrieving the SDK to get its dependencies.
|
||||||
|
|
||||||
|
go get github.com/aws/aws-sdk-go/...
|
||||||
|
|
||||||
|
This will still include the `vendor` folder. The `vendor` folder can be deleted
|
||||||
|
if not used by your environment.
|
||||||
|
|
||||||
|
rm -rf $GOPATH/src/github.com/aws/aws-sdk-go/vendor
|
||||||
|
|
||||||
|
## Getting Help
|
||||||
|
|
||||||
|
Please use these community resources for getting help. We use the GitHub issues
|
||||||
|
for tracking bugs and feature requests.
|
||||||
|
|
||||||
|
* Ask a question on [StackOverflow](http://stackoverflow.com/) and tag it with the [`aws-sdk-go`](http://stackoverflow.com/questions/tagged/aws-sdk-go) tag.
|
||||||
|
* Come join the AWS SDK for Go community chat on [gitter](https://gitter.im/aws/aws-sdk-go).
|
||||||
|
* Open a support ticket with [AWS Support](http://docs.aws.amazon.com/awssupport/latest/user/getting-started.html).
|
||||||
|
* If you think you may have found a bug, please open an [issue](https://github.com/aws/aws-sdk-go/issues/new).
|
||||||
|
|
||||||
|
## Opening Issues
|
||||||
|
|
||||||
|
If you encounter a bug with the AWS SDK for Go we would like to hear about it.
|
||||||
|
Search the [existing issues](https://github.com/aws/aws-sdk-go/issues) and see
|
||||||
|
if others are also experiencing the issue before opening a new issue. Please
|
||||||
|
include the version of AWS SDK for Go, Go language, and OS you’re using. Please
|
||||||
|
also include reproduction case when appropriate.
|
||||||
|
|
||||||
|
The GitHub issues are intended for bug reports and feature requests. For help
|
||||||
|
and questions with using AWS SDK for GO please make use of the resources listed
|
||||||
|
in the [Getting Help](https://github.com/aws/aws-sdk-go#getting-help) section.
|
||||||
|
Keeping the list of open issues lean will help us respond in a timely manner.
|
||||||
|
|
||||||
|
## Reference Documentation
|
||||||
|
|
||||||
|
[`Getting Started Guide`](https://aws.amazon.com/sdk-for-go/) - This document
|
||||||
|
is a general introduction on how to configure and make requests with the SDK.
|
||||||
|
If this is your first time using the SDK, this documentation and the API
|
||||||
|
documentation will help you get started. This document focuses on the syntax
|
||||||
|
and behavior of the SDK. The [Service Developer
|
||||||
|
Guide](https://aws.amazon.com/documentation/) will help you get started using
|
||||||
|
specific AWS services.
|
||||||
|
|
||||||
|
[`SDK API Reference
|
||||||
|
Documentation`](https://docs.aws.amazon.com/sdk-for-go/api/) - Use this
|
||||||
|
document to look up all API operation input and output parameters for AWS
|
||||||
|
services supported by the SDK. The API reference also includes documentation of
|
||||||
|
the SDK, and examples how to using the SDK, service client API operations, and
|
||||||
|
API operation require parameters.
|
||||||
|
|
||||||
|
[`Service Developer Guide`](https://aws.amazon.com/documentation/) - Use this
|
||||||
|
documentation to learn how to interface with AWS services. These are great
|
||||||
|
guides both, if you're getting started with a service, or looking for more
|
||||||
|
information on a service. You should not need this document for coding, though
|
||||||
|
in some cases, services may supply helpful samples that you might want to look
|
||||||
|
out for.
|
||||||
|
|
||||||
|
[`SDK Examples`](https://github.com/aws/aws-sdk-go/tree/master/example) -
|
||||||
|
Included in the SDK's repo are several hand crafted examples using the SDK
|
||||||
|
features and AWS services.
|
||||||
|
|
||||||
|
## Overview of SDK's Packages
|
||||||
|
|
||||||
|
The SDK is composed of two main components, SDK core, and service clients.
|
||||||
|
The SDK core packages are all available under the aws package at the root of
|
||||||
|
the SDK. Each client for a supported AWS service is available within its own
|
||||||
|
package under the service folder at the root of the SDK.
|
||||||
|
|
||||||
|
* aws - SDK core, provides common shared types such as Config, Logger,
|
||||||
|
and utilities to make working with API parameters easier.
|
||||||
|
|
||||||
|
* awserr - Provides the error interface that the SDK will use for all
|
||||||
|
errors that occur in the SDK's processing. This includes service API
|
||||||
|
response errors as well. The Error type is made up of a code and message.
|
||||||
|
Cast the SDK's returned error type to awserr.Error and call the Code
|
||||||
|
method to compare returned error to specific error codes. See the package's
|
||||||
|
documentation for additional values that can be extracted such as RequestID.
|
||||||
|
|
||||||
|
* credentials - Provides the types and built in credentials providers
|
||||||
|
the SDK will use to retrieve AWS credentials to make API requests with.
|
||||||
|
Nested under this folder are also additional credentials providers such as
|
||||||
|
stscreds for assuming IAM roles, and ec2rolecreds for EC2 Instance roles.
|
||||||
|
|
||||||
|
* endpoints - Provides the AWS Regions and Endpoints metadata for the SDK.
|
||||||
|
Use this to lookup AWS service endpoint information such as which services
|
||||||
|
are in a region, and what regions a service is in. Constants are also provided
|
||||||
|
for all region identifiers, e.g UsWest2RegionID for "us-west-2".
|
||||||
|
|
||||||
|
* session - Provides initial default configuration, and load
|
||||||
|
configuration from external sources such as environment and shared
|
||||||
|
credentials file.
|
||||||
|
|
||||||
|
* request - Provides the API request sending, and retry logic for the SDK.
|
||||||
|
This package also includes utilities for defining your own request
|
||||||
|
retryer, and configuring how the SDK processes the request.
|
||||||
|
|
||||||
|
* service - Clients for AWS services. All services supported by the SDK are
|
||||||
|
available under this folder.
|
||||||
|
|
||||||
|
## How to Use the SDK's AWS Service Clients
|
||||||
|
|
||||||
|
The SDK includes the Go types and utilities you can use to make requests to
|
||||||
|
AWS service APIs. Within the service folder at the root of the SDK you'll find
|
||||||
|
a package for each AWS service the SDK supports. All service clients follow common pattern of creation and usage.
|
||||||
|
|
||||||
|
When creating a client for an AWS service you'll first need to have a Session
|
||||||
|
value constructed. The Session provides shared configuration that can be shared
|
||||||
|
between your service clients. When service clients are created you can pass
|
||||||
|
in additional configuration via the aws.Config type to override configuration
|
||||||
|
provided by in the Session to create service client instances with custom
|
||||||
|
configuration.
|
||||||
|
|
||||||
|
Once the service's client is created you can use it to make API requests the
|
||||||
|
AWS service. These clients are safe to use concurrently.
|
||||||
|
|
||||||
|
## Configuring the SDK
|
||||||
|
|
||||||
|
In the AWS SDK for Go, you can configure settings for service clients, such
|
||||||
|
as the log level and maximum number of retries. Most settings are optional;
|
||||||
|
however, for each service client, you must specify a region and your credentials.
|
||||||
|
The SDK uses these values to send requests to the correct AWS region and sign
|
||||||
|
requests with the correct credentials. You can specify these values as part
|
||||||
|
of a session or as environment variables.
|
||||||
|
|
||||||
|
See the SDK's [configuration guide][config_guide] for more information.
|
||||||
|
|
||||||
|
See the [session][session_pkg] package documentation for more information on how to use Session
|
||||||
|
with the SDK.
|
||||||
|
|
||||||
|
See the [Config][config_typ] type in the [aws][aws_pkg] package for more information on configuration
|
||||||
|
options.
|
||||||
|
|
||||||
|
[config_guide]: https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html
|
||||||
|
[session_pkg]: https://docs.aws.amazon.com/sdk-for-go/api/aws/session/
|
||||||
|
[config_typ]: https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||||
|
[aws_pkg]: https://docs.aws.amazon.com/sdk-for-go/api/aws/
|
||||||
|
|
||||||
|
### Configuring Credentials
|
||||||
|
|
||||||
|
When using the SDK you'll generally need your AWS credentials to authenticate
|
||||||
|
with AWS services. The SDK supports multiple methods of supporting these
|
||||||
|
credentials. By default the SDK will source credentials automatically from
|
||||||
|
its default credential chain. See the session package for more information
|
||||||
|
on this chain, and how to configure it. The common items in the credential
|
||||||
|
chain are the following:
|
||||||
|
|
||||||
|
* Environment Credentials - Set of environment variables that are useful
|
||||||
|
when sub processes are created for specific roles.
|
||||||
|
|
||||||
|
* Shared Credentials file (~/.aws/credentials) - This file stores your
|
||||||
|
credentials based on a profile name and is useful for local development.
|
||||||
|
|
||||||
|
* EC2 Instance Role Credentials - Use EC2 Instance Role to assign credentials
|
||||||
|
to application running on an EC2 instance. This removes the need to manage
|
||||||
|
credential files in production.
|
||||||
|
|
||||||
|
Credentials can be configured in code as well by setting the Config's Credentials
|
||||||
|
value to a custom provider or using one of the providers included with the
|
||||||
|
SDK to bypass the default credential chain and use a custom one. This is
|
||||||
|
helpful when you want to instruct the SDK to only use a specific set of
|
||||||
|
credentials or providers.
|
||||||
|
|
||||||
|
This example creates a credential provider for assuming an IAM role, "myRoleARN"
|
||||||
|
and configures the S3 service client to use that role for API requests.
|
||||||
|
|
||||||
|
```go
|
||||||
|
// Initial credentials loaded from SDK's default credential chain. Such as
|
||||||
|
// the environment, shared credentials (~/.aws/credentials), or EC2 Instance
|
||||||
|
// Role. These credentials will be used to to make the STS Assume Role API.
|
||||||
|
sess := session.Must(session.NewSession())
|
||||||
|
|
||||||
|
// Create the credentials from AssumeRoleProvider to assume the role
|
||||||
|
// referenced by the "myRoleARN" ARN.
|
||||||
|
creds := stscreds.NewCredentials(sess, "myRoleArn")
|
||||||
|
|
||||||
|
// Create service client value configured for credentials
|
||||||
|
// from assumed role.
|
||||||
|
svc := s3.New(sess, &aws.Config{Credentials: creds})
|
||||||
|
```
|
||||||
|
|
||||||
|
See the [credentials][credentials_pkg] package documentation for more information on credential
|
||||||
|
providers included with the SDK, and how to customize the SDK's usage of
|
||||||
|
credentials.
|
||||||
|
|
||||||
|
The SDK has support for the shared configuration file (~/.aws/config). This
|
||||||
|
support can be enabled by setting the environment variable, "AWS_SDK_LOAD_CONFIG=1",
|
||||||
|
or enabling the feature in code when creating a Session via the
|
||||||
|
Option's SharedConfigState parameter.
|
||||||
|
|
||||||
|
```go
|
||||||
|
sess := session.Must(session.NewSessionWithOptions(session.Options{
|
||||||
|
SharedConfigState: session.SharedConfigEnable,
|
||||||
|
}))
|
||||||
|
```
|
||||||
|
|
||||||
|
[credentials_pkg]: https://docs.aws.amazon.com/sdk-for-go/api/aws/credentials
|
||||||
|
|
||||||
|
### Configuring AWS Region
|
||||||
|
|
||||||
|
In addition to the credentials you'll need to specify the region the SDK
|
||||||
|
will use to make AWS API requests to. In the SDK you can specify the region
|
||||||
|
either with an environment variable, or directly in code when a Session or
|
||||||
|
service client is created. The last value specified in code wins if the region
|
||||||
|
is specified multiple ways.
|
||||||
|
|
||||||
|
To set the region via the environment variable set the "AWS_REGION" to the
|
||||||
|
region you want to the SDK to use. Using this method to set the region will
|
||||||
|
allow you to run your application in multiple regions without needing additional
|
||||||
|
code in the application to select the region.
|
||||||
|
|
||||||
|
AWS_REGION=us-west-2
|
||||||
|
|
||||||
|
The endpoints package includes constants for all regions the SDK knows. The
|
||||||
|
values are all suffixed with RegionID. These values are helpful, because they
|
||||||
|
reduce the need to type the region string manually.
|
||||||
|
|
||||||
|
To set the region on a Session use the aws package's Config struct parameter
|
||||||
|
Region to the AWS region you want the service clients created from the session to
|
||||||
|
use. This is helpful when you want to create multiple service clients, and
|
||||||
|
all of the clients make API requests to the same region.
|
||||||
|
|
||||||
|
```go
|
||||||
|
sess := session.Must(session.NewSession(&aws.Config{
|
||||||
|
Region: aws.String(endpoints.UsWest2RegionID),
|
||||||
|
}))
|
||||||
|
```
|
||||||
|
|
||||||
|
See the [endpoints][endpoints_pkg] package for the AWS Regions and Endpoints metadata.
|
||||||
|
|
||||||
|
In addition to setting the region when creating a Session you can also set
|
||||||
|
the region on a per service client bases. This overrides the region of a
|
||||||
|
Session. This is helpful when you want to create service clients in specific
|
||||||
|
regions different from the Session's region.
|
||||||
|
|
||||||
|
```go
|
||||||
|
svc := s3.New(sess, &aws.Config{
|
||||||
|
Region: aws.String(endpoints.UsWest2RegionID),
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
See the [Config][config_typ] type in the [aws][aws_pkg] package for more information and additional
|
||||||
|
options such as setting the Endpoint, and other service client configuration options.
|
||||||
|
|
||||||
|
[endpoints_pkg]: https://docs.aws.amazon.com/sdk-for-go/api/aws/endpoints/
|
||||||
|
|
||||||
|
## Making API Requests
|
||||||
|
|
||||||
|
Once the client is created you can make an API request to the service.
|
||||||
|
Each API method takes a input parameter, and returns the service response
|
||||||
|
and an error. The SDK provides methods for making the API call in multiple ways.
|
||||||
|
|
||||||
|
In this list we'll use the S3 ListObjects API as an example for the different
|
||||||
|
ways of making API requests.
|
||||||
|
|
||||||
|
* ListObjects - Base API operation that will make the API request to the service.
|
||||||
|
|
||||||
|
* ListObjectsRequest - API methods suffixed with Request will construct the
|
||||||
|
API request, but not send it. This is also helpful when you want to get a
|
||||||
|
presigned URL for a request, and share the presigned URL instead of your
|
||||||
|
application making the request directly.
|
||||||
|
|
||||||
|
* ListObjectsPages - Same as the base API operation, but uses a callback to
|
||||||
|
automatically handle pagination of the API's response.
|
||||||
|
|
||||||
|
* ListObjectsWithContext - Same as base API operation, but adds support for
|
||||||
|
the Context pattern. This is helpful for controlling the canceling of in
|
||||||
|
flight requests. See the Go standard library context package for more
|
||||||
|
information. This method also takes request package's Option functional
|
||||||
|
options as the variadic argument for modifying how the request will be
|
||||||
|
made, or extracting information from the raw HTTP response.
|
||||||
|
|
||||||
|
* ListObjectsPagesWithContext - same as ListObjectsPages, but adds support for
|
||||||
|
the Context pattern. Similar to ListObjectsWithContext this method also
|
||||||
|
takes the request package's Option function option types as the variadic
|
||||||
|
argument.
|
||||||
|
|
||||||
|
In addition to the API operations the SDK also includes several higher level
|
||||||
|
methods that abstract checking for and waiting for an AWS resource to be in
|
||||||
|
a desired state. In this list we'll use WaitUntilBucketExists to demonstrate
|
||||||
|
the different forms of waiters.
|
||||||
|
|
||||||
|
* WaitUntilBucketExists. - Method to make API request to query an AWS service for
|
||||||
|
a resource's state. Will return successfully when that state is accomplished.
|
||||||
|
|
||||||
|
* WaitUntilBucketExistsWithContext - Same as WaitUntilBucketExists, but adds
|
||||||
|
support for the Context pattern. In addition these methods take request
|
||||||
|
package's WaiterOptions to configure the waiter, and how underlying request
|
||||||
|
will be made by the SDK.
|
||||||
|
|
||||||
|
The API method will document which error codes the service might return for
|
||||||
|
the operation. These errors will also be available as const strings prefixed
|
||||||
|
with "ErrCode" in the service client's package. If there are no errors listed
|
||||||
|
in the API's SDK documentation you'll need to consult the AWS service's API
|
||||||
|
documentation for the errors that could be returned.
|
||||||
|
|
||||||
|
```go
|
||||||
|
ctx := context.Background()
|
||||||
|
|
||||||
|
result, err := svc.GetObjectWithContext(ctx, &s3.GetObjectInput{
|
||||||
|
Bucket: aws.String("my-bucket"),
|
||||||
|
Key: aws.String("my-key"),
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
// Cast err to awserr.Error to handle specific error codes.
|
||||||
|
aerr, ok := err.(awserr.Error)
|
||||||
|
if ok && aerr.Code() == s3.ErrCodeNoSuchKey {
|
||||||
|
// Specific error code handling
|
||||||
|
}
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
// Make sure to close the body when done with it for S3 GetObject APIs or
|
||||||
|
// will leak connections.
|
||||||
|
defer result.Body.Close()
|
||||||
|
|
||||||
|
fmt.Println("Object Size:", aws.Int64Value(result.ContentLength))
|
||||||
|
```
|
||||||
|
|
||||||
|
### API Request Pagination and Resource Waiters
|
||||||
|
|
||||||
|
Pagination helper methods are suffixed with "Pages", and provide the
|
||||||
|
functionality needed to round trip API page requests. Pagination methods
|
||||||
|
take a callback function that will be called for each page of the API's response.
|
||||||
|
|
||||||
|
```go
|
||||||
|
objects := []string{}
|
||||||
|
err := svc.ListObjectsPagesWithContext(ctx, &s3.ListObjectsInput{
|
||||||
|
Bucket: aws.String(myBucket),
|
||||||
|
}, func(p *s3.ListObjectsOutput, lastPage bool) bool {
|
||||||
|
for _, o := range p.Contents {
|
||||||
|
objects = append(objects, aws.StringValue(o.Key))
|
||||||
|
}
|
||||||
|
return true // continue paging
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
panic(fmt.Sprintf("failed to list objects for bucket, %s, %v", myBucket, err))
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Println("Objects in bucket:", objects)
|
||||||
|
```
|
||||||
|
|
||||||
|
Waiter helper methods provide the functionality to wait for an AWS resource
|
||||||
|
state. These methods abstract the logic needed to check the state of an
|
||||||
|
AWS resource, and wait until that resource is in a desired state. The waiter
|
||||||
|
will block until the resource is in the state that is desired, an error occurs,
|
||||||
|
or the waiter times out. If a resource times out the error code returned will
|
||||||
|
be request.WaiterResourceNotReadyErrorCode.
|
||||||
|
|
||||||
|
```go
|
||||||
|
err := svc.WaitUntilBucketExistsWithContext(ctx, &s3.HeadBucketInput{
|
||||||
|
Bucket: aws.String(myBucket),
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
aerr, ok := err.(awserr.Error)
|
||||||
|
if ok && aerr.Code() == request.WaiterResourceNotReadyErrorCode {
|
||||||
|
fmt.Fprintf(os.Stderr, "timed out while waiting for bucket to exist")
|
||||||
|
}
|
||||||
|
panic(fmt.Errorf("failed to wait for bucket to exist, %v", err))
|
||||||
|
}
|
||||||
|
fmt.Println("Bucket", myBucket, "exists")
|
||||||
|
```
|
||||||
|
|
||||||
|
## Complete SDK Example
|
||||||
|
|
||||||
|
This example shows a complete working Go file which will upload a file to S3
|
||||||
|
and use the Context pattern to implement timeout logic that will cancel the
|
||||||
|
request if it takes too long. This example highlights how to use sessions,
|
||||||
|
create a service client, make a request, handle the error, and process the
|
||||||
|
response.
|
||||||
|
|
||||||
|
```go
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"flag"
|
||||||
|
"fmt"
|
||||||
|
"os"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/aws/aws-sdk-go/aws"
|
||||||
|
"github.com/aws/aws-sdk-go/aws/awserr"
|
||||||
|
"github.com/aws/aws-sdk-go/aws/request"
|
||||||
|
"github.com/aws/aws-sdk-go/aws/session"
|
||||||
|
"github.com/aws/aws-sdk-go/service/s3"
|
||||||
|
)
|
||||||
|
|
||||||
|
// Uploads a file to S3 given a bucket and object key. Also takes a duration
|
||||||
|
// value to terminate the update if it doesn't complete within that time.
|
||||||
|
//
|
||||||
|
// The AWS Region needs to be provided in the AWS shared config or on the
|
||||||
|
// environment variable as `AWS_REGION`. Credentials also must be provided
|
||||||
|
// Will default to shared config file, but can load from environment if provided.
|
||||||
|
//
|
||||||
|
// Usage:
|
||||||
|
// # Upload myfile.txt to myBucket/myKey. Must complete within 10 minutes or will fail
|
||||||
|
// go run withContext.go -b mybucket -k myKey -d 10m < myfile.txt
|
||||||
|
func main() {
|
||||||
|
var bucket, key string
|
||||||
|
var timeout time.Duration
|
||||||
|
|
||||||
|
flag.StringVar(&bucket, "b", "", "Bucket name.")
|
||||||
|
flag.StringVar(&key, "k", "", "Object key name.")
|
||||||
|
flag.DurationVar(&timeout, "d", 0, "Upload timeout.")
|
||||||
|
flag.Parse()
|
||||||
|
|
||||||
|
// All clients require a Session. The Session provides the client with
|
||||||
|
// shared configuration such as region, endpoint, and credentials. A
|
||||||
|
// Session should be shared where possible to take advantage of
|
||||||
|
// configuration and credential caching. See the session package for
|
||||||
|
// more information.
|
||||||
|
sess := session.Must(session.NewSession())
|
||||||
|
|
||||||
|
// Create a new instance of the service's client with a Session.
|
||||||
|
// Optional aws.Config values can also be provided as variadic arguments
|
||||||
|
// to the New function. This option allows you to provide service
|
||||||
|
// specific configuration.
|
||||||
|
svc := s3.New(sess)
|
||||||
|
|
||||||
|
// Create a context with a timeout that will abort the upload if it takes
|
||||||
|
// more than the passed in timeout.
|
||||||
|
ctx := context.Background()
|
||||||
|
var cancelFn func()
|
||||||
|
if timeout > 0 {
|
||||||
|
ctx, cancelFn = context.WithTimeout(ctx, timeout)
|
||||||
|
}
|
||||||
|
// Ensure the context is canceled to prevent leaking.
|
||||||
|
// See context package for more information, https://golang.org/pkg/context/
|
||||||
|
if cancelFn {
|
||||||
|
defer cancelFn()
|
||||||
|
}
|
||||||
|
|
||||||
|
// Uploads the object to S3. The Context will interrupt the request if the
|
||||||
|
// timeout expires.
|
||||||
|
_, err := svc.PutObjectWithContext(ctx, &s3.PutObjectInput{
|
||||||
|
Bucket: aws.String(bucket),
|
||||||
|
Key: aws.String(key),
|
||||||
|
Body: os.Stdin,
|
||||||
|
})
|
||||||
|
if err != nil {
|
||||||
|
if aerr, ok := err.(awserr.Error); ok && aerr.Code() == request.CanceledErrorCode {
|
||||||
|
// If the SDK can determine the request or retry delay was canceled
|
||||||
|
// by a context the CanceledErrorCode error code will be returned.
|
||||||
|
fmt.Fprintf(os.Stderr, "upload canceled due to timeout, %v\n", err)
|
||||||
|
} else {
|
||||||
|
fmt.Fprintf(os.Stderr, "failed to upload object, %v\n", err)
|
||||||
|
}
|
||||||
|
os.Exit(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Printf("successfully uploaded file to %s/%s\n", bucket, key)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This SDK is distributed under the
|
||||||
|
[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0),
|
||||||
|
see LICENSE.txt and NOTICE.txt for more information.
|
||||||
22
vendor/github.com/aws/aws-sdk-go/buildspec.yml
generated
vendored
Normal file
22
vendor/github.com/aws/aws-sdk-go/buildspec.yml
generated
vendored
Normal file
@ -0,0 +1,22 @@
|
|||||||
|
version: 0.2
|
||||||
|
|
||||||
|
phases:
|
||||||
|
build:
|
||||||
|
commands:
|
||||||
|
- echo Build started on `date`
|
||||||
|
- export GOPATH=/go
|
||||||
|
- export SDK_CB_ROOT=`pwd`
|
||||||
|
- export SDK_GO_ROOT=/go/src/github.com/aws/aws-sdk-go
|
||||||
|
- mkdir -p /go/src/github.com/aws
|
||||||
|
- ln -s $SDK_CB_ROOT $SDK_GO_ROOT
|
||||||
|
- cd $SDK_GO_ROOT
|
||||||
|
- make get-deps
|
||||||
|
- make ci-test
|
||||||
|
- cd $SDK_CB_ROOT
|
||||||
|
- #echo Compiling the Go code...
|
||||||
|
post_build:
|
||||||
|
commands:
|
||||||
|
- echo Build completed on `date`
|
||||||
|
#artifacts:
|
||||||
|
# files:
|
||||||
|
# - hello
|
||||||
405
vendor/github.com/aws/aws-sdk-go/doc.go
generated
vendored
Normal file
405
vendor/github.com/aws/aws-sdk-go/doc.go
generated
vendored
Normal file
@ -0,0 +1,405 @@
|
|||||||
|
// Package sdk is the official AWS SDK for the Go programming language.
|
||||||
|
//
|
||||||
|
// The AWS SDK for Go provides APIs and utilities that developers can use to
|
||||||
|
// build Go applications that use AWS services, such as Amazon Elastic Compute
|
||||||
|
// Cloud (Amazon EC2) and Amazon Simple Storage Service (Amazon S3).
|
||||||
|
//
|
||||||
|
// The SDK removes the complexity of coding directly against a web service
|
||||||
|
// interface. It hides a lot of the lower-level plumbing, such as authentication,
|
||||||
|
// request retries, and error handling.
|
||||||
|
//
|
||||||
|
// The SDK also includes helpful utilities on top of the AWS APIs that add additional
|
||||||
|
// capabilities and functionality. For example, the Amazon S3 Download and Upload
|
||||||
|
// Manager will automatically split up large objects into multiple parts and
|
||||||
|
// transfer them concurrently.
|
||||||
|
//
|
||||||
|
// See the s3manager package documentation for more information.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/
|
||||||
|
//
|
||||||
|
// Getting More Information
|
||||||
|
//
|
||||||
|
// Checkout the Getting Started Guide and API Reference Docs detailed the SDK's
|
||||||
|
// components and details on each AWS client the SDK supports.
|
||||||
|
//
|
||||||
|
// The Getting Started Guide provides examples and detailed description of how
|
||||||
|
// to get setup with the SDK.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/welcome.html
|
||||||
|
//
|
||||||
|
// The API Reference Docs include a detailed breakdown of the SDK's components
|
||||||
|
// such as utilities and AWS clients. Use this as a reference of the Go types
|
||||||
|
// included with the SDK, such as AWS clients, API operations, and API parameters.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||||
|
//
|
||||||
|
// Overview of SDK's Packages
|
||||||
|
//
|
||||||
|
// The SDK is composed of two main components, SDK core, and service clients.
|
||||||
|
// The SDK core packages are all available under the aws package at the root of
|
||||||
|
// the SDK. Each client for a supported AWS service is available within its own
|
||||||
|
// package under the service folder at the root of the SDK.
|
||||||
|
//
|
||||||
|
// * aws - SDK core, provides common shared types such as Config, Logger,
|
||||||
|
// and utilities to make working with API parameters easier.
|
||||||
|
//
|
||||||
|
// * awserr - Provides the error interface that the SDK will use for all
|
||||||
|
// errors that occur in the SDK's processing. This includes service API
|
||||||
|
// response errors as well. The Error type is made up of a code and message.
|
||||||
|
// Cast the SDK's returned error type to awserr.Error and call the Code
|
||||||
|
// method to compare returned error to specific error codes. See the package's
|
||||||
|
// documentation for additional values that can be extracted such as RequestId.
|
||||||
|
//
|
||||||
|
// * credentials - Provides the types and built in credentials providers
|
||||||
|
// the SDK will use to retrieve AWS credentials to make API requests with.
|
||||||
|
// Nested under this folder are also additional credentials providers such as
|
||||||
|
// stscreds for assuming IAM roles, and ec2rolecreds for EC2 Instance roles.
|
||||||
|
//
|
||||||
|
// * endpoints - Provides the AWS Regions and Endpoints metadata for the SDK.
|
||||||
|
// Use this to lookup AWS service endpoint information such as which services
|
||||||
|
// are in a region, and what regions a service is in. Constants are also provided
|
||||||
|
// for all region identifiers, e.g UsWest2RegionID for "us-west-2".
|
||||||
|
//
|
||||||
|
// * session - Provides initial default configuration, and load
|
||||||
|
// configuration from external sources such as environment and shared
|
||||||
|
// credentials file.
|
||||||
|
//
|
||||||
|
// * request - Provides the API request sending, and retry logic for the SDK.
|
||||||
|
// This package also includes utilities for defining your own request
|
||||||
|
// retryer, and configuring how the SDK processes the request.
|
||||||
|
//
|
||||||
|
// * service - Clients for AWS services. All services supported by the SDK are
|
||||||
|
// available under this folder.
|
||||||
|
//
|
||||||
|
// How to Use the SDK's AWS Service Clients
|
||||||
|
//
|
||||||
|
// The SDK includes the Go types and utilities you can use to make requests to
|
||||||
|
// AWS service APIs. Within the service folder at the root of the SDK you'll find
|
||||||
|
// a package for each AWS service the SDK supports. All service clients follows
|
||||||
|
// a common pattern of creation and usage.
|
||||||
|
//
|
||||||
|
// When creating a client for an AWS service you'll first need to have a Session
|
||||||
|
// value constructed. The Session provides shared configuration that can be shared
|
||||||
|
// between your service clients. When service clients are created you can pass
|
||||||
|
// in additional configuration via the aws.Config type to override configuration
|
||||||
|
// provided by in the Session to create service client instances with custom
|
||||||
|
// configuration.
|
||||||
|
//
|
||||||
|
// Once the service's client is created you can use it to make API requests the
|
||||||
|
// AWS service. These clients are safe to use concurrently.
|
||||||
|
//
|
||||||
|
// Configuring the SDK
|
||||||
|
//
|
||||||
|
// In the AWS SDK for Go, you can configure settings for service clients, such
|
||||||
|
// as the log level and maximum number of retries. Most settings are optional;
|
||||||
|
// however, for each service client, you must specify a region and your credentials.
|
||||||
|
// The SDK uses these values to send requests to the correct AWS region and sign
|
||||||
|
// requests with the correct credentials. You can specify these values as part
|
||||||
|
// of a session or as environment variables.
|
||||||
|
//
|
||||||
|
// See the SDK's configuration guide for more information.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html
|
||||||
|
//
|
||||||
|
// See the session package documentation for more information on how to use Session
|
||||||
|
// with the SDK.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/api/aws/session/
|
||||||
|
//
|
||||||
|
// See the Config type in the aws package for more information on configuration
|
||||||
|
// options.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||||
|
//
|
||||||
|
// Configuring Credentials
|
||||||
|
//
|
||||||
|
// When using the SDK you'll generally need your AWS credentials to authenticate
|
||||||
|
// with AWS services. The SDK supports multiple methods of supporting these
|
||||||
|
// credentials. By default the SDK will source credentials automatically from
|
||||||
|
// its default credential chain. See the session package for more information
|
||||||
|
// on this chain, and how to configure it. The common items in the credential
|
||||||
|
// chain are the following:
|
||||||
|
//
|
||||||
|
// * Environment Credentials - Set of environment variables that are useful
|
||||||
|
// when sub processes are created for specific roles.
|
||||||
|
//
|
||||||
|
// * Shared Credentials file (~/.aws/credentials) - This file stores your
|
||||||
|
// credentials based on a profile name and is useful for local development.
|
||||||
|
//
|
||||||
|
// * EC2 Instance Role Credentials - Use EC2 Instance Role to assign credentials
|
||||||
|
// to application running on an EC2 instance. This removes the need to manage
|
||||||
|
// credential files in production.
|
||||||
|
//
|
||||||
|
// Credentials can be configured in code as well by setting the Config's Credentials
|
||||||
|
// value to a custom provider or using one of the providers included with the
|
||||||
|
// SDK to bypass the default credential chain and use a custom one. This is
|
||||||
|
// helpful when you want to instruct the SDK to only use a specific set of
|
||||||
|
// credentials or providers.
|
||||||
|
//
|
||||||
|
// This example creates a credential provider for assuming an IAM role, "myRoleARN"
|
||||||
|
// and configures the S3 service client to use that role for API requests.
|
||||||
|
//
|
||||||
|
// // Initial credentials loaded from SDK's default credential chain. Such as
|
||||||
|
// // the environment, shared credentials (~/.aws/credentials), or EC2 Instance
|
||||||
|
// // Role. These credentials will be used to to make the STS Assume Role API.
|
||||||
|
// sess := session.Must(session.NewSession())
|
||||||
|
//
|
||||||
|
// // Create the credentials from AssumeRoleProvider to assume the role
|
||||||
|
// // referenced by the "myRoleARN" ARN.
|
||||||
|
// creds := stscreds.NewCredentials(sess, "myRoleArn")
|
||||||
|
//
|
||||||
|
// // Create service client value configured for credentials
|
||||||
|
// // from assumed role.
|
||||||
|
// svc := s3.New(sess, &aws.Config{Credentials: creds})/
|
||||||
|
//
|
||||||
|
// See the credentials package documentation for more information on credential
|
||||||
|
// providers included with the SDK, and how to customize the SDK's usage of
|
||||||
|
// credentials.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/api/aws/credentials
|
||||||
|
//
|
||||||
|
// The SDK has support for the shared configuration file (~/.aws/config). This
|
||||||
|
// support can be enabled by setting the environment variable, "AWS_SDK_LOAD_CONFIG=1",
|
||||||
|
// or enabling the feature in code when creating a Session via the
|
||||||
|
// Option's SharedConfigState parameter.
|
||||||
|
//
|
||||||
|
// sess := session.Must(session.NewSessionWithOptions(session.Options{
|
||||||
|
// SharedConfigState: session.SharedConfigEnable,
|
||||||
|
// }))
|
||||||
|
//
|
||||||
|
// Configuring AWS Region
|
||||||
|
//
|
||||||
|
// In addition to the credentials you'll need to specify the region the SDK
|
||||||
|
// will use to make AWS API requests to. In the SDK you can specify the region
|
||||||
|
// either with an environment variable, or directly in code when a Session or
|
||||||
|
// service client is created. The last value specified in code wins if the region
|
||||||
|
// is specified multiple ways.
|
||||||
|
//
|
||||||
|
// To set the region via the environment variable set the "AWS_REGION" to the
|
||||||
|
// region you want to the SDK to use. Using this method to set the region will
|
||||||
|
// allow you to run your application in multiple regions without needing additional
|
||||||
|
// code in the application to select the region.
|
||||||
|
//
|
||||||
|
// AWS_REGION=us-west-2
|
||||||
|
//
|
||||||
|
// The endpoints package includes constants for all regions the SDK knows. The
|
||||||
|
// values are all suffixed with RegionID. These values are helpful, because they
|
||||||
|
// reduce the need to type the region string manually.
|
||||||
|
//
|
||||||
|
// To set the region on a Session use the aws package's Config struct parameter
|
||||||
|
// Region to the AWS region you want the service clients created from the session to
|
||||||
|
// use. This is helpful when you want to create multiple service clients, and
|
||||||
|
// all of the clients make API requests to the same region.
|
||||||
|
//
|
||||||
|
// sess := session.Must(session.NewSession(&aws.Config{
|
||||||
|
// Region: aws.String(endpoints.UsWest2RegionID),
|
||||||
|
// }))
|
||||||
|
//
|
||||||
|
// See the endpoints package for the AWS Regions and Endpoints metadata.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/api/aws/endpoints/
|
||||||
|
//
|
||||||
|
// In addition to setting the region when creating a Session you can also set
|
||||||
|
// the region on a per service client bases. This overrides the region of a
|
||||||
|
// Session. This is helpful when you want to create service clients in specific
|
||||||
|
// regions different from the Session's region.
|
||||||
|
//
|
||||||
|
// svc := s3.New(sess, &aws.Config{
|
||||||
|
// Region: aws.String(endpoints.UsWest2RegionID),
|
||||||
|
// })
|
||||||
|
//
|
||||||
|
// See the Config type in the aws package for more information and additional
|
||||||
|
// options such as setting the Endpoint, and other service client configuration options.
|
||||||
|
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||||
|
//
|
||||||
|
// Making API Requests
|
||||||
|
//
|
||||||
|
// Once the client is created you can make an API request to the service.
|
||||||
|
// Each API method takes a input parameter, and returns the service response
|
||||||
|
// and an error. The SDK provides methods for making the API call in multiple ways.
|
||||||
|
//
|
||||||
|
// In this list we'll use the S3 ListObjects API as an example for the different
|
||||||
|
// ways of making API requests.
|
||||||
|
//
|
||||||
|
// * ListObjects - Base API operation that will make the API request to the service.
|
||||||
|
//
|
||||||
|
// * ListObjectsRequest - API methods suffixed with Request will construct the
|
||||||
|
// API request, but not send it. This is also helpful when you want to get a
|
||||||
|
// presigned URL for a request, and share the presigned URL instead of your
|
||||||
|
// application making the request directly.
|
||||||
|
//
|
||||||
|
// * ListObjectsPages - Same as the base API operation, but uses a callback to
|
||||||
|
// automatically handle pagination of the API's response.
|
||||||
|
//
|
||||||
|
// * ListObjectsWithContext - Same as base API operation, but adds support for
|
||||||
|
// the Context pattern. This is helpful for controlling the canceling of in
|
||||||
|
// flight requests. See the Go standard library context package for more
|
||||||
|
// information. This method also takes request package's Option functional
|
||||||
|
// options as the variadic argument for modifying how the request will be
|
||||||
|
// made, or extracting information from the raw HTTP response.
|
||||||
|
//
|
||||||
|
// * ListObjectsPagesWithContext - same as ListObjectsPages, but adds support for
|
||||||
|
// the Context pattern. Similar to ListObjectsWithContext this method also
|
||||||
|
// takes the request package's Option function option types as the variadic
|
||||||
|
// argument.
|
||||||
|
//
|
||||||
|
// In addition to the API operations the SDK also includes several higher level
|
||||||
|
// methods that abstract checking for and waiting for an AWS resource to be in
|
||||||
|
// a desired state. In this list we'll use WaitUntilBucketExists to demonstrate
|
||||||
|
// the different forms of waiters.
|
||||||
|
//
|
||||||
|
// * WaitUntilBucketExists. - Method to make API request to query an AWS service for
|
||||||
|
// a resource's state. Will return successfully when that state is accomplished.
|
||||||
|
//
|
||||||
|
// * WaitUntilBucketExistsWithContext - Same as WaitUntilBucketExists, but adds
|
||||||
|
// support for the Context pattern. In addition these methods take request
|
||||||
|
// package's WaiterOptions to configure the waiter, and how underlying request
|
||||||
|
// will be made by the SDK.
|
||||||
|
//
|
||||||
|
// The API method will document which error codes the service might return for
|
||||||
|
// the operation. These errors will also be available as const strings prefixed
|
||||||
|
// with "ErrCode" in the service client's package. If there are no errors listed
|
||||||
|
// in the API's SDK documentation you'll need to consult the AWS service's API
|
||||||
|
// documentation for the errors that could be returned.
|
||||||
|
//
|
||||||
|
// ctx := context.Background()
|
||||||
|
//
|
||||||
|
// result, err := svc.GetObjectWithContext(ctx, &s3.GetObjectInput{
|
||||||
|
// Bucket: aws.String("my-bucket"),
|
||||||
|
// Key: aws.String("my-key"),
|
||||||
|
// })
|
||||||
|
// if err != nil {
|
||||||
|
// // Cast err to awserr.Error to handle specific error codes.
|
||||||
|
// aerr, ok := err.(awserr.Error)
|
||||||
|
// if ok && aerr.Code() == s3.ErrCodeNoSuchKey {
|
||||||
|
// // Specific error code handling
|
||||||
|
// }
|
||||||
|
// return err
|
||||||
|
// }
|
||||||
|
//
|
||||||
|
// // Make sure to close the body when done with it for S3 GetObject APIs or
|
||||||
|
// // will leak connections.
|
||||||
|
// defer result.Body.Close()
|
||||||
|
//
|
||||||
|
// fmt.Println("Object Size:", aws.StringValue(result.ContentLength))
|
||||||
|
//
|
||||||
|
// API Request Pagination and Resource Waiters
|
||||||
|
//
|
||||||
|
// Pagination helper methods are suffixed with "Pages", and provide the
|
||||||
|
// functionality needed to round trip API page requests. Pagination methods
|
||||||
|
// take a callback function that will be called for each page of the API's response.
|
||||||
|
//
|
||||||
|
// objects := []string{}
|
||||||
|
// err := svc.ListObjectsPagesWithContext(ctx, &s3.ListObjectsInput{
|
||||||
|
// Bucket: aws.String(myBucket),
|
||||||
|
// }, func(p *s3.ListObjectsOutput, lastPage bool) bool {
|
||||||
|
// for _, o := range p.Contents {
|
||||||
|
// objects = append(objects, aws.StringValue(o.Key))
|
||||||
|
// }
|
||||||
|
// return true // continue paging
|
||||||
|
// })
|
||||||
|
// if err != nil {
|
||||||
|
// panic(fmt.Sprintf("failed to list objects for bucket, %s, %v", myBucket, err))
|
||||||
|
// }
|
||||||
|
//
|
||||||
|
// fmt.Println("Objects in bucket:", objects)
|
||||||
|
//
|
||||||
|
// Waiter helper methods provide the functionality to wait for an AWS resource
|
||||||
|
// state. These methods abstract the logic needed to to check the state of an
|
||||||
|
// AWS resource, and wait until that resource is in a desired state. The waiter
|
||||||
|
// will block until the resource is in the state that is desired, an error occurs,
|
||||||
|
// or the waiter times out. If a resource times out the error code returned will
|
||||||
|
// be request.WaiterResourceNotReadyErrorCode.
|
||||||
|
//
|
||||||
|
// err := svc.WaitUntilBucketExistsWithContext(ctx, &s3.HeadBucketInput{
|
||||||
|
// Bucket: aws.String(myBucket),
|
||||||
|
// })
|
||||||
|
// if err != nil {
|
||||||
|
// aerr, ok := err.(awserr.Error)
|
||||||
|
// if ok && aerr.Code() == request.WaiterResourceNotReadyErrorCode {
|
||||||
|
// fmt.Fprintf(os.Stderr, "timed out while waiting for bucket to exist")
|
||||||
|
// }
|
||||||
|
// panic(fmt.Errorf("failed to wait for bucket to exist, %v", err))
|
||||||
|
// }
|
||||||
|
// fmt.Println("Bucket", myBucket, "exists")
|
||||||
|
//
|
||||||
|
// Complete SDK Example
|
||||||
|
//
|
||||||
|
// This example shows a complete working Go file which will upload a file to S3
|
||||||
|
// and use the Context pattern to implement timeout logic that will cancel the
|
||||||
|
// request if it takes too long. This example highlights how to use sessions,
|
||||||
|
// create a service client, make a request, handle the error, and process the
|
||||||
|
// response.
|
||||||
|
//
|
||||||
|
// package main
|
||||||
|
//
|
||||||
|
// import (
|
||||||
|
// "context"
|
||||||
|
// "flag"
|
||||||
|
// "fmt"
|
||||||
|
// "os"
|
||||||
|
// "time"
|
||||||
|
//
|
||||||
|
// "github.com/aws/aws-sdk-go/aws"
|
||||||
|
// "github.com/aws/aws-sdk-go/aws/awserr"
|
||||||
|
// "github.com/aws/aws-sdk-go/aws/request"
|
||||||
|
// "github.com/aws/aws-sdk-go/aws/session"
|
||||||
|
// "github.com/aws/aws-sdk-go/service/s3"
|
||||||
|
// )
|
||||||
|
//
|
||||||
|
// // Uploads a file to S3 given a bucket and object key. Also takes a duration
|
||||||
|
// // value to terminate the update if it doesn't complete within that time.
|
||||||
|
// //
|
||||||
|
// // The AWS Region needs to be provided in the AWS shared config or on the
|
||||||
|
// // environment variable as `AWS_REGION`. Credentials also must be provided
|
||||||
|
// // Will default to shared config file, but can load from environment if provided.
|
||||||
|
// //
|
||||||
|
// // Usage:
|
||||||
|
// // # Upload myfile.txt to myBucket/myKey. Must complete within 10 minutes or will fail
|
||||||
|
// // go run withContext.go -b mybucket -k myKey -d 10m < myfile.txt
|
||||||
|
// func main() {
|
||||||
|
// var bucket, key string
|
||||||
|
// var timeout time.Duration
|
||||||
|
//
|
||||||
|
// flag.StringVar(&bucket, "b", "", "Bucket name.")
|
||||||
|
// flag.StringVar(&key, "k", "", "Object key name.")
|
||||||
|
// flag.DurationVar(&timeout, "d", 0, "Upload timeout.")
|
||||||
|
// flag.Parse()
|
||||||
|
//
|
||||||
|
// // All clients require a Session. The Session provides the client with
|
||||||
|
// // shared configuration such as region, endpoint, and credentials. A
|
||||||
|
// // Session should be shared where possible to take advantage of
|
||||||
|
// // configuration and credential caching. See the session package for
|
||||||
|
// // more information.
|
||||||
|
// sess := session.Must(session.NewSession())
|
||||||
|
//
|
||||||
|
// // Create a new instance of the service's client with a Session.
|
||||||
|
// // Optional aws.Config values can also be provided as variadic arguments
|
||||||
|
// // to the New function. This option allows you to provide service
|
||||||
|
// // specific configuration.
|
||||||
|
// svc := s3.New(sess)
|
||||||
|
//
|
||||||
|
// // Create a context with a timeout that will abort the upload if it takes
|
||||||
|
// // more than the passed in timeout.
|
||||||
|
// ctx := context.Background()
|
||||||
|
// var cancelFn func()
|
||||||
|
// if timeout > 0 {
|
||||||
|
// ctx, cancelFn = context.WithTimeout(ctx, timeout)
|
||||||
|
// }
|
||||||
|
// // Ensure the context is canceled to prevent leaking.
|
||||||
|
// // See context package for more information, https://golang.org/pkg/context/
|
||||||
|
// defer cancelFn()
|
||||||
|
//
|
||||||
|
// // Uploads the object to S3. The Context will interrupt the request if the
|
||||||
|
// // timeout expires.
|
||||||
|
// _, err := svc.PutObjectWithContext(ctx, &s3.PutObjectInput{
|
||||||
|
// Bucket: aws.String(bucket),
|
||||||
|
// Key: aws.String(key),
|
||||||
|
// Body: os.Stdin,
|
||||||
|
// })
|
||||||
|
// if err != nil {
|
||||||
|
// if aerr, ok := err.(awserr.Error); ok && aerr.Code() == request.CanceledErrorCode {
|
||||||
|
// // If the SDK can determine the request or retry delay was canceled
|
||||||
|
// // by a context the CanceledErrorCode error code will be returned.
|
||||||
|
// fmt.Fprintf(os.Stderr, "upload canceled due to timeout, %v\n", err)
|
||||||
|
// } else {
|
||||||
|
// fmt.Fprintf(os.Stderr, "failed to upload object, %v\n", err)
|
||||||
|
// }
|
||||||
|
// os.Exit(1)
|
||||||
|
// }
|
||||||
|
//
|
||||||
|
// fmt.Printf("successfully uploaded file to %s/%s\n", bucket, key)
|
||||||
|
// }
|
||||||
|
package sdk
|
||||||
3
vendor/github.com/aws/aws-sdk-go/go.mod
generated
vendored
Normal file
3
vendor/github.com/aws/aws-sdk-go/go.mod
generated
vendored
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
module github.com/aws/aws-sdk-go
|
||||||
|
|
||||||
|
require github.com/jmespath/go-jmespath v0.0.0-20180206201540-c2b33e8439af
|
||||||
2
vendor/github.com/aws/aws-sdk-go/go.sum
generated
vendored
Normal file
2
vendor/github.com/aws/aws-sdk-go/go.sum
generated
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
github.com/jmespath/go-jmespath v0.0.0-20180206201540-c2b33e8439af h1:pmfjZENx5imkbgOkpRUYLnmbU7UEFbjtDA2hxJ1ichM=
|
||||||
|
github.com/jmespath/go-jmespath v0.0.0-20180206201540-c2b33e8439af/go.mod h1:Nht3zPeWKUH0NzdCt2Blrr5ys8VGpn0CEB0cQHVjt7k=
|
||||||
6
vendor/vendor.json
vendored
6
vendor/vendor.json
vendored
@ -32,6 +32,12 @@
|
|||||||
"revision": "09c41003ee1d5015b75f331e52215512e7145b8d",
|
"revision": "09c41003ee1d5015b75f331e52215512e7145b8d",
|
||||||
"revisionTime": "2018-05-11T10:42:25Z"
|
"revisionTime": "2018-05-11T10:42:25Z"
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"checksumSHA1": "AdHtLqsHFd5jeMIj4D1fEdZf7Po=",
|
||||||
|
"path": "github.com/aws/aws-sdk-go",
|
||||||
|
"revision": "843d8b68903fa00bee80468c492055907685c47c",
|
||||||
|
"revisionTime": "2019-07-03T18:29:49Z"
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"checksumSHA1": "irAylH0FbfVgkCcXP9U+Fkou9+U=",
|
"checksumSHA1": "irAylH0FbfVgkCcXP9U+Fkou9+U=",
|
||||||
"path": "github.com/aws/aws-sdk-go/aws",
|
"path": "github.com/aws/aws-sdk-go/aws",
|
||||||
|
|||||||
Reference in New Issue
Block a user