provider/aws: Bump vendor package to 1.8.21
This commit is contained in:
parent
145fa084f9
commit
c9ef9942c6
|
@ -1,3 +1,53 @@
|
|||
Release v1.8.21 (2017-05-09)
|
||||
===
|
||||
|
||||
### Service Client Updates
|
||||
* `service/codestar`: Updates service documentation
|
||||
* Updated documentation for AWS CodeStar.
|
||||
* `service/workspaces`: Updates service API, documentation, and paginators
|
||||
* Doc-only Update for WorkSpaces
|
||||
|
||||
Release v1.8.20 (2017-05-04)
|
||||
===
|
||||
|
||||
### Service Client Updates
|
||||
* `service/ecs`: Updates service API, documentation, and paginators
|
||||
* Exposes container instance registration time in ECS:DescribeContainerInstances.
|
||||
* `aws/endpoints`: Updated Regions and Endpoints metadata.
|
||||
* `service/marketplaceentitlementservice`: Adds new service
|
||||
* `service/lambda`: Updates service API and documentation
|
||||
* Support for UpdateFunctionCode DryRun option
|
||||
|
||||
Release v1.8.19 (2017-04-28)
|
||||
===
|
||||
|
||||
### Service Client Updates
|
||||
* `service/cloudformation`: Updates service waiters and paginators
|
||||
* Adding back the removed waiters and paginators.
|
||||
|
||||
Release v1.8.18 (2017-04-28)
|
||||
===
|
||||
|
||||
### Service Client Updates
|
||||
* `service/cloudformation`: Updates service API, documentation, waiters, paginators, and examples
|
||||
* API update for CloudFormation: New optional parameter ClientRequestToken which can be used as an idempotency token to safely retry certain operations as well as tagging StackEvents.
|
||||
* `service/rds`: Updates service API, documentation, and examples
|
||||
* The DescribeDBClusterSnapshots API now returns a SourceDBClusterSnapshotArn field which identifies the source DB cluster snapshot of a copied snapshot.
|
||||
* `service/rekognition`: Updates service API
|
||||
* Fix for missing file type check
|
||||
* `service/snowball`: Updates service API, documentation, and paginators
|
||||
* The Snowball API has a new exception that can be thrown for list operation requests.
|
||||
* `service/sqs`: Updates service API, documentation, and paginators
|
||||
* Adding server-side encryption (SSE) support to SQS by integrating with AWS KMS; adding new queue attributes to SQS CreateQueue, SetQueueAttributes and GetQueueAttributes APIs to support SSE.
|
||||
|
||||
Release v1.8.17 (2017-04-26)
|
||||
===
|
||||
|
||||
### Service Client Updates
|
||||
* `aws/endpoints`: Updated Regions and Endpoints metadata.
|
||||
* `service/rds`: Updates service API and documentation
|
||||
* With Amazon Relational Database Service (Amazon RDS) running MySQL or Amazon Aurora, you can now authenticate to your DB instance using IAM database authentication.
|
||||
|
||||
Release v1.8.16 (2017-04-21)
|
||||
===
|
||||
|
||||
|
|
|
@ -5,6 +5,7 @@ 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 '
|
||||
LINTIGNOREDEPS='vendor/.+\.go'
|
||||
LINTIGNOREPKGCOMMENT='service/[^/]+/doc_custom.go:.+package comment should be of the form'
|
||||
UNIT_TEST_TAGS="example codegen"
|
||||
|
||||
SDK_WITH_VENDOR_PKGS=$(shell go list -tags ${UNIT_TEST_TAGS} ./... | grep -v "/vendor/src")
|
||||
|
@ -126,7 +127,7 @@ verify: get-deps-verify lint vet
|
|||
lint:
|
||||
@echo "go lint SDK and vendor packages"
|
||||
@lint=`if [ \( -z "${SDK_GO_1_4}" \) -a \( -z "${SDK_GO_1_5}" \) ]; then golint ./...; else echo "skipping golint"; fi`; \
|
||||
lint=`echo "$$lint" | grep -E -v -e ${LINTIGNOREDOT} -e ${LINTIGNOREDOC} -e ${LINTIGNORECONST} -e ${LINTIGNORESTUTTER} -e ${LINTIGNOREINFLECT} -e ${LINTIGNOREDEPS} -e ${LINTIGNOREINFLECTS3UPLOAD}`; \
|
||||
lint=`echo "$$lint" | grep -E -v -e ${LINTIGNOREDOT} -e ${LINTIGNOREDOC} -e ${LINTIGNORECONST} -e ${LINTIGNORESTUTTER} -e ${LINTIGNOREINFLECT} -e ${LINTIGNOREDEPS} -e ${LINTIGNOREINFLECTS3UPLOAD} -e ${LINTIGNOREPKGCOMMENT}`; \
|
||||
echo "$$lint"; \
|
||||
if [ "$$lint" != "" ] && [ "$$lint" != "skipping golint" ]; then exit 1; fi
|
||||
|
||||
|
|
|
@ -1,4 +1,6 @@
|
|||
# AWS SDK for Go [![API Reference](http://img.shields.io/badge/api-reference-blue.svg)](http://docs.aws.amazon.com/sdk-for-go/api) [![Join the chat at https://gitter.im/aws/aws-sdk-go](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/aws/aws-sdk-go?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Build Status](https://img.shields.io/travis/aws/aws-sdk-go.svg)](https://travis-ci.org/aws/aws-sdk-go) [![Apache V2 License](http://img.shields.io/badge/license-Apache%20V2-blue.svg)](https://github.com/aws/aws-sdk-go/blob/master/LICENSE.txt)
|
||||
[![API Reference](http://img.shields.io/badge/api-reference-blue.svg)](http://docs.aws.amazon.com/sdk-for-go/api) [![Join the chat at https://gitter.im/aws/aws-sdk-go](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/aws/aws-sdk-go?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Build Status](https://img.shields.io/travis/aws/aws-sdk-go.svg)](https://travis-ci.org/aws/aws-sdk-go) [![Apache V2 License](http://img.shields.io/badge/license-Apache%20V2-blue.svg)](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.
|
||||
|
||||
|
@ -26,6 +28,7 @@ These two processes will still include the `vendor` folder and it should be dele
|
|||
## 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).
|
||||
|
@ -33,9 +36,9 @@ Please use these community resources for getting help. We use the GitHub issues
|
|||
|
||||
## 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 repro case when appropriate.
|
||||
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 repro 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.
|
||||
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
|
||||
|
||||
|
@ -47,113 +50,397 @@ The GitHub issues are intended for bug reports and feature requests. For help an
|
|||
|
||||
[`SDK Examples`](https://github.com/aws/aws-sdk-go/tree/master/example) - Included in the SDK's repo are a several hand crafted examples using the SDK features and AWS services.
|
||||
|
||||
## Configuring Credentials
|
||||
## Overview of SDK's Packages
|
||||
|
||||
Before using the SDK, ensure that you've configured credentials. The best
|
||||
way to configure credentials on a development machine is to use the
|
||||
`~/.aws/credentials` file, which might look like:
|
||||
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.
|
||||
|
||||
```
|
||||
[default]
|
||||
aws_access_key_id = AKID1234567890
|
||||
aws_secret_access_key = MY-SECRET-KEY
|
||||
```
|
||||
* aws - SDK core, provides common shared types such as Config, Logger,
|
||||
and utilities to make working with API parameters easier.
|
||||
|
||||
You can learn more about the credentials file from this
|
||||
[blog post](http://blogs.aws.amazon.com/security/post/Tx3D6U6WSFGOK2H/A-New-and-Standardized-Way-to-Manage-Credentials-in-the-AWS-SDKs).
|
||||
* 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.
|
||||
|
||||
Alternatively, you can set the following environment variables:
|
||||
* 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.
|
||||
|
||||
```
|
||||
AWS_ACCESS_KEY_ID=AKID1234567890
|
||||
AWS_SECRET_ACCESS_KEY=MY-SECRET-KEY
|
||||
```
|
||||
* 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".
|
||||
|
||||
### AWS shared config file (`~/.aws/config`)
|
||||
The AWS SDK for Go added support the shared config file in release [v1.3.0](https://github.com/aws/aws-sdk-go/releases/tag/v1.3.0). You can opt into enabling support for the shared config by setting the environment variable `AWS_SDK_LOAD_CONFIG` to a truthy value. See the [Session](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/sessions.html) docs for more information about this feature.
|
||||
* session - Provides initial default configuration, and load
|
||||
configuration from external sources such as environment and shared
|
||||
credentials file.
|
||||
|
||||
## Using the Go SDK
|
||||
* 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.
|
||||
|
||||
To use a service in the SDK, create a service variable by calling the `New()`
|
||||
function. Once you have a service client, you can call API operations which each
|
||||
return response data and a possible error.
|
||||
* service - Clients for AWS services. All services supported by the SDK are
|
||||
available under this folder.
|
||||
|
||||
For example the following code shows how to upload an object to Amazon S3 with a Context timeout.
|
||||
## 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][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
|
||||
package main
|
||||
// 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())
|
||||
|
||||
import (
|
||||
"context"
|
||||
"flag"
|
||||
"fmt"
|
||||
"os"
|
||||
"time"
|
||||
// Create the credentials from AssumeRoleProvider to assume the role
|
||||
// referenced by the "myRoleARN" ARN.
|
||||
creds := stscreds.NewCredentials(sess, "myRoleArn")
|
||||
|
||||
"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()
|
||||
|
||||
sess := session.Must(session.NewSession())
|
||||
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)
|
||||
}
|
||||
// Create service client value configured for credentials
|
||||
// from assumed role.
|
||||
svc := s3.New(sess, &aws.Config{Credentials: creds})/
|
||||
```
|
||||
|
||||
You can find more information and operations in our
|
||||
[API documentation](http://docs.aws.amazon.com/sdk-for-go/api/).
|
||||
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]: ttps://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.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.
|
||||
|
||||
```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 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/
|
||||
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
|
||||
|
||||
|
|
|
@ -13,7 +13,7 @@ var (
|
|||
//
|
||||
// @readonly
|
||||
ErrNoValidProvidersFoundInChain = awserr.New("NoCredentialProviders",
|
||||
`no valid providers in chain. Deprecated.
|
||||
`no valid providers in chain. Deprecated.
|
||||
For verbose messaging see aws.Config.CredentialsChainVerboseErrors`,
|
||||
nil)
|
||||
)
|
||||
|
@ -39,16 +39,18 @@ var (
|
|||
// does not return any credentials ChainProvider will return the error
|
||||
// ErrNoValidProvidersFoundInChain
|
||||
//
|
||||
// creds := NewChainCredentials(
|
||||
// []Provider{
|
||||
// &EnvProvider{},
|
||||
// &EC2RoleProvider{
|
||||
// creds := credentials.NewChainCredentials(
|
||||
// []credentials.Provider{
|
||||
// &credentials.EnvProvider{},
|
||||
// &ec2rolecreds.EC2RoleProvider{
|
||||
// Client: ec2metadata.New(sess),
|
||||
// },
|
||||
// })
|
||||
//
|
||||
// // Usage of ChainCredentials with aws.Config
|
||||
// svc := ec2.New(&aws.Config{Credentials: creds})
|
||||
// svc := ec2.New(session.Must(session.NewSession(&aws.Config{
|
||||
// Credentials: creds,
|
||||
// })))
|
||||
//
|
||||
type ChainProvider struct {
|
||||
Providers []Provider
|
||||
|
|
|
@ -14,7 +14,7 @@
|
|||
//
|
||||
// Example of using the environment variable credentials.
|
||||
//
|
||||
// creds := NewEnvCredentials()
|
||||
// creds := credentials.NewEnvCredentials()
|
||||
//
|
||||
// // Retrieve the credentials value
|
||||
// credValue, err := creds.Get()
|
||||
|
@ -26,7 +26,7 @@
|
|||
// This may be helpful to proactively expire credentials and refresh them sooner
|
||||
// than they would naturally expire on their own.
|
||||
//
|
||||
// creds := NewCredentials(&EC2RoleProvider{})
|
||||
// creds := credentials.NewCredentials(&ec2rolecreds.EC2RoleProvider{})
|
||||
// creds.Expire()
|
||||
// credsValue, err := creds.Get()
|
||||
// // New credentials will be retrieved instead of from cache.
|
||||
|
@ -43,7 +43,7 @@
|
|||
// func (m *MyProvider) Retrieve() (Value, error) {...}
|
||||
// func (m *MyProvider) IsExpired() bool {...}
|
||||
//
|
||||
// creds := NewCredentials(&MyProvider{})
|
||||
// creds := credentials.NewCredentials(&MyProvider{})
|
||||
// credValue, err := creds.Get()
|
||||
//
|
||||
package credentials
|
||||
|
@ -60,7 +60,9 @@ import (
|
|||
// when making service API calls. For example, when accessing public
|
||||
// s3 buckets.
|
||||
//
|
||||
// svc := s3.New(&aws.Config{Credentials: AnonymousCredentials})
|
||||
// svc := s3.New(session.Must(session.NewSession(&aws.Config{
|
||||
// Credentials: credentials.AnonymousCredentials,
|
||||
// })))
|
||||
// // Access public S3 buckets.
|
||||
//
|
||||
// @readonly
|
||||
|
|
|
@ -29,6 +29,7 @@ var (
|
|||
// Environment variables used:
|
||||
//
|
||||
// * Access Key ID: AWS_ACCESS_KEY_ID or AWS_ACCESS_KEY
|
||||
//
|
||||
// * Secret Access Key: AWS_SECRET_ACCESS_KEY or AWS_SECRET_KEY
|
||||
type EnvProvider struct {
|
||||
retrieved bool
|
||||
|
|
2
vendor/github.com/aws/aws-sdk-go/aws/credentials/stscreds/assume_role_provider.go
generated
vendored
2
vendor/github.com/aws/aws-sdk-go/aws/credentials/stscreds/assume_role_provider.go
generated
vendored
|
@ -12,7 +12,7 @@ between multiple Credentials, Sessions or service clients.
|
|||
Assume Role
|
||||
|
||||
To assume an IAM role using STS with the SDK you can create a new Credentials
|
||||
with the SDKs's stscreds package.
|
||||
with the SDKs's stscreds package.
|
||||
|
||||
// Initial credentials loaded from SDK's default credential chain. Such as
|
||||
// the environment, shared credentials (~/.aws/credentials), or EC2 Instance
|
||||
|
|
|
@ -0,0 +1,56 @@
|
|||
// Package aws provides the core SDK's utilities and shared types. Use this package's
|
||||
// utilities to simplify setting and reading API operations parameters.
|
||||
//
|
||||
// Value and Pointer Conversion Utilities
|
||||
//
|
||||
// This package includes a helper conversion utility for each scalar type the SDK's
|
||||
// API use. These utilities make getting a pointer of the scalar, and dereferencing
|
||||
// a pointer easier.
|
||||
//
|
||||
// Each conversion utility comes in two forms. Value to Pointer and Pointer to Value.
|
||||
// The Pointer to value will safely dereference the pointer and return its value.
|
||||
// If the pointer was nil, the scalar's zero value will be returned.
|
||||
//
|
||||
// The value to pointer functions will be named after the scalar type. So get a
|
||||
// *string from a string value use the "String" function. This makes it easy to
|
||||
// to get pointer of a literal string value, because getting the address of a
|
||||
// literal requires assigning the value to a variable first.
|
||||
//
|
||||
// var strPtr *string
|
||||
//
|
||||
// // Without the SDK's conversion functions
|
||||
// str := "my string"
|
||||
// strPtr = &str
|
||||
//
|
||||
// // With the SDK's conversion functions
|
||||
// strPtr = aws.String("my string")
|
||||
//
|
||||
// // Convert *string to string value
|
||||
// str = aws.StringValue(strPtr)
|
||||
//
|
||||
// In addition to scalars the aws package also includes conversion utilities for
|
||||
// map and slice for commonly types used in API parameters. The map and slice
|
||||
// conversion functions use similar naming pattern as the scalar conversion
|
||||
// functions.
|
||||
//
|
||||
// var strPtrs []*string
|
||||
// var strs []string = []string{"Go", "Gophers", "Go"}
|
||||
//
|
||||
// // Convert []string to []*string
|
||||
// strPtrs = aws.StringSlice(strs)
|
||||
//
|
||||
// // Convert []*string to []string
|
||||
// strs = aws.StringValueSlice(strPtrs)
|
||||
//
|
||||
// SDK Default HTTP Client
|
||||
//
|
||||
// The SDK will use the http.DefaultClient if a HTTP client is not provided to
|
||||
// the SDK's Session, or service client constructor. This means that if the
|
||||
// http.DefaultClient is modified by other components of your application the
|
||||
// modifications will be picked up by the SDK as well.
|
||||
//
|
||||
// In some cases this might be intended, but it is a better practice to create
|
||||
// a custom HTTP Client to share explicitly through your application. You can
|
||||
// configure the SDK to use the custom HTTP Client by setting the HTTPClient
|
||||
// value of the SDK's Config type when creating a Session or service client.
|
||||
package aws
|
|
@ -60,6 +60,7 @@ const (
|
|||
CodecommitServiceID = "codecommit" // Codecommit.
|
||||
CodedeployServiceID = "codedeploy" // Codedeploy.
|
||||
CodepipelineServiceID = "codepipeline" // Codepipeline.
|
||||
CodestarServiceID = "codestar" // Codestar.
|
||||
CognitoIdentityServiceID = "cognito-identity" // CognitoIdentity.
|
||||
CognitoIdpServiceID = "cognito-idp" // CognitoIdp.
|
||||
CognitoSyncServiceID = "cognito-sync" // CognitoSync.
|
||||
|
@ -83,6 +84,7 @@ const (
|
|||
ElasticmapreduceServiceID = "elasticmapreduce" // Elasticmapreduce.
|
||||
ElastictranscoderServiceID = "elastictranscoder" // Elastictranscoder.
|
||||
EmailServiceID = "email" // Email.
|
||||
EntitlementMarketplaceServiceID = "entitlement.marketplace" // EntitlementMarketplace.
|
||||
EsServiceID = "es" // Es.
|
||||
EventsServiceID = "events" // Events.
|
||||
FirehoseServiceID = "firehose" // Firehose.
|
||||
|
@ -103,6 +105,7 @@ const (
|
|||
MarketplacecommerceanalyticsServiceID = "marketplacecommerceanalytics" // Marketplacecommerceanalytics.
|
||||
MeteringMarketplaceServiceID = "metering.marketplace" // MeteringMarketplace.
|
||||
MobileanalyticsServiceID = "mobileanalytics" // Mobileanalytics.
|
||||
ModelsLexServiceID = "models.lex" // ModelsLex.
|
||||
MonitoringServiceID = "monitoring" // Monitoring.
|
||||
MturkRequesterServiceID = "mturk-requester" // MturkRequester.
|
||||
OpsworksServiceID = "opsworks" // Opsworks.
|
||||
|
@ -350,6 +353,7 @@ var awsPartition = partition{
|
|||
"ap-southeast-1": endpoint{},
|
||||
"ap-southeast-2": endpoint{},
|
||||
"eu-west-1": endpoint{},
|
||||
"eu-west-2": endpoint{},
|
||||
"us-east-1": endpoint{},
|
||||
"us-east-2": endpoint{},
|
||||
"us-west-2": endpoint{},
|
||||
|
@ -492,11 +496,21 @@ var awsPartition = partition{
|
|||
"us-west-2": endpoint{},
|
||||
},
|
||||
},
|
||||
"codestar": service{
|
||||
|
||||
Endpoints: endpoints{
|
||||
"eu-west-1": endpoint{},
|
||||
"us-east-1": endpoint{},
|
||||
"us-east-2": endpoint{},
|
||||
"us-west-2": endpoint{},
|
||||
},
|
||||
},
|
||||
"cognito-identity": service{
|
||||
|
||||
Endpoints: endpoints{
|
||||
"ap-northeast-1": endpoint{},
|
||||
"ap-northeast-2": endpoint{},
|
||||
"ap-south-1": endpoint{},
|
||||
"ap-southeast-2": endpoint{},
|
||||
"eu-central-1": endpoint{},
|
||||
"eu-west-1": endpoint{},
|
||||
|
@ -511,6 +525,7 @@ var awsPartition = partition{
|
|||
Endpoints: endpoints{
|
||||
"ap-northeast-1": endpoint{},
|
||||
"ap-northeast-2": endpoint{},
|
||||
"ap-south-1": endpoint{},
|
||||
"ap-southeast-2": endpoint{},
|
||||
"eu-central-1": endpoint{},
|
||||
"eu-west-1": endpoint{},
|
||||
|
@ -525,6 +540,7 @@ var awsPartition = partition{
|
|||
Endpoints: endpoints{
|
||||
"ap-northeast-1": endpoint{},
|
||||
"ap-northeast-2": endpoint{},
|
||||
"ap-south-1": endpoint{},
|
||||
"ap-southeast-2": endpoint{},
|
||||
"eu-central-1": endpoint{},
|
||||
"eu-west-1": endpoint{},
|
||||
|
@ -839,6 +855,16 @@ var awsPartition = partition{
|
|||
"us-west-2": endpoint{},
|
||||
},
|
||||
},
|
||||
"entitlement.marketplace": service{
|
||||
Defaults: endpoint{
|
||||
CredentialScope: credentialScope{
|
||||
Service: "aws-marketplace",
|
||||
},
|
||||
},
|
||||
Endpoints: endpoints{
|
||||
"us-east-1": endpoint{},
|
||||
},
|
||||
},
|
||||
"es": service{
|
||||
|
||||
Endpoints: endpoints{
|
||||
|
@ -847,8 +873,10 @@ var awsPartition = partition{
|
|||
"ap-south-1": endpoint{},
|
||||
"ap-southeast-1": endpoint{},
|
||||
"ap-southeast-2": endpoint{},
|
||||
"ca-central-1": endpoint{},
|
||||
"eu-central-1": endpoint{},
|
||||
"eu-west-1": endpoint{},
|
||||
"eu-west-2": endpoint{},
|
||||
"sa-east-1": endpoint{},
|
||||
"us-east-1": endpoint{},
|
||||
"us-east-2": endpoint{},
|
||||
|
@ -1111,6 +1139,16 @@ var awsPartition = partition{
|
|||
"us-east-1": endpoint{},
|
||||
},
|
||||
},
|
||||
"models.lex": service{
|
||||
Defaults: endpoint{
|
||||
CredentialScope: credentialScope{
|
||||
Service: "lex",
|
||||
},
|
||||
},
|
||||
Endpoints: endpoints{
|
||||
"us-east-1": endpoint{},
|
||||
},
|
||||
},
|
||||
"monitoring": service{
|
||||
Defaults: endpoint{
|
||||
Protocols: []string{"http", "https"},
|
||||
|
@ -1477,6 +1515,7 @@ var awsPartition = partition{
|
|||
Endpoints: endpoints{
|
||||
"ap-northeast-1": endpoint{},
|
||||
"ap-northeast-2": endpoint{},
|
||||
"ap-south-1": endpoint{},
|
||||
"ap-southeast-1": endpoint{},
|
||||
"ap-southeast-2": endpoint{},
|
||||
"ca-central-1": endpoint{},
|
||||
|
|
|
@ -129,10 +129,10 @@ type EnumPartitions interface {
|
|||
// as the second parameter.
|
||||
//
|
||||
// This example shows how to get the regions for DynamoDB in the AWS partition.
|
||||
// rs := RegionsForService(endpoints.DefaultPartitions(), endpoints.AwsPartitionID, endpoints.DynamoDBServiceID)
|
||||
// rs, exists := endpoints.RegionsForService(endpoints.DefaultPartitions(), endpoints.AwsPartitionID, endpoints.DynamodbServiceID)
|
||||
//
|
||||
// This is equivalent to using the partition directly.
|
||||
// rs := endpoints.AwsPartition().Services()[endpoints.DynamoDBServiceID].Regions()
|
||||
// rs := endpoints.AwsPartition().Services()[endpoints.DynamodbServiceID].Regions()
|
||||
func RegionsForService(ps []Partition, partitionID, serviceID string) (map[string]Region, bool) {
|
||||
for _, p := range ps {
|
||||
if p.ID() != partitionID {
|
||||
|
|
|
@ -4,7 +4,8 @@ package aws
|
|||
// into a json string. This type can be used just like any other map.
|
||||
//
|
||||
// Example:
|
||||
// values := JSONValue{
|
||||
//
|
||||
// values := aws.JSONValue{
|
||||
// "Foo": "Bar",
|
||||
// }
|
||||
// values["Baz"] = "Qux"
|
||||
|
|
|
@ -66,8 +66,8 @@ func WithWaiterRequestOptions(opts ...Option) WaiterOption {
|
|||
}
|
||||
}
|
||||
|
||||
// A Waiter provides the functionality to performing blocking call which will
|
||||
// wait for an resource state to be satisfied a service.
|
||||
// A Waiter provides the functionality to perform a blocking call which will
|
||||
// wait for a resource state to be satisfied by a service.
|
||||
//
|
||||
// This type should not be used directly. The API operations provided in the
|
||||
// service packages prefixed with "WaitUntil" should be used instead.
|
||||
|
|
|
@ -124,9 +124,8 @@ file (~/.aws/config) and shared credentials file (~/.aws/credentials). Both
|
|||
files have the same format.
|
||||
|
||||
If both config files are present the configuration from both files will be
|
||||
read. The Session will be created from configuration values from the shared
|
||||
credentials file (~/.aws/credentials) over those in the shared credentials
|
||||
file (~/.aws/config).
|
||||
read. The Session will be created from configuration values from the shared
|
||||
credentials file (~/.aws/credentials) over those in the shared config file (~/.aws/config).
|
||||
|
||||
Credentials are the values the SDK should use for authenticating requests with
|
||||
AWS Services. They arfrom a configuration file will need to include both
|
||||
|
|
|
@ -218,7 +218,7 @@ type Options struct {
|
|||
//
|
||||
// // Force enable Shared Config support
|
||||
// sess := session.Must(session.NewSessionWithOptions(session.Options{
|
||||
// SharedConfigState: SharedConfigEnable,
|
||||
// SharedConfigState: session.SharedConfigEnable,
|
||||
// }))
|
||||
func NewSessionWithOptions(opts Options) (*Session, error) {
|
||||
var envCfg envConfig
|
||||
|
|
|
@ -5,4 +5,4 @@ package aws
|
|||
const SDKName = "aws-sdk-go"
|
||||
|
||||
// SDKVersion is the version of this SDK
|
||||
const SDKVersion = "1.8.16"
|
||||
const SDKVersion = "1.8.21"
|
||||
|
|
|
@ -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(ednpoints.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
|
|
@ -131,7 +131,6 @@ func (b *xmlBuilder) buildStruct(value reflect.Value, current *XMLNode, tag refl
|
|||
continue
|
||||
}
|
||||
|
||||
|
||||
mTag := field.Tag
|
||||
if mTag.Get("location") != "" { // skip non-body members
|
||||
continue
|
||||
|
|
|
@ -1,7 +0,0 @@
|
|||
// Package sdk is the official AWS SDK for the Go programming language.
|
||||
//
|
||||
// See our Developer Guide for information for on getting started and using
|
||||
// the SDK.
|
||||
//
|
||||
// https://github.com/aws/aws-sdk-go/wiki
|
||||
package sdk
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package acm provides a client for AWS Certificate Manager.
|
||||
package acm
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,84 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package acm provides the client and types for making API
|
||||
// requests to AWS Certificate Manager.
|
||||
//
|
||||
// Welcome to the AWS Certificate Manager (ACM) API documentation.
|
||||
//
|
||||
// You can use ACM to manage SSL/TLS certificates for your AWS-based websites
|
||||
// and applications. For general information about using ACM, see the AWS Certificate
|
||||
// Manager User Guide (http://docs.aws.amazon.com/acm/latest/userguide/).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/acm-2015-12-08 for more information on this service.
|
||||
//
|
||||
// See acm package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/acm/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS Certificate Manager you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := acm.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS Certificate Manager client ACM for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/acm/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AddTagsToCertificate(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AddTagsToCertificate result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AddTagsToCertificateWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package acm
|
|
@ -11,14 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Welcome to the AWS Certificate Manager (ACM) API documentation.
|
||||
// ACM provides the API operation methods for making requests to
|
||||
// AWS Certificate Manager. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// You can use ACM to manage SSL/TLS certificates for your AWS-based websites
|
||||
// and applications. For general information about using ACM, see the AWS Certificate
|
||||
// Manager User Guide (http://docs.aws.amazon.com/acm/latest/userguide/).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/acm-2015-12-08
|
||||
// ACM methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ACM struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package apigateway provides a client for Amazon API Gateway.
|
||||
package apigateway
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,82 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package apigateway provides the client and types for making API
|
||||
// requests to Amazon API Gateway.
|
||||
//
|
||||
// Amazon API Gateway helps developers deliver robust, secure, and scalable
|
||||
// mobile and web application back ends. Amazon API Gateway allows developers
|
||||
// to securely connect mobile and web applications to APIs that run on AWS Lambda,
|
||||
// Amazon EC2, or other publicly addressable web services that are hosted outside
|
||||
// of AWS.
|
||||
//
|
||||
// See apigateway package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/apigateway/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon API Gateway you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := apigateway.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon API Gateway client APIGateway for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/apigateway/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CreateApiKey(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CreateApiKey result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CreateApiKeyWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package apigateway
|
|
@ -11,13 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/restjson"
|
||||
)
|
||||
|
||||
// Amazon API Gateway helps developers deliver robust, secure, and scalable
|
||||
// mobile and web application back ends. Amazon API Gateway allows developers
|
||||
// to securely connect mobile and web applications to APIs that run on AWS Lambda,
|
||||
// Amazon EC2, or other publicly addressable web services that are hosted outside
|
||||
// of AWS.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// APIGateway provides the API operation methods for making requests to
|
||||
// Amazon API Gateway. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// APIGateway methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type APIGateway struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package applicationautoscaling provides a client for Application Auto Scaling.
|
||||
package applicationautoscaling
|
||||
|
||||
import (
|
||||
|
|
110
vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/doc.go
generated
vendored
Normal file
110
vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/doc.go
generated
vendored
Normal file
|
@ -0,0 +1,110 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package applicationautoscaling provides the client and types for making API
|
||||
// requests to Application Auto Scaling.
|
||||
//
|
||||
// With Application Auto Scaling, you can automatically scale your AWS resources.
|
||||
// The experience similar to that of Auto Scaling (https://aws.amazon.com/autoscaling/).
|
||||
// You can use Application Auto Scaling to accomplish the following tasks:
|
||||
//
|
||||
// * Define scaling policies to automatically scale your AWS resources
|
||||
//
|
||||
// * Scale your resources in response to CloudWatch alarms
|
||||
//
|
||||
// * View the history of your scaling events
|
||||
//
|
||||
// Application Auto Scaling can scale the following AWS resources:
|
||||
//
|
||||
// * Amazon ECS services. For more information, see Service Auto Scaling
|
||||
// (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-auto-scaling.html)
|
||||
// in the Amazon EC2 Container Service Developer Guide.
|
||||
//
|
||||
// * Amazon EC2 Spot fleets. For more information, see Automatic Scaling
|
||||
// for Spot Fleet (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/fleet-auto-scaling.html)
|
||||
// in the Amazon EC2 User Guide.
|
||||
//
|
||||
// * Amazon EMR clusters. For more information, see Using Automatic Scaling
|
||||
// in Amazon EMR (http://docs.aws.amazon.com/ElasticMapReduce/latest/ManagementGuide/emr-automatic-scaling.html)
|
||||
// in the Amazon EMR Management Guide.
|
||||
//
|
||||
// * AppStream 2.0 fleets. For more information, see Autoscaling Amazon AppStream
|
||||
// 2.0 Resources (http://docs.aws.amazon.com/appstream2/latest/developerguide/autoscaling.html)
|
||||
// in the Amazon AppStream 2.0 Developer Guide.
|
||||
//
|
||||
// For a list of supported regions, see AWS Regions and Endpoints: Application
|
||||
// Auto Scaling (http://docs.aws.amazon.com/general/latest/gr/rande.html#as-app_region)
|
||||
// in the AWS General Reference.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/application-autoscaling-2016-02-06 for more information on this service.
|
||||
//
|
||||
// See applicationautoscaling package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/applicationautoscaling/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Application Auto Scaling you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := applicationautoscaling.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Application Auto Scaling client ApplicationAutoScaling for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/applicationautoscaling/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.DeleteScalingPolicy(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("DeleteScalingPolicy result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.DeleteScalingPolicyWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package applicationautoscaling
|
|
@ -11,40 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// With Application Auto Scaling, you can automatically scale your AWS resources.
|
||||
// The experience similar to that of Auto Scaling (https://aws.amazon.com/autoscaling/).
|
||||
// You can use Application Auto Scaling to accomplish the following tasks:
|
||||
// ApplicationAutoScaling provides the API operation methods for making requests to
|
||||
// Application Auto Scaling. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// * Define scaling policies to automatically scale your AWS resources
|
||||
//
|
||||
// * Scale your resources in response to CloudWatch alarms
|
||||
//
|
||||
// * View the history of your scaling events
|
||||
//
|
||||
// Application Auto Scaling can scale the following AWS resources:
|
||||
//
|
||||
// * Amazon ECS services. For more information, see Service Auto Scaling
|
||||
// (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-auto-scaling.html)
|
||||
// in the Amazon EC2 Container Service Developer Guide.
|
||||
//
|
||||
// * Amazon EC2 Spot fleets. For more information, see Automatic Scaling
|
||||
// for Spot Fleet (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/fleet-auto-scaling.html)
|
||||
// in the Amazon EC2 User Guide.
|
||||
//
|
||||
// * Amazon EMR clusters. For more information, see Using Automatic Scaling
|
||||
// in Amazon EMR (http://docs.aws.amazon.com/ElasticMapReduce/latest/ManagementGuide/emr-automatic-scaling.html)
|
||||
// in the Amazon EMR Management Guide.
|
||||
//
|
||||
// * AppStream 2.0 fleets. For more information, see Autoscaling Amazon AppStream
|
||||
// 2.0 Resources (http://docs.aws.amazon.com/appstream2/latest/developerguide/autoscaling.html)
|
||||
// in the Amazon AppStream 2.0 Developer Guide.
|
||||
//
|
||||
// For a list of supported regions, see AWS Regions and Endpoints: Application
|
||||
// Auto Scaling (http://docs.aws.amazon.com/general/latest/gr/rande.html#as-app_region)
|
||||
// in the AWS General Reference.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/application-autoscaling-2016-02-06
|
||||
// ApplicationAutoScaling methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ApplicationAutoScaling struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package autoscaling provides a client for Auto Scaling.
|
||||
package autoscaling
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,82 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package autoscaling provides the client and types for making API
|
||||
// requests to Auto Scaling.
|
||||
//
|
||||
// Auto Scaling is designed to automatically launch or terminate EC2 instances
|
||||
// based on user-defined policies, schedules, and health checks. Use this service
|
||||
// in conjunction with the Amazon CloudWatch and Elastic Load Balancing services.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01 for more information on this service.
|
||||
//
|
||||
// See autoscaling package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/autoscaling/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Auto Scaling you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := autoscaling.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Auto Scaling client AutoScaling for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/autoscaling/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AttachInstances(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AttachInstances result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AttachInstancesWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package autoscaling
|
|
@ -11,12 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/query"
|
||||
)
|
||||
|
||||
// Auto Scaling is designed to automatically launch or terminate EC2 instances
|
||||
// based on user-defined policies, schedules, and health checks. Use this service
|
||||
// in conjunction with the Amazon CloudWatch and Elastic Load Balancing services.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01
|
||||
// AutoScaling provides the API operation methods for making requests to
|
||||
// Auto Scaling. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// AutoScaling methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type AutoScaling struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudformation provides a client for AWS CloudFormation.
|
||||
package cloudformation
|
||||
|
||||
import (
|
||||
|
@ -71,6 +70,11 @@ func (c *CloudFormation) CancelUpdateStackRequest(input *CancelUpdateStackInput)
|
|||
//
|
||||
// See the AWS API reference guide for AWS CloudFormation's
|
||||
// API operation CancelUpdateStack for usage and error information.
|
||||
//
|
||||
// Returned Error Codes:
|
||||
// * ErrCodeTokenAlreadyExistsException "TokenAlreadyExistsException"
|
||||
// A client request token already exists.
|
||||
//
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CancelUpdateStack
|
||||
func (c *CloudFormation) CancelUpdateStack(input *CancelUpdateStackInput) (*CancelUpdateStackOutput, error) {
|
||||
req, out := c.CancelUpdateStackRequest(input)
|
||||
|
@ -158,6 +162,11 @@ func (c *CloudFormation) ContinueUpdateRollbackRequest(input *ContinueUpdateRoll
|
|||
//
|
||||
// See the AWS API reference guide for AWS CloudFormation's
|
||||
// API operation ContinueUpdateRollback for usage and error information.
|
||||
//
|
||||
// Returned Error Codes:
|
||||
// * ErrCodeTokenAlreadyExistsException "TokenAlreadyExistsException"
|
||||
// A client request token already exists.
|
||||
//
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ContinueUpdateRollback
|
||||
func (c *CloudFormation) ContinueUpdateRollback(input *ContinueUpdateRollbackInput) (*ContinueUpdateRollbackOutput, error) {
|
||||
req, out := c.ContinueUpdateRollbackRequest(input)
|
||||
|
@ -225,21 +234,28 @@ func (c *CloudFormation) CreateChangeSetRequest(input *CreateChangeSetInput) (re
|
|||
|
||||
// CreateChangeSet API operation for AWS CloudFormation.
|
||||
//
|
||||
// Creates a list of changes for a stack. AWS CloudFormation generates the change
|
||||
// set by comparing the template's information with the information that you
|
||||
// submit. A change set can help you understand which resources AWS CloudFormation
|
||||
// will change, and how it will change them, before you update your stack. Change
|
||||
// sets allow you to check before making a change to avoid deleting or replacing
|
||||
// critical resources.
|
||||
// Creates a list of changes that will be applied to a stack so that you can
|
||||
// review the changes before executing them. You can create a change set for
|
||||
// a stack that doesn't exist or an existing stack. If you create a change set
|
||||
// for a stack that doesn't exist, the change set shows all of the resources
|
||||
// that AWS CloudFormation will create. If you create a change set for an existing
|
||||
// stack, AWS CloudFormation compares the stack's information with the information
|
||||
// that you submit in the change set and lists the differences. Use change sets
|
||||
// to understand which resources AWS CloudFormation will create or change, and
|
||||
// how it will change resources in an existing stack, before you create or update
|
||||
// a stack.
|
||||
//
|
||||
// AWS CloudFormation doesn't make any changes to the stack when you create
|
||||
// a change set. To make the specified changes, you must execute the change
|
||||
// set by using the ExecuteChangeSet action.
|
||||
//
|
||||
// After the call successfully completes, AWS CloudFormation starts creating
|
||||
// the change set. To check the status of the change set, use the DescribeChangeSet
|
||||
// To create a change set for a stack that doesn't exist, for the ChangeSetType
|
||||
// parameter, specify CREATE. To create a change set for an existing stack,
|
||||
// specify UPDATE for the ChangeSetType parameter. After the CreateChangeSet
|
||||
// call successfully completes, AWS CloudFormation starts creating the change
|
||||
// set. To check the status of the change set or to review it, use the DescribeChangeSet
|
||||
// action.
|
||||
//
|
||||
// When you are satisfied with the changes the change set will make, execute
|
||||
// the change set by using the ExecuteChangeSet action. AWS CloudFormation doesn't
|
||||
// make changes until you execute the change set.
|
||||
//
|
||||
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
|
||||
// with awserr.Error's Code and Message methods to get detailed information about
|
||||
// the error.
|
||||
|
@ -343,6 +359,9 @@ func (c *CloudFormation) CreateStackRequest(input *CreateStackInput) (req *reque
|
|||
// * ErrCodeAlreadyExistsException "AlreadyExistsException"
|
||||
// Resource with the name requested already exists.
|
||||
//
|
||||
// * ErrCodeTokenAlreadyExistsException "TokenAlreadyExistsException"
|
||||
// A client request token already exists.
|
||||
//
|
||||
// * ErrCodeInsufficientCapabilitiesException "InsufficientCapabilitiesException"
|
||||
// The template contains resources with capabilities that were not specified
|
||||
// in the Capabilities parameter.
|
||||
|
@ -512,6 +531,11 @@ func (c *CloudFormation) DeleteStackRequest(input *DeleteStackInput) (req *reque
|
|||
//
|
||||
// See the AWS API reference guide for AWS CloudFormation's
|
||||
// API operation DeleteStack for usage and error information.
|
||||
//
|
||||
// Returned Error Codes:
|
||||
// * ErrCodeTokenAlreadyExistsException "TokenAlreadyExistsException"
|
||||
// A client request token already exists.
|
||||
//
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DeleteStack
|
||||
func (c *CloudFormation) DeleteStack(input *DeleteStackInput) (*DeleteStackOutput, error) {
|
||||
req, out := c.DeleteStackRequest(input)
|
||||
|
@ -1290,6 +1314,9 @@ func (c *CloudFormation) ExecuteChangeSetRequest(input *ExecuteChangeSetInput) (
|
|||
// The template contains resources with capabilities that were not specified
|
||||
// in the Capabilities parameter.
|
||||
//
|
||||
// * ErrCodeTokenAlreadyExistsException "TokenAlreadyExistsException"
|
||||
// A client request token already exists.
|
||||
//
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ExecuteChangeSet
|
||||
func (c *CloudFormation) ExecuteChangeSet(input *ExecuteChangeSetInput) (*ExecuteChangeSetOutput, error) {
|
||||
req, out := c.ExecuteChangeSetRequest(input)
|
||||
|
@ -2405,6 +2432,9 @@ func (c *CloudFormation) UpdateStackRequest(input *UpdateStackInput) (req *reque
|
|||
// The template contains resources with capabilities that were not specified
|
||||
// in the Capabilities parameter.
|
||||
//
|
||||
// * ErrCodeTokenAlreadyExistsException "TokenAlreadyExistsException"
|
||||
// A client request token already exists.
|
||||
//
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/UpdateStack
|
||||
func (c *CloudFormation) UpdateStack(input *UpdateStackInput) (*UpdateStackOutput, error) {
|
||||
req, out := c.UpdateStackRequest(input)
|
||||
|
@ -2544,6 +2574,13 @@ func (s *AccountLimit) SetValue(v int64) *AccountLimit {
|
|||
type CancelUpdateStackInput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// A unique identifier for this CancelUpdateStack request. Specify this token
|
||||
// if you plan to retry requests so that AWS CloudFormation knows that you're
|
||||
// not attempting to cancel an update on a stack with the same name. You might
|
||||
// retry CancelUpdateStack requests to ensure that AWS CloudFormation successfully
|
||||
// received them.
|
||||
ClientRequestToken *string `min:"1" type:"string"`
|
||||
|
||||
// The name or the unique stack ID that is associated with the stack.
|
||||
//
|
||||
// StackName is a required field
|
||||
|
@ -2563,6 +2600,9 @@ func (s CancelUpdateStackInput) GoString() string {
|
|||
// Validate inspects the fields of the type to determine if they are valid.
|
||||
func (s *CancelUpdateStackInput) Validate() error {
|
||||
invalidParams := request.ErrInvalidParams{Context: "CancelUpdateStackInput"}
|
||||
if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 1))
|
||||
}
|
||||
if s.StackName == nil {
|
||||
invalidParams.Add(request.NewErrParamRequired("StackName"))
|
||||
}
|
||||
|
@ -2573,6 +2613,12 @@ func (s *CancelUpdateStackInput) Validate() error {
|
|||
return nil
|
||||
}
|
||||
|
||||
// SetClientRequestToken sets the ClientRequestToken field's value.
|
||||
func (s *CancelUpdateStackInput) SetClientRequestToken(v string) *CancelUpdateStackInput {
|
||||
s.ClientRequestToken = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetStackName sets the StackName field's value.
|
||||
func (s *CancelUpdateStackInput) SetStackName(v string) *CancelUpdateStackInput {
|
||||
s.StackName = &v
|
||||
|
@ -2740,6 +2786,13 @@ func (s *ChangeSetSummary) SetStatusReason(v string) *ChangeSetSummary {
|
|||
type ContinueUpdateRollbackInput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// A unique identifier for this ContinueUpdateRollback request. Specify this
|
||||
// token if you plan to retry requests so that AWS CloudFormation knows that
|
||||
// you're not attempting to continue the rollback to a stack with the same name.
|
||||
// You might retry ContinueUpdateRollback requests to ensure that AWS CloudFormation
|
||||
// successfully received them.
|
||||
ClientRequestToken *string `min:"1" type:"string"`
|
||||
|
||||
// A list of the logical IDs of the resources that AWS CloudFormation skips
|
||||
// during the continue update rollback operation. You can specify only resources
|
||||
// that are in the UPDATE_FAILED state because a rollback failed. You can't
|
||||
|
@ -2763,9 +2816,9 @@ type ContinueUpdateRollbackInput struct {
|
|||
// to fail. In this case, it might not be necessary to skip the dependent resources.
|
||||
//
|
||||
// To specify resources in a nested stack, use the following format: NestedStackName.ResourceLogicalID.
|
||||
// You can specify a nested stack resource (the logical ID of an AWS::CloudFormation::Stack
|
||||
// resource) only if it's in one of the following states: DELETE_IN_PROGRESS,
|
||||
// DELETE_COMPLETE, or DELETE_FAILED.
|
||||
// If the ResourceLogicalID is a stack resource (Type: AWS::CloudFormation::Stack),
|
||||
// it must be in one of the following states: DELETE_IN_PROGRESS, DELETE_COMPLETE,
|
||||
// or DELETE_FAILED.
|
||||
ResourcesToSkip []*string `type:"list"`
|
||||
|
||||
// The Amazon Resource Name (ARN) of an AWS Identity and Access Management (IAM)
|
||||
|
@ -2806,6 +2859,9 @@ func (s ContinueUpdateRollbackInput) GoString() string {
|
|||
// Validate inspects the fields of the type to determine if they are valid.
|
||||
func (s *ContinueUpdateRollbackInput) Validate() error {
|
||||
invalidParams := request.ErrInvalidParams{Context: "ContinueUpdateRollbackInput"}
|
||||
if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 1))
|
||||
}
|
||||
if s.RoleARN != nil && len(*s.RoleARN) < 20 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("RoleARN", 20))
|
||||
}
|
||||
|
@ -2822,6 +2878,12 @@ func (s *ContinueUpdateRollbackInput) Validate() error {
|
|||
return nil
|
||||
}
|
||||
|
||||
// SetClientRequestToken sets the ClientRequestToken field's value.
|
||||
func (s *ContinueUpdateRollbackInput) SetClientRequestToken(v string) *ContinueUpdateRollbackInput {
|
||||
s.ClientRequestToken = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetResourcesToSkip sets the ResourcesToSkip field's value.
|
||||
func (s *ContinueUpdateRollbackInput) SetResourcesToSkip(v []*string) *ContinueUpdateRollbackInput {
|
||||
s.ResourcesToSkip = v
|
||||
|
@ -3184,6 +3246,12 @@ type CreateStackInput struct {
|
|||
// Templates (http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities).
|
||||
Capabilities []*string `type:"list"`
|
||||
|
||||
// A unique identifier for this CreateStack request. Specify this token if you
|
||||
// plan to retry requests so that AWS CloudFormation knows that you're not attempting
|
||||
// to create a stack with the same name. You might retry CreateStack requests
|
||||
// to ensure that AWS CloudFormation successfully received them.
|
||||
ClientRequestToken *string `min:"1" type:"string"`
|
||||
|
||||
// Set to true to disable rollback of the stack if stack creation failed. You
|
||||
// can specify either DisableRollback or OnFailure, but not both.
|
||||
//
|
||||
|
@ -3191,8 +3259,8 @@ type CreateStackInput struct {
|
|||
DisableRollback *bool `type:"boolean"`
|
||||
|
||||
// The Simple Notification Service (SNS) topic ARNs to publish stack related
|
||||
// events. You can find your SNS topic ARNs using the SNS console (https://console.aws.amazon.com/sns)
|
||||
// or your Command Line Interface (CLI).
|
||||
// events. You can find your SNS topic ARNs using the SNS console or your Command
|
||||
// Line Interface (CLI).
|
||||
NotificationARNs []*string `type:"list"`
|
||||
|
||||
// Determines what action will be taken if stack creation fails. This must be
|
||||
|
@ -3300,6 +3368,9 @@ func (s CreateStackInput) GoString() string {
|
|||
// Validate inspects the fields of the type to determine if they are valid.
|
||||
func (s *CreateStackInput) Validate() error {
|
||||
invalidParams := request.ErrInvalidParams{Context: "CreateStackInput"}
|
||||
if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 1))
|
||||
}
|
||||
if s.RoleARN != nil && len(*s.RoleARN) < 20 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("RoleARN", 20))
|
||||
}
|
||||
|
@ -3334,6 +3405,12 @@ func (s *CreateStackInput) SetCapabilities(v []*string) *CreateStackInput {
|
|||
return s
|
||||
}
|
||||
|
||||
// SetClientRequestToken sets the ClientRequestToken field's value.
|
||||
func (s *CreateStackInput) SetClientRequestToken(v string) *CreateStackInput {
|
||||
s.ClientRequestToken = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetDisableRollback sets the DisableRollback field's value.
|
||||
func (s *CreateStackInput) SetDisableRollback(v bool) *CreateStackInput {
|
||||
s.DisableRollback = &v
|
||||
|
@ -3515,6 +3592,12 @@ func (s DeleteChangeSetOutput) GoString() string {
|
|||
type DeleteStackInput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// A unique identifier for this DeleteStack request. Specify this token if you
|
||||
// plan to retry requests so that AWS CloudFormation knows that you're not attempting
|
||||
// to delete a stack with the same name. You might retry DeleteStack requests
|
||||
// to ensure that AWS CloudFormation successfully received them.
|
||||
ClientRequestToken *string `min:"1" type:"string"`
|
||||
|
||||
// For stacks in the DELETE_FAILED state, a list of resource logical IDs that
|
||||
// are associated with the resources you want to retain. During deletion, AWS
|
||||
// CloudFormation deletes the stack but does not delete the retained resources.
|
||||
|
@ -3551,6 +3634,9 @@ func (s DeleteStackInput) GoString() string {
|
|||
// Validate inspects the fields of the type to determine if they are valid.
|
||||
func (s *DeleteStackInput) Validate() error {
|
||||
invalidParams := request.ErrInvalidParams{Context: "DeleteStackInput"}
|
||||
if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 1))
|
||||
}
|
||||
if s.RoleARN != nil && len(*s.RoleARN) < 20 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("RoleARN", 20))
|
||||
}
|
||||
|
@ -3564,6 +3650,12 @@ func (s *DeleteStackInput) Validate() error {
|
|||
return nil
|
||||
}
|
||||
|
||||
// SetClientRequestToken sets the ClientRequestToken field's value.
|
||||
func (s *DeleteStackInput) SetClientRequestToken(v string) *DeleteStackInput {
|
||||
s.ClientRequestToken = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetRetainResources sets the RetainResources field's value.
|
||||
func (s *DeleteStackInput) SetRetainResources(v []*string) *DeleteStackInput {
|
||||
s.RetainResources = v
|
||||
|
@ -4376,6 +4468,13 @@ type ExecuteChangeSetInput struct {
|
|||
// ChangeSetName is a required field
|
||||
ChangeSetName *string `min:"1" type:"string" required:"true"`
|
||||
|
||||
// A unique identifier for this ExecuteChangeSet request. Specify this token
|
||||
// if you plan to retry requests so that AWS CloudFormation knows that you're
|
||||
// not attempting to execute a change set to update a stack with the same name.
|
||||
// You might retry ExecuteChangeSet requests to ensure that AWS CloudFormation
|
||||
// successfully received them.
|
||||
ClientRequestToken *string `min:"1" type:"string"`
|
||||
|
||||
// If you specified the name of a change set, specify the stack name or ID (ARN)
|
||||
// that is associated with the change set you want to execute.
|
||||
StackName *string `min:"1" type:"string"`
|
||||
|
@ -4400,6 +4499,9 @@ func (s *ExecuteChangeSetInput) Validate() error {
|
|||
if s.ChangeSetName != nil && len(*s.ChangeSetName) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("ChangeSetName", 1))
|
||||
}
|
||||
if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 1))
|
||||
}
|
||||
if s.StackName != nil && len(*s.StackName) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("StackName", 1))
|
||||
}
|
||||
|
@ -4416,6 +4518,12 @@ func (s *ExecuteChangeSetInput) SetChangeSetName(v string) *ExecuteChangeSetInpu
|
|||
return s
|
||||
}
|
||||
|
||||
// SetClientRequestToken sets the ClientRequestToken field's value.
|
||||
func (s *ExecuteChangeSetInput) SetClientRequestToken(v string) *ExecuteChangeSetInput {
|
||||
s.ClientRequestToken = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetStackName sets the StackName field's value.
|
||||
func (s *ExecuteChangeSetInput) SetStackName(v string) *ExecuteChangeSetInput {
|
||||
s.StackName = &v
|
||||
|
@ -6077,6 +6185,13 @@ func (s *Stack) SetTimeoutInMinutes(v int64) *Stack {
|
|||
type StackEvent struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// The token passed to the operation that generated this event.
|
||||
//
|
||||
// For example, if you execute a CreateStack operation with the token token1,
|
||||
// then all the StackEvents generated by that operation will have ClientRequestToken
|
||||
// set as token1.
|
||||
ClientRequestToken *string `min:"1" type:"string"`
|
||||
|
||||
// The unique ID of this event.
|
||||
//
|
||||
// EventId is a required field
|
||||
|
@ -6129,6 +6244,12 @@ func (s StackEvent) GoString() string {
|
|||
return s.String()
|
||||
}
|
||||
|
||||
// SetClientRequestToken sets the ClientRequestToken field's value.
|
||||
func (s *StackEvent) SetClientRequestToken(v string) *StackEvent {
|
||||
s.ClientRequestToken = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetEventId sets the EventId field's value.
|
||||
func (s *StackEvent) SetEventId(v string) *StackEvent {
|
||||
s.EventId = &v
|
||||
|
@ -6714,6 +6835,12 @@ type UpdateStackInput struct {
|
|||
// Templates (http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities).
|
||||
Capabilities []*string `type:"list"`
|
||||
|
||||
// A unique identifier for this UpdateStack request. Specify this token if you
|
||||
// plan to retry requests so that AWS CloudFormation knows that you're not attempting
|
||||
// to update a stack with the same name. You might retry UpdateStack requests
|
||||
// to ensure that AWS CloudFormation successfully received them.
|
||||
ClientRequestToken *string `min:"1" type:"string"`
|
||||
|
||||
// Amazon Simple Notification Service topic Amazon Resource Names (ARNs) that
|
||||
// AWS CloudFormation associates with the stack. Specify an empty list to remove
|
||||
// all notification topics.
|
||||
|
@ -6804,8 +6931,8 @@ type UpdateStackInput struct {
|
|||
// (http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html)
|
||||
// in the AWS CloudFormation User Guide.)
|
||||
//
|
||||
// Conditional: You must specify either the TemplateBody or the TemplateURL
|
||||
// parameter, but not both.
|
||||
// Conditional: You must specify only one of the following parameters: TemplateBody,
|
||||
// TemplateURL, or set the UsePreviousTemplate to true.
|
||||
TemplateBody *string `min:"1" type:"string"`
|
||||
|
||||
// Location of file containing the template body. The URL must point to a template
|
||||
|
@ -6813,12 +6940,15 @@ type UpdateStackInput struct {
|
|||
// Anatomy (http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html)
|
||||
// in the AWS CloudFormation User Guide.
|
||||
//
|
||||
// Conditional: You must specify either the TemplateBody or the TemplateURL
|
||||
// parameter, but not both.
|
||||
// Conditional: You must specify only one of the following parameters: TemplateBody,
|
||||
// TemplateURL, or set the UsePreviousTemplate to true.
|
||||
TemplateURL *string `min:"1" type:"string"`
|
||||
|
||||
// Reuse the existing template that is associated with the stack that you are
|
||||
// updating.
|
||||
//
|
||||
// Conditional: You must specify only one of the following parameters: TemplateBody,
|
||||
// TemplateURL, or set the UsePreviousTemplate to true.
|
||||
UsePreviousTemplate *bool `type:"boolean"`
|
||||
}
|
||||
|
||||
|
@ -6835,6 +6965,9 @@ func (s UpdateStackInput) GoString() string {
|
|||
// Validate inspects the fields of the type to determine if they are valid.
|
||||
func (s *UpdateStackInput) Validate() error {
|
||||
invalidParams := request.ErrInvalidParams{Context: "UpdateStackInput"}
|
||||
if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 1 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 1))
|
||||
}
|
||||
if s.RoleARN != nil && len(*s.RoleARN) < 20 {
|
||||
invalidParams.Add(request.NewErrParamMinLen("RoleARN", 20))
|
||||
}
|
||||
|
@ -6872,6 +7005,12 @@ func (s *UpdateStackInput) SetCapabilities(v []*string) *UpdateStackInput {
|
|||
return s
|
||||
}
|
||||
|
||||
// SetClientRequestToken sets the ClientRequestToken field's value.
|
||||
func (s *UpdateStackInput) SetClientRequestToken(v string) *UpdateStackInput {
|
||||
s.ClientRequestToken = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetNotificationARNs sets the NotificationARNs field's value.
|
||||
func (s *UpdateStackInput) SetNotificationARNs(v []*string) *UpdateStackInput {
|
||||
s.NotificationARNs = v
|
||||
|
|
|
@ -0,0 +1,98 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudformation provides the client and types for making API
|
||||
// requests to AWS CloudFormation.
|
||||
//
|
||||
// AWS CloudFormation allows you to create and manage AWS infrastructure deployments
|
||||
// predictably and repeatedly. You can use AWS CloudFormation to leverage AWS
|
||||
// products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store,
|
||||
// Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling
|
||||
// to build highly-reliable, highly scalable, cost-effective applications without
|
||||
// creating or configuring the underlying AWS infrastructure.
|
||||
//
|
||||
// With AWS CloudFormation, you declare all of your resources and dependencies
|
||||
// in a template file. The template defines a collection of resources as a single
|
||||
// unit called a stack. AWS CloudFormation creates and deletes all member resources
|
||||
// of the stack together and manages all dependencies between the resources
|
||||
// for you.
|
||||
//
|
||||
// For more information about AWS CloudFormation, see the AWS CloudFormation
|
||||
// Product Page (http://aws.amazon.com/cloudformation/).
|
||||
//
|
||||
// Amazon CloudFormation makes use of other AWS products. If you need additional
|
||||
// technical information about a specific AWS product, you can find the product's
|
||||
// technical documentation at docs.aws.amazon.com (http://docs.aws.amazon.com/).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15 for more information on this service.
|
||||
//
|
||||
// See cloudformation package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudformation/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS CloudFormation you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := cloudformation.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS CloudFormation client CloudFormation for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudformation/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CancelUpdateStack(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CancelUpdateStack result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CancelUpdateStackWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package cloudformation
|
|
@ -37,4 +37,10 @@ const (
|
|||
//
|
||||
// Quota for the resource has already been reached.
|
||||
ErrCodeLimitExceededException = "LimitExceededException"
|
||||
|
||||
// ErrCodeTokenAlreadyExistsException for service response error code
|
||||
// "TokenAlreadyExistsException".
|
||||
//
|
||||
// A client request token already exists.
|
||||
ErrCodeTokenAlreadyExistsException = "TokenAlreadyExistsException"
|
||||
)
|
||||
|
|
|
@ -11,28 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/query"
|
||||
)
|
||||
|
||||
// AWS CloudFormation allows you to create and manage AWS infrastructure deployments
|
||||
// predictably and repeatedly. You can use AWS CloudFormation to leverage AWS
|
||||
// products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store,
|
||||
// Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling
|
||||
// to build highly-reliable, highly scalable, cost-effective applications without
|
||||
// creating or configuring the underlying AWS infrastructure.
|
||||
// CloudFormation provides the API operation methods for making requests to
|
||||
// AWS CloudFormation. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// With AWS CloudFormation, you declare all of your resources and dependencies
|
||||
// in a template file. The template defines a collection of resources as a single
|
||||
// unit called a stack. AWS CloudFormation creates and deletes all member resources
|
||||
// of the stack together and manages all dependencies between the resources
|
||||
// for you.
|
||||
//
|
||||
// For more information about AWS CloudFormation, see the AWS CloudFormation
|
||||
// Product Page (http://aws.amazon.com/cloudformation/).
|
||||
//
|
||||
// Amazon CloudFormation makes use of other AWS products. For additional technical
|
||||
// information about a specific AWS product, see its technical documentation
|
||||
// (http://docs.aws.amazon.com/).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15
|
||||
// CloudFormation methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CloudFormation struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudfront provides a client for Amazon CloudFront.
|
||||
package cloudfront
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,83 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudfront provides the client and types for making API
|
||||
// requests to Amazon CloudFront.
|
||||
//
|
||||
// This is the Amazon CloudFront API Reference. This guide is for developers
|
||||
// who need detailed information about the CloudFront API actions, data types,
|
||||
// and errors. For detailed information about CloudFront features and their
|
||||
// associated API calls, see the Amazon CloudFront Developer Guide.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25 for more information on this service.
|
||||
//
|
||||
// See cloudfront package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudfront/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon CloudFront you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := cloudfront.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon CloudFront client CloudFront for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudfront/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CreateCloudFrontOriginAccessIdentity(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CreateCloudFrontOriginAccessIdentity result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CreateCloudFrontOriginAccessIdentityWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package cloudfront
|
|
@ -11,13 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/restxml"
|
||||
)
|
||||
|
||||
// This is the Amazon CloudFront API Reference. This guide is for developers
|
||||
// who need detailed information about the CloudFront API actions, data types,
|
||||
// and errors. For detailed information about CloudFront features and their
|
||||
// associated API calls, see the Amazon CloudFront Developer Guide.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25
|
||||
// CloudFront provides the API operation methods for making requests to
|
||||
// Amazon CloudFront. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// CloudFront methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CloudFront struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudtrail provides a client for AWS CloudTrail.
|
||||
package cloudtrail
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,100 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudtrail provides the client and types for making API
|
||||
// requests to AWS CloudTrail.
|
||||
//
|
||||
// This is the CloudTrail API Reference. It provides descriptions of actions,
|
||||
// data types, common parameters, and common errors for CloudTrail.
|
||||
//
|
||||
// CloudTrail is a web service that records AWS API calls for your AWS account
|
||||
// and delivers log files to an Amazon S3 bucket. The recorded information includes
|
||||
// the identity of the user, the start time of the AWS API call, the source
|
||||
// IP address, the request parameters, and the response elements returned by
|
||||
// the service.
|
||||
//
|
||||
// As an alternative to the API, you can use one of the AWS SDKs, which consist
|
||||
// of libraries and sample code for various programming languages and platforms
|
||||
// (Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide a convenient way
|
||||
// to create programmatic access to AWSCloudTrail. For example, the SDKs take
|
||||
// care of cryptographically signing requests, managing errors, and retrying
|
||||
// requests automatically. For information about the AWS SDKs, including how
|
||||
// to download and install them, see the Tools for Amazon Web Services page
|
||||
// (http://aws.amazon.com/tools/).
|
||||
//
|
||||
// See the AWS CloudTrail User Guide (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)
|
||||
// for information about the data that is included with each AWS API call listed
|
||||
// in the log files.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01 for more information on this service.
|
||||
//
|
||||
// See cloudtrail package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudtrail/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS CloudTrail you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := cloudtrail.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS CloudTrail client CloudTrail for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudtrail/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AddTags(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AddTags result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AddTagsWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package cloudtrail
|
|
@ -11,30 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// This is the CloudTrail API Reference. It provides descriptions of actions,
|
||||
// data types, common parameters, and common errors for CloudTrail.
|
||||
// CloudTrail provides the API operation methods for making requests to
|
||||
// AWS CloudTrail. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// CloudTrail is a web service that records AWS API calls for your AWS account
|
||||
// and delivers log files to an Amazon S3 bucket. The recorded information includes
|
||||
// the identity of the user, the start time of the AWS API call, the source
|
||||
// IP address, the request parameters, and the response elements returned by
|
||||
// the service.
|
||||
//
|
||||
// As an alternative to the API, you can use one of the AWS SDKs, which consist
|
||||
// of libraries and sample code for various programming languages and platforms
|
||||
// (Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide a convenient way
|
||||
// to create programmatic access to AWSCloudTrail. For example, the SDKs take
|
||||
// care of cryptographically signing requests, managing errors, and retrying
|
||||
// requests automatically. For information about the AWS SDKs, including how
|
||||
// to download and install them, see the Tools for Amazon Web Services page
|
||||
// (http://aws.amazon.com/tools/).
|
||||
//
|
||||
// See the AWS CloudTrail User Guide (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)
|
||||
// for information about the data that is included with each AWS API call listed
|
||||
// in the log files.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01
|
||||
// CloudTrail methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CloudTrail struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudwatch provides a client for Amazon CloudWatch.
|
||||
package cloudwatch
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,94 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudwatch provides the client and types for making API
|
||||
// requests to Amazon CloudWatch.
|
||||
//
|
||||
// Amazon CloudWatch monitors your Amazon Web Services (AWS) resources and the
|
||||
// applications you run on AWS in real-time. You can use CloudWatch to collect
|
||||
// and track metrics, which are the variables you want to measure for your resources
|
||||
// and applications.
|
||||
//
|
||||
// CloudWatch alarms send notifications or automatically make changes to the
|
||||
// resources you are monitoring based on rules that you define. For example,
|
||||
// you can monitor the CPU usage and disk reads and writes of your Amazon Elastic
|
||||
// Compute Cloud (Amazon EC2) instances and then use this data to determine
|
||||
// whether you should launch additional instances to handle increased load.
|
||||
// You can also use this data to stop under-used instances to save money.
|
||||
//
|
||||
// In addition to monitoring the built-in metrics that come with AWS, you can
|
||||
// monitor your own custom metrics. With CloudWatch, you gain system-wide visibility
|
||||
// into resource utilization, application performance, and operational health.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01 for more information on this service.
|
||||
//
|
||||
// See cloudwatch package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudwatch/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon CloudWatch you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := cloudwatch.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon CloudWatch client CloudWatch for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudwatch/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.DeleteAlarms(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("DeleteAlarms result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.DeleteAlarmsWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package cloudwatch
|
|
@ -11,24 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/query"
|
||||
)
|
||||
|
||||
// Amazon CloudWatch monitors your Amazon Web Services (AWS) resources and the
|
||||
// applications you run on AWS in real-time. You can use CloudWatch to collect
|
||||
// and track metrics, which are the variables you want to measure for your resources
|
||||
// and applications.
|
||||
// CloudWatch provides the API operation methods for making requests to
|
||||
// Amazon CloudWatch. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// CloudWatch alarms send notifications or automatically make changes to the
|
||||
// resources you are monitoring based on rules that you define. For example,
|
||||
// you can monitor the CPU usage and disk reads and writes of your Amazon Elastic
|
||||
// Compute Cloud (Amazon EC2) instances and then use this data to determine
|
||||
// whether you should launch additional instances to handle increased load.
|
||||
// You can also use this data to stop under-used instances to save money.
|
||||
//
|
||||
// In addition to monitoring the built-in metrics that come with AWS, you can
|
||||
// monitor your own custom metrics. With CloudWatch, you gain system-wide visibility
|
||||
// into resource utilization, application performance, and operational health.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01
|
||||
// CloudWatch methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CloudWatch struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudwatchevents provides a client for Amazon CloudWatch Events.
|
||||
package cloudwatchevents
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,97 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudwatchevents provides the client and types for making API
|
||||
// requests to Amazon CloudWatch Events.
|
||||
//
|
||||
// Amazon CloudWatch Events helps you to respond to state changes in your AWS
|
||||
// resources. When your resources change state, they automatically send events
|
||||
// into an event stream. You can create rules that match selected events in
|
||||
// the stream and route them to targets to take action. You can also use rules
|
||||
// to take action on a pre-determined schedule. For example, you can configure
|
||||
// rules to:
|
||||
//
|
||||
// * Automatically invoke an AWS Lambda function to update DNS entries when
|
||||
// an event notifies you that Amazon EC2 instance enters the running state.
|
||||
//
|
||||
// * Direct specific API records from CloudTrail to an Amazon Kinesis stream
|
||||
// for detailed analysis of potential security or availability risks.
|
||||
//
|
||||
// * Periodically invoke a built-in target to create a snapshot of an Amazon
|
||||
// EBS volume.
|
||||
//
|
||||
// For more information about the features of Amazon CloudWatch Events, see
|
||||
// the Amazon CloudWatch Events User Guide (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07 for more information on this service.
|
||||
//
|
||||
// See cloudwatchevents package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudwatchevents/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon CloudWatch Events you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := cloudwatchevents.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon CloudWatch Events client CloudWatchEvents for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudwatchevents/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.DeleteRule(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("DeleteRule result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.DeleteRuleWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package cloudwatchevents
|
|
@ -11,27 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Amazon CloudWatch Events helps you to respond to state changes in your AWS
|
||||
// resources. When your resources change state, they automatically send events
|
||||
// into an event stream. You can create rules that match selected events in
|
||||
// the stream and route them to targets to take action. You can also use rules
|
||||
// to take action on a pre-determined schedule. For example, you can configure
|
||||
// rules to:
|
||||
// CloudWatchEvents provides the API operation methods for making requests to
|
||||
// Amazon CloudWatch Events. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// * Automatically invoke an AWS Lambda function to update DNS entries when
|
||||
// an event notifies you that Amazon EC2 instance enters the running state.
|
||||
//
|
||||
// * Direct specific API records from CloudTrail to an Amazon Kinesis stream
|
||||
// for detailed analysis of potential security or availability risks.
|
||||
//
|
||||
// * Periodically invoke a built-in target to create a snapshot of an Amazon
|
||||
// EBS volume.
|
||||
//
|
||||
// For more information about the features of Amazon CloudWatch Events, see
|
||||
// the Amazon CloudWatch Events User Guide (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07
|
||||
// CloudWatchEvents methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CloudWatchEvents struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudwatchlogs provides a client for Amazon CloudWatch Logs.
|
||||
package cloudwatchlogs
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,109 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cloudwatchlogs provides the client and types for making API
|
||||
// requests to Amazon CloudWatch Logs.
|
||||
//
|
||||
// You can use Amazon CloudWatch Logs to monitor, store, and access your log
|
||||
// files from EC2 instances, Amazon CloudTrail, or other sources. You can then
|
||||
// retrieve the associated log data from CloudWatch Logs using the Amazon CloudWatch
|
||||
// console, the CloudWatch Logs commands in the AWS CLI, the CloudWatch Logs
|
||||
// API, or the CloudWatch Logs SDK.
|
||||
//
|
||||
// You can use CloudWatch Logs to:
|
||||
//
|
||||
// * Monitor Logs from Amazon EC2 Instances in Real-time: You can use CloudWatch
|
||||
// Logs to monitor applications and systems using log data. For example,
|
||||
// CloudWatch Logs can track the number of errors that occur in your application
|
||||
// logs and send you a notification whenever the rate of errors exceeds a
|
||||
// threshold you specify. CloudWatch Logs uses your log data for monitoring;
|
||||
// so, no code changes are required. For example, you can monitor application
|
||||
// logs for specific literal terms (such as "NullReferenceException") or
|
||||
// count the number of occurrences of a literal term at a particular position
|
||||
// in log data (such as "404" status codes in an Apache access log). When
|
||||
// the term you are searching for is found, CloudWatch Logs reports the data
|
||||
// to a Amazon CloudWatch metric that you specify.
|
||||
//
|
||||
// * Monitor Amazon CloudTrail Logged Events: You can create alarms in Amazon
|
||||
// CloudWatch and receive notifications of particular API activity as captured
|
||||
// by CloudTrail and use the notification to perform troubleshooting.
|
||||
//
|
||||
// * Archive Log Data: You can use CloudWatch Logs to store your log data
|
||||
// in highly durable storage. You can change the log retention setting so
|
||||
// that any log events older than this setting are automatically deleted.
|
||||
// The CloudWatch Logs agent makes it easy to quickly send both rotated and
|
||||
// non-rotated log data off of a host and into the log service. You can then
|
||||
// access the raw log data when you need it.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28 for more information on this service.
|
||||
//
|
||||
// See cloudwatchlogs package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudwatchlogs/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon CloudWatch Logs you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := cloudwatchlogs.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon CloudWatch Logs client CloudWatchLogs for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudwatchlogs/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CancelExportTask(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CancelExportTask result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CancelExportTaskWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package cloudwatchlogs
|
|
@ -11,39 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// You can use Amazon CloudWatch Logs to monitor, store, and access your log
|
||||
// files from EC2 instances, Amazon CloudTrail, or other sources. You can then
|
||||
// retrieve the associated log data from CloudWatch Logs using the Amazon CloudWatch
|
||||
// console, the CloudWatch Logs commands in the AWS CLI, the CloudWatch Logs
|
||||
// API, or the CloudWatch Logs SDK.
|
||||
// CloudWatchLogs provides the API operation methods for making requests to
|
||||
// Amazon CloudWatch Logs. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// You can use CloudWatch Logs to:
|
||||
//
|
||||
// * Monitor Logs from Amazon EC2 Instances in Real-time: You can use CloudWatch
|
||||
// Logs to monitor applications and systems using log data. For example,
|
||||
// CloudWatch Logs can track the number of errors that occur in your application
|
||||
// logs and send you a notification whenever the rate of errors exceeds a
|
||||
// threshold you specify. CloudWatch Logs uses your log data for monitoring;
|
||||
// so, no code changes are required. For example, you can monitor application
|
||||
// logs for specific literal terms (such as "NullReferenceException") or
|
||||
// count the number of occurrences of a literal term at a particular position
|
||||
// in log data (such as "404" status codes in an Apache access log). When
|
||||
// the term you are searching for is found, CloudWatch Logs reports the data
|
||||
// to a Amazon CloudWatch metric that you specify.
|
||||
//
|
||||
// * Monitor Amazon CloudTrail Logged Events: You can create alarms in Amazon
|
||||
// CloudWatch and receive notifications of particular API activity as captured
|
||||
// by CloudTrail and use the notification to perform troubleshooting.
|
||||
//
|
||||
// * Archive Log Data: You can use CloudWatch Logs to store your log data
|
||||
// in highly durable storage. You can change the log retention setting so
|
||||
// that any log events older than this setting are automatically deleted.
|
||||
// The CloudWatch Logs agent makes it easy to quickly send both rotated and
|
||||
// non-rotated log data off of a host and into the log service. You can then
|
||||
// access the raw log data when you need it.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28
|
||||
// CloudWatchLogs methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CloudWatchLogs struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codebuild provides a client for AWS CodeBuild.
|
||||
package codebuild
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,123 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codebuild provides the client and types for making API
|
||||
// requests to AWS CodeBuild.
|
||||
//
|
||||
// AWS CodeBuild is a fully managed build service in the cloud. AWS CodeBuild
|
||||
// compiles your source code, runs unit tests, and produces artifacts that are
|
||||
// ready to deploy. AWS CodeBuild eliminates the need to provision, manage,
|
||||
// and scale your own build servers. It provides prepackaged build environments
|
||||
// for the most popular programming languages and build tools, such as Apach
|
||||
// Maven, Gradle, and more. You can also fully customize build environments
|
||||
// in AWS CodeBuild to use your own build tools. AWS CodeBuild scales automatically
|
||||
// to meet peak build requests, and you pay only for the build time you consume.
|
||||
// For more information about AWS CodeBuild, see the AWS CodeBuild User Guide.
|
||||
//
|
||||
// AWS CodeBuild supports these operations:
|
||||
//
|
||||
// * BatchGetProjects: Gets information about one or more build projects.
|
||||
// A build project defines how AWS CodeBuild will run a build. This includes
|
||||
// information such as where to get the source code to build, the build environment
|
||||
// to use, the build commands to run, and where to store the build output.
|
||||
// A build environment represents a combination of operating system, programming
|
||||
// language runtime, and tools that AWS CodeBuild will use to run a build.
|
||||
// Also, you can add tags to build projects to help manage your resources
|
||||
// and costs.
|
||||
//
|
||||
// * CreateProject: Creates a build project.
|
||||
//
|
||||
// * DeleteProject: Deletes a build project.
|
||||
//
|
||||
// * ListProjects: Gets a list of build project names, with each build project
|
||||
// name representing a single build project.
|
||||
//
|
||||
// * UpdateProject: Changes the settings of an existing build project.
|
||||
//
|
||||
// * BatchGetBuilds: Gets information about one or more builds.
|
||||
//
|
||||
// * ListBuilds: Gets a list of build IDs, with each build ID representing
|
||||
// a single build.
|
||||
//
|
||||
// * ListBuildsForProject: Gets a list of build IDs for the specified build
|
||||
// project, with each build ID representing a single build.
|
||||
//
|
||||
// * StartBuild: Starts running a build.
|
||||
//
|
||||
// * StopBuild: Attempts to stop running a build.
|
||||
//
|
||||
// * ListCuratedEnvironmentImages: Gets information about Docker images that
|
||||
// are managed by AWS CodeBuild.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06 for more information on this service.
|
||||
//
|
||||
// See codebuild package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codebuild/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS CodeBuild you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := codebuild.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS CodeBuild client CodeBuild for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codebuild/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.BatchGetBuilds(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("BatchGetBuilds result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.BatchGetBuildsWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package codebuild
|
|
@ -11,53 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// AWS CodeBuild is a fully managed build service in the cloud. AWS CodeBuild
|
||||
// compiles your source code, runs unit tests, and produces artifacts that are
|
||||
// ready to deploy. AWS CodeBuild eliminates the need to provision, manage,
|
||||
// and scale your own build servers. It provides prepackaged build environments
|
||||
// for the most popular programming languages and build tools, such as Apach
|
||||
// Maven, Gradle, and more. You can also fully customize build environments
|
||||
// in AWS CodeBuild to use your own build tools. AWS CodeBuild scales automatically
|
||||
// to meet peak build requests, and you pay only for the build time you consume.
|
||||
// For more information about AWS CodeBuild, see the AWS CodeBuild User Guide.
|
||||
// CodeBuild provides the API operation methods for making requests to
|
||||
// AWS CodeBuild. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// AWS CodeBuild supports these operations:
|
||||
//
|
||||
// * BatchGetProjects: Gets information about one or more build projects.
|
||||
// A build project defines how AWS CodeBuild will run a build. This includes
|
||||
// information such as where to get the source code to build, the build environment
|
||||
// to use, the build commands to run, and where to store the build output.
|
||||
// A build environment represents a combination of operating system, programming
|
||||
// language runtime, and tools that AWS CodeBuild will use to run a build.
|
||||
// Also, you can add tags to build projects to help manage your resources
|
||||
// and costs.
|
||||
//
|
||||
// * CreateProject: Creates a build project.
|
||||
//
|
||||
// * DeleteProject: Deletes a build project.
|
||||
//
|
||||
// * ListProjects: Gets a list of build project names, with each build project
|
||||
// name representing a single build project.
|
||||
//
|
||||
// * UpdateProject: Changes the settings of an existing build project.
|
||||
//
|
||||
// * BatchGetBuilds: Gets information about one or more builds.
|
||||
//
|
||||
// * ListBuilds: Gets a list of build IDs, with each build ID representing
|
||||
// a single build.
|
||||
//
|
||||
// * ListBuildsForProject: Gets a list of build IDs for the specified build
|
||||
// project, with each build ID representing a single build.
|
||||
//
|
||||
// * StartBuild: Starts running a build.
|
||||
//
|
||||
// * StopBuild: Attempts to stop running a build.
|
||||
//
|
||||
// * ListCuratedEnvironmentImages: Gets information about Docker images that
|
||||
// are managed by AWS CodeBuild.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06
|
||||
// CodeBuild methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CodeBuild struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codecommit provides a client for AWS CodeCommit.
|
||||
package codecommit
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,141 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codecommit provides the client and types for making API
|
||||
// requests to AWS CodeCommit.
|
||||
//
|
||||
// This is the AWS CodeCommit API Reference. This reference provides descriptions
|
||||
// of the operations and data types for AWS CodeCommit API along with usage
|
||||
// examples.
|
||||
//
|
||||
// You can use the AWS CodeCommit API to work with the following objects:
|
||||
//
|
||||
// Repositories, by calling the following:
|
||||
//
|
||||
// * BatchGetRepositories, which returns information about one or more repositories
|
||||
// associated with your AWS account
|
||||
//
|
||||
// * CreateRepository, which creates an AWS CodeCommit repository
|
||||
//
|
||||
// * DeleteRepository, which deletes an AWS CodeCommit repository
|
||||
//
|
||||
// * GetRepository, which returns information about a specified repository
|
||||
//
|
||||
// * ListRepositories, which lists all AWS CodeCommit repositories associated
|
||||
// with your AWS account
|
||||
//
|
||||
// * UpdateRepositoryDescription, which sets or updates the description of
|
||||
// the repository
|
||||
//
|
||||
// * UpdateRepositoryName, which changes the name of the repository. If you
|
||||
// change the name of a repository, no other users of that repository will
|
||||
// be able to access it until you send them the new HTTPS or SSH URL to use.
|
||||
//
|
||||
// Branches, by calling the following:
|
||||
//
|
||||
// * CreateBranch, which creates a new branch in a specified repository
|
||||
//
|
||||
// * GetBranch, which returns information about a specified branch
|
||||
//
|
||||
// * ListBranches, which lists all branches for a specified repository
|
||||
//
|
||||
// * UpdateDefaultBranch, which changes the default branch for a repository
|
||||
//
|
||||
// Information about committed code in a repository, by calling the following:
|
||||
//
|
||||
// * GetBlob, which returns the base-64 encoded content of an individual
|
||||
// Git blob object within a repository
|
||||
//
|
||||
// * GetCommit, which returns information about a commit, including commit
|
||||
// messages and author and committer information
|
||||
//
|
||||
// * GetDifferences, which returns information about the differences in a
|
||||
// valid commit specifier (such as a branch, tag, HEAD, commit ID or other
|
||||
// fully qualified reference)
|
||||
//
|
||||
// Triggers, by calling the following:
|
||||
//
|
||||
// * GetRepositoryTriggers, which returns information about triggers configured
|
||||
// for a repository
|
||||
//
|
||||
// * PutRepositoryTriggers, which replaces all triggers for a repository
|
||||
// and can be used to create or delete triggers
|
||||
//
|
||||
// * TestRepositoryTriggers, which tests the functionality of a repository
|
||||
// trigger by sending data to the trigger target
|
||||
//
|
||||
// For information about how to use AWS CodeCommit, see the AWS CodeCommit User
|
||||
// Guide (http://docs.aws.amazon.com/codecommit/latest/userguide/welcome.html).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/codecommit-2015-04-13 for more information on this service.
|
||||
//
|
||||
// See codecommit package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codecommit/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS CodeCommit you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := codecommit.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS CodeCommit client CodeCommit for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codecommit/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.BatchGetRepositories(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("BatchGetRepositories result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.BatchGetRepositoriesWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package codecommit
|
|
@ -11,71 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// This is the AWS CodeCommit API Reference. This reference provides descriptions
|
||||
// of the operations and data types for AWS CodeCommit API along with usage
|
||||
// examples.
|
||||
// CodeCommit provides the API operation methods for making requests to
|
||||
// AWS CodeCommit. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// You can use the AWS CodeCommit API to work with the following objects:
|
||||
//
|
||||
// Repositories, by calling the following:
|
||||
//
|
||||
// * BatchGetRepositories, which returns information about one or more repositories
|
||||
// associated with your AWS account
|
||||
//
|
||||
// * CreateRepository, which creates an AWS CodeCommit repository
|
||||
//
|
||||
// * DeleteRepository, which deletes an AWS CodeCommit repository
|
||||
//
|
||||
// * GetRepository, which returns information about a specified repository
|
||||
//
|
||||
// * ListRepositories, which lists all AWS CodeCommit repositories associated
|
||||
// with your AWS account
|
||||
//
|
||||
// * UpdateRepositoryDescription, which sets or updates the description of
|
||||
// the repository
|
||||
//
|
||||
// * UpdateRepositoryName, which changes the name of the repository. If you
|
||||
// change the name of a repository, no other users of that repository will
|
||||
// be able to access it until you send them the new HTTPS or SSH URL to use.
|
||||
//
|
||||
// Branches, by calling the following:
|
||||
//
|
||||
// * CreateBranch, which creates a new branch in a specified repository
|
||||
//
|
||||
// * GetBranch, which returns information about a specified branch
|
||||
//
|
||||
// * ListBranches, which lists all branches for a specified repository
|
||||
//
|
||||
// * UpdateDefaultBranch, which changes the default branch for a repository
|
||||
//
|
||||
// Information about committed code in a repository, by calling the following:
|
||||
//
|
||||
// * GetBlob, which returns the base-64 encoded content of an individual
|
||||
// Git blob object within a repository
|
||||
//
|
||||
// * GetCommit, which returns information about a commit, including commit
|
||||
// messages and author and committer information
|
||||
//
|
||||
// * GetDifferences, which returns information about the differences in a
|
||||
// valid commit specifier (such as a branch, tag, HEAD, commit ID or other
|
||||
// fully qualified reference)
|
||||
//
|
||||
// Triggers, by calling the following:
|
||||
//
|
||||
// * GetRepositoryTriggers, which returns information about triggers configured
|
||||
// for a repository
|
||||
//
|
||||
// * PutRepositoryTriggers, which replaces all triggers for a repository
|
||||
// and can be used to create or delete triggers
|
||||
//
|
||||
// * TestRepositoryTriggers, which tests the functionality of a repository
|
||||
// trigger by sending data to the trigger target
|
||||
//
|
||||
// For information about how to use AWS CodeCommit, see the AWS CodeCommit User
|
||||
// Guide (http://docs.aws.amazon.com/codecommit/latest/userguide/welcome.html).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codecommit-2015-04-13
|
||||
// CodeCommit methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CodeCommit struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codedeploy provides a client for AWS CodeDeploy.
|
||||
package codedeploy
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,132 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codedeploy provides the client and types for making API
|
||||
// requests to AWS CodeDeploy.
|
||||
//
|
||||
// Overview
|
||||
//
|
||||
// This reference guide provides descriptions of the AWS CodeDeploy APIs. For
|
||||
// more information about AWS CodeDeploy, see the AWS CodeDeploy User Guide
|
||||
// (http://docs.aws.amazon.com/codedeploy/latest/userguide).
|
||||
//
|
||||
// Using the APIs
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to work with the following:
|
||||
//
|
||||
// * Applications are unique identifiers used by AWS CodeDeploy to ensure
|
||||
// the correct combinations of revisions, deployment configurations, and
|
||||
// deployment groups are being referenced during deployments.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, delete, get, list, and update
|
||||
// applications.
|
||||
//
|
||||
// * Deployment configurations are sets of deployment rules and success and
|
||||
// failure conditions used by AWS CodeDeploy during deployments.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, delete, get, and list deployment
|
||||
// configurations.
|
||||
//
|
||||
// * Deployment groups are groups of instances to which application revisions
|
||||
// can be deployed.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, delete, get, list, and update
|
||||
// deployment groups.
|
||||
//
|
||||
// * Instances represent Amazon EC2 instances to which application revisions
|
||||
// are deployed. Instances are identified by their Amazon EC2 tags or Auto
|
||||
// Scaling group names. Instances belong to deployment groups.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to get and list instance.
|
||||
//
|
||||
// * Deployments represent the process of deploying revisions to instances.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, get, list, and stop deployments.
|
||||
//
|
||||
// * Application revisions are archive files stored in Amazon S3 buckets
|
||||
// or GitHub repositories. These revisions contain source content (such as
|
||||
// source code, web pages, executable files, and deployment scripts) along
|
||||
// with an application specification (AppSpec) file. (The AppSpec file is
|
||||
// unique to AWS CodeDeploy; it defines the deployment actions you want AWS
|
||||
// CodeDeploy to execute.) For application revisions stored in Amazon S3
|
||||
// buckets, an application revision is uniquely identified by its Amazon
|
||||
// S3 object key and its ETag, version, or both. For application revisions
|
||||
// stored in GitHub repositories, an application revision is uniquely identified
|
||||
// by its repository name and commit ID. Application revisions are deployed
|
||||
// through deployment groups.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to get, list, and register application
|
||||
// revisions.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06 for more information on this service.
|
||||
//
|
||||
// See codedeploy package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codedeploy/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS CodeDeploy you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := codedeploy.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS CodeDeploy client CodeDeploy for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codedeploy/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AddTagsToOnPremisesInstances(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AddTagsToOnPremisesInstances result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AddTagsToOnPremisesInstancesWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package codedeploy
|
|
@ -11,62 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Overview
|
||||
// CodeDeploy provides the API operation methods for making requests to
|
||||
// AWS CodeDeploy. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// This reference guide provides descriptions of the AWS CodeDeploy APIs. For
|
||||
// more information about AWS CodeDeploy, see the AWS CodeDeploy User Guide
|
||||
// (http://docs.aws.amazon.com/codedeploy/latest/userguide).
|
||||
//
|
||||
// Using the APIs
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to work with the following:
|
||||
//
|
||||
// * Applications are unique identifiers used by AWS CodeDeploy to ensure
|
||||
// the correct combinations of revisions, deployment configurations, and
|
||||
// deployment groups are being referenced during deployments.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, delete, get, list, and update
|
||||
// applications.
|
||||
//
|
||||
// * Deployment configurations are sets of deployment rules and success and
|
||||
// failure conditions used by AWS CodeDeploy during deployments.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, delete, get, and list deployment
|
||||
// configurations.
|
||||
//
|
||||
// * Deployment groups are groups of instances to which application revisions
|
||||
// can be deployed.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, delete, get, list, and update
|
||||
// deployment groups.
|
||||
//
|
||||
// * Instances represent Amazon EC2 instances to which application revisions
|
||||
// are deployed. Instances are identified by their Amazon EC2 tags or Auto
|
||||
// Scaling group names. Instances belong to deployment groups.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to get and list instance.
|
||||
//
|
||||
// * Deployments represent the process of deploying revisions to instances.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to create, get, list, and stop deployments.
|
||||
//
|
||||
// * Application revisions are archive files stored in Amazon S3 buckets
|
||||
// or GitHub repositories. These revisions contain source content (such as
|
||||
// source code, web pages, executable files, and deployment scripts) along
|
||||
// with an application specification (AppSpec) file. (The AppSpec file is
|
||||
// unique to AWS CodeDeploy; it defines the deployment actions you want AWS
|
||||
// CodeDeploy to execute.) For application revisions stored in Amazon S3
|
||||
// buckets, an application revision is uniquely identified by its Amazon
|
||||
// S3 object key and its ETag, version, or both. For application revisions
|
||||
// stored in GitHub repositories, an application revision is uniquely identified
|
||||
// by its repository name and commit ID. Application revisions are deployed
|
||||
// through deployment groups.
|
||||
//
|
||||
// You can use the AWS CodeDeploy APIs to get, list, and register application
|
||||
// revisions.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06
|
||||
// CodeDeploy methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CodeDeploy struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codepipeline provides a client for AWS CodePipeline.
|
||||
package codepipeline
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,188 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package codepipeline provides the client and types for making API
|
||||
// requests to AWS CodePipeline.
|
||||
//
|
||||
// Overview
|
||||
//
|
||||
// This is the AWS CodePipeline API Reference. This guide provides descriptions
|
||||
// of the actions and data types for AWS CodePipeline. Some functionality for
|
||||
// your pipeline is only configurable through the API. For additional information,
|
||||
// see the AWS CodePipeline User Guide (http://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html).
|
||||
//
|
||||
// You can use the AWS CodePipeline API to work with pipelines, stages, actions,
|
||||
// gates, and transitions, as described below.
|
||||
//
|
||||
// Pipelines are models of automated release processes. Each pipeline is uniquely
|
||||
// named, and consists of actions, gates, and stages.
|
||||
//
|
||||
// You can work with pipelines by calling:
|
||||
//
|
||||
// * CreatePipeline, which creates a uniquely-named pipeline.
|
||||
//
|
||||
// * DeletePipeline, which deletes the specified pipeline.
|
||||
//
|
||||
// * GetPipeline, which returns information about a pipeline structure.
|
||||
//
|
||||
// * GetPipelineExecution, which returns information about a specific execution
|
||||
// of a pipeline.
|
||||
//
|
||||
// * GetPipelineState, which returns information about the current state
|
||||
// of the stages and actions of a pipeline.
|
||||
//
|
||||
// * ListPipelines, which gets a summary of all of the pipelines associated
|
||||
// with your account.
|
||||
//
|
||||
// * StartPipelineExecution, which runs the the most recent revision of an
|
||||
// artifact through the pipeline.
|
||||
//
|
||||
// * UpdatePipeline, which updates a pipeline with edits or changes to the
|
||||
// structure of the pipeline.
|
||||
//
|
||||
// Pipelines include stages, which are logical groupings of gates and actions.
|
||||
// Each stage contains one or more actions that must complete before the next
|
||||
// stage begins. A stage will result in success or failure. If a stage fails,
|
||||
// then the pipeline stops at that stage and will remain stopped until either
|
||||
// a new version of an artifact appears in the source location, or a user takes
|
||||
// action to re-run the most recent artifact through the pipeline. You can call
|
||||
// GetPipelineState, which displays the status of a pipeline, including the
|
||||
// status of stages in the pipeline, or GetPipeline, which returns the entire
|
||||
// structure of the pipeline, including the stages of that pipeline. For more
|
||||
// information about the structure of stages and actions, also refer to the
|
||||
// AWS CodePipeline Pipeline Structure Reference (http://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-structure.html).
|
||||
//
|
||||
// Pipeline stages include actions, which are categorized into categories such
|
||||
// as source or build actions performed within a stage of a pipeline. For example,
|
||||
// you can use a source action to import artifacts into a pipeline from a source
|
||||
// such as Amazon S3. Like stages, you do not work with actions directly in
|
||||
// most cases, but you do define and interact with actions when working with
|
||||
// pipeline operations such as CreatePipeline and GetPipelineState.
|
||||
//
|
||||
// Pipelines also include transitions, which allow the transition of artifacts
|
||||
// from one stage to the next in a pipeline after the actions in one stage complete.
|
||||
//
|
||||
// You can work with transitions by calling:
|
||||
//
|
||||
// * DisableStageTransition, which prevents artifacts from transitioning
|
||||
// to the next stage in a pipeline.
|
||||
//
|
||||
// * EnableStageTransition, which enables transition of artifacts between
|
||||
// stages in a pipeline.
|
||||
//
|
||||
// Using the API to integrate with AWS CodePipeline
|
||||
//
|
||||
// For third-party integrators or developers who want to create their own integrations
|
||||
// with AWS CodePipeline, the expected sequence varies from the standard API
|
||||
// user. In order to integrate with AWS CodePipeline, developers will need to
|
||||
// work with the following items:
|
||||
//
|
||||
// Jobs, which are instances of an action. For example, a job for a source action
|
||||
// might import a revision of an artifact from a source.
|
||||
//
|
||||
// You can work with jobs by calling:
|
||||
//
|
||||
// * AcknowledgeJob, which confirms whether a job worker has received the
|
||||
// specified job,
|
||||
//
|
||||
// * GetJobDetails, which returns the details of a job,
|
||||
//
|
||||
// * PollForJobs, which determines whether there are any jobs to act upon,
|
||||
//
|
||||
//
|
||||
// * PutJobFailureResult, which provides details of a job failure, and
|
||||
//
|
||||
// * PutJobSuccessResult, which provides details of a job success.
|
||||
//
|
||||
// Third party jobs, which are instances of an action created by a partner action
|
||||
// and integrated into AWS CodePipeline. Partner actions are created by members
|
||||
// of the AWS Partner Network.
|
||||
//
|
||||
// You can work with third party jobs by calling:
|
||||
//
|
||||
// * AcknowledgeThirdPartyJob, which confirms whether a job worker has received
|
||||
// the specified job,
|
||||
//
|
||||
// * GetThirdPartyJobDetails, which requests the details of a job for a partner
|
||||
// action,
|
||||
//
|
||||
// * PollForThirdPartyJobs, which determines whether there are any jobs to
|
||||
// act upon,
|
||||
//
|
||||
// * PutThirdPartyJobFailureResult, which provides details of a job failure,
|
||||
// and
|
||||
//
|
||||
// * PutThirdPartyJobSuccessResult, which provides details of a job success.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/codepipeline-2015-07-09 for more information on this service.
|
||||
//
|
||||
// See codepipeline package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codepipeline/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS CodePipeline you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := codepipeline.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS CodePipeline client CodePipeline for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/codepipeline/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AcknowledgeJob(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AcknowledgeJob result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AcknowledgeJobWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package codepipeline
|
|
@ -11,118 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Overview
|
||||
// CodePipeline provides the API operation methods for making requests to
|
||||
// AWS CodePipeline. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// This is the AWS CodePipeline API Reference. This guide provides descriptions
|
||||
// of the actions and data types for AWS CodePipeline. Some functionality for
|
||||
// your pipeline is only configurable through the API. For additional information,
|
||||
// see the AWS CodePipeline User Guide (http://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html).
|
||||
//
|
||||
// You can use the AWS CodePipeline API to work with pipelines, stages, actions,
|
||||
// gates, and transitions, as described below.
|
||||
//
|
||||
// Pipelines are models of automated release processes. Each pipeline is uniquely
|
||||
// named, and consists of actions, gates, and stages.
|
||||
//
|
||||
// You can work with pipelines by calling:
|
||||
//
|
||||
// * CreatePipeline, which creates a uniquely-named pipeline.
|
||||
//
|
||||
// * DeletePipeline, which deletes the specified pipeline.
|
||||
//
|
||||
// * GetPipeline, which returns information about a pipeline structure.
|
||||
//
|
||||
// * GetPipelineExecution, which returns information about a specific execution
|
||||
// of a pipeline.
|
||||
//
|
||||
// * GetPipelineState, which returns information about the current state
|
||||
// of the stages and actions of a pipeline.
|
||||
//
|
||||
// * ListPipelines, which gets a summary of all of the pipelines associated
|
||||
// with your account.
|
||||
//
|
||||
// * StartPipelineExecution, which runs the the most recent revision of an
|
||||
// artifact through the pipeline.
|
||||
//
|
||||
// * UpdatePipeline, which updates a pipeline with edits or changes to the
|
||||
// structure of the pipeline.
|
||||
//
|
||||
// Pipelines include stages, which are logical groupings of gates and actions.
|
||||
// Each stage contains one or more actions that must complete before the next
|
||||
// stage begins. A stage will result in success or failure. If a stage fails,
|
||||
// then the pipeline stops at that stage and will remain stopped until either
|
||||
// a new version of an artifact appears in the source location, or a user takes
|
||||
// action to re-run the most recent artifact through the pipeline. You can call
|
||||
// GetPipelineState, which displays the status of a pipeline, including the
|
||||
// status of stages in the pipeline, or GetPipeline, which returns the entire
|
||||
// structure of the pipeline, including the stages of that pipeline. For more
|
||||
// information about the structure of stages and actions, also refer to the
|
||||
// AWS CodePipeline Pipeline Structure Reference (http://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-structure.html).
|
||||
//
|
||||
// Pipeline stages include actions, which are categorized into categories such
|
||||
// as source or build actions performed within a stage of a pipeline. For example,
|
||||
// you can use a source action to import artifacts into a pipeline from a source
|
||||
// such as Amazon S3. Like stages, you do not work with actions directly in
|
||||
// most cases, but you do define and interact with actions when working with
|
||||
// pipeline operations such as CreatePipeline and GetPipelineState.
|
||||
//
|
||||
// Pipelines also include transitions, which allow the transition of artifacts
|
||||
// from one stage to the next in a pipeline after the actions in one stage complete.
|
||||
//
|
||||
// You can work with transitions by calling:
|
||||
//
|
||||
// * DisableStageTransition, which prevents artifacts from transitioning
|
||||
// to the next stage in a pipeline.
|
||||
//
|
||||
// * EnableStageTransition, which enables transition of artifacts between
|
||||
// stages in a pipeline.
|
||||
//
|
||||
// Using the API to integrate with AWS CodePipeline
|
||||
//
|
||||
// For third-party integrators or developers who want to create their own integrations
|
||||
// with AWS CodePipeline, the expected sequence varies from the standard API
|
||||
// user. In order to integrate with AWS CodePipeline, developers will need to
|
||||
// work with the following items:
|
||||
//
|
||||
// Jobs, which are instances of an action. For example, a job for a source action
|
||||
// might import a revision of an artifact from a source.
|
||||
//
|
||||
// You can work with jobs by calling:
|
||||
//
|
||||
// * AcknowledgeJob, which confirms whether a job worker has received the
|
||||
// specified job,
|
||||
//
|
||||
// * GetJobDetails, which returns the details of a job,
|
||||
//
|
||||
// * PollForJobs, which determines whether there are any jobs to act upon,
|
||||
//
|
||||
//
|
||||
// * PutJobFailureResult, which provides details of a job failure, and
|
||||
//
|
||||
// * PutJobSuccessResult, which provides details of a job success.
|
||||
//
|
||||
// Third party jobs, which are instances of an action created by a partner action
|
||||
// and integrated into AWS CodePipeline. Partner actions are created by members
|
||||
// of the AWS Partner Network.
|
||||
//
|
||||
// You can work with third party jobs by calling:
|
||||
//
|
||||
// * AcknowledgeThirdPartyJob, which confirms whether a job worker has received
|
||||
// the specified job,
|
||||
//
|
||||
// * GetThirdPartyJobDetails, which requests the details of a job for a partner
|
||||
// action,
|
||||
//
|
||||
// * PollForThirdPartyJobs, which determines whether there are any jobs to
|
||||
// act upon,
|
||||
//
|
||||
// * PutThirdPartyJobFailureResult, which provides details of a job failure,
|
||||
// and
|
||||
//
|
||||
// * PutThirdPartyJobSuccessResult, which provides details of a job success.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codepipeline-2015-07-09
|
||||
// CodePipeline methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CodePipeline struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cognitoidentity provides a client for Amazon Cognito Identity.
|
||||
package cognitoidentity
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,111 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package cognitoidentity provides the client and types for making API
|
||||
// requests to Amazon Cognito Identity.
|
||||
//
|
||||
// Amazon Cognito is a web service that delivers scoped temporary credentials
|
||||
// to mobile devices and other untrusted environments. Amazon Cognito uniquely
|
||||
// identifies a device and supplies the user with a consistent identity over
|
||||
// the lifetime of an application.
|
||||
//
|
||||
// Using Amazon Cognito, you can enable authentication with one or more third-party
|
||||
// identity providers (Facebook, Google, or Login with Amazon), and you can
|
||||
// also choose to support unauthenticated access from your app. Cognito delivers
|
||||
// a unique identifier for each user and acts as an OpenID token provider trusted
|
||||
// by AWS Security Token Service (STS) to access temporary, limited-privilege
|
||||
// AWS credentials.
|
||||
//
|
||||
// To provide end-user credentials, first make an unsigned call to GetId. If
|
||||
// the end user is authenticated with one of the supported identity providers,
|
||||
// set the Logins map with the identity provider token. GetId returns a unique
|
||||
// identifier for the user.
|
||||
//
|
||||
// Next, make an unsigned call to GetCredentialsForIdentity. This call expects
|
||||
// the same Logins map as the GetId call, as well as the IdentityID originally
|
||||
// returned by GetId. Assuming your identity pool has been configured via the
|
||||
// SetIdentityPoolRoles operation, GetCredentialsForIdentity will return AWS
|
||||
// credentials for your use. If your pool has not been configured with SetIdentityPoolRoles,
|
||||
// or if you want to follow legacy flow, make an unsigned call to GetOpenIdToken,
|
||||
// which returns the OpenID token necessary to call STS and retrieve AWS credentials.
|
||||
// This call expects the same Logins map as the GetId call, as well as the IdentityID
|
||||
// originally returned by GetId. The token returned by GetOpenIdToken can be
|
||||
// passed to the STS operation AssumeRoleWithWebIdentity (http://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)
|
||||
// to retrieve AWS credentials.
|
||||
//
|
||||
// If you want to use Amazon Cognito in an Android, iOS, or Unity application,
|
||||
// you will probably want to make API calls via the AWS Mobile SDK. To learn
|
||||
// more, see the AWS Mobile SDK Developer Guide (http://docs.aws.amazon.com/mobile/index.html).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/cognito-identity-2014-06-30 for more information on this service.
|
||||
//
|
||||
// See cognitoidentity package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cognitoidentity/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon Cognito Identity you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := cognitoidentity.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon Cognito Identity client CognitoIdentity for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/cognitoidentity/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CreateIdentityPool(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CreateIdentityPool result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CreateIdentityPoolWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package cognitoidentity
|
|
@ -11,41 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Amazon Cognito is a web service that delivers scoped temporary credentials
|
||||
// to mobile devices and other untrusted environments. Amazon Cognito uniquely
|
||||
// identifies a device and supplies the user with a consistent identity over
|
||||
// the lifetime of an application.
|
||||
// CognitoIdentity provides the API operation methods for making requests to
|
||||
// Amazon Cognito Identity. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// Using Amazon Cognito, you can enable authentication with one or more third-party
|
||||
// identity providers (Facebook, Google, or Login with Amazon), and you can
|
||||
// also choose to support unauthenticated access from your app. Cognito delivers
|
||||
// a unique identifier for each user and acts as an OpenID token provider trusted
|
||||
// by AWS Security Token Service (STS) to access temporary, limited-privilege
|
||||
// AWS credentials.
|
||||
//
|
||||
// To provide end-user credentials, first make an unsigned call to GetId. If
|
||||
// the end user is authenticated with one of the supported identity providers,
|
||||
// set the Logins map with the identity provider token. GetId returns a unique
|
||||
// identifier for the user.
|
||||
//
|
||||
// Next, make an unsigned call to GetCredentialsForIdentity. This call expects
|
||||
// the same Logins map as the GetId call, as well as the IdentityID originally
|
||||
// returned by GetId. Assuming your identity pool has been configured via the
|
||||
// SetIdentityPoolRoles operation, GetCredentialsForIdentity will return AWS
|
||||
// credentials for your use. If your pool has not been configured with SetIdentityPoolRoles,
|
||||
// or if you want to follow legacy flow, make an unsigned call to GetOpenIdToken,
|
||||
// which returns the OpenID token necessary to call STS and retrieve AWS credentials.
|
||||
// This call expects the same Logins map as the GetId call, as well as the IdentityID
|
||||
// originally returned by GetId. The token returned by GetOpenIdToken can be
|
||||
// passed to the STS operation AssumeRoleWithWebIdentity (http://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)
|
||||
// to retrieve AWS credentials.
|
||||
//
|
||||
// If you want to use Amazon Cognito in an Android, iOS, or Unity application,
|
||||
// you will probably want to make API calls via the AWS Mobile SDK. To learn
|
||||
// more, see the AWS Mobile SDK Developer Guide (http://docs.aws.amazon.com/mobile/index.html).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/cognito-identity-2014-06-30
|
||||
// CognitoIdentity methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type CognitoIdentity struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package configservice provides a client for AWS Config.
|
||||
package configservice
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,103 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package configservice provides the client and types for making API
|
||||
// requests to AWS Config.
|
||||
//
|
||||
// AWS Config provides a way to keep track of the configurations of all the
|
||||
// AWS resources associated with your AWS account. You can use AWS Config to
|
||||
// get the current and historical configurations of each AWS resource and also
|
||||
// to get information about the relationship between the resources. An AWS resource
|
||||
// can be an Amazon Compute Cloud (Amazon EC2) instance, an Elastic Block Store
|
||||
// (EBS) volume, an Elastic network Interface (ENI), or a security group. For
|
||||
// a complete list of resources currently supported by AWS Config, see Supported
|
||||
// AWS Resources (http://docs.aws.amazon.com/config/latest/developerguide/resource-config-reference.html#supported-resources).
|
||||
//
|
||||
// You can access and manage AWS Config through the AWS Management Console,
|
||||
// the AWS Command Line Interface (AWS CLI), the AWS Config API, or the AWS
|
||||
// SDKs for AWS Config
|
||||
//
|
||||
// This reference guide contains documentation for the AWS Config API and the
|
||||
// AWS CLI commands that you can use to manage AWS Config.
|
||||
//
|
||||
// The AWS Config API uses the Signature Version 4 protocol for signing requests.
|
||||
// For more information about how to sign a request with this protocol, see
|
||||
// Signature Version 4 Signing Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html).
|
||||
//
|
||||
// For detailed information about AWS Config features and their associated actions
|
||||
// or commands, as well as how to work with AWS Management Console, see What
|
||||
// Is AWS Config? (http://docs.aws.amazon.com/config/latest/developerguide/WhatIsConfig.html)
|
||||
// in the AWS Config Developer Guide.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12 for more information on this service.
|
||||
//
|
||||
// See configservice package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/configservice/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS Config you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := configservice.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS Config client ConfigService for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/configservice/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.DeleteConfigRule(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("DeleteConfigRule result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.DeleteConfigRuleWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package configservice
|
|
@ -11,33 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// AWS Config provides a way to keep track of the configurations of all the
|
||||
// AWS resources associated with your AWS account. You can use AWS Config to
|
||||
// get the current and historical configurations of each AWS resource and also
|
||||
// to get information about the relationship between the resources. An AWS resource
|
||||
// can be an Amazon Compute Cloud (Amazon EC2) instance, an Elastic Block Store
|
||||
// (EBS) volume, an Elastic network Interface (ENI), or a security group. For
|
||||
// a complete list of resources currently supported by AWS Config, see Supported
|
||||
// AWS Resources (http://docs.aws.amazon.com/config/latest/developerguide/resource-config-reference.html#supported-resources).
|
||||
// ConfigService provides the API operation methods for making requests to
|
||||
// AWS Config. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// You can access and manage AWS Config through the AWS Management Console,
|
||||
// the AWS Command Line Interface (AWS CLI), the AWS Config API, or the AWS
|
||||
// SDKs for AWS Config
|
||||
//
|
||||
// This reference guide contains documentation for the AWS Config API and the
|
||||
// AWS CLI commands that you can use to manage AWS Config.
|
||||
//
|
||||
// The AWS Config API uses the Signature Version 4 protocol for signing requests.
|
||||
// For more information about how to sign a request with this protocol, see
|
||||
// Signature Version 4 Signing Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html).
|
||||
//
|
||||
// For detailed information about AWS Config features and their associated actions
|
||||
// or commands, as well as how to work with AWS Management Console, see What
|
||||
// Is AWS Config? (http://docs.aws.amazon.com/config/latest/developerguide/WhatIsConfig.html)
|
||||
// in the AWS Config Developer Guide.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12
|
||||
// ConfigService methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ConfigService struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package databasemigrationservice provides a client for AWS Database Migration Service.
|
||||
package databasemigrationservice
|
||||
|
||||
import (
|
||||
|
|
86
vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/doc.go
generated
vendored
Normal file
86
vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/doc.go
generated
vendored
Normal file
|
@ -0,0 +1,86 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package databasemigrationservice provides the client and types for making API
|
||||
// requests to AWS Database Migration Service.
|
||||
//
|
||||
// AWS Database Migration Service (AWS DMS) can migrate your data to and from
|
||||
// the most widely used commercial and open-source databases such as Oracle,
|
||||
// PostgreSQL, Microsoft SQL Server, Amazon Redshift, MariaDB, Amazon Aurora,
|
||||
// MySQL, and SAP Adaptive Server Enterprise (ASE). The service supports homogeneous
|
||||
// migrations such as Oracle to Oracle, as well as heterogeneous migrations
|
||||
// between different database platforms, such as Oracle to MySQL or SQL Server
|
||||
// to PostgreSQL.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01 for more information on this service.
|
||||
//
|
||||
// See databasemigrationservice package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/databasemigrationservice/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS Database Migration Service you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := databasemigrationservice.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS Database Migration Service client DatabaseMigrationService for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/databasemigrationservice/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AddTagsToResource(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AddTagsToResource result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AddTagsToResourceWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package databasemigrationservice
|
|
@ -11,16 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// AWS Database Migration Service (AWS DMS) can migrate your data to and from
|
||||
// the most widely used commercial and open-source databases such as Oracle,
|
||||
// PostgreSQL, Microsoft SQL Server, Amazon Redshift, MariaDB, Amazon Aurora,
|
||||
// MySQL, and SAP Adaptive Server Enterprise (ASE). The service supports homogeneous
|
||||
// migrations such as Oracle to Oracle, as well as heterogeneous migrations
|
||||
// between different database platforms, such as Oracle to MySQL or SQL Server
|
||||
// to PostgreSQL.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01
|
||||
// DatabaseMigrationService provides the API operation methods for making requests to
|
||||
// AWS Database Migration Service. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// DatabaseMigrationService methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type DatabaseMigrationService struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package directoryservice provides a client for AWS Directory Service.
|
||||
package directoryservice
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,92 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package directoryservice provides the client and types for making API
|
||||
// requests to AWS Directory Service.
|
||||
//
|
||||
// AWS Directory Service is a web service that makes it easy for you to setup
|
||||
// and run directories in the AWS cloud, or connect your AWS resources with
|
||||
// an existing on-premises Microsoft Active Directory. This guide provides detailed
|
||||
// information about AWS Directory Service operations, data types, parameters,
|
||||
// and errors. For information about AWS Directory Services features, see AWS
|
||||
// Directory Service (https://aws.amazon.com/directoryservice/) and the AWS
|
||||
// Directory Service Administration Guide (http://docs.aws.amazon.com/directoryservice/latest/admin-guide/what_is.html).
|
||||
//
|
||||
// AWS provides SDKs that consist of libraries and sample code for various programming
|
||||
// languages and platforms (Java, Ruby, .Net, iOS, Android, etc.). The SDKs
|
||||
// provide a convenient way to create programmatic access to AWS Directory Service
|
||||
// and other AWS services. For more information about the AWS SDKs, including
|
||||
// how to download and install them, see Tools for Amazon Web Services (http://aws.amazon.com/tools/).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/ds-2015-04-16 for more information on this service.
|
||||
//
|
||||
// See directoryservice package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/directoryservice/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS Directory Service you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := directoryservice.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS Directory Service client DirectoryService for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/directoryservice/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AddIpRoutes(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AddIpRoutes result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AddIpRoutesWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package directoryservice
|
|
@ -11,22 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// AWS Directory Service is a web service that makes it easy for you to setup
|
||||
// and run directories in the AWS cloud, or connect your AWS resources with
|
||||
// an existing on-premises Microsoft Active Directory. This guide provides detailed
|
||||
// information about AWS Directory Service operations, data types, parameters,
|
||||
// and errors. For information about AWS Directory Services features, see AWS
|
||||
// Directory Service (https://aws.amazon.com/directoryservice/) and the AWS
|
||||
// Directory Service Administration Guide (http://docs.aws.amazon.com/directoryservice/latest/admin-guide/what_is.html).
|
||||
// DirectoryService provides the API operation methods for making requests to
|
||||
// AWS Directory Service. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// AWS provides SDKs that consist of libraries and sample code for various programming
|
||||
// languages and platforms (Java, Ruby, .Net, iOS, Android, etc.). The SDKs
|
||||
// provide a convenient way to create programmatic access to AWS Directory Service
|
||||
// and other AWS services. For more information about the AWS SDKs, including
|
||||
// how to download and install them, see Tools for Amazon Web Services (http://aws.amazon.com/tools/).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/ds-2015-04-16
|
||||
// DirectoryService methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type DirectoryService struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package dynamodb provides a client for Amazon DynamoDB.
|
||||
package dynamodb
|
||||
|
||||
import (
|
||||
|
@ -4345,6 +4344,7 @@ func (s *DescribeTimeToLiveInput) SetTableName(v string) *DescribeTimeToLiveInpu
|
|||
type DescribeTimeToLiveOutput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// The description of the Time to Live (TTL) status on the specified table.
|
||||
TimeToLiveDescription *TimeToLiveDescription `type:"structure"`
|
||||
}
|
||||
|
||||
|
|
|
@ -0,0 +1,97 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package dynamodb provides the client and types for making API
|
||||
// requests to Amazon DynamoDB.
|
||||
//
|
||||
// Amazon DynamoDB is a fully managed NoSQL database service that provides fast
|
||||
// and predictable performance with seamless scalability. DynamoDB lets you
|
||||
// offload the administrative burdens of operating and scaling a distributed
|
||||
// database, so that you don't have to worry about hardware provisioning, setup
|
||||
// and configuration, replication, software patching, or cluster scaling.
|
||||
//
|
||||
// With DynamoDB, you can create database tables that can store and retrieve
|
||||
// any amount of data, and serve any level of request traffic. You can scale
|
||||
// up or scale down your tables' throughput capacity without downtime or performance
|
||||
// degradation, and use the AWS Management Console to monitor resource utilization
|
||||
// and performance metrics.
|
||||
//
|
||||
// DynamoDB automatically spreads the data and traffic for your tables over
|
||||
// a sufficient number of servers to handle your throughput and storage requirements,
|
||||
// while maintaining consistent and fast performance. All of your data is stored
|
||||
// on solid state disks (SSDs) and automatically replicated across multiple
|
||||
// Availability Zones in an AWS region, providing built-in high availability
|
||||
// and data durability.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10 for more information on this service.
|
||||
//
|
||||
// See dynamodb package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon DynamoDB you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := dynamodb.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon DynamoDB client DynamoDB for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.BatchGetItem(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("BatchGetItem result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.BatchGetItemWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package dynamodb
|
|
@ -0,0 +1,84 @@
|
|||
// AttributeValue Marshaling and Unmarshaling Helpers
|
||||
//
|
||||
// Utility helpers to marshal and unmarshal AttributeValue to and
|
||||
// from Go types can be found in the dynamodbattribute sub package. This package
|
||||
// provides has specialized functions for the common ways of working with
|
||||
// AttributeValues. Such as map[string]*AttributeValue, []*AttributeValue, and
|
||||
// directly with *AttributeValue. This is helpful for marshaling Go types for API
|
||||
// operations such as PutItem, and unmarshaling Query and Scan APIs' responses.
|
||||
//
|
||||
// See the dynamodbattribute package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/dynamodbattribute/
|
||||
//
|
||||
// AttributeValue Marshaling
|
||||
//
|
||||
// To marshal a Go type to an AttributeValue you can use the Marshal
|
||||
// functions in the dynamodbattribute package. There are specialized versions
|
||||
// of these functions for collections of AttributeValue, such as maps and lists.
|
||||
//
|
||||
// The following example uses MarshalMap to convert the Record Go type to a
|
||||
// dynamodb.AttributeValue type and use the value to make a PutItem API request.
|
||||
//
|
||||
// type Record struct {
|
||||
// ID string
|
||||
// URLs []string
|
||||
// }
|
||||
//
|
||||
// //...
|
||||
//
|
||||
// r := Record{
|
||||
// ID: "ABC123",
|
||||
// URLs: []string{
|
||||
// "https://example.com/first/link",
|
||||
// "https://example.com/second/url",
|
||||
// },
|
||||
// }
|
||||
// av, err := dynamodbattribute.MarshalMap(r)
|
||||
// if err != nil {
|
||||
// panic(fmt.Sprintf("failed to DynamoDB marshal Record, %v", err))
|
||||
// }
|
||||
//
|
||||
// _, err = svc.PutItem(&dynamodb.PutItemInput{
|
||||
// TableName: aws.String(myTableName),
|
||||
// Item: av,
|
||||
// })
|
||||
// if err != nil {
|
||||
// panic(fmt.Sprintf("failed to put Record to DynamoDB, %v", err))
|
||||
// }
|
||||
//
|
||||
// AttributeValue Unmarshaling
|
||||
//
|
||||
// To unmarshal a dynamodb.AttributeValue to a Go type you can use the Unmarshal
|
||||
// functions in the dynamodbattribute package. There are specialized versions
|
||||
// of these functions for collections of AttributeValue, such as maps and lists.
|
||||
//
|
||||
// The following example will unmarshal the DynamoDB's Scan API operation. The
|
||||
// Items returned by the operation will be unmarshaled into the slice of Records
|
||||
// Go type.
|
||||
//
|
||||
// type Record struct {
|
||||
// ID string
|
||||
// URLs []string
|
||||
// }
|
||||
//
|
||||
// //...
|
||||
//
|
||||
// var records []Record
|
||||
//
|
||||
// // Use the ScanPages method to perform the scan with pagination. Use
|
||||
// // just Scan method to make the API call without pagination.
|
||||
// err := svc.ScanPages(&dynamodb.ScanInput{
|
||||
// TableName: aws.String(myTableName),
|
||||
// }, func(page *dynamodb.ScanOutput, last bool) bool {
|
||||
// recs := []Record{}
|
||||
//
|
||||
// err := dynamodbattribute.UnmarshalListOfMaps(page.Items, &recs)
|
||||
// if err != nil {
|
||||
// panic(fmt.Sprintf("failed to unmarshal Dynamodb Scan Items, %v", err))
|
||||
// }
|
||||
//
|
||||
// records = append(records, recs...)
|
||||
//
|
||||
// return true // keep paging
|
||||
// })
|
||||
package dynamodb
|
|
@ -11,27 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Amazon DynamoDB is a fully managed NoSQL database service that provides fast
|
||||
// and predictable performance with seamless scalability. DynamoDB lets you
|
||||
// offload the administrative burdens of operating and scaling a distributed
|
||||
// database, so that you don't have to worry about hardware provisioning, setup
|
||||
// and configuration, replication, software patching, or cluster scaling.
|
||||
// DynamoDB provides the API operation methods for making requests to
|
||||
// Amazon DynamoDB. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// With DynamoDB, you can create database tables that can store and retrieve
|
||||
// any amount of data, and serve any level of request traffic. You can scale
|
||||
// up or scale down your tables' throughput capacity without downtime or performance
|
||||
// degradation, and use the AWS Management Console to monitor resource utilization
|
||||
// and performance metrics.
|
||||
//
|
||||
// DynamoDB automatically spreads the data and traffic for your tables over
|
||||
// a sufficient number of servers to handle your throughput and storage requirements,
|
||||
// while maintaining consistent and fast performance. All of your data is stored
|
||||
// on solid state disks (SSDs) and automatically replicated across multiple
|
||||
// Availability Zones in an AWS region, providing built-in high availability
|
||||
// and data durability.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10
|
||||
// DynamoDB methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type DynamoDB struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package ec2 provides a client for Amazon Elastic Compute Cloud.
|
||||
package ec2
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,83 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package ec2 provides the client and types for making API
|
||||
// requests to Amazon Elastic Compute Cloud.
|
||||
//
|
||||
// Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity
|
||||
// in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your
|
||||
// need to invest in hardware up front, so you can develop and deploy applications
|
||||
// faster.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15 for more information on this service.
|
||||
//
|
||||
// See ec2 package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon Elastic Compute Cloud you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := ec2.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon Elastic Compute Cloud client EC2 for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/ec2/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AcceptReservedInstancesExchangeQuote(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AcceptReservedInstancesExchangeQuote result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AcceptReservedInstancesExchangeQuoteWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package ec2
|
|
@ -11,13 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/ec2query"
|
||||
)
|
||||
|
||||
// Amazon Elastic Compute Cloud (Amazon EC2) provides resizable computing capacity
|
||||
// in the Amazon Web Services (AWS) cloud. Using Amazon EC2 eliminates your
|
||||
// need to invest in hardware up front, so you can develop and deploy applications
|
||||
// faster.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15
|
||||
// EC2 provides the API operation methods for making requests to
|
||||
// Amazon Elastic Compute Cloud. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// EC2 methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type EC2 struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package ecr provides a client for Amazon EC2 Container Registry.
|
||||
package ecr
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,85 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package ecr provides the client and types for making API
|
||||
// requests to Amazon EC2 Container Registry.
|
||||
//
|
||||
// Amazon EC2 Container Registry (Amazon ECR) is a managed AWS Docker registry
|
||||
// service. Customers can use the familiar Docker CLI to push, pull, and manage
|
||||
// images. Amazon ECR provides a secure, scalable, and reliable registry. Amazon
|
||||
// ECR supports private Docker repositories with resource-based permissions
|
||||
// using AWS IAM so that specific users or Amazon EC2 instances can access repositories
|
||||
// and images. Developers can use the Docker CLI to author and manage images.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21 for more information on this service.
|
||||
//
|
||||
// See ecr package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/ecr/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon EC2 Container Registry you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := ecr.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon EC2 Container Registry client ECR for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/ecr/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.BatchCheckLayerAvailability(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("BatchCheckLayerAvailability result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.BatchCheckLayerAvailabilityWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package ecr
|
|
@ -11,15 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Amazon EC2 Container Registry (Amazon ECR) is a managed AWS Docker registry
|
||||
// service. Customers can use the familiar Docker CLI to push, pull, and manage
|
||||
// images. Amazon ECR provides a secure, scalable, and reliable registry. Amazon
|
||||
// ECR supports private Docker repositories with resource-based permissions
|
||||
// using AWS IAM so that specific users or Amazon EC2 instances can access repositories
|
||||
// and images. Developers can use the Docker CLI to author and manage images.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21
|
||||
// ECR provides the API operation methods for making requests to
|
||||
// Amazon EC2 Container Registry. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// ECR methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ECR struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package ecs provides a client for Amazon EC2 Container Service.
|
||||
package ecs
|
||||
|
||||
import (
|
||||
|
@ -169,23 +168,23 @@ func (c *ECS) CreateServiceRequest(input *CreateServiceInput) (req *request.Requ
|
|||
// service's tasks that must remain in the RUNNING state during a deployment,
|
||||
// as a percentage of the desiredCount (rounded up to the nearest integer).
|
||||
// This parameter enables you to deploy without using additional cluster capacity.
|
||||
// For example, if desiredCount is four tasks and the minimum is 50%, the scheduler
|
||||
// can stop two existing tasks to free up cluster capacity before starting two
|
||||
// new tasks. Tasks for services that do not use a load balancer are considered
|
||||
// healthy if they are in the RUNNING state. Tasks for services that use a load
|
||||
// balancer are considered healthy if they are in the RUNNING state and the
|
||||
// container instance they are hosted on is reported as healthy by the load
|
||||
// balancer. The default value is 50% in the console and 100% for the AWS CLI,
|
||||
// the AWS SDKs, and the APIs.
|
||||
// For example, if your service has a desiredCount of four tasks and a minimumHealthyPercent
|
||||
// of 50%, the scheduler can stop two existing tasks to free up cluster capacity
|
||||
// before starting two new tasks. Tasks for services that do not use a load
|
||||
// balancer are considered healthy if they are in the RUNNING state. Tasks for
|
||||
// services that do use a load balancer are considered healthy if they are in
|
||||
// the RUNNING state and the container instance they are hosted on is reported
|
||||
// as healthy by the load balancer. The default value for minimumHealthyPercent
|
||||
// is 50% in the console and 100% for the AWS CLI, the AWS SDKs, and the APIs.
|
||||
//
|
||||
// The maximumPercent parameter represents an upper limit on the number of your
|
||||
// service's tasks that are allowed in the RUNNING or PENDING state during a
|
||||
// deployment, as a percentage of the desiredCount (rounded down to the nearest
|
||||
// integer). This parameter enables you to define the deployment batch size.
|
||||
// For example, if desiredCount is four tasks and the maximum is 200%, the scheduler
|
||||
// can start four new tasks before stopping the four older tasks (provided that
|
||||
// the cluster resources required to do this are available). The default value
|
||||
// is 200%.
|
||||
// For example, if your service has a desiredCount of four tasks and a maximumPercent
|
||||
// value of 200%, the scheduler can start four new tasks before stopping the
|
||||
// four older tasks (provided that the cluster resources required to do this
|
||||
// are available). The default value for maximumPercent is 200%.
|
||||
//
|
||||
// When the service scheduler launches new tasks, it determines task placement
|
||||
// in your cluster using the following logic:
|
||||
|
@ -195,7 +194,8 @@ func (c *ECS) CreateServiceRequest(input *CreateServiceInput) (req *request.Requ
|
|||
// memory, ports, and container instance attributes).
|
||||
//
|
||||
// * By default, the service scheduler attempts to balance tasks across Availability
|
||||
// Zones in this manner (although you can choose a different placement strategy):
|
||||
// Zones in this manner (although you can choose a different placement strategy)
|
||||
// with the placementStrategy parameter):
|
||||
//
|
||||
// Sort the valid container instances by the fewest number of running tasks
|
||||
// for this service in the same Availability Zone as the instance. For example,
|
||||
|
@ -721,6 +721,11 @@ func (c *ECS) DeregisterTaskDefinitionRequest(input *DeregisterTaskDefinitionInp
|
|||
// task definition (although there may be up to a 10 minute window following
|
||||
// deregistration where these restrictions have not yet taken effect).
|
||||
//
|
||||
// At this time, INACTIVE task definitions remain discoverable in your account
|
||||
// indefinitely; however, this behavior is subject to change in the future,
|
||||
// so you should not rely on INACTIVE task definitions persisting beyond the
|
||||
// life cycle of any associated tasks and services.
|
||||
//
|
||||
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
|
||||
// with awserr.Error's Code and Message methods to get detailed information about
|
||||
// the error.
|
||||
|
@ -1361,7 +1366,7 @@ func (c *ECS) ListAttributesRequest(input *ListAttributesInput) (req *request.Re
|
|||
// ListAttributes API operation for Amazon EC2 Container Service.
|
||||
//
|
||||
// Lists the attributes for Amazon ECS resources within a specified target type
|
||||
// and cluster. When you specify a target type and cluster, LisAttributes returns
|
||||
// and cluster. When you specify a target type and cluster, ListAttributes returns
|
||||
// a list of attribute objects, one for each attribute on each resource. You
|
||||
// can filter the list of results to a single attribute name to only return
|
||||
// results that have that name. You can also filter the results by attribute
|
||||
|
@ -2849,10 +2854,15 @@ func (c *ECS) StopTaskRequest(input *StopTaskInput) (req *request.Request, outpu
|
|||
// Stops a running task.
|
||||
//
|
||||
// When StopTask is called on a task, the equivalent of docker stop is issued
|
||||
// to the containers running in the task. This results in a SIGTERM and a 30-second
|
||||
// timeout, after which SIGKILL is sent and the containers are forcibly stopped.
|
||||
// If the container handles the SIGTERM gracefully and exits within 30 seconds
|
||||
// from receiving it, no SIGKILL is sent.
|
||||
// to the containers running in the task. This results in a SIGTERM and a default
|
||||
// 30-second timeout, after which SIGKILL is sent and the containers are forcibly
|
||||
// stopped. If the container handles the SIGTERM gracefully and exits within
|
||||
// 30 seconds from receiving it, no SIGKILL is sent.
|
||||
//
|
||||
// The default 30-second timeout can be configured on the Amazon ECS container
|
||||
// agent with the ECS_CONTAINER_STOP_TIMEOUT variable. For more information,
|
||||
// see Amazon ECS Container Agent Configuration (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html)
|
||||
// in the Amazon EC2 Container Service Developer Guide.
|
||||
//
|
||||
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
|
||||
// with awserr.Error's Code and Message methods to get detailed information about
|
||||
|
@ -4310,6 +4320,9 @@ type ContainerInstance struct {
|
|||
// The number of tasks on the container instance that are in the PENDING status.
|
||||
PendingTasksCount *int64 `locationName:"pendingTasksCount" type:"integer"`
|
||||
|
||||
// The Unix timestamp for when the container instance was registered.
|
||||
RegisteredAt *time.Time `locationName:"registeredAt" type:"timestamp" timestampFormat:"unix"`
|
||||
|
||||
// For most resource types, this parameter describes the registered resources
|
||||
// on the container instance that are in use by current tasks. For port resource
|
||||
// types, this parameter describes the ports that were reserved by the Amazon
|
||||
|
@ -4327,8 +4340,12 @@ type ContainerInstance struct {
|
|||
// The number of tasks on the container instance that are in the RUNNING status.
|
||||
RunningTasksCount *int64 `locationName:"runningTasksCount" type:"integer"`
|
||||
|
||||
// The status of the container instance. The valid values are ACTIVE or INACTIVE.
|
||||
// ACTIVE indicates that the container instance can accept tasks.
|
||||
// The status of the container instance. The valid values are ACTIVE, INACTIVE,
|
||||
// or DRAINING. ACTIVE indicates that the container instance can accept tasks.
|
||||
// DRAINING indicates that new tasks are not placed on the container instance
|
||||
// and any service tasks running on the container instance are removed if possible.
|
||||
// For more information, see Container Instance Draining (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-draining.html)
|
||||
// in the Amazon EC2 Container Service Developer Guide.
|
||||
Status *string `locationName:"status" type:"string"`
|
||||
|
||||
// The version counter for the container instance. Every time a container instance
|
||||
|
@ -4391,6 +4408,12 @@ func (s *ContainerInstance) SetPendingTasksCount(v int64) *ContainerInstance {
|
|||
return s
|
||||
}
|
||||
|
||||
// SetRegisteredAt sets the RegisteredAt field's value.
|
||||
func (s *ContainerInstance) SetRegisteredAt(v time.Time) *ContainerInstance {
|
||||
s.RegisteredAt = &v
|
||||
return s
|
||||
}
|
||||
|
||||
// SetRegisteredResources sets the RegisteredResources field's value.
|
||||
func (s *ContainerInstance) SetRegisteredResources(v []*Resource) *ContainerInstance {
|
||||
s.RegisteredResources = v
|
||||
|
@ -4433,15 +4456,18 @@ type ContainerOverride struct {
|
|||
_ struct{} `type:"structure"`
|
||||
|
||||
// The command to send to the container that overrides the default command from
|
||||
// the Docker image or the task definition.
|
||||
// the Docker image or the task definition. You must also specify a container
|
||||
// name.
|
||||
Command []*string `locationName:"command" type:"list"`
|
||||
|
||||
// The environment variables to send to the container. You can add new environment
|
||||
// variables, which are added to the container at launch, or you can override
|
||||
// the existing environment variables from the Docker image or the task definition.
|
||||
// You must also specify a container name.
|
||||
Environment []*KeyValuePair `locationName:"environment" type:"list"`
|
||||
|
||||
// The name of the container that receives the override.
|
||||
// The name of the container that receives the override. This parameter is required
|
||||
// if a command or environment variable is specified.
|
||||
Name *string `locationName:"name" type:"string"`
|
||||
}
|
||||
|
||||
|
@ -4730,7 +4756,7 @@ type DeleteAttributesInput struct {
|
|||
Attributes []*Attribute `locationName:"attributes" type:"list" required:"true"`
|
||||
|
||||
// The short name or full Amazon Resource Name (ARN) of the cluster that contains
|
||||
// the resource to apply attributes. If you do not specify a cluster, the default
|
||||
// the resource to delete attributes. If you do not specify a cluster, the default
|
||||
// cluster is assumed.
|
||||
Cluster *string `locationName:"cluster" type:"string"`
|
||||
}
|
||||
|
@ -4871,8 +4897,9 @@ func (s *DeleteClusterOutput) SetCluster(v *Cluster) *DeleteClusterOutput {
|
|||
type DeleteServiceInput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// The name of the cluster that hosts the service to delete. If you do not specify
|
||||
// a cluster, the default cluster is assumed.
|
||||
// The short name or full Amazon Resource Name (ARN) of the cluster that hosts
|
||||
// the service to delete. If you do not specify a cluster, the default cluster
|
||||
// is assumed.
|
||||
Cluster *string `locationName:"cluster" type:"string"`
|
||||
|
||||
// The name of the service to delete.
|
||||
|
@ -5240,9 +5267,8 @@ func (s *DeregisterTaskDefinitionOutput) SetTaskDefinition(v *TaskDefinition) *D
|
|||
type DescribeClustersInput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// A space-separated list of up to 100 cluster names or full cluster Amazon
|
||||
// Resource Name (ARN) entries. If you do not specify a cluster, the default
|
||||
// cluster is assumed.
|
||||
// A list of up to 100 cluster names or full cluster Amazon Resource Name (ARN)
|
||||
// entries. If you do not specify a cluster, the default cluster is assumed.
|
||||
Clusters []*string `locationName:"clusters" type:"list"`
|
||||
}
|
||||
|
||||
|
@ -5304,8 +5330,7 @@ type DescribeContainerInstancesInput struct {
|
|||
// default cluster is assumed.
|
||||
Cluster *string `locationName:"cluster" type:"string"`
|
||||
|
||||
// A space-separated list of container instance IDs or full Amazon Resource
|
||||
// Name (ARN) entries.
|
||||
// A list of container instance IDs or full Amazon Resource Name (ARN) entries.
|
||||
//
|
||||
// ContainerInstances is a required field
|
||||
ContainerInstances []*string `locationName:"containerInstances" type:"list" required:"true"`
|
||||
|
@ -5383,8 +5408,9 @@ func (s *DescribeContainerInstancesOutput) SetFailures(v []*Failure) *DescribeCo
|
|||
type DescribeServicesInput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// The name of the cluster that hosts the service to describe. If you do not
|
||||
// specify a cluster, the default cluster is assumed.
|
||||
// The short name or full Amazon Resource Name (ARN)the cluster that hosts the
|
||||
// service to describe. If you do not specify a cluster, the default cluster
|
||||
// is assumed.
|
||||
Cluster *string `locationName:"cluster" type:"string"`
|
||||
|
||||
// A list of services to describe. You may specify up to 10 services to describe
|
||||
|
@ -5536,7 +5562,7 @@ type DescribeTasksInput struct {
|
|||
// is assumed.
|
||||
Cluster *string `locationName:"cluster" type:"string"`
|
||||
|
||||
// A space-separated list of task IDs or full Amazon Resource Name (ARN) entries.
|
||||
// A list of up to 100 task IDs or full Amazon Resource Name (ARN) entries.
|
||||
//
|
||||
// Tasks is a required field
|
||||
Tasks []*string `locationName:"tasks" type:"list" required:"true"`
|
||||
|
@ -5614,7 +5640,8 @@ func (s *DescribeTasksOutput) SetTasks(v []*Task) *DescribeTasksOutput {
|
|||
type DiscoverPollEndpointInput struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
||||
// The cluster that the container instance belongs to.
|
||||
// The short name or full Amazon Resource Name (ARN) of the cluster that the
|
||||
// container instance belongs to.
|
||||
Cluster *string `locationName:"cluster" type:"string"`
|
||||
|
||||
// The container instance ID or full Amazon Resource Name (ARN) of the container
|
||||
|
@ -6087,10 +6114,11 @@ type ListContainerInstancesInput struct {
|
|||
// retrieve the next items in a list and not for other programmatic purposes.
|
||||
NextToken *string `locationName:"nextToken" type:"string"`
|
||||
|
||||
// The container instance status with which to filter the ListContainerInstances
|
||||
// results. Specifying a container instance status of DRAINING limits the results
|
||||
// to container instances that have been set to drain with the UpdateContainerInstancesState
|
||||
// operation.
|
||||
// Filters the container instances by status. For example, if you specify the
|
||||
// DRAINING status, the results include only container instances that have been
|
||||
// set to DRAINING using UpdateContainerInstancesState. If you do not specify
|
||||
// this parameter, the default is to include container instances set to ACTIVE
|
||||
// and DRAINING.
|
||||
Status *string `locationName:"status" type:"string" enum:"ContainerInstanceStatus"`
|
||||
}
|
||||
|
||||
|
@ -6660,7 +6688,7 @@ type LoadBalancer struct {
|
|||
// mapping.
|
||||
ContainerPort *int64 `locationName:"containerPort" type:"integer"`
|
||||
|
||||
// The name of the load balancer.
|
||||
// The name of a Classic load balancer.
|
||||
LoadBalancerName *string `locationName:"loadBalancerName" type:"string"`
|
||||
|
||||
// The full Amazon Resource Name (ARN) of the Elastic Load Balancing target
|
||||
|
@ -8780,8 +8808,7 @@ type UpdateContainerInstancesStateInput struct {
|
|||
// cluster is assumed.
|
||||
Cluster *string `locationName:"cluster" type:"string"`
|
||||
|
||||
// A space-separated list of container instance IDs or full Amazon Resource
|
||||
// Name (ARN) entries.
|
||||
// A list of container instance IDs or full Amazon Resource Name (ARN) entries.
|
||||
//
|
||||
// ContainerInstances is a required field
|
||||
ContainerInstances []*string `locationName:"containerInstances" type:"list" required:"true"`
|
||||
|
@ -9061,7 +9088,7 @@ func (s *Volume) SetName(v string) *Volume {
|
|||
return s
|
||||
}
|
||||
|
||||
// Details on a data volume from another container.
|
||||
// Details on a data volume from another container in the same task definition.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/VolumeFrom
|
||||
type VolumeFrom struct {
|
||||
_ struct{} `type:"structure"`
|
||||
|
@ -9071,7 +9098,8 @@ type VolumeFrom struct {
|
|||
// value is false.
|
||||
ReadOnly *bool `locationName:"readOnly" type:"boolean"`
|
||||
|
||||
// The name of the container to mount volumes from.
|
||||
// The name of another container within the same task definition to mount volumes
|
||||
// from.
|
||||
SourceContainer *string `locationName:"sourceContainer" type:"string"`
|
||||
}
|
||||
|
||||
|
|
|
@ -0,0 +1,91 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package ecs provides the client and types for making API
|
||||
// requests to Amazon EC2 Container Service.
|
||||
//
|
||||
// Amazon EC2 Container Service (Amazon ECS) is a highly scalable, fast, container
|
||||
// management service that makes it easy to run, stop, and manage Docker containers
|
||||
// on a cluster of EC2 instances. Amazon ECS lets you launch and stop container-enabled
|
||||
// applications with simple API calls, allows you to get the state of your cluster
|
||||
// from a centralized service, and gives you access to many familiar Amazon
|
||||
// EC2 features like security groups, Amazon EBS volumes, and IAM roles.
|
||||
//
|
||||
// You can use Amazon ECS to schedule the placement of containers across your
|
||||
// cluster based on your resource needs, isolation policies, and availability
|
||||
// requirements. Amazon EC2 Container Service eliminates the need for you to
|
||||
// operate your own cluster management and configuration management systems
|
||||
// or worry about scaling your management infrastructure.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13 for more information on this service.
|
||||
//
|
||||
// See ecs package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/ecs/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon EC2 Container Service you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := ecs.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon EC2 Container Service client ECS for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/ecs/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CreateCluster(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CreateCluster result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CreateClusterWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package ecs
|
|
@ -11,21 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
|
||||
)
|
||||
|
||||
// Amazon EC2 Container Service (Amazon ECS) is a highly scalable, fast, container
|
||||
// management service that makes it easy to run, stop, and manage Docker containers
|
||||
// on a cluster of EC2 instances. Amazon ECS lets you launch and stop container-enabled
|
||||
// applications with simple API calls, allows you to get the state of your cluster
|
||||
// from a centralized service, and gives you access to many familiar Amazon
|
||||
// EC2 features like security groups, Amazon EBS volumes, and IAM roles.
|
||||
// ECS provides the API operation methods for making requests to
|
||||
// Amazon EC2 Container Service. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// You can use Amazon ECS to schedule the placement of containers across your
|
||||
// cluster based on your resource needs, isolation policies, and availability
|
||||
// requirements. Amazon EC2 Container Service eliminates the need for you to
|
||||
// operate your own cluster management and configuration management systems
|
||||
// or worry about scaling your management infrastructure.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13
|
||||
// ECS methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ECS struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package efs provides a client for Amazon Elastic File System.
|
||||
package efs
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,84 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package efs provides the client and types for making API
|
||||
// requests to Amazon Elastic File System.
|
||||
//
|
||||
// Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage
|
||||
// for use with Amazon EC2 instances in the AWS Cloud. With Amazon EFS, storage
|
||||
// capacity is elastic, growing and shrinking automatically as you add and remove
|
||||
// files, so your applications have the storage they need, when they need it.
|
||||
// For more information, see the User Guide (http://docs.aws.amazon.com/efs/latest/ug/api-reference.html).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01 for more information on this service.
|
||||
//
|
||||
// See efs package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/efs/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon Elastic File System you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := efs.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon Elastic File System client EFS for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/efs/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CreateFileSystem(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CreateFileSystem result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CreateFileSystemWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package efs
|
|
@ -11,14 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/restjson"
|
||||
)
|
||||
|
||||
// Amazon Elastic File System (Amazon EFS) provides simple, scalable file storage
|
||||
// for use with Amazon EC2 instances in the AWS Cloud. With Amazon EFS, storage
|
||||
// capacity is elastic, growing and shrinking automatically as you add and remove
|
||||
// files, so your applications have the storage they need, when they need it.
|
||||
// For more information, see the User Guide (http://docs.aws.amazon.com/efs/latest/ug/api-reference.html).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01
|
||||
// EFS provides the API operation methods for making requests to
|
||||
// Amazon Elastic File System. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// EFS methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type EFS struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elasticache provides a client for Amazon ElastiCache.
|
||||
package elasticache
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,90 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elasticache provides the client and types for making API
|
||||
// requests to Amazon ElastiCache.
|
||||
//
|
||||
// Amazon ElastiCache is a web service that makes it easier to set up, operate,
|
||||
// and scale a distributed cache in the cloud.
|
||||
//
|
||||
// With ElastiCache, customers get all of the benefits of a high-performance,
|
||||
// in-memory cache with less of the administrative burden involved in launching
|
||||
// and managing a distributed cache. The service makes setup, scaling, and cluster
|
||||
// failure handling much simpler than in a self-managed cache deployment.
|
||||
//
|
||||
// In addition, through integration with Amazon CloudWatch, customers get enhanced
|
||||
// visibility into the key performance statistics associated with their cache
|
||||
// and can receive alarms if a part of their cache runs hot.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/elasticache-2015-02-02 for more information on this service.
|
||||
//
|
||||
// See elasticache package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elasticache/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon ElastiCache you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := elasticache.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon ElastiCache client ElastiCache for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elasticache/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AddTagsToResource(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AddTagsToResource result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AddTagsToResourceWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package elasticache
|
|
@ -11,20 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/query"
|
||||
)
|
||||
|
||||
// Amazon ElastiCache is a web service that makes it easier to set up, operate,
|
||||
// and scale a distributed cache in the cloud.
|
||||
// ElastiCache provides the API operation methods for making requests to
|
||||
// Amazon ElastiCache. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// With ElastiCache, customers get all of the benefits of a high-performance,
|
||||
// in-memory cache with less of the administrative burden involved in launching
|
||||
// and managing a distributed cache. The service makes setup, scaling, and cluster
|
||||
// failure handling much simpler than in a self-managed cache deployment.
|
||||
//
|
||||
// In addition, through integration with Amazon CloudWatch, customers get enhanced
|
||||
// visibility into the key performance statistics associated with their cache
|
||||
// and can receive alarms if a part of their cache runs hot.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticache-2015-02-02
|
||||
// ElastiCache methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ElastiCache struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elasticbeanstalk provides a client for AWS Elastic Beanstalk.
|
||||
package elasticbeanstalk
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,96 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elasticbeanstalk provides the client and types for making API
|
||||
// requests to AWS Elastic Beanstalk.
|
||||
//
|
||||
// AWS Elastic Beanstalk makes it easy for you to create, deploy, and manage
|
||||
// scalable, fault-tolerant applications running on the Amazon Web Services
|
||||
// cloud.
|
||||
//
|
||||
// For more information about this product, go to the AWS Elastic Beanstalk
|
||||
// (http://aws.amazon.com/elasticbeanstalk/) details page. The location of the
|
||||
// latest AWS Elastic Beanstalk WSDL is http://elasticbeanstalk.s3.amazonaws.com/doc/2010-12-01/AWSElasticBeanstalk.wsdl
|
||||
// (http://elasticbeanstalk.s3.amazonaws.com/doc/2010-12-01/AWSElasticBeanstalk.wsdl).
|
||||
// To install the Software Development Kits (SDKs), Integrated Development Environment
|
||||
// (IDE) Toolkits, and command line tools that enable you to access the API,
|
||||
// go to Tools for Amazon Web Services (http://aws.amazon.com/tools/).
|
||||
//
|
||||
// Endpoints
|
||||
//
|
||||
// For a list of region-specific endpoints that AWS Elastic Beanstalk supports,
|
||||
// go to Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#elasticbeanstalk_region)
|
||||
// in the Amazon Web Services Glossary.
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/elasticbeanstalk-2010-12-01 for more information on this service.
|
||||
//
|
||||
// See elasticbeanstalk package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elasticbeanstalk/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for AWS Elastic Beanstalk you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := elasticbeanstalk.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the AWS Elastic Beanstalk client ElasticBeanstalk for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elasticbeanstalk/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AbortEnvironmentUpdate(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AbortEnvironmentUpdate result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AbortEnvironmentUpdateWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package elasticbeanstalk
|
|
@ -11,26 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/query"
|
||||
)
|
||||
|
||||
// AWS Elastic Beanstalk makes it easy for you to create, deploy, and manage
|
||||
// scalable, fault-tolerant applications running on the Amazon Web Services
|
||||
// cloud.
|
||||
// ElasticBeanstalk provides the API operation methods for making requests to
|
||||
// AWS Elastic Beanstalk. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// For more information about this product, go to the AWS Elastic Beanstalk
|
||||
// (http://aws.amazon.com/elasticbeanstalk/) details page. The location of the
|
||||
// latest AWS Elastic Beanstalk WSDL is http://elasticbeanstalk.s3.amazonaws.com/doc/2010-12-01/AWSElasticBeanstalk.wsdl
|
||||
// (http://elasticbeanstalk.s3.amazonaws.com/doc/2010-12-01/AWSElasticBeanstalk.wsdl).
|
||||
// To install the Software Development Kits (SDKs), Integrated Development Environment
|
||||
// (IDE) Toolkits, and command line tools that enable you to access the API,
|
||||
// go to Tools for Amazon Web Services (http://aws.amazon.com/tools/).
|
||||
//
|
||||
// Endpoints
|
||||
//
|
||||
// For a list of region-specific endpoints that AWS Elastic Beanstalk supports,
|
||||
// go to Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#elasticbeanstalk_region)
|
||||
// in the Amazon Web Services Glossary.
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticbeanstalk-2010-12-01
|
||||
// ElasticBeanstalk methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ElasticBeanstalk struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elasticsearchservice provides a client for Amazon Elasticsearch Service.
|
||||
package elasticsearchservice
|
||||
|
||||
import (
|
||||
|
|
85
vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/doc.go
generated
vendored
Normal file
85
vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/doc.go
generated
vendored
Normal file
|
@ -0,0 +1,85 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elasticsearchservice provides the client and types for making API
|
||||
// requests to Amazon Elasticsearch Service.
|
||||
//
|
||||
// Use the Amazon Elasticsearch configuration API to create, configure, and
|
||||
// manage Elasticsearch domains.
|
||||
//
|
||||
// The endpoint for configuration service requests is region-specific: es.region.amazonaws.com.
|
||||
// For example, es.us-east-1.amazonaws.com. For a current list of supported
|
||||
// regions and endpoints, see Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#elasticsearch-service-regions).
|
||||
//
|
||||
// See https://docs.aws.amazon.com/goto/WebAPI/es-2015-01-01 for more information on this service.
|
||||
//
|
||||
// See elasticsearchservice package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elasticsearchservice/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon Elasticsearch Service you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := elasticsearchservice.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon Elasticsearch Service client ElasticsearchService for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elasticsearchservice/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.AddTags(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("AddTags result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.AddTagsWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package elasticsearchservice
|
|
@ -11,15 +11,12 @@ import (
|
|||
"github.com/aws/aws-sdk-go/private/protocol/restjson"
|
||||
)
|
||||
|
||||
// Use the Amazon Elasticsearch configuration API to create, configure, and
|
||||
// manage Elasticsearch domains.
|
||||
// ElasticsearchService provides the API operation methods for making requests to
|
||||
// Amazon Elasticsearch Service. See this package's package overview docs
|
||||
// for details on the service.
|
||||
//
|
||||
// The endpoint for configuration service requests is region-specific: es.region.amazonaws.com.
|
||||
// For example, es.us-east-1.amazonaws.com. For a current list of supported
|
||||
// regions and endpoints, see Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#elasticsearch-service-regions).
|
||||
// The service client's operations are safe to be used concurrently.
|
||||
// It is not safe to mutate any of the client's properties though.
|
||||
// Please also see https://docs.aws.amazon.com/goto/WebAPI/es-2015-01-01
|
||||
// ElasticsearchService methods are safe to use concurrently. It is not safe to
|
||||
// modify mutate any of the struct's properties though.
|
||||
type ElasticsearchService struct {
|
||||
*client.Client
|
||||
}
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elastictranscoder provides a client for Amazon Elastic Transcoder.
|
||||
package elastictranscoder
|
||||
|
||||
import (
|
||||
|
|
|
@ -0,0 +1,78 @@
|
|||
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
||||
|
||||
// Package elastictranscoder provides the client and types for making API
|
||||
// requests to Amazon Elastic Transcoder.
|
||||
//
|
||||
// The AWS Elastic Transcoder Service.
|
||||
//
|
||||
// See elastictranscoder package documentation for more information.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elastictranscoder/
|
||||
//
|
||||
// Using the Client
|
||||
//
|
||||
// To use the client for Amazon Elastic Transcoder you will first need
|
||||
// to create a new instance of it.
|
||||
//
|
||||
// When creating a client for an AWS service you'll first need to have a Session
|
||||
// already created. The Session provides configuration that can be shared
|
||||
// between multiple service clients. Additional configuration can be applied to
|
||||
// the Session and service's client when they are constructed. The aws package's
|
||||
// Config type contains several fields such as Region for the AWS Region the
|
||||
// client should make API requests too. The optional Config value can be provided
|
||||
// as the variadic argument for Sessions and client creation.
|
||||
//
|
||||
// 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.
|
||||
//
|
||||
// // Create a session to share configuration, and load external configuration.
|
||||
// sess := session.Must(session.NewSession())
|
||||
//
|
||||
// // Create the service's client with the session.
|
||||
// svc := elastictranscoder.New(sess)
|
||||
//
|
||||
// See the SDK's documentation for more information on how to use service clients.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/
|
||||
//
|
||||
// See aws package's Config type for more information on configuration options.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
|
||||
//
|
||||
// See the Amazon Elastic Transcoder client ElasticTranscoder for more
|
||||
// information on creating the service's client.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/service/elastictranscoder/#New
|
||||
//
|
||||
// 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 API method will document which error codes the service can be returned
|
||||
// by the operation if the service models the API operation's errors. These
|
||||
// errors will also be available as const strings prefixed with "ErrCode".
|
||||
//
|
||||
// result, err := svc.CancelJob(params)
|
||||
// if err != nil {
|
||||
// // Cast err to awserr.Error to handle specific error codes.
|
||||
// aerr, ok := err.(awserr.Error)
|
||||
// if ok && aerr.Code() == <error code to check for> {
|
||||
// // Specific error code handling
|
||||
// }
|
||||
// return err
|
||||
// }
|
||||
//
|
||||
// fmt.Println("CancelJob result:")
|
||||
// fmt.Println(result)
|
||||
//
|
||||
// Using the Client with Context
|
||||
//
|
||||
// The service's client also provides methods to make API requests with a Context
|
||||
// value. This allows you to control the timeout, and cancellation of pending
|
||||
// requests. These methods also take request Option as variadic parameter to apply
|
||||
// additional configuration to the API request.
|
||||
//
|
||||
// ctx := context.Background()
|
||||
//
|
||||
// result, err := svc.CancelJobWithContext(ctx, params)
|
||||
//
|
||||
// See the request package documentation for more information on using Context pattern
|
||||
// with the SDK.
|
||||
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
|
||||
package elastictranscoder
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue