diff options
| author | Dave Henderson <dhenderson@gmail.com> | 2017-05-19 23:09:42 -0400 |
|---|---|---|
| committer | Dave Henderson <dhenderson@gmail.com> | 2017-05-19 23:09:42 -0400 |
| commit | 7a66f5b55e55879c237b87f659a2307ff29a3040 (patch) | |
| tree | bdfca619cfc570e78b2defcdcd6b172b0b665a67 /vendor/github.com | |
| parent | 7f60597fdf8a2dce653eea2c1ff6d4d3e1f4c77c (diff) | |
Updating aws-sdk-go dep to 1.8.26
Signed-off-by: Dave Henderson <dhenderson@gmail.com>
Diffstat (limited to 'vendor/github.com')
465 files changed, 27582 insertions, 4842 deletions
diff --git a/vendor/github.com/aws/aws-sdk-go/CHANGELOG.md b/vendor/github.com/aws/aws-sdk-go/CHANGELOG.md index f3f434ea..950ffd17 100644 --- a/vendor/github.com/aws/aws-sdk-go/CHANGELOG.md +++ b/vendor/github.com/aws/aws-sdk-go/CHANGELOG.md @@ -1,3 +1,105 @@ +Release v1.8.26 (2017-05-18) +=== + +### Service Client Updates +* `service/athena`: Adds new service + * This release adds support for Amazon Athena. Amazon Athena is an interactive query service that makes it easy to analyze data in Amazon S3 using standard SQL. Athena is serverless, so there is no infrastructure to manage, and you pay only for the queries that you run. +* `service/lightsail`: Updates service API, documentation, and paginators + * This release adds new APIs that make it easier to set network port configurations on Lightsail instances. Developers can now make a single request to both open and close public ports on an instance using the PutInstancePublicPorts operation. + +### SDK Bugs +* `aws/request`: Fix logging from reporting wrong retry request errors #1281 + * Fixes the SDK's retry request logging to report the the actual error that occurred, not a stubbed Unknown error message. + * Fixes the SDK's response logger to not output the response log multiple times per retry. +Release v1.8.25 (2017-05-17) +=== + +### Service Client Updates +* `service/autoscaling`: Updates service documentation, paginators, and examples + * Various Auto Scaling documentation updates +* `service/cloudwatchevents`: Updates service documentation + * Various CloudWatch Events documentation updates. +* `service/cloudwatchlogs`: Updates service documentation and paginators + * Various CloudWatch Logs documentation updates. +* `service/polly`: Updates service API + * Amazon Polly adds new German voice "Vicki" + +Release v1.8.24 (2017-05-16) +=== + +### Service Client Updates +* `service/codedeploy`: Updates service API and documentation + * This release introduces the previousRevision field in the responses to the GetDeployment and BatchGetDeployments actions. previousRevision provides information about the application revision that was deployed to the deployment group before the most recent successful deployment. Also, the fileExistsBehavior parameter has been added for CreateDeployment action requests. In the past, if the AWS CodeDeploy agent detected files in a target location that weren't part of the application revision from the most recent successful deployment, it would fail the current deployment by default. This new parameter provides options for how the agent handles these files: fail the deployment, retain the content, or overwrite the content. +* `service/gamelift`: Updates service API and documentation + * Allow developers to specify how metrics are grouped in CloudWatch for their GameLift fleets. Developers can also specify how many concurrent game sessions activate on a per-instance basis. +* `service/inspector`: Updates service API, documentation, paginators, and examples + * Adds ability to produce an assessment report that includes detailed and comprehensive results of a specified assessment run. +* `service/kms`: Updates service documentation + * Update documentation for KMS. + +Release v1.8.23 (2017-05-15) +=== + +### Service Client Updates +* `service/ssm`: Updates service API and documentation + * UpdateAssociation API now supports updating document name and targets of an association. GetAutomationExecution API can return FailureDetails as an optional field to the StepExecution Object, which contains failure type, failure stage as well as other failure related information for a failed step. + +### SDK Enhancements +* `aws/session`: SDK should be able to load multiple custom shared config files. [#1258](https://github.com/aws/aws-sdk-go/issues/1258) + * This change adds a `SharedConfigFiles` field to the `session.Options` type that allows you to specify the files, and their order, the SDK will use for loading shared configuration and credentials from when the `Session` is created. Use the `NewSessionWithOptions` Session constructor to specify these options. You'll also most likely want to enable support for the shared configuration file's additional attributes by setting `session.Option`'s `SharedConfigState` to `session.SharedConfigEnabled`. + +Release v1.8.22 (2017-05-11) +=== + +### Service Client Updates +* `service/elb`: Updates service API, documentation, and paginators +* `service/elbv2`: Updates service API and documentation +* `service/lexmodelbuildingservice`: Updates service API and documentation +* `service/organizations`: Updates service API, documentation, paginators, and examples + * AWS Organizations APIs that return an Account object now include the email address associated with the account’s root user. + +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) === diff --git a/vendor/github.com/aws/aws-sdk-go/Makefile b/vendor/github.com/aws/aws-sdk-go/Makefile index b1611d2e..931bfd69 100644 --- a/vendor/github.com/aws/aws-sdk-go/Makefile +++ b/vendor/github.com/aws/aws-sdk-go/Makefile @@ -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 @@ -152,6 +153,7 @@ get-deps-tests: go get github.com/stretchr/testify go get github.com/smartystreets/goconvey go get golang.org/x/net/html + go get golang.org/x/net/http2 get-deps-verify: @echo "go get SDK verification utilities" diff --git a/vendor/github.com/aws/aws-sdk-go/README.md b/vendor/github.com/aws/aws-sdk-go/README.md index fefe453f..9c871847 100644 --- a/vendor/github.com/aws/aws-sdk-go/README.md +++ b/vendor/github.com/aws/aws-sdk-go/README.md @@ -1,4 +1,6 @@ -# AWS SDK for Go [](http://docs.aws.amazon.com/sdk-for-go/api) [](https://gitter.im/aws/aws-sdk-go?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://travis-ci.org/aws/aws-sdk-go) [](https://github.com/aws/aws-sdk-go/blob/master/LICENSE.txt) +[](http://docs.aws.amazon.com/sdk-for-go/api) [](https://gitter.im/aws/aws-sdk-go?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://travis-ci.org/aws/aws-sdk-go) [](https://github.com/aws/aws-sdk-go/blob/master/LICENSE.txt) + +# AWS SDK for Go aws-sdk-go is the official AWS SDK for the Go programming language. @@ -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 + +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. -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: +See the SDK's [configuration guide][config_guide] for more information. +See the [session][session_pkg] package documentation for more information on how to use Session +with the SDK. + +See the [Config][config_typ] type in the [aws][aws_pkg] package for more information on configuration +options. + +[config_guide]: https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html +[session_pkg]: https://docs.aws.amazon.com/sdk-for-go/api/aws/session/ +[config_typ]: https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config +[aws_pkg]: https://docs.aws.amazon.com/sdk-for-go/api/aws/ + +### Configuring Credentials + +When using the SDK you'll generally need your AWS credentials to authenticate +with AWS services. The SDK supports multiple methods of supporting these +credentials. By default the SDK will source credentials automatically from +its default credential chain. See the session package for more information +on this chain, and how to configure it. The common items in the credential +chain are the following: + + * Environment Credentials - Set of environment variables that are useful + when sub processes are created for specific roles. + + * Shared Credentials file (~/.aws/credentials) - This file stores your + credentials based on a profile name and is useful for local development. + + * EC2 Instance Role Credentials - Use EC2 Instance Role to assign credentials + to application running on an EC2 instance. This removes the need to manage + credential files in production. + +Credentials can be configured in code as well by setting the Config's Credentials +value to a custom provider or using one of the providers included with the +SDK to bypass the default credential chain and use a custom one. This is +helpful when you want to instruct the SDK to only use a specific set of +credentials or providers. + +This example creates a credential provider for assuming an IAM role, "myRoleARN" +and configures the S3 service client to use that role for API requests. + +```go + // Initial credentials loaded from SDK's default credential chain. Such as + // the environment, shared credentials (~/.aws/credentials), or EC2 Instance + // Role. These credentials will be used to to make the STS Assume Role API. + sess := session.Must(session.NewSession()) + + // Create the credentials from AssumeRoleProvider to assume the role + // referenced by the "myRoleARN" ARN. + creds := stscreds.NewCredentials(sess, "myRoleArn") + + // Create service client value configured for credentials + // from assumed role. + svc := s3.New(sess, &aws.Config{Credentials: creds})/ +``` + +See the [credentials][credentials_pkg] package documentation for more information on credential +providers included with the SDK, and how to customize the SDK's usage of +credentials. + +The SDK has support for the shared configuration file (~/.aws/config). This +support can be enabled by setting the environment variable, "AWS_SDK_LOAD_CONFIG=1", +or enabling the feature in code when creating a Session via the +Option's SharedConfigState parameter. + +```go + sess := session.Must(session.NewSessionWithOptions(session.Options{ + SharedConfigState: session.SharedConfigEnable, + })) ``` -[default] -aws_access_key_id = AKID1234567890 -aws_secret_access_key = MY-SECRET-KEY + +[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), + })) ``` -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). +See the [endpoints][endpoints_pkg] package for the AWS Regions and Endpoints metadata. -Alternatively, you can set the following environment variables: +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), + }) ``` -AWS_ACCESS_KEY_ID=AKID1234567890 -AWS_SECRET_ACCESS_KEY=MY-SECRET-KEY + +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)) ``` -### 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. +### API Request Pagination and Resource Waiters -## Using the Go SDK +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. -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. +```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) +``` -For example the following code shows how to upload an object to Amazon S3 with a Context timeout. +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 -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() - - 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) -} + 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") ``` -You can find more information and operations in our -[API documentation](http://docs.aws.amazon.com/sdk-for-go/api/). +## 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 diff --git a/vendor/github.com/aws/aws-sdk-go/aws/client/client.go b/vendor/github.com/aws/aws-sdk-go/aws/client/client.go index 48b0fbd9..788fe6e2 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/client/client.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/client/client.go @@ -2,10 +2,8 @@ package client import ( "fmt" - "net/http/httputil" "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/client/metadata" "github.com/aws/aws-sdk-go/aws/request" ) @@ -90,60 +88,3 @@ func (c *Client) AddDebugHandlers() { c.Handlers.Send.PushFrontNamed(request.NamedHandler{Name: "awssdk.client.LogRequest", Fn: logRequest}) c.Handlers.Send.PushBackNamed(request.NamedHandler{Name: "awssdk.client.LogResponse", Fn: logResponse}) } - -const logReqMsg = `DEBUG: Request %s/%s Details: ----[ REQUEST POST-SIGN ]----------------------------- -%s ------------------------------------------------------` - -const logReqErrMsg = `DEBUG ERROR: Request %s/%s: ----[ REQUEST DUMP ERROR ]----------------------------- -%s ------------------------------------------------------` - -func logRequest(r *request.Request) { - logBody := r.Config.LogLevel.Matches(aws.LogDebugWithHTTPBody) - dumpedBody, err := httputil.DumpRequestOut(r.HTTPRequest, logBody) - if err != nil { - r.Config.Logger.Log(fmt.Sprintf(logReqErrMsg, r.ClientInfo.ServiceName, r.Operation.Name, err)) - r.Error = awserr.New(request.ErrCodeRead, "an error occurred during request body reading", err) - return - } - - if logBody { - // Reset the request body because dumpRequest will re-wrap the r.HTTPRequest's - // Body as a NoOpCloser and will not be reset after read by the HTTP - // client reader. - r.ResetBody() - } - - r.Config.Logger.Log(fmt.Sprintf(logReqMsg, r.ClientInfo.ServiceName, r.Operation.Name, string(dumpedBody))) -} - -const logRespMsg = `DEBUG: Response %s/%s Details: ----[ RESPONSE ]-------------------------------------- -%s ------------------------------------------------------` - -const logRespErrMsg = `DEBUG ERROR: Response %s/%s: ----[ RESPONSE DUMP ERROR ]----------------------------- -%s ------------------------------------------------------` - -func logResponse(r *request.Request) { - var msg = "no response data" - if r.HTTPResponse != nil { - logBody := r.Config.LogLevel.Matches(aws.LogDebugWithHTTPBody) - dumpedBody, err := httputil.DumpResponse(r.HTTPResponse, logBody) - if err != nil { - r.Config.Logger.Log(fmt.Sprintf(logRespErrMsg, r.ClientInfo.ServiceName, r.Operation.Name, err)) - r.Error = awserr.New(request.ErrCodeRead, "an error occurred during response body reading", err) - return - } - - msg = string(dumpedBody) - } else if r.Error != nil { - msg = r.Error.Error() - } - r.Config.Logger.Log(fmt.Sprintf(logRespMsg, r.ClientInfo.ServiceName, r.Operation.Name, msg)) -} diff --git a/vendor/github.com/aws/aws-sdk-go/aws/client/logger.go b/vendor/github.com/aws/aws-sdk-go/aws/client/logger.go new file mode 100644 index 00000000..1f39c91f --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/aws/client/logger.go @@ -0,0 +1,108 @@ +package client + +import ( + "bytes" + "fmt" + "io" + "io/ioutil" + "net/http/httputil" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/request" +) + +const logReqMsg = `DEBUG: Request %s/%s Details: +---[ REQUEST POST-SIGN ]----------------------------- +%s +-----------------------------------------------------` + +const logReqErrMsg = `DEBUG ERROR: Request %s/%s: +---[ REQUEST DUMP ERROR ]----------------------------- +%s +------------------------------------------------------` + +type logWriter struct { + // Logger is what we will use to log the payload of a response. + Logger aws.Logger + // buf stores the contents of what has been read + buf *bytes.Buffer +} + +func (logger *logWriter) Write(b []byte) (int, error) { + return logger.buf.Write(b) +} + +type teeReaderCloser struct { + // io.Reader will be a tee reader that is used during logging. + // This structure will read from a body and write the contents to a logger. + io.Reader + // Source is used just to close when we are done reading. + Source io.ReadCloser +} + +func (reader *teeReaderCloser) Close() error { + return reader.Source.Close() +} + +func logRequest(r *request.Request) { + logBody := r.Config.LogLevel.Matches(aws.LogDebugWithHTTPBody) + dumpedBody, err := httputil.DumpRequestOut(r.HTTPRequest, logBody) + if err != nil { + r.Config.Logger.Log(fmt.Sprintf(logReqErrMsg, r.ClientInfo.ServiceName, r.Operation.Name, err)) + return + } + + if logBody { + // Reset the request body because dumpRequest will re-wrap the r.HTTPRequest's + // Body as a NoOpCloser and will not be reset after read by the HTTP + // client reader. + r.ResetBody() + } + + r.Config.Logger.Log(fmt.Sprintf(logReqMsg, r.ClientInfo.ServiceName, r.Operation.Name, string(dumpedBody))) +} + +const logRespMsg = `DEBUG: Response %s/%s Details: +---[ RESPONSE ]-------------------------------------- +%s +-----------------------------------------------------` + +const logRespErrMsg = `DEBUG ERROR: Response %s/%s: +---[ RESPONSE DUMP ERROR ]----------------------------- +%s +-----------------------------------------------------` + +func logResponse(r *request.Request) { + lw := &logWriter{r.Config.Logger, bytes.NewBuffer(nil)} + r.HTTPResponse.Body = &teeReaderCloser{ + Reader: io.TeeReader(r.HTTPResponse.Body, lw), + Source: r.HTTPResponse.Body, + } + + handlerFn := func(req *request.Request) { + body, err := httputil.DumpResponse(req.HTTPResponse, false) + if err != nil { + lw.Logger.Log(fmt.Sprintf(logRespErrMsg, req.ClientInfo.ServiceName, req.Operation.Name, err)) + return + } + + b, err := ioutil.ReadAll(lw.buf) + if err != nil { + lw.Logger.Log(fmt.Sprintf(logRespErrMsg, req.ClientInfo.ServiceName, req.Operation.Name, err)) + return + } + lw.Logger.Log(fmt.Sprintf(logRespMsg, req.ClientInfo.ServiceName, req.Operation.Name, string(body))) + if req.Config.LogLevel.Matches(aws.LogDebugWithHTTPBody) { + lw.Logger.Log(string(b)) + } + } + + const handlerName = "awsdk.client.LogResponse.ResponseBody" + + r.Handlers.Unmarshal.SetBackNamed(request.NamedHandler{ + Name: handlerName, Fn: handlerFn, + }) + r.Handlers.UnmarshalError.SetBackNamed(request.NamedHandler{ + Name: handlerName, Fn: handlerFn, + }) +} diff --git a/vendor/github.com/aws/aws-sdk-go/aws/client/logger_test.go b/vendor/github.com/aws/aws-sdk-go/aws/client/logger_test.go new file mode 100644 index 00000000..b8d600c9 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/aws/client/logger_test.go @@ -0,0 +1,57 @@ +package client + +import ( + "bytes" + "io" + "testing" +) + +type mockCloser struct { + closed bool +} + +func (closer *mockCloser) Read(b []byte) (int, error) { + return 0, io.EOF +} + +func (closer *mockCloser) Close() error { + closer.closed = true + return nil +} + +func TestTeeReaderCloser(t *testing.T) { + expected := "FOO" + buf := bytes.NewBuffer([]byte(expected)) + lw := bytes.NewBuffer(nil) + c := &mockCloser{} + closer := teeReaderCloser{ + io.TeeReader(buf, lw), + c, + } + + b := make([]byte, len(expected)) + _, err := closer.Read(b) + closer.Close() + + if expected != lw.String() { + t.Errorf("Expected %q, but received %q", expected, lw.String()) + } + + if err != nil { + t.Errorf("Expected 'nil', but received %v", err) + } + + if !c.closed { + t.Error("Expected 'true', but received 'false'") + } +} + +func TestLogWriter(t *testing.T) { + expected := "FOO" + lw := &logWriter{nil, bytes.NewBuffer(nil)} + lw.Write([]byte(expected)) + + if expected != lw.buf.String() { + t.Errorf("Expected %q, but received %q", expected, lw.buf.String()) + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go b/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go index 25b461c3..495e3ef6 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go @@ -106,6 +106,22 @@ var SendHandler = request.NamedHandler{ sender = sendWithoutFollowRedirects } + if request.NoBody == r.HTTPRequest.Body { + // Strip off the request body if the NoBody reader was used as a + // place holder for a request body. This prevents the SDK from + // making requests with a request body when it would be invalid + // to do so. + // + // Use a shallow copy of the http.Request to ensure the race condition + // of transport on Body will not trigger + reqOrig, reqCopy := r.HTTPRequest, *r.HTTPRequest + reqCopy.Body = nil + r.HTTPRequest = &reqCopy + defer func() { + r.HTTPRequest = reqOrig + }() + } + var err error r.HTTPResponse, err = sender(r) if err != nil { diff --git a/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers_1_8_test.go b/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers_1_8_test.go new file mode 100644 index 00000000..b47afc24 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers_1_8_test.go @@ -0,0 +1,64 @@ +// +build go1.8 + +package corehandlers_test + +import ( + "crypto/tls" + "net/http" + "testing" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/credentials" + "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/aws/session" + "github.com/aws/aws-sdk-go/awstesting" + "github.com/aws/aws-sdk-go/service/s3" + "golang.org/x/net/http2" +) + +func TestSendHandler_HEADNoBody(t *testing.T) { + TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile, err := awstesting.CreateTLSBundleFiles() + if err != nil { + panic(err) + } + defer awstesting.CleanupTLSBundleFiles(TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile) + + endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + + transport := http.DefaultTransport.(*http.Transport) + // test server's certificate is self-signed certificate + transport.TLSClientConfig = &tls.Config{InsecureSkipVerify: true} + http2.ConfigureTransport(transport) + + sess, err := session.NewSessionWithOptions(session.Options{ + Config: aws.Config{ + HTTPClient: &http.Client{}, + Endpoint: aws.String(endpoint), + Region: aws.String("mock-region"), + Credentials: credentials.AnonymousCredentials, + S3ForcePathStyle: aws.Bool(true), + }, + }) + + svc := s3.New(sess) + + req, _ := svc.HeadObjectRequest(&s3.HeadObjectInput{ + Bucket: aws.String("bucketname"), + Key: aws.String("keyname"), + }) + + if e, a := request.NoBody, req.HTTPRequest.Body; e != a { + t.Fatalf("expect %T request body, got %T", e, a) + } + + err = req.Send() + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if e, a := http.StatusOK, req.HTTPResponse.StatusCode; e != a { + t.Errorf("expect %d status code, got %d", e, a) + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go b/vendor/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go index 6efc77bf..f298d659 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/credentials/chain_provider.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/aws/credentials/credentials.go b/vendor/github.com/aws/aws-sdk-go/aws/credentials/credentials.go index 03630cf0..42416fc2 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/credentials/credentials.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/credentials/credentials.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go b/vendor/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go index 96655bc4..c14231a1 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/credentials/env_provider.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/aws/doc.go b/vendor/github.com/aws/aws-sdk-go/aws/doc.go new file mode 100644 index 00000000..4fcb6161 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/aws/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/aws/endpoints/defaults.go b/vendor/github.com/aws/aws-sdk-go/aws/endpoints/defaults.go index 90558c44..e6d7ede6 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/endpoints/defaults.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/endpoints/defaults.go @@ -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. @@ -494,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{}, @@ -513,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{}, @@ -527,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{}, @@ -841,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{ @@ -1491,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{}, diff --git a/vendor/github.com/aws/aws-sdk-go/aws/endpoints/endpoints.go b/vendor/github.com/aws/aws-sdk-go/aws/endpoints/endpoints.go index 64dccea4..9c3eedb4 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/endpoints/endpoints.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/endpoints/endpoints.go @@ -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 { diff --git a/vendor/github.com/aws/aws-sdk-go/aws/jsonvalue.go b/vendor/github.com/aws/aws-sdk-go/aws/jsonvalue.go index a94f0410..91a6f277 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/jsonvalue.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/jsonvalue.go @@ -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" diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error.go b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error.go index 10fc8cb2..271da432 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error.go @@ -1,4 +1,4 @@ -// +build !appengine +// +build !appengine,!plan9 package request diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_appengine.go b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_other.go index 996196e7..daf9eca4 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_appengine.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_other.go @@ -1,4 +1,4 @@ -// +build appengine +// +build appengine plan9 package request diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_appengine_test.go b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_other_test.go index 29660da2..aba8eb4e 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_appengine_test.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_other_test.go @@ -1,4 +1,4 @@ -// +build appengine +// +build appengine plan9 package request_test diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_test.go b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_test.go index f02c507d..bb5f6bdd 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_test.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/connection_reset_error_test.go @@ -1,4 +1,4 @@ -// +build !appengine +// +build !appengine,!plan9 package request_test diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/handlers.go b/vendor/github.com/aws/aws-sdk-go/aws/request/handlers.go index 6c14336f..802ac88a 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/handlers.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/handlers.go @@ -158,6 +158,37 @@ func (l *HandlerList) RemoveByName(name string) { } } +// SwapNamed will swap out any existing handlers with the same name as the +// passed in NamedHandler returning true if handlers were swapped. False is +// returned otherwise. +func (l *HandlerList) SwapNamed(n NamedHandler) (swapped bool) { + for i := 0; i < len(l.list); i++ { + if l.list[i].Name == n.Name { + l.list[i].Fn = n.Fn + swapped = true + } + } + + return swapped +} + +// SetBackNamed will replace the named handler if it exists in the handler list. +// If the handler does not exist the handler will be added to the end of the list. +func (l *HandlerList) SetBackNamed(n NamedHandler) { + if !l.SwapNamed(n) { + l.PushBackNamed(n) + } +} + +// SetFrontNamed will replace the named handler if it exists in the handler list. +// If the handler does not exist the handler will be added to the beginning of +// the list. +func (l *HandlerList) SetFrontNamed(n NamedHandler) { + if !l.SwapNamed(n) { + l.PushFrontNamed(n) + } +} + // Run executes all handlers in the list with a given request object. func (l *HandlerList) Run(r *Request) { for i, h := range l.list { diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/handlers_test.go b/vendor/github.com/aws/aws-sdk-go/aws/request/handlers_test.go index e375a998..b2da558d 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/handlers_test.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/handlers_test.go @@ -1,10 +1,9 @@ package request_test import ( + "reflect" "testing" - "github.com/stretchr/testify/assert" - "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/request" "github.com/aws/aws-sdk-go/awstesting/unit" @@ -20,8 +19,12 @@ func TestHandlerList(t *testing.T) { r.Data = s }) l.Run(r) - assert.Equal(t, "a", s) - assert.Equal(t, "a", r.Data) + if e, a := "a", s; e != a { + t.Errorf("expect %q update got %q", e, a) + } + if e, a := "a", r.Data.(string); e != a { + t.Errorf("expect %q data update got %q", e, a) + } } func TestMultipleHandlers(t *testing.T) { @@ -43,9 +46,110 @@ func TestNamedHandlers(t *testing.T) { l.PushBackNamed(named) l.PushBackNamed(named2) l.PushBack(func(r *request.Request) {}) - assert.Equal(t, 4, l.Len()) + if e, a := 4, l.Len(); e != a { + t.Errorf("expect %d list length, got %d", e, a) + } l.Remove(named) - assert.Equal(t, 2, l.Len()) + if e, a := 2, l.Len(); e != a { + t.Errorf("expect %d list length, got %d", e, a) + } +} + +func TestSwapHandlers(t *testing.T) { + firstHandlerCalled := 0 + swappedOutHandlerCalled := 0 + swappedInHandlerCalled := 0 + + l := request.HandlerList{} + named := request.NamedHandler{Name: "Name", Fn: func(r *request.Request) { + firstHandlerCalled++ + }} + named2 := request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) { + swappedOutHandlerCalled++ + }} + l.PushBackNamed(named) + l.PushBackNamed(named2) + l.PushBackNamed(named) + + l.SwapNamed(request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) { + swappedInHandlerCalled++ + }}) + + l.Run(&request.Request{}) + + if e, a := 2, firstHandlerCalled; e != a { + t.Errorf("expect first handler to be called %d, was called %d times", e, a) + } + if n := swappedOutHandlerCalled; n != 0 { + t.Errorf("expect swapped out handler to not be called, was called %d times", n) + } + if e, a := 1, swappedInHandlerCalled; e != a { + t.Errorf("expect swapped in handler to be called %d, was called %d times", e, a) + } +} + +func TestSetBackNamed_Exists(t *testing.T) { + firstHandlerCalled := 0 + swappedOutHandlerCalled := 0 + swappedInHandlerCalled := 0 + + l := request.HandlerList{} + named := request.NamedHandler{Name: "Name", Fn: func(r *request.Request) { + firstHandlerCalled++ + }} + named2 := request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) { + swappedOutHandlerCalled++ + }} + l.PushBackNamed(named) + l.PushBackNamed(named2) + + l.SetBackNamed(request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) { + swappedInHandlerCalled++ + }}) + + l.Run(&request.Request{}) + + if e, a := 1, firstHandlerCalled; e != a { + t.Errorf("expect first handler to be called %d, was called %d times", e, a) + } + if n := swappedOutHandlerCalled; n != 0 { + t.Errorf("expect swapped out handler to not be called, was called %d times", n) + } + if e, a := 1, swappedInHandlerCalled; e != a { + t.Errorf("expect swapped in handler to be called %d, was called %d times", e, a) + } +} + +func TestSetBackNamed_NotExists(t *testing.T) { + firstHandlerCalled := 0 + secondHandlerCalled := 0 + swappedInHandlerCalled := 0 + + l := request.HandlerList{} + named := request.NamedHandler{Name: "Name", Fn: func(r *request.Request) { + firstHandlerCalled++ + }} + named2 := request.NamedHandler{Name: "OtherName", Fn: func(r *request.Request) { + secondHandlerCalled++ + }} + l.PushBackNamed(named) + l.PushBackNamed(named2) + + l.SetBackNamed(request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) { + swappedInHandlerCalled++ + }}) + + l.Run(&request.Request{}) + + if e, a := 1, firstHandlerCalled; e != a { + t.Errorf("expect first handler to be called %d, was called %d times", e, a) + } + if e, a := 1, secondHandlerCalled; e != a { + t.Errorf("expect second handler to be called %d, was called %d times", e, a) + } + if e, a := 1, swappedInHandlerCalled; e != a { + t.Errorf("expect swapped in handler to be called %d, was called %d times", e, a) + } } func TestLoggedHandlers(t *testing.T) { @@ -63,7 +167,10 @@ func TestLoggedHandlers(t *testing.T) { l.PushBackNamed(named2) l.Run(&request.Request{Config: cfg}) - assert.Equal(t, expectedHandlers, loggedHandlers) + if !reflect.DeepEqual(expectedHandlers, loggedHandlers) { + t.Errorf("expect handlers executed %v to match logged handlers, %v", + expectedHandlers, loggedHandlers) + } } func TestStopHandlers(t *testing.T) { @@ -81,11 +188,13 @@ func TestStopHandlers(t *testing.T) { called++ }}) l.PushBackNamed(request.NamedHandler{Name: "name3", Fn: func(r *request.Request) { - assert.Fail(t, "third handler should not be called") + t.Fatalf("third handler should not be called") }}) l.Run(&request.Request{}) - assert.Equal(t, 2, called, "Expect only two handlers to be called") + if e, a := 2, called; e != a { + t.Errorf("expect %d handlers called, got %d", e, a) + } } func BenchmarkNewRequest(b *testing.B) { diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/request.go b/vendor/github.com/aws/aws-sdk-go/aws/request/request.go index 4f4f1123..1d462550 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/request.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/request.go @@ -368,7 +368,7 @@ func (r *Request) ResetBody() { } if l == 0 { - r.HTTPRequest.Body = noBodyReader + r.HTTPRequest.Body = NoBody } else if l > 0 { r.HTTPRequest.Body = r.safeBody } else { @@ -382,7 +382,7 @@ func (r *Request) ResetBody() { // a io.Reader that was not also an io.Seeker. switch r.Operation.HTTPMethod { case "GET", "HEAD", "DELETE": - r.HTTPRequest.Body = noBodyReader + r.HTTPRequest.Body = NoBody default: r.HTTPRequest.Body = r.safeBody } @@ -488,7 +488,7 @@ func (r *Request) Send() error { r.Handlers.Retry.Run(r) r.Handlers.AfterRetry.Run(r) if r.Error != nil { - debugLogReqError(r, "Send Request", false, r.Error) + debugLogReqError(r, "Send Request", false, err) return r.Error } debugLogReqError(r, "Send Request", true, err) @@ -497,12 +497,13 @@ func (r *Request) Send() error { r.Handlers.UnmarshalMeta.Run(r) r.Handlers.ValidateResponse.Run(r) if r.Error != nil { - err := r.Error r.Handlers.UnmarshalError.Run(r) + err := r.Error + r.Handlers.Retry.Run(r) r.Handlers.AfterRetry.Run(r) if r.Error != nil { - debugLogReqError(r, "Validate Response", false, r.Error) + debugLogReqError(r, "Validate Response", false, err) return r.Error } debugLogReqError(r, "Validate Response", true, err) @@ -515,7 +516,7 @@ func (r *Request) Send() error { r.Handlers.Retry.Run(r) r.Handlers.AfterRetry.Run(r) if r.Error != nil { - debugLogReqError(r, "Unmarshal Response", false, r.Error) + debugLogReqError(r, "Unmarshal Response", false, err) return r.Error } debugLogReqError(r, "Unmarshal Response", true, err) diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_7.go b/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_7.go index 1323af90..2665e818 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_7.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_7.go @@ -16,6 +16,6 @@ func (noBody) Read([]byte) (int, error) { return 0, io.EOF } func (noBody) Close() error { return nil } func (noBody) WriteTo(io.Writer) (int64, error) { return 0, nil } -// Is an empty reader that will trigger the Go HTTP client to not include +// NoBody is an empty reader that will trigger the Go HTTP client to not include // and body in the HTTP request. -var noBodyReader = noBody{} +var NoBody = noBody{} diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_8.go b/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_8.go index 8b963f4d..8ac66b78 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_8.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/request_1_8.go @@ -2,8 +2,10 @@ package request -import "net/http" +import ( + "net/http" +) -// Is a http.NoBody reader instructing Go HTTP client to not include +// NoBody is a http.NoBody reader instructing Go HTTP client to not include // and body in the HTTP request. -var noBodyReader = http.NoBody +var NoBody = http.NoBody diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/request_resetbody_test.go b/vendor/github.com/aws/aws-sdk-go/aws/request/request_resetbody_test.go index 4efc5057..4a917248 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/request_resetbody_test.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/request_resetbody_test.go @@ -50,7 +50,7 @@ func TestResetBody_ExcludeUnseekableBodyByMethod(t *testing.T) { r.SetReaderBody(reader) - if a, e := r.HTTPRequest.Body == noBodyReader, c.IsNoBody; a != e { + if a, e := r.HTTPRequest.Body == NoBody, c.IsNoBody; a != e { t.Errorf("%d, expect body to be set to noBody(%t), but was %t", i, e, a) } } diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/request_test.go b/vendor/github.com/aws/aws-sdk-go/aws/request/request_test.go index c741b5ee..eec650b6 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/request_test.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/request_test.go @@ -3,7 +3,6 @@ package request_test import ( "bytes" "encoding/json" - "errors" "fmt" "io" "io/ioutil" @@ -762,31 +761,20 @@ func (reader *errReader) Close() error { return nil } -func TestLoggerNotIgnoringErrors(t *testing.T) { - s := awstesting.NewClient(&aws.Config{ - Region: aws.String("mock-region"), - MaxRetries: aws.Int(0), - DisableSSL: aws.Bool(true), - LogLevel: aws.LogLevel(aws.LogDebugWithHTTPBody), - }) - - s.Handlers.Validate.Clear() - s.Handlers.Send.Clear() - s.Handlers.Send.PushBack(func(r *request.Request) { - r.HTTPResponse = &http.Response{StatusCode: 200, Body: &errReader{errors.New("Foo error")}} - }) - s.AddDebugHandlers() - - out := &testData{} - r := s.NewRequest(&request.Operation{Name: "Operation"}, nil, out) - err := r.Send() - if err == nil { - t.Error("expected error, but got nil") +func TestIsNoBodyReader(t *testing.T) { + cases := []struct { + reader io.ReadCloser + expect bool + }{ + {ioutil.NopCloser(bytes.NewReader([]byte("abc"))), false}, + {ioutil.NopCloser(bytes.NewReader(nil)), false}, + {nil, false}, + {request.NoBody, true}, } - if aerr, ok := err.(awserr.Error); !ok { - t.Errorf("expected awserr.Error, but got different error, %v", err) - } else if aerr.Code() != request.ErrCodeRead { - t.Errorf("expected %q, but received %q", request.ErrCodeRead, aerr.Code()) + for i, c := range cases { + if e, a := c.expect, request.NoBody == c.reader; e != a { + t.Errorf("%d, expect %t match, but was %t", i, e, a) + } } } diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/retryer.go b/vendor/github.com/aws/aws-sdk-go/aws/request/retryer.go index 7af81de2..e36aa382 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/retryer.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/retryer.go @@ -38,7 +38,6 @@ var throttleCodes = map[string]struct{}{ "ThrottlingException": {}, "RequestLimitExceeded": {}, "RequestThrottled": {}, - "LimitExceededException": {}, // Deleting 10+ DynamoDb tables at once "TooManyRequestsException": {}, // Lambda functions "PriorRequestNotComplete": {}, // Route53 } diff --git a/vendor/github.com/aws/aws-sdk-go/aws/request/waiter.go b/vendor/github.com/aws/aws-sdk-go/aws/request/waiter.go index 854b0854..22d2f809 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/request/waiter.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/request/waiter.go @@ -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. diff --git a/vendor/github.com/aws/aws-sdk-go/aws/session/custom_ca_bundle_test.go b/vendor/github.com/aws/aws-sdk-go/aws/session/custom_ca_bundle_test.go index 8a5a3a04..52e59d99 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/session/custom_ca_bundle_test.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/session/custom_ca_bundle_test.go @@ -2,90 +2,76 @@ package session import ( "bytes" - "crypto/tls" - "io/ioutil" + "fmt" "net" "net/http" - "net/http/httptest" "os" + "strings" "testing" "time" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/stretchr/testify/assert" + "github.com/aws/aws-sdk-go/awstesting" ) -func createTLSServer(cert, key []byte, done <-chan struct{}) (*httptest.Server, error) { - c, err := tls.X509KeyPair(cert, key) - if err != nil { - return nil, err - } - - s := httptest.NewUnstartedServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { - w.WriteHeader(http.StatusOK) - })) - s.TLS = &tls.Config{ - Certificates: []tls.Certificate{c}, - } - s.TLS.BuildNameToCertificate() - s.StartTLS() +var TLSBundleCertFile string +var TLSBundleKeyFile string +var TLSBundleCAFile string - go func() { - <-done - s.Close() - }() +func TestMain(m *testing.M) { + var err error - return s, nil -} - -func setupTestCAFile(b []byte) (string, error) { - bundleFile, err := ioutil.TempFile(os.TempDir(), "aws-sdk-go-session-test") + TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile, err = awstesting.CreateTLSBundleFiles() if err != nil { - return "", err + panic(err) } - _, err = bundleFile.Write(b) + fmt.Println("TestMain", TLSBundleCertFile, TLSBundleKeyFile) + + code := m.Run() + + err = awstesting.CleanupTLSBundleFiles(TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile) if err != nil { - return "", err + panic(err) } - defer bundleFile.Close() - return bundleFile.Name(), nil + os.Exit(code) } func TestNewSession_WithCustomCABundle_Env(t *testing.T) { oldEnv := initSessionTestEnv() defer popEnv(oldEnv) - done := make(chan struct{}) - server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done) - assert.NoError(t, err) - - // Write bundle to file - caFilename, err := setupTestCAFile(testTLSBundleCA) - defer func() { - os.Remove(caFilename) - }() - assert.NoError(t, err) + endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } - os.Setenv("AWS_CA_BUNDLE", caFilename) + os.Setenv("AWS_CA_BUNDLE", TLSBundleCAFile) s, err := NewSession(&aws.Config{ HTTPClient: &http.Client{}, - Endpoint: aws.String(server.URL), + Endpoint: aws.String(endpoint), Region: aws.String("mock-region"), Credentials: credentials.AnonymousCredentials, }) - assert.NoError(t, err) - assert.NotNil(t, s) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if s == nil { + t.Fatalf("expect session to be created, got none") + } req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil) resp, err := s.Config.HTTPClient.Do(req) - assert.NoError(t, err) - - assert.Equal(t, http.StatusOK, resp.StatusCode) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if e, a := http.StatusOK, resp.StatusCode; e != a { + t.Errorf("expect %d status code, got %d", e, a) + } } func TestNewSession_WithCustomCABundle_EnvNotExists(t *testing.T) { @@ -95,65 +81,87 @@ func TestNewSession_WithCustomCABundle_EnvNotExists(t *testing.T) { os.Setenv("AWS_CA_BUNDLE", "file-not-exists") s, err := NewSession() - assert.Error(t, err) - assert.Equal(t, "LoadCustomCABundleError", err.(awserr.Error).Code()) - assert.Nil(t, s) + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "LoadCustomCABundleError", err.(awserr.Error).Code(); e != a { + t.Errorf("expect %s error code, got %s", e, a) + } + if s != nil { + t.Errorf("expect nil session, got %v", s) + } } func TestNewSession_WithCustomCABundle_Option(t *testing.T) { oldEnv := initSessionTestEnv() defer popEnv(oldEnv) - done := make(chan struct{}) - server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done) - assert.NoError(t, err) + endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } s, err := NewSessionWithOptions(Options{ Config: aws.Config{ HTTPClient: &http.Client{}, - Endpoint: aws.String(server.URL), + Endpoint: aws.String(endpoint), Region: aws.String("mock-region"), Credentials: credentials.AnonymousCredentials, }, - CustomCABundle: bytes.NewReader(testTLSBundleCA), + CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA), }) - assert.NoError(t, err) - assert.NotNil(t, s) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if s == nil { + t.Fatalf("expect session to be created, got none") + } req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil) resp, err := s.Config.HTTPClient.Do(req) - assert.NoError(t, err) - - assert.Equal(t, http.StatusOK, resp.StatusCode) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if e, a := http.StatusOK, resp.StatusCode; e != a { + t.Errorf("expect %d status code, got %d", e, a) + } } func TestNewSession_WithCustomCABundle_OptionPriority(t *testing.T) { oldEnv := initSessionTestEnv() defer popEnv(oldEnv) - done := make(chan struct{}) - server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done) - assert.NoError(t, err) + endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } os.Setenv("AWS_CA_BUNDLE", "file-not-exists") s, err := NewSessionWithOptions(Options{ Config: aws.Config{ HTTPClient: &http.Client{}, - Endpoint: aws.String(server.URL), + Endpoint: aws.String(endpoint), Region: aws.String("mock-region"), Credentials: credentials.AnonymousCredentials, }, - CustomCABundle: bytes.NewReader(testTLSBundleCA), + CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA), }) - assert.NoError(t, err) - assert.NotNil(t, s) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if s == nil { + t.Fatalf("expect session to be created, got none") + } req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil) resp, err := s.Config.HTTPClient.Do(req) - assert.NoError(t, err) - - assert.Equal(t, http.StatusOK, resp.StatusCode) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if e, a := http.StatusOK, resp.StatusCode; e != a { + t.Errorf("expect %d status code, got %d", e, a) + } } type mockRoundTripper struct{} @@ -172,25 +180,35 @@ func TestNewSession_WithCustomCABundle_UnsupportedTransport(t *testing.T) { Transport: &mockRoundTripper{}, }, }, - CustomCABundle: bytes.NewReader(testTLSBundleCA), + CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA), }) - assert.Error(t, err) - assert.Equal(t, "LoadCustomCABundleError", err.(awserr.Error).Code()) - assert.Contains(t, err.(awserr.Error).Message(), "transport unsupported type") - assert.Nil(t, s) + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "LoadCustomCABundleError", err.(awserr.Error).Code(); e != a { + t.Errorf("expect %s error code, got %s", e, a) + } + if s != nil { + t.Errorf("expect nil session, got %v", s) + } + aerrMsg := err.(awserr.Error).Message() + if e, a := "transport unsupported type", aerrMsg; !strings.Contains(a, e) { + t.Errorf("expect %s to be in %s", e, a) + } } func TestNewSession_WithCustomCABundle_TransportSet(t *testing.T) { oldEnv := initSessionTestEnv() defer popEnv(oldEnv) - done := make(chan struct{}) - server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done) - assert.NoError(t, err) + endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } s, err := NewSessionWithOptions(Options{ Config: aws.Config{ - Endpoint: aws.String(server.URL), + Endpoint: aws.String(endpoint), Region: aws.String("mock-region"), Credentials: credentials.AnonymousCredentials, HTTPClient: &http.Client{ @@ -205,115 +223,21 @@ func TestNewSession_WithCustomCABundle_TransportSet(t *testing.T) { }, }, }, - CustomCABundle: bytes.NewReader(testTLSBundleCA), + CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA), }) - assert.NoError(t, err) - assert.NotNil(t, s) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if s == nil { + t.Fatalf("expect session to be created, got none") + } req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil) resp, err := s.Config.HTTPClient.Do(req) - assert.NoError(t, err) - - assert.Equal(t, http.StatusOK, resp.StatusCode) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if e, a := http.StatusOK, resp.StatusCode; e != a { + t.Errorf("expect %d status code, got %d", e, a) + } } - -/* Cert generation steps -# Create the CA key -openssl genrsa -des3 -out ca.key 1024 - -# Create the CA Cert -openssl req -new -sha256 -x509 -days 3650 \ - -subj "/C=GO/ST=Gopher/O=Testing ROOT CA" \ - -key ca.key -out ca.crt - -# Create config -cat > csr_details.txt <<-EOF - -[req] -default_bits = 1024 -prompt = no -default_md = sha256 -req_extensions = SAN -distinguished_name = dn - -[ dn ] -C=GO -ST=Gopher -O=Testing Certificate -OU=Testing IP - -[SAN] -subjectAltName = IP:127.0.0.1 -EOF - -# Create certificate signing request -openssl req -new -sha256 -nodes -newkey rsa:1024 \ - -config <( cat csr_details.txt ) \ - -keyout ia.key -out ia.csr - -# Create a signed certificate -openssl x509 -req -days 3650 \ - -CAcreateserial \ - -extfile <( cat csr_details.txt ) \ - -extensions SAN \ - -CA ca.crt -CAkey ca.key -in ia.csr -out ia.crt - -# Verify -openssl req -noout -text -in ia.csr -openssl x509 -noout -text -in ia.crt -*/ -var ( - // ca.crt - testTLSBundleCA = []byte(`-----BEGIN CERTIFICATE----- -MIICiTCCAfKgAwIBAgIJAJ5X1olt05XjMA0GCSqGSIb3DQEBCwUAMDgxCzAJBgNV -BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD -QTAeFw0xNzAzMDkwMDAyMDZaFw0yNzAzMDcwMDAyMDZaMDgxCzAJBgNVBAYTAkdP -MQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBDQTCBnzAN -BgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAw/8DN+t9XQR60jx42rsQ2WE2Dx85rb3n -GQxnKZZLNddsT8rDyxJNP18aFalbRbFlyln5fxWxZIblu9Xkm/HRhOpbSimSqo1y -uDx21NVZ1YsOvXpHby71jx3gPrrhSc/t/zikhi++6D/C6m1CiIGuiJ0GBiJxtrub -UBMXT0QtI2ECAwEAAaOBmjCBlzAdBgNVHQ4EFgQU8XG3X/YHBA6T04kdEkq6+4GV -YykwaAYDVR0jBGEwX4AU8XG3X/YHBA6T04kdEkq6+4GVYymhPKQ6MDgxCzAJBgNV -BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD -QYIJAJ5X1olt05XjMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQELBQADgYEAeILv -z49+uxmPcfOZzonuOloRcpdvyjiXblYxbzz6ch8GsE7Q886FTZbvwbgLhzdwSVgG -G8WHkodDUsymVepdqAamS3f8PdCUk8xIk9mop8LgaB9Ns0/TssxDvMr3sOD2Grb3 -xyWymTWMcj6uCiEBKtnUp4rPiefcvCRYZ17/hLE= ------END CERTIFICATE----- -`) - - // ai.crt - testTLSBundleCert = []byte(`-----BEGIN CERTIFICATE----- -MIICGjCCAYOgAwIBAgIJAIIu+NOoxxM0MA0GCSqGSIb3DQEBBQUAMDgxCzAJBgNV -BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD -QTAeFw0xNzAzMDkwMDAzMTRaFw0yNzAzMDcwMDAzMTRaMFExCzAJBgNVBAYTAkdP -MQ8wDQYDVQQIDAZHb3BoZXIxHDAaBgNVBAoME1Rlc3RpbmcgQ2VydGlmaWNhdGUx -EzARBgNVBAsMClRlc3RpbmcgSVAwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGB -AN1hWHeioo/nASvbrjwCQzXCiWiEzGkw353NxsAB54/NqDL3LXNATtiSJu8kJBrm -Ah12IFLtWLGXjGjjYlHbQWnOR6awveeXnQZukJyRWh7m/Qlt9Ho0CgZE1U+832ac -5GWVldNxW1Lz4I+W9/ehzqe8I80RS6eLEKfUFXGiW+9RAgMBAAGjEzARMA8GA1Ud -EQQIMAaHBH8AAAEwDQYJKoZIhvcNAQEFBQADgYEAdF4WQHfVdPCbgv9sxgJjcR1H -Hgw9rZ47gO1IiIhzglnLXQ6QuemRiHeYFg4kjcYBk1DJguxzDTGnUwhUXOibAB+S -zssmrkdYYvn9aUhjc3XK3tjAoDpsPpeBeTBamuUKDHoH/dNRXxerZ8vu6uPR3Pgs -5v/KCV6IAEcvNyOXMPo= ------END CERTIFICATE----- -`) - - // ai.key - testTLSBundleKey = []byte(`-----BEGIN RSA PRIVATE KEY----- -MIICXAIBAAKBgQDdYVh3oqKP5wEr2648AkM1wolohMxpMN+dzcbAAeePzagy9y1z -QE7YkibvJCQa5gIddiBS7Vixl4xo42JR20FpzkemsL3nl50GbpCckVoe5v0JbfR6 -NAoGRNVPvN9mnORllZXTcVtS8+CPlvf3oc6nvCPNEUunixCn1BVxolvvUQIDAQAB -AoGBAMISrcirddGrlLZLLrKC1ULS2T0cdkqdQtwHYn4+7S5+/z42vMx1iumHLsSk -rVY7X41OWkX4trFxhvEIrc/O48bo2zw78P7flTxHy14uxXnllU8cLThE29SlUU7j -AVBNxJZMsXMlS/DowwD4CjFe+x4Pu9wZcReF2Z9ntzMpySABAkEA+iWoJCPE2JpS -y78q3HYYgpNY3gF3JqQ0SI/zTNkb3YyEIUffEYq0Y9pK13HjKtdsSuX4osTIhQkS -+UgRp6tCAQJBAOKPYTfQ2FX8ijgUpHZRuEAVaxASAS0UATiLgzXxLvOh/VC2at5x -wjOX6sD65pPz/0D8Qj52Cq6Q1TQ+377SDVECQAIy0od+yPweXxvrUjUd1JlRMjbB -TIrKZqs8mKbUQapw0bh5KTy+O1elU4MRPS3jNtBxtP25PQnuSnxmZcFTgAECQFzg -DiiFcsn9FuRagfkHExMiNJuH5feGxeFaP9WzI144v9GAllrOI6Bm3JNzx2ZLlg4b -20Qju8lIEj6yr6JYFaECQHM1VSojGRKpOl9Ox/R4yYSA9RV5Gyn00/aJNxVYyPD5 -i3acL2joQm2kLD/LO8paJ4+iQdRXCOMMIpjxSNjGQjQ= ------END RSA PRIVATE KEY----- -`) -) diff --git a/vendor/github.com/aws/aws-sdk-go/aws/session/doc.go b/vendor/github.com/aws/aws-sdk-go/aws/session/doc.go index 2fe35e74..ea7b886f 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/session/doc.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/session/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/aws/session/session.go b/vendor/github.com/aws/aws-sdk-go/aws/session/session.go index 96c740d0..34a29208 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/session/session.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/session/session.go @@ -155,6 +155,10 @@ type Options struct { // and enable or disable the shared config functionality. SharedConfigState SharedConfigState + // Ordered list of files the session will load configuration from. + // It will override environment variable AWS_SHARED_CREDENTIALS_FILE, AWS_CONFIG_FILE. + SharedConfigFiles []string + // When the SDK's shared config is configured to assume a role with MFA // this option is required in order to provide the mechanism that will // retrieve the MFA token. There is no default value for this field. If @@ -218,7 +222,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 @@ -304,13 +308,18 @@ func newSession(opts Options, envCfg envConfig, cfgs ...*aws.Config) (*Session, userCfg := &aws.Config{} userCfg.MergeIn(cfgs...) - // Order config files will be loaded in with later files overwriting + // Ordered config files will be loaded in with later files overwriting // previous config file values. - cfgFiles := []string{envCfg.SharedConfigFile, envCfg.SharedCredentialsFile} - if !envCfg.EnableSharedConfig { - // The shared config file (~/.aws/config) is only loaded if instructed - // to load via the envConfig.EnableSharedConfig (AWS_SDK_LOAD_CONFIG). - cfgFiles = cfgFiles[1:] + var cfgFiles []string + if opts.SharedConfigFiles != nil { + cfgFiles = opts.SharedConfigFiles + } else { + cfgFiles = []string{envCfg.SharedConfigFile, envCfg.SharedCredentialsFile} + if !envCfg.EnableSharedConfig { + // The shared config file (~/.aws/config) is only loaded if instructed + // to load via the envConfig.EnableSharedConfig (AWS_SDK_LOAD_CONFIG). + cfgFiles = cfgFiles[1:] + } } // Load additional config from file(s) diff --git a/vendor/github.com/aws/aws-sdk-go/aws/session/session_test.go b/vendor/github.com/aws/aws-sdk-go/aws/session/session_test.go index 877af02e..25aed689 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/session/session_test.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/session/session_test.go @@ -178,6 +178,29 @@ func TestNewSessionWithOptions_OverrideSharedConfigDisable(t *testing.T) { assert.Contains(t, creds.ProviderName, "SharedConfigCredentials") } +func TestNewSessionWithOptions_OverrideSharedConfigFiles(t *testing.T) { + oldEnv := initSessionTestEnv() + defer popEnv(oldEnv) + + os.Setenv("AWS_SDK_LOAD_CONFIG", "1") + os.Setenv("AWS_SHARED_CREDENTIALS_FILE", testConfigFilename) + os.Setenv("AWS_PROFILE", "config_file_load_order") + + s, err := NewSessionWithOptions(Options{ + SharedConfigFiles: []string{testConfigOtherFilename}, + }) + assert.NoError(t, err) + + assert.Equal(t, "shared_config_other_region", *s.Config.Region) + + creds, err := s.Config.Credentials.Get() + assert.NoError(t, err) + assert.Equal(t, "shared_config_other_akid", creds.AccessKeyID) + assert.Equal(t, "shared_config_other_secret", creds.SecretAccessKey) + assert.Empty(t, creds.SessionToken) + assert.Contains(t, creds.ProviderName, "SharedConfigCredentials") +} + func TestNewSessionWithOptions_Overrides(t *testing.T) { cases := []struct { InEnvs map[string]string diff --git a/vendor/github.com/aws/aws-sdk-go/aws/version.go b/vendor/github.com/aws/aws-sdk-go/aws/version.go index ffec984e..74b99830 100644 --- a/vendor/github.com/aws/aws-sdk-go/aws/version.go +++ b/vendor/github.com/aws/aws-sdk-go/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.8.17" +const SDKVersion = "1.8.26" diff --git a/vendor/github.com/aws/aws-sdk-go/awstesting/custom_ca_bundle.go b/vendor/github.com/aws/aws-sdk-go/awstesting/custom_ca_bundle.go new file mode 100644 index 00000000..33d17553 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/awstesting/custom_ca_bundle.go @@ -0,0 +1,191 @@ +package awstesting + +import ( + "io/ioutil" + "net" + "net/http" + "os" + "time" +) + +func availableLocalAddr(ip string) (string, error) { + l, err := net.Listen("tcp", ip+":0") + if err != nil { + return "", err + } + defer l.Close() + + return l.Addr().String(), nil +} + +// CreateTLSServer will create the TLS server on an open port using the +// certificate and key. The address will be returned that the server is running on. +func CreateTLSServer(cert, key string, mux *http.ServeMux) (string, error) { + addr, err := availableLocalAddr("127.0.0.1") + if err != nil { + return "", err + } + + if mux == nil { + mux = http.NewServeMux() + mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {}) + } + + go func() { + if err := http.ListenAndServeTLS(addr, cert, key, mux); err != nil { + panic(err) + } + }() + time.Sleep(1 * time.Second) + + return "https://" + addr, nil +} + +// CreateTLSBundleFiles returns the temporary filenames for the certificate +// key, and CA PEM content. These files should be deleted when no longer +// needed. CleanupTLSBundleFiles can be used for this cleanup. +func CreateTLSBundleFiles() (cert, key, ca string, err error) { + cert, err = createTmpFile(TLSBundleCert) + if err != nil { + return "", "", "", err + } + + key, err = createTmpFile(TLSBundleKey) + if err != nil { + return "", "", "", err + } + + ca, err = createTmpFile(TLSBundleCA) + if err != nil { + return "", "", "", err + } + + return cert, key, ca, nil +} + +// CleanupTLSBundleFiles takes variadic list of files to be deleted. +func CleanupTLSBundleFiles(files ...string) error { + for _, file := range files { + if err := os.Remove(file); err != nil { + return err + } + } + + return nil +} + +func createTmpFile(b []byte) (string, error) { + bundleFile, err := ioutil.TempFile(os.TempDir(), "aws-sdk-go-session-test") + if err != nil { + return "", err + } + + _, err = bundleFile.Write(b) + if err != nil { + return "", err + } + + defer bundleFile.Close() + return bundleFile.Name(), nil +} + +/* Cert generation steps +# Create the CA key +openssl genrsa -des3 -out ca.key 1024 + +# Create the CA Cert +openssl req -new -sha256 -x509 -days 3650 \ + -subj "/C=GO/ST=Gopher/O=Testing ROOT CA" \ + -key ca.key -out ca.crt + +# Create config +cat > csr_details.txt <<-EOF + +[req] +default_bits = 1024 +prompt = no +default_md = sha256 +req_extensions = SAN +distinguished_name = dn + +[ dn ] +C=GO +ST=Gopher +O=Testing Certificate +OU=Testing IP + +[SAN] +subjectAltName = IP:127.0.0.1 +EOF + +# Create certificate signing request +openssl req -new -sha256 -nodes -newkey rsa:1024 \ + -config <( cat csr_details.txt ) \ + -keyout ia.key -out ia.csr + +# Create a signed certificate +openssl x509 -req -days 3650 \ + -CAcreateserial \ + -extfile <( cat csr_details.txt ) \ + -extensions SAN \ + -CA ca.crt -CAkey ca.key -in ia.csr -out ia.crt + +# Verify +openssl req -noout -text -in ia.csr +openssl x509 -noout -text -in ia.crt +*/ +var ( + // TLSBundleCA ca.crt + TLSBundleCA = []byte(`-----BEGIN CERTIFICATE----- +MIICiTCCAfKgAwIBAgIJAJ5X1olt05XjMA0GCSqGSIb3DQEBCwUAMDgxCzAJBgNV +BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD +QTAeFw0xNzAzMDkwMDAyMDZaFw0yNzAzMDcwMDAyMDZaMDgxCzAJBgNVBAYTAkdP +MQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBDQTCBnzAN +BgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAw/8DN+t9XQR60jx42rsQ2WE2Dx85rb3n +GQxnKZZLNddsT8rDyxJNP18aFalbRbFlyln5fxWxZIblu9Xkm/HRhOpbSimSqo1y +uDx21NVZ1YsOvXpHby71jx3gPrrhSc/t/zikhi++6D/C6m1CiIGuiJ0GBiJxtrub +UBMXT0QtI2ECAwEAAaOBmjCBlzAdBgNVHQ4EFgQU8XG3X/YHBA6T04kdEkq6+4GV +YykwaAYDVR0jBGEwX4AU8XG3X/YHBA6T04kdEkq6+4GVYymhPKQ6MDgxCzAJBgNV +BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD +QYIJAJ5X1olt05XjMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQELBQADgYEAeILv +z49+uxmPcfOZzonuOloRcpdvyjiXblYxbzz6ch8GsE7Q886FTZbvwbgLhzdwSVgG +G8WHkodDUsymVepdqAamS3f8PdCUk8xIk9mop8LgaB9Ns0/TssxDvMr3sOD2Grb3 +xyWymTWMcj6uCiEBKtnUp4rPiefcvCRYZ17/hLE= +-----END CERTIFICATE----- +`) + + // TLSBundleCert ai.crt + TLSBundleCert = []byte(`-----BEGIN CERTIFICATE----- +MIICGjCCAYOgAwIBAgIJAIIu+NOoxxM0MA0GCSqGSIb3DQEBBQUAMDgxCzAJBgNV +BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD +QTAeFw0xNzAzMDkwMDAzMTRaFw0yNzAzMDcwMDAzMTRaMFExCzAJBgNVBAYTAkdP +MQ8wDQYDVQQIDAZHb3BoZXIxHDAaBgNVBAoME1Rlc3RpbmcgQ2VydGlmaWNhdGUx +EzARBgNVBAsMClRlc3RpbmcgSVAwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGB +AN1hWHeioo/nASvbrjwCQzXCiWiEzGkw353NxsAB54/NqDL3LXNATtiSJu8kJBrm +Ah12IFLtWLGXjGjjYlHbQWnOR6awveeXnQZukJyRWh7m/Qlt9Ho0CgZE1U+832ac +5GWVldNxW1Lz4I+W9/ehzqe8I80RS6eLEKfUFXGiW+9RAgMBAAGjEzARMA8GA1Ud +EQQIMAaHBH8AAAEwDQYJKoZIhvcNAQEFBQADgYEAdF4WQHfVdPCbgv9sxgJjcR1H +Hgw9rZ47gO1IiIhzglnLXQ6QuemRiHeYFg4kjcYBk1DJguxzDTGnUwhUXOibAB+S +zssmrkdYYvn9aUhjc3XK3tjAoDpsPpeBeTBamuUKDHoH/dNRXxerZ8vu6uPR3Pgs +5v/KCV6IAEcvNyOXMPo= +-----END CERTIFICATE----- +`) + + // TLSBundleKey ai.key + TLSBundleKey = []byte(`-----BEGIN RSA PRIVATE KEY----- +MIICXAIBAAKBgQDdYVh3oqKP5wEr2648AkM1wolohMxpMN+dzcbAAeePzagy9y1z +QE7YkibvJCQa5gIddiBS7Vixl4xo42JR20FpzkemsL3nl50GbpCckVoe5v0JbfR6 +NAoGRNVPvN9mnORllZXTcVtS8+CPlvf3oc6nvCPNEUunixCn1BVxolvvUQIDAQAB +AoGBAMISrcirddGrlLZLLrKC1ULS2T0cdkqdQtwHYn4+7S5+/z42vMx1iumHLsSk +rVY7X41OWkX4trFxhvEIrc/O48bo2zw78P7flTxHy14uxXnllU8cLThE29SlUU7j +AVBNxJZMsXMlS/DowwD4CjFe+x4Pu9wZcReF2Z9ntzMpySABAkEA+iWoJCPE2JpS +y78q3HYYgpNY3gF3JqQ0SI/zTNkb3YyEIUffEYq0Y9pK13HjKtdsSuX4osTIhQkS ++UgRp6tCAQJBAOKPYTfQ2FX8ijgUpHZRuEAVaxASAS0UATiLgzXxLvOh/VC2at5x +wjOX6sD65pPz/0D8Qj52Cq6Q1TQ+377SDVECQAIy0od+yPweXxvrUjUd1JlRMjbB +TIrKZqs8mKbUQapw0bh5KTy+O1elU4MRPS3jNtBxtP25PQnuSnxmZcFTgAECQFzg +DiiFcsn9FuRagfkHExMiNJuH5feGxeFaP9WzI144v9GAllrOI6Bm3JNzx2ZLlg4b +20Qju8lIEj6yr6JYFaECQHM1VSojGRKpOl9Ox/R4yYSA9RV5Gyn00/aJNxVYyPD5 +i3acL2joQm2kLD/LO8paJ4+iQdRXCOMMIpjxSNjGQjQ= +-----END RSA PRIVATE KEY----- +`) +) diff --git a/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/godoc.html b/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/godoc.html index 7d81f71d..bbbe82ad 100644 --- a/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/godoc.html +++ b/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/godoc.html @@ -27,7 +27,12 @@ var s_code = s.t(); if (s_code) document.write(s_code); </script> - +<script type="text/javascript"> +window.onload = function() { + var a = document.getElementById('feedback-link'); + a.href = "https://docs.aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=awssdkgo&topic_url=" + document.URL +}; +</script> <script> ((window.gitter = {}).chat = {}).options = { room: 'aws/aws-sdk-go' @@ -118,7 +123,7 @@ </div> <div id="mobile-nav" onclick="toggleMobileNav()"></div> <div class="top_link"> - <a class="title" href="https://aws.amazon.com/forms/aws-doc-feedback?hidden_service_name=godoc&hidden_file_name=godoc&hidden_guide_name=godoc&hidden_api_version=HEAD">Feedback</a> + <a id="feedback-link" class="title" href="">Feedback</a> </div> <div class="top_link"> <a class="title" href="https://aws.amazon.com/blogs/developer/category/go/">Blog</a> diff --git a/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/package_service.html b/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/package_service.html index 83b260cf..1b5373fd 100644 --- a/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/package_service.html +++ b/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/package_service.html @@ -61,41 +61,41 @@ <!-- Table of contents for API; must be named manual-nav to turn off auto nav. --> <div id="manual-nav"> <dl> - {{range .Funcs}} + {{range .Funcs -}} {{$name_html := html .Name}} <dd><a href="#{{$name_html}}">{{node_html $ .Decl false | sanitize}}</a></dd> - {{end}} - {{range .Types}} - {{$tname_html := html .Name}} - {{range .Funcs}} - {{$name_html := html .Name}} + {{end -}} + {{range .Types -}} + {{$tname_html := html .Name -}} + {{range .Funcs -}} + {{ $name_html := html .Name -}} <dd><a href="#{{$name_html}}">{{node_html $ .Decl false | sanitize}}</a></dd> - {{end}} - {{range .Methods}} - {{if (and (ne .Name "String") (ne .Name "GoString")) }} - {{ if (not (is_setter $.PDoc.Name .)) }} - {{ if (not (is_paginator .)) }} - {{ if (ne .Name "Validate") }} - {{$name_html := html .Name}} + {{end -}} + {{range .Methods -}} + {{if (and (ne .Name "String") (ne .Name "GoString")) -}} + {{ if (not (is_setter $.PDoc.Name .)) -}} + {{ if (not (is_paginator .)) -}} + {{ if (ne .Name "Validate") -}} + {{ $name_html := html .Name -}} {{ if not (is_op_deprecated $.PDoc.Name .Name) -}} <dd><a href="#{{$tname_html}}.{{$name_html}}">{{client_html $ .Decl false | sanitize}}</a></dd> {{ end -}} - {{end}} - {{end}} - {{end}} - {{end}} - {{end}} - {{if $.Notes}} - {{range $marker, $item := $.Notes}} + {{ end -}} + {{ end -}} + {{ end -}} + {{ end -}} + {{ end -}} + {{if $.Notes -}} + {{range $marker, $item := $.Notes -}} <dd><a href="#pkg-note-{{$marker}}">{{noteTitle $marker | html}}s</a></dd> - {{end}} - {{end}} - {{end}} + {{end -}} + {{ end -}} + {{ end -}} </dl> </div><!-- #manual-nav --> </div><!-- .expanded --> </div><!-- #pkg-index --> - {{ if $.HasPaginators }} + {{ if $.HasPaginators -}} <div id="pkg-pagination " class="toggle"> <div class="collapsed"> <h2 class="toggleButton" title="Click to show Index section">Paginators ▹</h2> @@ -103,42 +103,42 @@ <div class="expanded"> <h2 class="toggleButton" title="Click to hide Index section">Paginators ▾</h2> {{range .Types -}} - {{$tname_html := html .Name}} + {{ $tname_html := html .Name -}} {{range .Methods -}} {{if is_paginator . -}} {{$name_html := html .Name}} <dd><a href="#{{$tname_html}}.{{$name_html}}">{{client_html $ .Decl false | sanitize}}</a></dd> - {{end }} - {{ end }} - {{ end }} + {{end -}} + {{ end -}} + {{ end -}} </div> </div> - {{ end }} + {{ end -}} <div id="pkg-types" class="toggle"> <div class="collapsed"> <h2 class="toggleButton" title="Click to show Index section">Types ▹</h2> </div> <div class="expanded"> <h2 class="toggleButton" title="Click to hide Index section">Types ▾</h2> - {{if .Vars}} + {{ if .Vars -}} <dd><a href="#pkg-variables">Variables</a></dd> - {{end}} + {{ end -}} <dl> - {{range .Types}} - {{$tname_html := html .Name}} + {{ range .Types -}} + {{ $tname_html := html .Name -}} <dt><a href="#{{$tname_html}}">type {{$tname_html}}</a></dd> - {{range .Methods}} - {{ if is_setter $.PDoc.Name .}} - {{$name_html := html .Name}} + {{ range .Methods -}} + {{ if is_setter $.PDoc.Name . -}} + {{ $name_html := html .Name -}} <dd><a href="#{{$tname_html}}.{{$name_html}}">{{name_only_html $ . | sanitize}}</a></dd> - {{end}} - {{end}} - {{end}} + {{ end -}} + {{ end -}} + {{ end -}} </dl> </div> </div> - {{if $.Examples}} + {{ if $.Examples -}} <div id="pkg-examples" class="toggle"> <div class="collapsed"> <h2 class="toggleButton" title="Click to show Index section">Examples ▹</h2> @@ -147,14 +147,14 @@ <h2 class="toggleButton" title="Click to hide Index section">Examples ▾</h2> <div id="pkg-examples"> <dl> - {{range $.Examples}} + {{ range $.Examples -}} <dd><a class="exampleLink" href="#example_{{.Name}}">{{example_name .Name}}</a></dd> - {{end}} + {{ end -}} </dl> </div> </div> </div> - {{end}} + {{ end -}} <div id="pkg-callgraph" class="toggle" style="display: none"> <div class="collapsed"> @@ -192,70 +192,63 @@ <ul style="margin-left: 0.5in" id="callgraph-0" class="treeview"></ul> </div> </div> <!-- #pkg-callgraph --> - - {{with .Consts}} + {{ with .Consts -}} <div id="pkg-consts" class="toggle"> <div class="collapsed"> <h2 class="toggleButton" title="Click to show Index section">Constants ▹</h2> </div> <div class="expanded"> <h2 class="toggleButton" title="Click to hide Index section">Constants ▾</h2> - {{range .}} + {{ range . -}} <pre>{{node_html $ .Decl true}}</pre> - {{comment_html .Doc}} - {{end}} + {{ comment_html .Doc -}} + {{ end -}} </div> </div> - {{end}} - {{with .Vars}} + {{ end -}} + {{ with .Vars -}} <h2 id="pkg-variables">Variables</h2> - {{range .}} + {{ range . -}} <pre>{{node_html $ .Decl true}}</pre> - {{comment_html .Doc}} - {{end}} - {{end}} - {{range .Funcs}} - {{/* Name is a string - no need for FSet */}} - {{$name_html := html .Name}} + {{ comment_html .Doc -}} + {{ end -}} + {{ end -}} + {{ range .Funcs -}} + {{/* Name is a string - no need for FSet */ -}} + {{ $name_html := html .Name -}} <h2 id="{{$name_html}}">func <a href="{{posLink_url $ .Decl}}">{{$name_html}}</a></h2> <pre>{{node_html $ .Decl true}}</pre> {{comment_html .Doc}} {{example_html $ .Name}} {{callgraph_html $ "" .Name}} - - {{end}} - {{range .Types}} - {{$tname := .Name}} - {{$tname_html := html .Name}} + {{ end -}} + {{ range .Types -}} + {{$tname := .Name -}} + {{$tname_html := html .Name -}} <h2 id="{{$tname_html}}">type <a href="{{posLink_url $ .Decl}}">{{$tname_html}}</a></h2> <pre>{{node_html $ .Decl true}}</pre> {{comment_html .Doc}} - - {{range .Consts}} + {{ range .Consts -}} <pre>{{node_html $ .Decl true}}</pre> - {{comment_html .Doc}} - {{end}} - - {{range .Vars}} + {{ comment_html .Doc -}} + {{ end -}} + {{ range .Vars -}} <pre>{{node_html $ .Decl true}}</pre> {{comment_html .Doc}} - {{end}} - - {{example_html $ $tname}} - {{implements_html $ $tname}} - {{methodset_html $ $tname}} - - {{range .Funcs}} - {{$name_html := html .Name}} + {{ end -}} + {{ example_html $ $tname -}} + {{ implements_html $ $tname -}} + {{ methodset_html $ $tname -}} + {{ range .Funcs -}} + {{ $name_html := html .Name -}} <h3 id="{{$name_html}}">func <a href="{{posLink_url $ .Decl}}">{{$name_html}}</a></h3> <pre>{{node_html $ .Decl true}}</pre> {{comment_html .Doc}} {{example_html $ .Name}} {{callgraph_html $ "" .Name}} - {{end}} - - {{range .Methods}} - {{$name_html := html .Name}} + {{ end -}} + {{ range .Methods -}} + {{ $name_html := html .Name -}} {{ if is_op_deprecated $.PDoc.Name .Name -}} <h3 id="{{$tname_html}}.{{$name_html}}">func ({{html .Recv}}) <a href="{{posLink_url $ .Decl}}">{{$name_html}}</a><div class="deprecated">Deprecated</div></h3> {{ else }} @@ -266,24 +259,23 @@ {{$name := printf "%s_%s" $tname .Name}} {{example_html $ $name}} {{callgraph_html $ .Recv .Name}} - {{end}} - {{end}} - {{end}} - - {{with $.Notes}} - {{range $marker, $content := .}} + {{ end -}} + {{ end -}} + {{ end -}} + {{ with $.Notes -}} + {{ range $marker, $content := . -}} <h2 id="pkg-note-{{$marker}}">{{noteTitle $marker | html}}s</h2> <ul style="list-style: none; padding: 0;"> - {{range .}} + {{ range . -}} <li><a href="{{posLink_url $ .}}">☞</a> {{html .Body}}</li> - {{end}} + {{ end -}} </ul> - {{end}} - {{end}} -{{end}} + {{ end -}} + {{ end -}} +{{ end -}} -{{with .PAst}} - {{range $filename, $ast := .}} +{{ with .PAst -}} + {{ range $filename, $ast := . -}} <a href="{{$filename|srcLink|html}}">{{$filename|filename|html}}</a>:<pre>{{node_html $ $ast false}}</pre> - {{end}} -{{end}} + {{ end -}} +{{ end -}} diff --git a/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/style.css b/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/style.css index fb3c356b..d292d90a 100644 --- a/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/style.css +++ b/vendor/github.com/aws/aws-sdk-go/doc-src/aws-godoc/templates/style.css @@ -17,13 +17,6 @@ div.deprecated { margin-left: 5px; } -a > img { - max-height:70%; - float:left; - padding-left:22px; - padding-top:8px; -} - .packages { margin:0; padding:0; @@ -772,13 +765,6 @@ a.error { padding: 10px; } - a > img { - max-height:100%; - float:left; - padding-left:10px; - padding-top:2px; - } - div#mobile-nav { display:inline-block; float:right; diff --git a/vendor/github.com/aws/aws-sdk-go/doc.go b/vendor/github.com/aws/aws-sdk-go/doc.go new file mode 100644 index 00000000..3e077e51 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/example/service/dynamodb/scanItems/README.md b/vendor/github.com/aws/aws-sdk-go/example/service/dynamodb/scanItems/README.md index fbe81065..89359262 100644 --- a/vendor/github.com/aws/aws-sdk-go/example/service/dynamodb/scanItems/README.md +++ b/vendor/github.com/aws/aws-sdk-go/example/service/dynamodb/scanItems/README.md @@ -13,7 +13,7 @@ type Item struct { Data map[string]interface{} } ``` -Use Go tags to define what the name is of the attribute in your DynamoDB table. See [AWS SDK for Go API Reference: Marshal](http://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/dynamodbattribute/#Marshal) for more information. +Use Go tags to define what the name is of the attribute in your DynamoDB table. See [AWS SDK for Go API Reference: Marshal](https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/dynamodbattribute/#Marshal) for more information. In DynamoDB the structure of the item to be returned will be: ```json diff --git a/vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/README.md b/vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/README.md new file mode 100644 index 00000000..2a569b29 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/README.md @@ -0,0 +1,15 @@ +# Example + +This is an example using the AWS SDK for Go to create an Amazon RDS DB token using the +rdsutils package. + +# Usage + +```sh +go run -tags example iam_authetnication.go <region> <db user> <db name> <endpoint to database> <iam arn> +``` + +Output: +``` +Successfully opened connection to database +``` diff --git a/vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/iam_authentication.go b/vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/iam_authentication.go new file mode 100644 index 00000000..fe749a1d --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/iam_authentication.go @@ -0,0 +1,47 @@ +// +build example,skip + +package main + +import ( + "database/sql" + "fmt" + "log" + "os" + + "github.com/go-sql-driver/mysql" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/credentials/stscreds" + "github.com/aws/aws-sdk-go/aws/session" + "github.com/aws/aws-sdk-go/service/rds/rdsutils" +) + +// Usage ./iam_authentication <region> <db user> <db name> <endpoint to database> <iam arn> +func main() { + if len(os.Args) < 5 { + log.Println("USAGE ERROR: go run concatenateObjects.go <region> <endpoint to database> <iam arn>") + os.Exit(1) + } + + awsRegion := os.Args[1] + dbUser := os.Args[2] + dbName := os.Args[3] + dbEndpoint := os.Args[4] + awsCreds := stscreds.NewCredentials(session.New(&aws.Config{Region: &awsRegion}), os.Args[5]) + authToken, err := rdsutils.BuildAuthToken(dbEndpoint, awsRegion, dbUser, awsCreds) + + // Create the MySQL DNS string for the DB connection + // user:password@protocol(endpoint)/dbname?<params> + dnsStr := fmt.Sprintf("%s:%s@tcp(%s)/%s?tls=true", + dbUser, authToken, dbEndpoint, dbName, + ) + + driver := mysql.MySQLDriver{} + _ = driver + // Use db to perform SQL operations on database + if _, err = sql.Open("mysql", dnsStr); err != nil { + panic(err) + } + + fmt.Println("Successfully opened connection to database") +} diff --git a/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/README.md b/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/README.md new file mode 100644 index 00000000..b0e00454 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/README.md @@ -0,0 +1,124 @@ +# Presigned Amazon S3 API Operation Example + +This example demonstrates how you can build a client application to retrieve and +upload object data from Amazon S3 without needing to know anything about Amazon +S3 or have access to any AWS credentials. Only the service would have knowledge +of how and where the objects are stored in Amazon S3. + +The example is split into two parts `server.go` and `client.go`. These two parts +simulate the client/server architecture. In this example the client will represent +a third part user that will request resource URLs from the service. The service +will generate presigned S3 URLs which the client can use to download and +upload S3 object content. + +The service supports generating presigned URLs for two S3 APIs; `GetObject` and +`PutObject`. The client will request a presigned URL from the service with an +object Key. In this example the value is the S3 object's `key`. Alternatively, +you could use your own pattern with no visible relation to the S3 object's key. +The server would then perform a cross reference with client provided value to +one that maps to the S3 object's key. + +Before using the client to upload and download S3 objects you'll need to start the +service. The service will use the SDK's default credential chain to source your +AWS credentials. See the [`Configuring Credentials`](http://docs.aws.amazon.com/sdk-for-go/api/) +section of the SDK's API Reference guide on how the SDK loads your AWS credentials. + +The server requires the S3 `-b bucket` the presigned URLs will be generated for. A +`-r region` is only needed if the bucket is in AWS China or AWS Gov Cloud. For +buckets in AWS the server will use the [`s3manager.GetBucketRegion`](http://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#GetBucketRegion) utility to lookup the bucket's region. + +You should run the service in the background or in a separate terminal tab before +moving onto the client. + + +```sh +go run -tags example server/server.go -b mybucket +> Starting Server On: 127.0.0.1:8080 +``` + +Use the `--help` flag to see a list of additional configuration flags, and their +defaults. + +## Downloading an Amazon S3 Object + +Use the client application to request a presigned URL from the server and use +that presigned URL to download the object from S3. Calling the client with the +`-get key` flag will do this. An optional `-f filename` flag can be provided as +well to write the object to. If no flag is provided the object will be written +to `stdout` + +```sh +go run -tags example client/client.go -get "my-object/key" -f outputfilename +``` + +Use the `--help` flag to see a list of additional configuration flags, and their +defaults. + +The following curl request demonstrates the request the client makes to the server +for the presigned URL for the `my-object/key` S3 object. The `method` query +parameter lets the server know that we are requesting the `GetObject`'s presigned +URL. The `method` value can be `GET` or `PUT` for the `GetObject` or `PutObject` APIs. + +```sh +curl -v "http://127.0.0.1:8080/presign/my-object/key?method=GET" +``` + +The server will respond with a JSON value. The value contains three pieces of +information that the client will need to correctly make the request. First is +the presigned URL. This is the URL the client will make the request to. Second +is the HTTP method the request should be sent as. This is included to simplify +the client's request building. Finally the response will include a list of +additional headers that the client should include that the presigned request +was signed with. + +```json +{ + "URL": "https://mybucket.s3-us-west-2.amazonaws.com/my-object/key?<signature>", + "Method": "GET", + "Header": { + "x-amz-content-sha256":["UNSIGNED-PAYLOAD"] + } +} +``` + +With this URL our client will build a HTTP request for the S3 object's data. The +`client.go` will then write the object's data to the `filename` if one is provided, +or to `stdout` of a filename is not set in the command line arguments. + +## Uploading a File to Amazon S3 + +Just like the download, uploading a file to S3 will use a presigned URL requested +from the server. The resigned URL will be built into an HTTP request using the +URL, Method, and Headers. The `-put key` flag will upload the content of `-f filename` +or stdin if no filename is provided to S3 using a presigned URL provided by the +service + +```sh +go run -tags example client/client.go -put "my-object/key" -f filename +``` + +Like the download case this will make a HTTP request to the server for the +presigned URL. The Server will respond with a presigned URL for S3's `PutObject` +API operation. In addition the `method` query parameter the client will also +include a `contentLength` this value instructs the server to generate the presigned +PutObject request with a `Content-Length` header value included in the signature. +This is done so the content that is uploaded by the client can only be the size +the presigned request was generated for. + +```sh +curl -v "http://127.0.0.1:8080/presign/my-object/key?method=PUT&contentLength=1024" +``` + +## Expanding the Example + +This example provides a spring board you can use to vend presigned URLs to your +clients instead of streaming the object's content through your service. This +client and server example can be expanded and customized. Adding new functionality +such as additional constraints the server puts on the presigned URLs like +`Content-Type`. + +In addition to adding constraints to the presigned URLs the service could be +updated to obfuscate S3 object's key. Instead of the client knowing the object's +key, a lookup system could be used instead. This could be substitution based, +or lookup into an external data store such as DynamoDB. + diff --git a/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/client/client.go b/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/client/client.go new file mode 100644 index 00000000..df63aa22 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/client/client.go @@ -0,0 +1,266 @@ +// +build example + +package main + +import ( + "bytes" + "encoding/json" + "flag" + "fmt" + "io" + "io/ioutil" + "net/http" + "os" + "strconv" + "strings" +) + +// client.go is an example of a client that will request URLs from a service that +// the client will use to upload and download content with. +// +// The server must be started before the client is run. +// +// Use "--help" command line argument flag to see all options and defaults. If +// filename is not provided the client will read from stdin for uploads and +// write to stdout for downloads. +// +// Usage: +// go run -tags example client.go -get myObjectKey -f filename +func main() { + method, filename, key, serverURL := loadConfig() + + var err error + + switch method { + case GetMethod: + // Requests the URL from the server that the client will use to download + // the content from. The content will be written to the file pointed to + // by filename. Creating it if the file does not exist. If filename is + // not set the contents will be written to stdout. + err = downloadFile(serverURL, key, filename) + case PutMethod: + // Requests the URL from the service that the client will use to upload + // content to. The content will be read from the file pointed to by the + // filename. If the filename is not set, content will be read from stdin. + err = uploadFile(serverURL, key, filename) + } + + if err != nil { + exitError(err) + } +} + +// loadConfig configures the client based on the command line arguments used. +func loadConfig() (method Method, serverURL, key, filename string) { + var getKey, putKey string + flag.StringVar(&getKey, "get", "", + "Downloads the object from S3 by the `key`. Writes the object to a file the filename is provided, otherwise writes to stdout.") + flag.StringVar(&putKey, "put", "", + "Uploads data to S3 at the `key` provided. Uploads the file if filename is provided, otherwise reads from stdin.") + flag.StringVar(&serverURL, "s", "http://127.0.0.1:8080", "Required `URL` the client will request presigned S3 operation from.") + flag.StringVar(&filename, "f", "", "The `filename` of the file to upload and get from S3.") + flag.Parse() + + var errs Errors + + if len(serverURL) == 0 { + errs = append(errs, fmt.Errorf("server URL required")) + } + + if !((len(getKey) != 0) != (len(putKey) != 0)) { + errs = append(errs, fmt.Errorf("either `get` or `put` can be provided, and one of the two is required.")) + } + + if len(getKey) > 0 { + method = GetMethod + key = getKey + } else { + method = PutMethod + key = putKey + } + + if len(errs) > 0 { + fmt.Fprintf(os.Stderr, "Failed to load configuration:%v\n", errs) + flag.PrintDefaults() + os.Exit(1) + } + + return method, filename, key, serverURL +} + +// downloadFile will request a URL from the server that the client can download +// the content pointed to by "key". The content will be written to the file +// pointed to by filename, creating the file if it doesn't exist. If filename +// is not set the content will be written to stdout. +func downloadFile(serverURL, key, filename string) error { + var w *os.File + if len(filename) > 0 { + f, err := os.Create(filename) + if err != nil { + return fmt.Errorf("failed to create download file %s, %v", filename, err) + } + w = f + } else { + w = os.Stdout + } + defer w.Close() + + // Get the presigned URL from the remote service. + req, err := getPresignedRequest(serverURL, "GET", key, 0) + if err != nil { + return fmt.Errorf("failed to get get presigned request, %v", err) + } + + // Gets the file contents with the URL provided by the service. + resp, err := http.DefaultClient.Do(req) + if err != nil { + return fmt.Errorf("failed to do GET request, %v", err) + } + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return fmt.Errorf("failed to get S3 object, %d:%s", + resp.StatusCode, resp.Status) + } + + if _, err = io.Copy(w, resp.Body); err != nil { + return fmt.Errorf("failed to write S3 object, %v", err) + } + + return nil +} + +// uploadFile will request a URL from the service that the client can use to +// upload content to. The content will be read from the file pointed to by filename. +// If filename is not set the content will be read from stdin. +func uploadFile(serverURL, key, filename string) error { + var r io.ReadCloser + var size int64 + if len(filename) > 0 { + f, err := os.Open(filename) + if err != nil { + return fmt.Errorf("failed to open upload file %s, %v", filename, err) + } + + // Get the size of the file so that the constraint of Content-Length + // can be included with the presigned URL. This can be used by the + // server or client to ensure the content uploaded is of a certain size. + // + // These constraints can further be expanded to include things like + // Content-Type. Additionally constraints such as X-Amz-Content-Sha256 + // header set restricting the content of the file to only the content + // the client initially made the request with. This prevents the object + // from being overwritten or used to upload other unintended content. + stat, err := f.Stat() + if err != nil { + return fmt.Errorf("failed to stat file, %s, %v", filename, err) + } + + size = stat.Size() + r = f + } else { + buf := &bytes.Buffer{} + io.Copy(buf, os.Stdin) + size = int64(buf.Len()) + + r = ioutil.NopCloser(buf) + } + defer r.Close() + + // Get the Presigned URL from the remote service. Pass in the file's + // size if it is known so that the presigned URL returned will be required + // to be used with the size of content requested. + req, err := getPresignedRequest(serverURL, "PUT", key, size) + if err != nil { + return fmt.Errorf("failed to get get presigned request, %v", err) + } + req.Body = r + + // Upload the file contents to S3. + resp, err := http.DefaultClient.Do(req) + if err != nil { + return fmt.Errorf("failed to do GET request, %v", err) + } + + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return fmt.Errorf("failed to put S3 object, %d:%s", + resp.StatusCode, resp.Status) + } + + return nil +} + +// getPresignRequest will request a URL from the service for the content specified +// by the key and method. Returns a constructed Request that can be used to +// upload or download content with based on the method used. +// +// If the PUT method is used the request's Body will need to be set on the returned +// request value. +func getPresignedRequest(serverURL, method, key string, contentLen int64) (*http.Request, error) { + u := fmt.Sprintf("%s/presign/%s?method=%s&contentLength=%d", + serverURL, key, method, contentLen, + ) + + resp, err := http.Get(u) + if err != nil { + return nil, fmt.Errorf("failed to make request for presigned URL, %v", err) + } + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return nil, fmt.Errorf("failed to get valid presign response, %s", resp.Status) + } + + p := PresignResp{} + if err := json.NewDecoder(resp.Body).Decode(&p); err != nil { + return nil, fmt.Errorf("failed to decode response body, %v", err) + } + + req, err := http.NewRequest(p.Method, p.URL, nil) + if err != nil { + return nil, fmt.Errorf("failed to build presigned request, %v", err) + } + + for k, vs := range p.Header { + for _, v := range vs { + req.Header.Add(k, v) + } + } + // Need to ensure that the content length member is set of the HTTP Request + // or the request will not be transmitted correctly with a content length + // value across the wire. + if contLen := req.Header.Get("Content-Length"); len(contLen) > 0 { + req.ContentLength, _ = strconv.ParseInt(contLen, 10, 64) + } + + return req, nil +} + +type Method int + +const ( + PutMethod Method = iota + GetMethod +) + +type Errors []error + +func (es Errors) Error() string { + out := make([]string, len(es)) + for _, e := range es { + out = append(out, e.Error()) + } + return strings.Join(out, "\n") +} + +type PresignResp struct { + Method, URL string + Header http.Header +} + +func exitError(err error) { + fmt.Fprintln(os.Stderr, err.Error()) + os.Exit(1) +} diff --git a/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/server/server.go b/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/server/server.go new file mode 100644 index 00000000..ddf3f42e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/server/server.go @@ -0,0 +1,186 @@ +// +build example + +package main + +import ( + "encoding/json" + "flag" + "fmt" + "net" + "net/http" + "os" + "strconv" + "strings" + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/endpoints" + "github.com/aws/aws-sdk-go/aws/session" + "github.com/aws/aws-sdk-go/service/s3" + "github.com/aws/aws-sdk-go/service/s3/s3iface" + "github.com/aws/aws-sdk-go/service/s3/s3manager" +) + +// server.go is an example of a service that vends lists for requests for presigned +// URLs for S3 objects. The service supports two S3 operations, "GetObject" and +// "PutObject". +// +// Example GetObject request to the service for the object with the key "MyObjectKey": +// +// curl -v "http://127.0.0.1:8080/presign/my-object/key?method=GET" +// +// Example PutObject request to the service for the object with the key "MyObjectKey": +// +// curl -v "http://127.0.0.1:8080/presign/my-object/key?method=PUT&contentLength=1024" +// +// Use "--help" command line argument flag to see all options and defaults. +// +// Usage: +// go run -tags example service.go -b myBucket +func main() { + addr, bucket, region := loadConfig() + + // Create a AWS SDK for Go Session that will load credentials using the SDK's + // default credential change. + sess := session.Must(session.NewSession()) + + // Use the GetBucketRegion utility to lookup the bucket's region automatically. + // The service.go will only do this correctly for AWS regions. For AWS China + // and AWS Gov Cloud the region needs to be specified to let the service know + // to look in those partitions instead of AWS. + if len(region) == 0 { + var err error + region, err = s3manager.GetBucketRegion(aws.BackgroundContext(), sess, bucket, endpoints.UsWest2RegionID) + if err != nil { + exitError(fmt.Errorf("failed to get bucket region, %v", err)) + } + } + + // Create a new S3 service client that will be use by the service to generate + // presigned URLs with. Not actual API requests will be made with this client. + // The credentials loaded when the Session was created above will be used + // to sign the requests with. + s3Svc := s3.New(sess, &aws.Config{ + Region: aws.String(region), + }) + + // Start the server listening and serve presigned URLs for GetObject and + // PutObject requests. + if err := listenAndServe(addr, bucket, s3Svc); err != nil { + exitError(err) + } +} + +func loadConfig() (addr, bucket, region string) { + flag.StringVar(&bucket, "b", "", "S3 `bucket` object should be uploaded to.") + flag.StringVar(®ion, "r", "", "AWS `region` the bucket exists in, If not set region will be looked up, only valid for AWS Regions, not AWS China or Gov Cloud.") + flag.StringVar(&addr, "a", "127.0.0.1:8080", "The TCP `address` the server will be started on.") + flag.Parse() + + if len(bucket) == 0 { + fmt.Fprintln(os.Stderr, "bucket is required") + flag.PrintDefaults() + os.Exit(1) + } + + return addr, bucket, region +} + +func listenAndServe(addr, bucket string, svc s3iface.S3API) error { + l, err := net.Listen("tcp", addr) + if err != nil { + return fmt.Errorf("failed to start service listener, %v", err) + } + + const presignPath = "/presign/" + + // Create the HTTP handler for the "/presign/" path prefix. This will handle + // all requests on this path, extracting the object's key from the path. + http.HandleFunc(presignPath, func(w http.ResponseWriter, r *http.Request) { + var u string + var err error + var signedHeaders http.Header + + query := r.URL.Query() + + var contentLen int64 + // Optionally the Content-Length header can be included with the signature + // of the request. This is helpful to ensure the content uploaded is the + // size that is expected. Constraints like these can be further expanded + // with headers such as `Content-Type`. These can be enforced by the service + // requiring the client to satisfying those constraints when uploading + // + // In addition the client could provide the service with a SHA256 of the + // content to be uploaded. This prevents any other third party from uploading + // anything else with the presigned URL + if contLenStr := query.Get("contentLength"); len(contLenStr) > 0 { + contentLen, err = strconv.ParseInt(contLenStr, 10, 64) + if err != nil { + fmt.Fprintf(os.Stderr, "unable to parse request content length, %v", err) + http.Error(w, err.Error(), http.StatusBadRequest) + return + } + } + + // Extract the object key from the path + key := strings.Replace(r.URL.Path, presignPath, "", 1) + method := query.Get("method") + + switch method { + case "PUT": + // For creating PutObject presigned URLs + fmt.Println("Received request to presign PutObject for,", key) + sdkReq, _ := svc.PutObjectRequest(&s3.PutObjectInput{ + Bucket: aws.String(bucket), + Key: aws.String(key), + + // If ContentLength is 0 the header will not be included in the signature. + ContentLength: aws.Int64(contentLen), + }) + u, signedHeaders, err = sdkReq.PresignRequest(15 * time.Minute) + case "GET": + // For creating GetObject presigned URLs + fmt.Println("Received request to presign GetObject for,", key) + sdkReq, _ := svc.GetObjectRequest(&s3.GetObjectInput{ + Bucket: aws.String(bucket), + Key: aws.String(key), + }) + u, signedHeaders, err = sdkReq.PresignRequest(15 * time.Minute) + default: + fmt.Fprintf(os.Stderr, "invalid method provided, %s, %v\n", method, err) + err = fmt.Errorf("invalid request") + } + + if err != nil { + http.Error(w, err.Error(), http.StatusBadRequest) + return + } + + // Create the response back to the client with the information on the + // presigned request and additional headers to include. + if err := json.NewEncoder(w).Encode(PresignResp{ + Method: method, + URL: u, + Header: signedHeaders, + }); err != nil { + fmt.Fprintf(os.Stderr, "failed to encode presign response, %v", err) + } + }) + + fmt.Println("Starting Server On:", "http://"+l.Addr().String()) + + s := &http.Server{} + return s.Serve(l) +} + +// PresignResp provides the Go representation of the JSON value that will be +// sent to the client. +type PresignResp struct { + Method, URL string + Header http.Header +} + +func exitError(err error) { + fmt.Fprintln(os.Stderr, err.Error()) + os.Exit(1) +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/api-2.json new file mode 100644 index 00000000..b0d7c07a --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/api-2.json @@ -0,0 +1,615 @@ +{ + "version":"2.0", + "metadata":{ + "apiVersion":"2017-05-18", + "endpointPrefix":"athena", + "jsonVersion":"1.1", + "protocol":"json", + "serviceFullName":"Amazon Athena", + "signatureVersion":"v4", + "targetPrefix":"AmazonAthena", + "uid":"athena-2017-05-18" + }, + "operations":{ + "BatchGetNamedQuery":{ + "name":"BatchGetNamedQuery", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"BatchGetNamedQueryInput"}, + "output":{"shape":"BatchGetNamedQueryOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ] + }, + "BatchGetQueryExecution":{ + "name":"BatchGetQueryExecution", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"BatchGetQueryExecutionInput"}, + "output":{"shape":"BatchGetQueryExecutionOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ] + }, + "CreateNamedQuery":{ + "name":"CreateNamedQuery", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateNamedQueryInput"}, + "output":{"shape":"CreateNamedQueryOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ], + "idempotent":true + }, + "DeleteNamedQuery":{ + "name":"DeleteNamedQuery", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteNamedQueryInput"}, + "output":{"shape":"DeleteNamedQueryOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ], + "idempotent":true + }, + "GetNamedQuery":{ + "name":"GetNamedQuery", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetNamedQueryInput"}, + "output":{"shape":"GetNamedQueryOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ] + }, + "GetQueryExecution":{ + "name":"GetQueryExecution", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetQueryExecutionInput"}, + "output":{"shape":"GetQueryExecutionOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ] + }, + "GetQueryResults":{ + "name":"GetQueryResults", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetQueryResultsInput"}, + "output":{"shape":"GetQueryResultsOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ] + }, + "ListNamedQueries":{ + "name":"ListNamedQueries", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListNamedQueriesInput"}, + "output":{"shape":"ListNamedQueriesOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ] + }, + "ListQueryExecutions":{ + "name":"ListQueryExecutions", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListQueryExecutionsInput"}, + "output":{"shape":"ListQueryExecutionsOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ] + }, + "StartQueryExecution":{ + "name":"StartQueryExecution", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"StartQueryExecutionInput"}, + "output":{"shape":"StartQueryExecutionOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"}, + {"shape":"TooManyRequestsException"} + ], + "idempotent":true + }, + "StopQueryExecution":{ + "name":"StopQueryExecution", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"StopQueryExecutionInput"}, + "output":{"shape":"StopQueryExecutionOutput"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"InvalidRequestException"} + ], + "idempotent":true + } + }, + "shapes":{ + "BatchGetNamedQueryInput":{ + "type":"structure", + "required":["NamedQueryIds"], + "members":{ + "NamedQueryIds":{"shape":"NamedQueryIdList"} + } + }, + "BatchGetNamedQueryOutput":{ + "type":"structure", + "members":{ + "NamedQueries":{"shape":"NamedQueryList"}, + "UnprocessedNamedQueryIds":{"shape":"UnprocessedNamedQueryIdList"} + } + }, + "BatchGetQueryExecutionInput":{ + "type":"structure", + "required":["QueryExecutionIds"], + "members":{ + "QueryExecutionIds":{"shape":"QueryExecutionIdList"} + } + }, + "BatchGetQueryExecutionOutput":{ + "type":"structure", + "members":{ + "QueryExecutions":{"shape":"QueryExecutionList"}, + "UnprocessedQueryExecutionIds":{"shape":"UnprocessedQueryExecutionIdList"} + } + }, + "Boolean":{"type":"boolean"}, + "ColumnInfo":{ + "type":"structure", + "required":[ + "Name", + "Type" + ], + "members":{ + "CatalogName":{"shape":"String"}, + "SchemaName":{"shape":"String"}, + "TableName":{"shape":"String"}, + "Name":{"shape":"String"}, + "Label":{"shape":"String"}, + "Type":{"shape":"String"}, + "Precision":{"shape":"Integer"}, + "Scale":{"shape":"Integer"}, + "Nullable":{"shape":"ColumnNullable"}, + "CaseSensitive":{"shape":"Boolean"} + } + }, + "ColumnInfoList":{ + "type":"list", + "member":{"shape":"ColumnInfo"} + }, + "ColumnNullable":{ + "type":"string", + "enum":[ + "NOT_NULL", + "NULLABLE", + "UNKNOWN" + ] + }, + "CreateNamedQueryInput":{ + "type":"structure", + "required":[ + "Name", + "Database", + "QueryString" + ], + "members":{ + "Name":{"shape":"NameString"}, + "Description":{"shape":"DescriptionString"}, + "Database":{"shape":"DatabaseString"}, + "QueryString":{"shape":"QueryString"}, + "ClientRequestToken":{ + "shape":"IdempotencyToken", + "idempotencyToken":true + } + } + }, + "CreateNamedQueryOutput":{ + "type":"structure", + "members":{ + "NamedQueryId":{"shape":"NamedQueryId"} + } + }, + "DatabaseString":{ + "type":"string", + "max":32, + "min":1 + }, + "Date":{"type":"timestamp"}, + "Datum":{ + "type":"structure", + "members":{ + "VarCharValue":{"shape":"datumString"} + } + }, + "DeleteNamedQueryInput":{ + "type":"structure", + "required":["NamedQueryId"], + "members":{ + "NamedQueryId":{ + "shape":"NamedQueryId", + "idempotencyToken":true + } + } + }, + "DeleteNamedQueryOutput":{ + "type":"structure", + "members":{ + } + }, + "DescriptionString":{ + "type":"string", + "max":1024, + "min":1 + }, + "EncryptionConfiguration":{ + "type":"structure", + "required":["EncryptionOption"], + "members":{ + "EncryptionOption":{"shape":"EncryptionOption"}, + "KmsKey":{"shape":"String"} + } + }, + "EncryptionOption":{ + "type":"string", + "enum":[ + "SSE_S3", + "SSE_KMS", + "CSE_KMS" + ] + }, + "ErrorCode":{ + "type":"string", + "max":256, + "min":1 + }, + "ErrorMessage":{"type":"string"}, + "GetNamedQueryInput":{ + "type":"structure", + "required":["NamedQueryId"], + "members":{ + "NamedQueryId":{"shape":"NamedQueryId"} + } + }, + "GetNamedQueryOutput":{ + "type":"structure", + "members":{ + "NamedQuery":{"shape":"NamedQuery"} + } + }, + "GetQueryExecutionInput":{ + "type":"structure", + "required":["QueryExecutionId"], + "members":{ + "QueryExecutionId":{"shape":"QueryExecutionId"} + } + }, + "GetQueryExecutionOutput":{ + "type":"structure", + "members":{ + "QueryExecution":{"shape":"QueryExecution"} + } + }, + "GetQueryResultsInput":{ + "type":"structure", + "required":["QueryExecutionId"], + "members":{ + "QueryExecutionId":{"shape":"QueryExecutionId"}, + "NextToken":{"shape":"Token"}, + "MaxResults":{"shape":"MaxQueryResults"} + } + }, + "GetQueryResultsOutput":{ + "type":"structure", + "members":{ + "ResultSet":{"shape":"ResultSet"}, + "NextToken":{"shape":"Token"} + } + }, + "IdempotencyToken":{ + "type":"string", + "max":128, + "min":32 + }, + "Integer":{"type":"integer"}, + "InternalServerException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"} + }, + "exception":true, + "fault":true + }, + "InvalidRequestException":{ + "type":"structure", + "members":{ + "AthenaErrorCode":{"shape":"ErrorCode"}, + "Message":{"shape":"ErrorMessage"} + }, + "exception":true + }, + "ListNamedQueriesInput":{ + "type":"structure", + "members":{ + "NextToken":{"shape":"Token"}, + "MaxResults":{"shape":"MaxNamedQueriesCount"} + } + }, + "ListNamedQueriesOutput":{ + "type":"structure", + "members":{ + "NamedQueryIds":{"shape":"NamedQueryIdList"}, + "NextToken":{"shape":"Token"} + } + }, + "ListQueryExecutionsInput":{ + "type":"structure", + "members":{ + "NextToken":{"shape":"Token"}, + "MaxResults":{"shape":"MaxQueryExecutionsCount"} + } + }, + "ListQueryExecutionsOutput":{ + "type":"structure", + "members":{ + "QueryExecutionIds":{"shape":"QueryExecutionIdList"}, + "NextToken":{"shape":"Token"} + } + }, + "Long":{"type":"long"}, + "MaxNamedQueriesCount":{ + "type":"integer", + "box":true, + "max":50, + "min":0 + }, + "MaxQueryExecutionsCount":{ + "type":"integer", + "box":true, + "max":50, + "min":0 + }, + "MaxQueryResults":{ + "type":"integer", + "box":true, + "max":1000, + "min":0 + }, + "NameString":{ + "type":"string", + "max":128, + "min":1 + }, + "NamedQuery":{ + "type":"structure", + "required":[ + "Name", + "Database", + "QueryString" + ], + "members":{ + "Name":{"shape":"NameString"}, + "Description":{"shape":"DescriptionString"}, + "Database":{"shape":"DatabaseString"}, + "QueryString":{"shape":"QueryString"}, + "NamedQueryId":{"shape":"NamedQueryId"} + } + }, + "NamedQueryId":{"type":"string"}, + "NamedQueryIdList":{ + "type":"list", + "member":{"shape":"NamedQueryId"}, + "max":50, + "min":1 + }, + "NamedQueryList":{ + "type":"list", + "member":{"shape":"NamedQuery"} + }, + "QueryExecution":{ + "type":"structure", + "members":{ + "QueryExecutionId":{"shape":"QueryExecutionId"}, + "Query":{"shape":"QueryString"}, + "ResultConfiguration":{"shape":"ResultConfiguration"}, + "QueryExecutionContext":{"shape":"QueryExecutionContext"}, + "Status":{"shape":"QueryExecutionStatus"}, + "Statistics":{"shape":"QueryExecutionStatistics"} + } + }, + "QueryExecutionContext":{ + "type":"structure", + "members":{ + "Database":{"shape":"DatabaseString"} + } + }, + "QueryExecutionId":{"type":"string"}, + "QueryExecutionIdList":{ + "type":"list", + "member":{"shape":"QueryExecutionId"}, + "max":50, + "min":1 + }, + "QueryExecutionList":{ + "type":"list", + "member":{"shape":"QueryExecution"} + }, + "QueryExecutionState":{ + "type":"string", + "enum":[ + "QUEUED", + "RUNNING", + "SUCCEEDED", + "FAILED", + "CANCELLED" + ] + }, + "QueryExecutionStatistics":{ + "type":"structure", + "members":{ + "EngineExecutionTimeInMillis":{"shape":"Long"}, + "DataScannedInBytes":{"shape":"Long"} + } + }, + "QueryExecutionStatus":{ + "type":"structure", + "members":{ + "State":{"shape":"QueryExecutionState"}, + "StateChangeReason":{"shape":"String"}, + "SubmissionDateTime":{"shape":"Date"}, + "CompletionDateTime":{"shape":"Date"} + } + }, + "QueryString":{ + "type":"string", + "max":262144, + "min":1 + }, + "ResultConfiguration":{ + "type":"structure", + "required":["OutputLocation"], + "members":{ + "OutputLocation":{"shape":"String"}, + "EncryptionConfiguration":{"shape":"EncryptionConfiguration"} + } + }, + "ResultSet":{ + "type":"structure", + "members":{ + "Rows":{"shape":"RowList"}, + "ResultSetMetadata":{"shape":"ResultSetMetadata"} + } + }, + "ResultSetMetadata":{ + "type":"structure", + "members":{ + "ColumnInfo":{"shape":"ColumnInfoList"} + } + }, + "Row":{ + "type":"structure", + "members":{ + "Data":{"shape":"datumList"} + } + }, + "RowList":{ + "type":"list", + "member":{"shape":"Row"} + }, + "StartQueryExecutionInput":{ + "type":"structure", + "required":[ + "QueryString", + "ResultConfiguration" + ], + "members":{ + "QueryString":{"shape":"QueryString"}, + "ClientRequestToken":{ + "shape":"IdempotencyToken", + "idempotencyToken":true + }, + "QueryExecutionContext":{"shape":"QueryExecutionContext"}, + "ResultConfiguration":{"shape":"ResultConfiguration"} + } + }, + "StartQueryExecutionOutput":{ + "type":"structure", + "members":{ + "QueryExecutionId":{"shape":"QueryExecutionId"} + } + }, + "StopQueryExecutionInput":{ + "type":"structure", + "required":["QueryExecutionId"], + "members":{ + "QueryExecutionId":{ + "shape":"QueryExecutionId", + "idempotencyToken":true + } + } + }, + "StopQueryExecutionOutput":{ + "type":"structure", + "members":{ + } + }, + "String":{"type":"string"}, + "ThrottleReason":{ + "type":"string", + "enum":["CONCURRENT_QUERY_LIMIT_EXCEEDED"] + }, + "Token":{"type":"string"}, + "TooManyRequestsException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"}, + "Reason":{"shape":"ThrottleReason"} + }, + "exception":true + }, + "UnprocessedNamedQueryId":{ + "type":"structure", + "members":{ + "NamedQueryId":{"shape":"NamedQueryId"}, + "ErrorCode":{"shape":"ErrorCode"}, + "ErrorMessage":{"shape":"ErrorMessage"} + } + }, + "UnprocessedNamedQueryIdList":{ + "type":"list", + "member":{"shape":"UnprocessedNamedQueryId"} + }, + "UnprocessedQueryExecutionId":{ + "type":"structure", + "members":{ + "QueryExecutionId":{"shape":"QueryExecutionId"}, + "ErrorCode":{"shape":"ErrorCode"}, + "ErrorMessage":{"shape":"ErrorMessage"} + } + }, + "UnprocessedQueryExecutionIdList":{ + "type":"list", + "member":{"shape":"UnprocessedQueryExecutionId"} + }, + "datumList":{ + "type":"list", + "member":{"shape":"Datum"} + }, + "datumString":{"type":"string"} + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/docs-2.json new file mode 100644 index 00000000..fc6ef23e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/docs-2.json @@ -0,0 +1,467 @@ +{ + "version": "2.0", + "service": "<p>Amazon Athena is an interactive query service that lets you use standard SQL to analyze data directly in Amazon S3. You can point Athena at your data in Amazon S3 and run ad-hoc queries and get results in seconds. Athena is serverless, so there is no infrastructure to set up or manage. You pay only for the queries you run. Athena scales automatically—executing queries in parallel—so results are fast, even with large datasets and complex queries. For more information, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/what-is.html\">What is Amazon Athena</a> in the <i>Amazon Athena User Guide</i>.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>", + "operations": { + "BatchGetNamedQuery": "<p>Returns the details of a single named query or a list of up to 50 queries, which you provide as an array of query ID strings. Use <a>ListNamedQueries</a> to get the list of named query IDs. If information could not be retrieved for a submitted query ID, information about the query ID submitted is listed under <a>UnprocessedNamedQueryId</a>. Named queries are different from executed queries. Use <a>BatchGetQueryExecution</a> to get details about each unique query execution, and <a>ListQueryExecutions</a> to get a list of query execution IDs.</p>", + "BatchGetQueryExecution": "<p>Returns the details of a single query execution or a list of up to 50 query executions, which you provide as an array of query execution ID strings. To get a list of query execution IDs, use <a>ListQueryExecutions</a>. Query executions are different from named (saved) queries. Use <a>BatchGetNamedQuery</a> to get details about named queries.</p>", + "CreateNamedQuery": "<p>Creates a named query.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>", + "DeleteNamedQuery": "<p>Deletes a named query.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>", + "GetNamedQuery": "<p>Returns information about a single query.</p>", + "GetQueryExecution": "<p>Returns information about a single execution of a query. Each time a query executes, information about the query execution is saved with a unique ID.</p>", + "GetQueryResults": "<p>Returns the results of a single query execution specified by <code>QueryExecutionId</code>. This request does not execute the query but returns results. Use <a>StartQueryExecution</a> to run a query.</p>", + "ListNamedQueries": "<p>Provides a list of all available query IDs.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>", + "ListQueryExecutions": "<p>Provides a list of all available query execution IDs.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>", + "StartQueryExecution": "<p>Runs (executes) the SQL query statements contained in the <code>Query</code> string.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>", + "StopQueryExecution": "<p>Stops a query execution.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>" + }, + "shapes": { + "BatchGetNamedQueryInput": { + "base": null, + "refs": { + } + }, + "BatchGetNamedQueryOutput": { + "base": null, + "refs": { + } + }, + "BatchGetQueryExecutionInput": { + "base": null, + "refs": { + } + }, + "BatchGetQueryExecutionOutput": { + "base": null, + "refs": { + } + }, + "Boolean": { + "base": null, + "refs": { + "ColumnInfo$CaseSensitive": "<p>Indicates whether values in the column are case-sensitive.</p>" + } + }, + "ColumnInfo": { + "base": "<p>Information about the columns in a query execution result.</p>", + "refs": { + "ColumnInfoList$member": null + } + }, + "ColumnInfoList": { + "base": null, + "refs": { + "ResultSetMetadata$ColumnInfo": "<p>Information about the columns in a query execution result.</p>" + } + }, + "ColumnNullable": { + "base": null, + "refs": { + "ColumnInfo$Nullable": "<p>Indicates the column's nullable status.</p>" + } + }, + "CreateNamedQueryInput": { + "base": null, + "refs": { + } + }, + "CreateNamedQueryOutput": { + "base": null, + "refs": { + } + }, + "DatabaseString": { + "base": null, + "refs": { + "CreateNamedQueryInput$Database": "<p>The database to which the query belongs.</p>", + "NamedQuery$Database": "<p>The database to which the query belongs.</p>", + "QueryExecutionContext$Database": "<p>The name of the database.</p>" + } + }, + "Date": { + "base": null, + "refs": { + "QueryExecutionStatus$SubmissionDateTime": "<p>The date and time that the query was submitted.</p>", + "QueryExecutionStatus$CompletionDateTime": "<p>The date and time that the query completed.</p>" + } + }, + "Datum": { + "base": "<p>A piece of data (a field in the table).</p>", + "refs": { + "datumList$member": null + } + }, + "DeleteNamedQueryInput": { + "base": null, + "refs": { + } + }, + "DeleteNamedQueryOutput": { + "base": null, + "refs": { + } + }, + "DescriptionString": { + "base": null, + "refs": { + "CreateNamedQueryInput$Description": "<p>A brief explanation of the query.</p>", + "NamedQuery$Description": "<p>A brief description of the query.</p>" + } + }, + "EncryptionConfiguration": { + "base": "<p>If query results are encrypted in Amazon S3, indicates the Amazon S3 encryption option used.</p>", + "refs": { + "ResultConfiguration$EncryptionConfiguration": "<p>If query results are encrypted in S3, indicates the S3 encryption option used (for example, <code>SSE-KMS</code> or <code>CSE-KMS</code> and key information.</p>" + } + }, + "EncryptionOption": { + "base": null, + "refs": { + "EncryptionConfiguration$EncryptionOption": "<p>Indicates whether Amazon S3 server-side encryption with Amazon S3-managed keys (<code>SSE-S3</code>), server-side encryption with KMS-managed keys (<code>SSE-KMS</code>), or client-side encryption with KMS-managed keys (CSE-KMS) is used.</p>" + } + }, + "ErrorCode": { + "base": null, + "refs": { + "InvalidRequestException$AthenaErrorCode": null, + "UnprocessedNamedQueryId$ErrorCode": "<p>The error code returned when the processing request for the named query failed, if applicable.</p>", + "UnprocessedQueryExecutionId$ErrorCode": "<p>The error code returned when the query execution failed to process, if applicable.</p>" + } + }, + "ErrorMessage": { + "base": null, + "refs": { + "InternalServerException$Message": null, + "InvalidRequestException$Message": null, + "TooManyRequestsException$Message": null, + "UnprocessedNamedQueryId$ErrorMessage": "<p>The error message returned when the processing request for the named query failed, if applicable.</p>", + "UnprocessedQueryExecutionId$ErrorMessage": "<p>The error message returned when the query execution failed to process, if applicable.</p>" + } + }, + "GetNamedQueryInput": { + "base": null, + "refs": { + } + }, + "GetNamedQueryOutput": { + "base": null, + "refs": { + } + }, + "GetQueryExecutionInput": { + "base": null, + "refs": { + } + }, + "GetQueryExecutionOutput": { + "base": null, + "refs": { + } + }, + "GetQueryResultsInput": { + "base": null, + "refs": { + } + }, + "GetQueryResultsOutput": { + "base": null, + "refs": { + } + }, + "IdempotencyToken": { + "base": null, + "refs": { + "CreateNamedQueryInput$ClientRequestToken": "<p>A unique case-sensitive string used to ensure the request to create the query is idempotent (executes only once). If another <code>CreateNamedQuery</code> request is received, the same response is returned and another query is not created. If a parameter has changed, for example, the <code>QueryString</code>, an error is returned.</p> <important> <p>This token is listed as not required because AWS SDKs (for example the AWS SDK for Java) auto-generate the token for users. If you are not using the AWS SDK or the AWS CLI, you must provide this token or the action will fail.</p> </important>", + "StartQueryExecutionInput$ClientRequestToken": "<p>A unique case-sensitive string used to ensure the request to create the query is idempotent (executes only once). If another <code>StartQueryExecution</code> request is received, the same response is returned and another query is not created. If a parameter has changed, for example, the <code>QueryString</code>, an error is returned.</p> <important> <p>This token is listed as not required because AWS SDKs (for example the AWS SDK for Java) auto-generate the token for users. If you are not using the AWS SDK or the AWS CLI, you must provide this token or the action will fail.</p> </important>" + } + }, + "Integer": { + "base": null, + "refs": { + "ColumnInfo$Precision": "<p>For <code>DECIMAL</code> data types, specifies the total number of digits, up to 38. For performance reasons, we recommend up to 18 digits.</p>", + "ColumnInfo$Scale": "<p>For <code>DECIMAL</code> data types, specifies the total number of digits in the fractional part of the value. Defaults to 0.</p>" + } + }, + "InternalServerException": { + "base": "<p>Indicates a platform issue, which may be due to a transient condition or outage.</p>", + "refs": { + } + }, + "InvalidRequestException": { + "base": "<p>Indicates that something is wrong with the input to the request. For example, a required parameter may be missing or out of range.</p>", + "refs": { + } + }, + "ListNamedQueriesInput": { + "base": null, + "refs": { + } + }, + "ListNamedQueriesOutput": { + "base": null, + "refs": { + } + }, + "ListQueryExecutionsInput": { + "base": null, + "refs": { + } + }, + "ListQueryExecutionsOutput": { + "base": null, + "refs": { + } + }, + "Long": { + "base": null, + "refs": { + "QueryExecutionStatistics$EngineExecutionTimeInMillis": "<p>The number of milliseconds that the query took to execute.</p>", + "QueryExecutionStatistics$DataScannedInBytes": "<p>The number of bytes in the data that was queried.</p>" + } + }, + "MaxNamedQueriesCount": { + "base": null, + "refs": { + "ListNamedQueriesInput$MaxResults": "<p>The maximum number of queries to return in this request.</p>" + } + }, + "MaxQueryExecutionsCount": { + "base": null, + "refs": { + "ListQueryExecutionsInput$MaxResults": "<p>The maximum number of query executions to return in this request.</p>" + } + }, + "MaxQueryResults": { + "base": null, + "refs": { + "GetQueryResultsInput$MaxResults": "<p>The maximum number of results (rows) to return in this request.</p>" + } + }, + "NameString": { + "base": null, + "refs": { + "CreateNamedQueryInput$Name": "<p>The plain language name for the query.</p>", + "NamedQuery$Name": "<p>The plain-language name of the query.</p>" + } + }, + "NamedQuery": { + "base": "<p>A query, where <code>QueryString</code> is the SQL query statements that comprise the query.</p>", + "refs": { + "GetNamedQueryOutput$NamedQuery": "<p>Information about the query.</p>", + "NamedQueryList$member": null + } + }, + "NamedQueryId": { + "base": null, + "refs": { + "CreateNamedQueryOutput$NamedQueryId": "<p>The unique ID of the query.</p>", + "DeleteNamedQueryInput$NamedQueryId": "<p>The unique ID of the query to delete.</p>", + "GetNamedQueryInput$NamedQueryId": "<p>The unique ID of the query. Use <a>ListNamedQueries</a> to get query IDs.</p>", + "NamedQuery$NamedQueryId": "<p>The unique identifier of the query.</p>", + "NamedQueryIdList$member": null, + "UnprocessedNamedQueryId$NamedQueryId": "<p>The unique identifier of the named query.</p>" + } + }, + "NamedQueryIdList": { + "base": null, + "refs": { + "BatchGetNamedQueryInput$NamedQueryIds": "<p>An array of query IDs.</p>", + "ListNamedQueriesOutput$NamedQueryIds": "<p>The list of unique query IDs.</p>" + } + }, + "NamedQueryList": { + "base": null, + "refs": { + "BatchGetNamedQueryOutput$NamedQueries": "<p>Information about the named query IDs submitted.</p>" + } + }, + "QueryExecution": { + "base": "<p>Information about a single instance of a query execution.</p>", + "refs": { + "GetQueryExecutionOutput$QueryExecution": "<p>Information about the query execution.</p>", + "QueryExecutionList$member": null + } + }, + "QueryExecutionContext": { + "base": "<p>The database in which the query execution occurs.</p>", + "refs": { + "QueryExecution$QueryExecutionContext": "<p>The database in which the query execution occurred.</p>", + "StartQueryExecutionInput$QueryExecutionContext": "<p>The database within which the query executes.</p>" + } + }, + "QueryExecutionId": { + "base": null, + "refs": { + "GetQueryExecutionInput$QueryExecutionId": "<p>The unique ID of the query execution.</p>", + "GetQueryResultsInput$QueryExecutionId": "<p>The unique ID of the query execution.</p>", + "QueryExecution$QueryExecutionId": "<p>The unique identifier for each query execution.</p>", + "QueryExecutionIdList$member": null, + "StartQueryExecutionOutput$QueryExecutionId": "<p>The unique ID of the query that ran as a result of this request.</p>", + "StopQueryExecutionInput$QueryExecutionId": "<p>The unique ID of the query execution to stop.</p>", + "UnprocessedQueryExecutionId$QueryExecutionId": "<p>The unique identifier of the query execution.</p>" + } + }, + "QueryExecutionIdList": { + "base": null, + "refs": { + "BatchGetQueryExecutionInput$QueryExecutionIds": "<p>An array of query execution IDs.</p>", + "ListQueryExecutionsOutput$QueryExecutionIds": "<p>The unique IDs of each query execution as an array of strings.</p>" + } + }, + "QueryExecutionList": { + "base": null, + "refs": { + "BatchGetQueryExecutionOutput$QueryExecutions": "<p>Information about a query execution.</p>" + } + }, + "QueryExecutionState": { + "base": null, + "refs": { + "QueryExecutionStatus$State": "<p>The state of query execution. <code>SUBMITTED</code> indicates that the query is queued for execution. <code>RUNNING</code> indicates that the query is scanning data and returning results. <code>SUCCEEDED</code> indicates that the query completed without error. <code>FAILED</code> indicates that the query experienced an error and did not complete processing. <code>CANCELLED</code> indicates that user input interrupted query execution.</p>" + } + }, + "QueryExecutionStatistics": { + "base": "<p>The amount of data scanned during the query execution and the amount of time that it took to execute.</p>", + "refs": { + "QueryExecution$Statistics": "<p>The amount of data scanned during the query execution and the amount of time that it took to execute.</p>" + } + }, + "QueryExecutionStatus": { + "base": "<p>The completion date, current state, submission time, and state change reason (if applicable) for the query execution.</p>", + "refs": { + "QueryExecution$Status": "<p>The completion date, current state, submission time, and state change reason (if applicable) for the query execution.</p>" + } + }, + "QueryString": { + "base": null, + "refs": { + "CreateNamedQueryInput$QueryString": "<p>The text of the query itself. In other words, all query statements.</p>", + "NamedQuery$QueryString": "<p>The SQL query statements that comprise the query.</p>", + "QueryExecution$Query": "<p>The SQL query statements which the query execution ran.</p>", + "StartQueryExecutionInput$QueryString": "<p>The SQL query statements to be executed.</p>" + } + }, + "ResultConfiguration": { + "base": "<p>The location in Amazon S3 where query results are stored and the encryption option, if any, used for query results.</p>", + "refs": { + "QueryExecution$ResultConfiguration": "<p>The location in Amazon S3 where query results were stored and the encryption option, if any, used for query results.</p>", + "StartQueryExecutionInput$ResultConfiguration": "<p>Specifies information about where and how to save the results of the query execution.</p>" + } + }, + "ResultSet": { + "base": "<p>The metadata and rows that comprise a query result set. The metadata describes the column structure and data types.</p>", + "refs": { + "GetQueryResultsOutput$ResultSet": "<p>The results of the query execution.</p>" + } + }, + "ResultSetMetadata": { + "base": "<p>The metadata that describes the column structure and data types of a table of query results.</p>", + "refs": { + "ResultSet$ResultSetMetadata": "<p>The metadata that describes the column structure and data types of a table of query results.</p>" + } + }, + "Row": { + "base": "<p>The rows that comprise a query result table.</p>", + "refs": { + "RowList$member": null + } + }, + "RowList": { + "base": null, + "refs": { + "ResultSet$Rows": "<p>The rows in the table.</p>" + } + }, + "StartQueryExecutionInput": { + "base": null, + "refs": { + } + }, + "StartQueryExecutionOutput": { + "base": null, + "refs": { + } + }, + "StopQueryExecutionInput": { + "base": null, + "refs": { + } + }, + "StopQueryExecutionOutput": { + "base": null, + "refs": { + } + }, + "String": { + "base": null, + "refs": { + "ColumnInfo$CatalogName": "<p>The catalog to which the query results belong.</p>", + "ColumnInfo$SchemaName": "<p>The schema name (database name) to which the query results belong.</p>", + "ColumnInfo$TableName": "<p>The table name for the query results.</p>", + "ColumnInfo$Name": "<p>The name of the column.</p>", + "ColumnInfo$Label": "<p>A column label.</p>", + "ColumnInfo$Type": "<p>The data type of the column.</p>", + "EncryptionConfiguration$KmsKey": "<p>For <code>SSE-KMS</code> and <code>CSE-KMS</code>, this is the KMS key ARN or ID.</p>", + "QueryExecutionStatus$StateChangeReason": "<p>Further detail about the status of the query.</p>", + "ResultConfiguration$OutputLocation": "<p>The location in S3 where query results are stored.</p>" + } + }, + "ThrottleReason": { + "base": null, + "refs": { + "TooManyRequestsException$Reason": null + } + }, + "Token": { + "base": null, + "refs": { + "GetQueryResultsInput$NextToken": "<p>The token that specifies where to start pagination if a previous request was truncated.</p>", + "GetQueryResultsOutput$NextToken": "<p>A token to be used by the next request if this request is truncated.</p>", + "ListNamedQueriesInput$NextToken": "<p>The token that specifies where to start pagination if a previous request was truncated.</p>", + "ListNamedQueriesOutput$NextToken": "<p>A token to be used by the next request if this request is truncated.</p>", + "ListQueryExecutionsInput$NextToken": "<p>The token that specifies where to start pagination if a previous request was truncated.</p>", + "ListQueryExecutionsOutput$NextToken": "<p>A token to be used by the next request if this request is truncated.</p>" + } + }, + "TooManyRequestsException": { + "base": "<p>Indicates that the request was throttled.</p>", + "refs": { + } + }, + "UnprocessedNamedQueryId": { + "base": "<p>Information about a named query ID that could not be processed.</p>", + "refs": { + "UnprocessedNamedQueryIdList$member": null + } + }, + "UnprocessedNamedQueryIdList": { + "base": null, + "refs": { + "BatchGetNamedQueryOutput$UnprocessedNamedQueryIds": "<p>Information about provided query IDs.</p>" + } + }, + "UnprocessedQueryExecutionId": { + "base": "<p>Describes a query execution that failed to process.</p>", + "refs": { + "UnprocessedQueryExecutionIdList$member": null + } + }, + "UnprocessedQueryExecutionIdList": { + "base": null, + "refs": { + "BatchGetQueryExecutionOutput$UnprocessedQueryExecutionIds": "<p>Information about the query executions that failed to run.</p>" + } + }, + "datumList": { + "base": null, + "refs": { + "Row$Data": "<p>The data that populates a row in a query result table.</p>" + } + }, + "datumString": { + "base": null, + "refs": { + "Datum$VarCharValue": "<p>The value of the datum.</p>" + } + } + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/examples-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/examples-1.json new file mode 100644 index 00000000..0ea7e3b0 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/examples-1.json @@ -0,0 +1,5 @@ +{ + "version": "1.0", + "examples": { + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/paginators-1.json new file mode 100644 index 00000000..be4b1f01 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/paginators-1.json @@ -0,0 +1,19 @@ +{ + "pagination": { + "GetQueryResults": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListNamedQueries": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListQueryExecutions": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + } + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/docs-2.json index 9509d0de..a2014c9e 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/docs-2.json @@ -2,9 +2,9 @@ "version": "2.0", "service": "<fullname>Auto Scaling</fullname> <p>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.</p>", "operations": { - "AttachInstances": "<p>Attaches one or more EC2 instances to the specified Auto Scaling group.</p> <p>When you attach instances, Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.</p> <p>If there is a Classic load balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-instance-asg.html\">Attach EC2 Instances to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", + "AttachInstances": "<p>Attaches one or more EC2 instances to the specified Auto Scaling group.</p> <p>When you attach instances, Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.</p> <p>If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-instance-asg.html\">Attach EC2 Instances to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", "AttachLoadBalancerTargetGroups": "<p>Attaches one or more target groups to the specified Auto Scaling group.</p> <p>To describe the target groups for an Auto Scaling group, use <a>DescribeLoadBalancerTargetGroups</a>. To detach the target group from the Auto Scaling group, use <a>DetachLoadBalancerTargetGroups</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html\">Attach a Load Balancer to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", - "AttachLoadBalancers": "<p>Attaches one or more Classic load balancers to the specified Auto Scaling group.</p> <p>To attach an Application load balancer instead, see <a>AttachLoadBalancerTargetGroups</a>.</p> <p>To describe the load balancers for an Auto Scaling group, use <a>DescribeLoadBalancers</a>. To detach the load balancer from the Auto Scaling group, use <a>DetachLoadBalancers</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html\">Attach a Load Balancer to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", + "AttachLoadBalancers": "<p>Attaches one or more Classic Load Balancers to the specified Auto Scaling group.</p> <p>To attach an Application Load Balancer instead, see <a>AttachLoadBalancerTargetGroups</a>.</p> <p>To describe the load balancers for an Auto Scaling group, use <a>DescribeLoadBalancers</a>. To detach the load balancer from the Auto Scaling group, use <a>DetachLoadBalancers</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html\">Attach a Load Balancer to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", "CompleteLifecycleAction": "<p>Completes the lifecycle action for the specified token or instance with the specified result.</p> <p>This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:</p> <ol> <li> <p>(Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.</p> </li> <li> <p>(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.</p> </li> <li> <p>Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.</p> </li> <li> <p>If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.</p> </li> <li> <p> <b>If you finish before the timeout period ends, complete the lifecycle action.</b> </p> </li> </ol> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html\">Auto Scaling Lifecycle</a> in the <i>Auto Scaling User Guide</i>.</p>", "CreateAutoScalingGroup": "<p>Creates an Auto Scaling group with the specified name and attributes.</p> <p>If you exceed your maximum limit of Auto Scaling groups, which by default is 20 per region, the call fails. For information about viewing and updating this limit, see <a>DescribeAccountLimits</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroup.html\">Auto Scaling Groups</a> in the <i>Auto Scaling User Guide</i>.</p>", "CreateLaunchConfiguration": "<p>Creates a launch configuration.</p> <p>If you exceed your maximum limit of launch configurations, which by default is 100 per region, the call fails. For information about viewing and updating this limit, see <a>DescribeAccountLimits</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/LaunchConfiguration.html\">Launch Configurations</a> in the <i>Auto Scaling User Guide</i>.</p>", @@ -25,7 +25,7 @@ "DescribeLifecycleHookTypes": "<p>Describes the available types of lifecycle hooks.</p>", "DescribeLifecycleHooks": "<p>Describes the lifecycle hooks for the specified Auto Scaling group.</p>", "DescribeLoadBalancerTargetGroups": "<p>Describes the target groups for the specified Auto Scaling group.</p>", - "DescribeLoadBalancers": "<p>Describes the load balancers for the specified Auto Scaling group.</p> <p>Note that this operation describes only Classic load balancers. If you have Application load balancers, use <a>DescribeLoadBalancerTargetGroups</a> instead.</p>", + "DescribeLoadBalancers": "<p>Describes the load balancers for the specified Auto Scaling group.</p> <p>Note that this operation describes only Classic Load Balancers. If you have Application Load Balancers, use <a>DescribeLoadBalancerTargetGroups</a> instead.</p>", "DescribeMetricCollectionTypes": "<p>Describes the available CloudWatch metrics for Auto Scaling.</p> <p>Note that the <code>GroupStandbyInstances</code> metric is not returned by default. You must explicitly request this metric when calling <a>EnableMetricsCollection</a>.</p>", "DescribeNotificationConfigurations": "<p>Describes the notification actions associated with the specified Auto Scaling group.</p>", "DescribePolicies": "<p>Describes the policies for the specified Auto Scaling group.</p>", @@ -34,14 +34,14 @@ "DescribeScheduledActions": "<p>Describes the actions scheduled for your Auto Scaling group that haven't run. To describe the actions that have already run, use <a>DescribeScalingActivities</a>.</p>", "DescribeTags": "<p>Describes the specified tags.</p> <p>You can use filters to limit the results. For example, you can query for the tags for a specific Auto Scaling group. You can specify multiple values for a filter. A tag must match at least one of the specified values for it to be included in the results.</p> <p>You can also specify multiple filters. The result includes information for a particular tag only if it matches all the filters. If there's no match, no special message is returned.</p>", "DescribeTerminationPolicyTypes": "<p>Describes the termination policies supported by Auto Scaling.</p>", - "DetachInstances": "<p>Removes one or more instances from the specified Auto Scaling group.</p> <p>After the instances are detached, you can manage them independently from the rest of the Auto Scaling group.</p> <p>If you do not specify the option to decrement the desired capacity, Auto Scaling launches instances to replace the ones that are detached.</p> <p>If there is a Classic load balancer attached to the Auto Scaling group, the instances are deregistered from the load balancer. If there are target groups attached to the Auto Scaling group, the instances are deregistered from the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/detach-instance-asg.html\">Detach EC2 Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", + "DetachInstances": "<p>Removes one or more instances from the specified Auto Scaling group.</p> <p>After the instances are detached, you can manage them independent of the Auto Scaling group.</p> <p>If you do not specify the option to decrement the desired capacity, Auto Scaling launches instances to replace the ones that are detached.</p> <p>If there is a Classic Load Balancer attached to the Auto Scaling group, the instances are deregistered from the load balancer. If there are target groups attached to the Auto Scaling group, the instances are deregistered from the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/detach-instance-asg.html\">Detach EC2 Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", "DetachLoadBalancerTargetGroups": "<p>Detaches one or more target groups from the specified Auto Scaling group.</p>", - "DetachLoadBalancers": "<p>Detaches one or more Classic load balancers from the specified Auto Scaling group.</p> <p>Note that this operation detaches only Classic load balancers. If you have Application load balancers, use <a>DetachLoadBalancerTargetGroups</a> instead.</p> <p>When you detach a load balancer, it enters the <code>Removing</code> state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using <a>DescribeLoadBalancers</a>. Note that the instances remain running.</p>", + "DetachLoadBalancers": "<p>Detaches one or more Classic Load Balancers from the specified Auto Scaling group.</p> <p>Note that this operation detaches only Classic Load Balancers. If you have Application Load Balancers, use <a>DetachLoadBalancerTargetGroups</a> instead.</p> <p>When you detach a load balancer, it enters the <code>Removing</code> state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using <a>DescribeLoadBalancers</a>. Note that the instances remain running.</p>", "DisableMetricsCollection": "<p>Disables group metrics for the specified Auto Scaling group.</p>", "EnableMetricsCollection": "<p>Enables group metrics for the specified Auto Scaling group. For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-monitoring.html\">Monitoring Your Auto Scaling Groups and Instances</a> in the <i>Auto Scaling User Guide</i>.</p>", - "EnterStandby": "<p>Moves the specified instances into <code>Standby</code> mode.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html\">Auto Scaling Lifecycle</a> in the <i>Auto Scaling User Guide</i>.</p>", + "EnterStandby": "<p>Moves the specified instances into the standby state.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html\">Temporarily Removing Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", "ExecutePolicy": "<p>Executes the specified policy.</p>", - "ExitStandby": "<p>Moves the specified instances out of <code>Standby</code> mode.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html\">Auto Scaling Lifecycle</a> in the <i>Auto Scaling User Guide</i>.</p>", + "ExitStandby": "<p>Moves the specified instances out of the standby state.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html\">Temporarily Removing Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", "PutLifecycleHook": "<p>Creates or updates a lifecycle hook for the specified Auto Scaling Group.</p> <p>A lifecycle hook tells Auto Scaling that you want to perform an action on an instance that is not actively in service; for example, either when the instance launches or before the instance terminates.</p> <p>This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:</p> <ol> <li> <p>(Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.</p> </li> <li> <p>(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.</p> </li> <li> <p> <b>Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.</b> </p> </li> <li> <p>If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.</p> </li> <li> <p>If you finish before the timeout period ends, complete the lifecycle action.</p> </li> </ol> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/lifecycle-hooks.html\">Auto Scaling Lifecycle Hooks</a> in the <i>Auto Scaling User Guide</i>.</p> <p>If you exceed your maximum limit of lifecycle hooks, which by default is 50 per Auto Scaling group, the call fails. For information about updating this limit, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html\">AWS Service Limits</a> in the <i>Amazon Web Services General Reference</i>.</p>", "PutNotificationConfiguration": "<p>Configures an Auto Scaling group to send notifications when specified events take place. Subscribers to the specified topic can have messages delivered to an endpoint such as a web server or an email address.</p> <p>This configuration overwrites any existing configuration.</p> <p>For more information see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/ASGettingNotifications.html\">Getting SNS Notifications When Your Auto Scaling Group Scales</a> in the <i>Auto Scaling User Guide</i>.</p>", "PutScalingPolicy": "<p>Creates or updates a policy for an Auto Scaling group. To update an existing policy, use the existing policy name and set the parameters you want to change. Any existing parameter not changed in an update to an existing policy is not changed in this update request.</p> <p>If you exceed your maximum limit of step adjustments, which by default is 20 per region, the call fails. For information about updating this limit, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html\">AWS Service Limits</a> in the <i>Amazon Web Services General Reference</i>.</p>", @@ -53,7 +53,7 @@ "SetInstanceProtection": "<p>Updates the instance protection settings of the specified instances.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-termination.html#instance-protection\">Instance Protection</a> in the <i>Auto Scaling User Guide</i>.</p>", "SuspendProcesses": "<p>Suspends the specified Auto Scaling processes, or all processes, for the specified Auto Scaling group.</p> <p>Note that if you suspend either the <code>Launch</code> or <code>Terminate</code> process types, it can prevent other process types from functioning properly.</p> <p>To resume processes that have been suspended, use <a>ResumeProcesses</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-suspend-resume-processes.html\">Suspending and Resuming Auto Scaling Processes</a> in the <i>Auto Scaling User Guide</i>.</p>", "TerminateInstanceInAutoScalingGroup": "<p>Terminates the specified instance and optionally adjusts the desired group size.</p> <p>This call simply makes a termination request. The instance is not terminated immediately.</p>", - "UpdateAutoScalingGroup": "<p>Updates the configuration for the specified Auto Scaling group.</p> <p>To update an Auto Scaling group with a launch configuration with <code>InstanceMonitoring</code> set to <code>False</code>, you must first disable the collection of group metrics. Otherwise, you will get an error. If you have previously enabled the collection of group metrics, you can disable it using <a>DisableMetricsCollection</a>.</p> <p>The new settings are registered upon the completion of this call. Any launch configuration settings take effect on any triggers after this call returns. Scaling activities that are currently in progress aren't affected.</p> <p>Note the following:</p> <ul> <li> <p>If you specify a new value for <code>MinSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MinSize</code> is larger than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MinSize</code>.</p> </li> <li> <p>If you specify a new value for <code>MaxSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MaxSize</code> is smaller than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MaxSize</code>.</p> </li> <li> <p>All other optional parameters are left unchanged if not specified.</p> </li> </ul>" + "UpdateAutoScalingGroup": "<p>Updates the configuration for the specified Auto Scaling group.</p> <p>The new settings take effect on any scaling activities after this call returns. Scaling activities that are currently in progress aren't affected.</p> <p>To update an Auto Scaling group with a launch configuration with <code>InstanceMonitoring</code> set to <code>false</code>, you must first disable the collection of group metrics. Otherwise, you will get an error. If you have previously enabled the collection of group metrics, you can disable it using <a>DisableMetricsCollection</a>.</p> <p>Note the following:</p> <ul> <li> <p>If you specify a new value for <code>MinSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MinSize</code> is larger than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MinSize</code>.</p> </li> <li> <p>If you specify a new value for <code>MaxSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MaxSize</code> is smaller than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MaxSize</code>.</p> </li> <li> <p>All other optional parameters are left unchanged if not specified.</p> </li> </ul>" }, "shapes": { "Activities": { @@ -66,7 +66,7 @@ } }, "ActivitiesType": { - "base": "<p>Contains the output of DescribeScalingActivities.</p>", + "base": null, "refs": { } }, @@ -84,7 +84,7 @@ } }, "ActivityType": { - "base": "<p>Contains the output of TerminateInstancesInAutoScalingGroup.</p>", + "base": null, "refs": { } }, @@ -136,7 +136,7 @@ } }, "AttachInstancesQuery": { - "base": "<p>Contains the parameters for AttachInstances.</p>", + "base": null, "refs": { } }, @@ -146,17 +146,17 @@ } }, "AttachLoadBalancerTargetGroupsType": { - "base": "<p>Contains the parameters for AttachLoadBalancerTargetGroups.</p>", + "base": null, "refs": { } }, "AttachLoadBalancersResultType": { - "base": "<p>Contains the output of AttachLoadBalancers.</p>", + "base": null, "refs": { } }, "AttachLoadBalancersType": { - "base": "<p>Contains the parameters for AttachLoadBalancers.</p>", + "base": null, "refs": { } }, @@ -170,7 +170,7 @@ "base": null, "refs": { "AutoScalingGroup$DesiredCapacity": "<p>The desired size of the group.</p>", - "CreateAutoScalingGroupType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group.</p>", + "CreateAutoScalingGroupType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group. If you do not specify a desired capacity, the default is the minimum size of the group.</p>", "PutScheduledUpdateGroupActionType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the group.</p>", "ScheduledUpdateGroupAction$DesiredCapacity": "<p>The number of instances you prefer to maintain in the group.</p>", "SetDesiredCapacityType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the Auto Scaling group.</p>", @@ -205,7 +205,7 @@ } }, "AutoScalingGroupNamesType": { - "base": "<p>Contains the parameters for DescribeAutoScalingGroups.</p>", + "base": null, "refs": { } }, @@ -216,7 +216,7 @@ } }, "AutoScalingGroupsType": { - "base": "<p>Contains the output for DescribeAutoScalingGroups.</p>", + "base": null, "refs": { } }, @@ -233,7 +233,7 @@ } }, "AutoScalingInstancesType": { - "base": "<p>Contains the output of DescribeAutoScalingInstances.</p>", + "base": null, "refs": { } }, @@ -304,12 +304,12 @@ } }, "CompleteLifecycleActionAnswer": { - "base": "<p>Contains the output of CompleteLifecycleAction.</p>", + "base": null, "refs": { } }, "CompleteLifecycleActionType": { - "base": "<p>Contains the parameters for CompleteLifecycleAction.</p>", + "base": null, "refs": { } }, @@ -319,162 +319,162 @@ "AutoScalingGroup$DefaultCooldown": "<p>The amount of time, in seconds, after a scaling activity completes before another scaling activity can start.</p>", "CreateAutoScalingGroupType$DefaultCooldown": "<p>The amount of time, in seconds, after a scaling activity completes before another scaling activity can start. The default is 300.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html\">Auto Scaling Cooldowns</a> in the <i>Auto Scaling User Guide</i>.</p>", "PutScalingPolicyType$Cooldown": "<p>The amount of time, in seconds, after a scaling activity completes and before the next scaling activity can start. If this parameter is not specified, the default cooldown period for the group applies.</p> <p>This parameter is not supported unless the policy type is <code>SimpleScaling</code>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html\">Auto Scaling Cooldowns</a> in the <i>Auto Scaling User Guide</i>.</p>", - "ScalingPolicy$Cooldown": "<p>The amount of time, in seconds, after a scaling activity completes before any further trigger-related scaling activities can start.</p>", + "ScalingPolicy$Cooldown": "<p>The amount of time, in seconds, after a scaling activity completes before any further dynamic scaling activities can start.</p>", "UpdateAutoScalingGroupType$DefaultCooldown": "<p>The amount of time, in seconds, after a scaling activity completes before another scaling activity can start. The default is 300.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html\">Auto Scaling Cooldowns</a> in the <i>Auto Scaling User Guide</i>.</p>" } }, "CreateAutoScalingGroupType": { - "base": "<p>Contains the parameters for CreateAutoScalingGroup.</p>", + "base": null, "refs": { } }, "CreateLaunchConfigurationType": { - "base": "<p>Contains the parameters for CreateLaunchConfiguration.</p>", + "base": null, "refs": { } }, "CreateOrUpdateTagsType": { - "base": "<p>Contains the parameters for CreateOrUpdateTags.</p>", + "base": null, "refs": { } }, "DeleteAutoScalingGroupType": { - "base": "<p>Contains the parameters for DeleteAutoScalingGroup.</p>", + "base": null, "refs": { } }, "DeleteLifecycleHookAnswer": { - "base": "<p>Contains the output of DeleteLifecycleHook.</p>", + "base": null, "refs": { } }, "DeleteLifecycleHookType": { - "base": "<p>Contains the parameters for DeleteLifecycleHook.</p>", + "base": null, "refs": { } }, "DeleteNotificationConfigurationType": { - "base": "<p>Contains the parameters for DeleteNotificationConfiguration.</p>", + "base": null, "refs": { } }, "DeletePolicyType": { - "base": "<p>Contains the parameters for DeletePolicy.</p>", + "base": null, "refs": { } }, "DeleteScheduledActionType": { - "base": "<p>Contains the parameters for DeleteScheduledAction.</p>", + "base": null, "refs": { } }, "DeleteTagsType": { - "base": "<p>Contains the parameters for DeleteTags.</p>", + "base": null, "refs": { } }, "DescribeAccountLimitsAnswer": { - "base": "<p>Contains the parameters for DescribeAccountLimits.</p>", + "base": null, "refs": { } }, "DescribeAdjustmentTypesAnswer": { - "base": "<p>Contains the parameters for DescribeAdjustmentTypes.</p>", + "base": null, "refs": { } }, "DescribeAutoScalingInstancesType": { - "base": "<p>Contains the parameters for DescribeAutoScalingInstances.</p>", + "base": null, "refs": { } }, "DescribeAutoScalingNotificationTypesAnswer": { - "base": "<p>Contains the output of DescribeAutoScalingNotificationTypes.</p>", + "base": null, "refs": { } }, "DescribeLifecycleHookTypesAnswer": { - "base": "<p>Contains the output of DescribeLifecycleHookTypes.</p>", + "base": null, "refs": { } }, "DescribeLifecycleHooksAnswer": { - "base": "<p>Contains the output of DescribeLifecycleHooks.</p>", + "base": null, "refs": { } }, "DescribeLifecycleHooksType": { - "base": "<p>Contains the parameters for DescribeLifecycleHooks.</p>", + "base": null, "refs": { } }, "DescribeLoadBalancerTargetGroupsRequest": { - "base": "<p>Contains the parameters for DescribeLoadBalancerTargetGroups.</p>", + "base": null, "refs": { } }, "DescribeLoadBalancerTargetGroupsResponse": { - "base": "<p>Contains the output of DescribeLoadBalancerTargetGroups.</p>", + "base": null, "refs": { } }, "DescribeLoadBalancersRequest": { - "base": "<p>Contains the parameters for DescribeLoadBalancers.</p>", + "base": null, "refs": { } }, "DescribeLoadBalancersResponse": { - "base": "<p>Contains the output of DescribeLoadBalancers.</p>", + "base": null, "refs": { } }, "DescribeMetricCollectionTypesAnswer": { - "base": "<p>Contains the output of DescribeMetricsCollectionTypes.</p>", + "base": null, "refs": { } }, "DescribeNotificationConfigurationsAnswer": { - "base": "<p>Contains the output from DescribeNotificationConfigurations.</p>", + "base": null, "refs": { } }, "DescribeNotificationConfigurationsType": { - "base": "<p>Contains the parameters for DescribeNotificationConfigurations.</p>", + "base": null, "refs": { } }, "DescribePoliciesType": { - "base": "<p>Contains the parameters for DescribePolicies.</p>", + "base": null, "refs": { } }, "DescribeScalingActivitiesType": { - "base": "<p>Contains the parameters for DescribeScalingActivities.</p>", + "base": null, "refs": { } }, "DescribeScheduledActionsType": { - "base": "<p>Contains the parameters for DescribeScheduledActions.</p>", + "base": null, "refs": { } }, "DescribeTagsType": { - "base": "<p>Contains the parameters for DescribeTags.</p>", + "base": null, "refs": { } }, "DescribeTerminationPolicyTypesAnswer": { - "base": "<p>Contains the output of DescribeTerminationPolicyTypes.</p>", + "base": null, "refs": { } }, "DetachInstancesAnswer": { - "base": "<p>Contains the output of DetachInstances.</p>", + "base": null, "refs": { } }, "DetachInstancesQuery": { - "base": "<p>Contains the parameters for DetachInstances.</p>", + "base": null, "refs": { } }, @@ -489,17 +489,17 @@ } }, "DetachLoadBalancersResultType": { - "base": "<p>Contains the output for DetachLoadBalancers.</p>", + "base": null, "refs": { } }, "DetachLoadBalancersType": { - "base": "<p>Contains the parameters for DetachLoadBalancers.</p>", + "base": null, "refs": { } }, "DisableMetricsCollectionQuery": { - "base": "<p>Contains the parameters for DisableMetricsCollection.</p>", + "base": null, "refs": { } }, @@ -517,7 +517,7 @@ } }, "EnableMetricsCollectionQuery": { - "base": "<p>Contains the parameters for EnableMetricsCollection.</p>", + "base": null, "refs": { } }, @@ -534,12 +534,12 @@ } }, "EnterStandbyAnswer": { - "base": "<p>Contains the output of EnterStandby.</p>", + "base": null, "refs": { } }, "EnterStandbyQuery": { - "base": "<p>Contains the parameters for EnteStandby.</p>", + "base": null, "refs": { } }, @@ -551,17 +551,17 @@ } }, "ExecutePolicyType": { - "base": "<p>Contains the parameters for ExecutePolicy.</p>", + "base": null, "refs": { } }, "ExitStandbyAnswer": { - "base": "<p>Contains the parameters for ExitStandby.</p>", + "base": null, "refs": { } }, "ExitStandbyQuery": { - "base": "<p>Contains the parameters for ExitStandby.</p>", + "base": null, "refs": { } }, @@ -629,9 +629,9 @@ } }, "InstanceMonitoring": { - "base": "<p>Describes whether instance monitoring is enabled.</p>", + "base": "<p>Describes whether detailed monitoring is enabled for the Auto Scaling instances.</p>", "refs": { - "CreateLaunchConfigurationType$InstanceMonitoring": "<p>Enables detailed monitoring (<code>true</code>) or basic monitoring (<code>false</code>) for the Auto Scaling instances.</p>", + "CreateLaunchConfigurationType$InstanceMonitoring": "<p>Enables detailed monitoring (<code>true</code>) or basic monitoring (<code>false</code>) for the Auto Scaling instances. The default is <code>true</code>.</p>", "LaunchConfiguration$InstanceMonitoring": "<p>Controls whether instances in this group are launched with detailed (<code>true</code>) or basic (<code>false</code>) monitoring.</p>" } }, @@ -663,7 +663,7 @@ } }, "LaunchConfigurationNameType": { - "base": "<p>Contains the parameters for DeleteLaunchConfiguration.</p>", + "base": null, "refs": { } }, @@ -674,7 +674,7 @@ } }, "LaunchConfigurationNamesType": { - "base": "<p>Contains the parameters for DescribeLaunchConfigurations.</p>", + "base": null, "refs": { } }, @@ -685,7 +685,7 @@ } }, "LaunchConfigurationsType": { - "base": "<p>Contains the output of DescribeLaunchConfigurations.</p>", + "base": null, "refs": { } }, @@ -745,12 +745,12 @@ "refs": { "AttachLoadBalancersType$LoadBalancerNames": "<p>One or more load balancer names.</p>", "AutoScalingGroup$LoadBalancerNames": "<p>One or more load balancers associated with the group.</p>", - "CreateAutoScalingGroupType$LoadBalancerNames": "<p>One or more Classic load balancers. To specify an Application load balancer, use <code>TargetGroupARNs</code> instead.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html\">Using a Load Balancer With an Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", + "CreateAutoScalingGroupType$LoadBalancerNames": "<p>One or more Classic Load Balancers. To specify an Application Load Balancer, use <code>TargetGroupARNs</code> instead.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html\">Using a Load Balancer With an Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>", "DetachLoadBalancersType$LoadBalancerNames": "<p>One or more load balancer names.</p>" } }, "LoadBalancerState": { - "base": "<p>Describes the state of a Classic load balancer.</p> <p>If you specify a load balancer when creating the Auto Scaling group, the state of the load balancer is <code>InService</code>.</p> <p>If you attach a load balancer to an existing Auto Scaling group, the initial state is <code>Adding</code>. The state transitions to <code>Added</code> after all instances in the group are registered with the load balancer. If ELB health checks are enabled for the load balancer, the state transitions to <code>InService</code> after at least one instance in the group passes the health check. If EC2 health checks are enabled instead, the load balancer remains in the <code>Added</code> state.</p>", + "base": "<p>Describes the state of a Classic Load Balancer.</p> <p>If you specify a load balancer when creating the Auto Scaling group, the state of the load balancer is <code>InService</code>.</p> <p>If you attach a load balancer to an existing Auto Scaling group, the initial state is <code>Adding</code>. The state transitions to <code>Added</code> after all instances in the group are registered with the load balancer. If ELB health checks are enabled for the load balancer, the state transitions to <code>InService</code> after at least one instance in the group passes the health check. If EC2 health checks are enabled instead, the load balancer remains in the <code>Added</code> state.</p>", "refs": { "LoadBalancerStates$member": null } @@ -788,16 +788,16 @@ "MaxRecords": { "base": null, "refs": { - "AutoScalingGroupNamesType$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "DescribeAutoScalingInstancesType$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "DescribeLoadBalancerTargetGroupsRequest$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "DescribeLoadBalancersRequest$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "DescribeNotificationConfigurationsType$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "DescribePoliciesType$MaxRecords": "<p>The maximum number of items to be returned with each call.</p>", - "DescribeScalingActivitiesType$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "DescribeScheduledActionsType$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "DescribeTagsType$MaxRecords": "<p>The maximum number of items to return with this call.</p>", - "LaunchConfigurationNamesType$MaxRecords": "<p>The maximum number of items to return with this call. The default is 100.</p>" + "AutoScalingGroupNamesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>", + "DescribeAutoScalingInstancesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>", + "DescribeLoadBalancerTargetGroupsRequest$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>", + "DescribeLoadBalancersRequest$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>", + "DescribeNotificationConfigurationsType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>", + "DescribePoliciesType$MaxRecords": "<p>The maximum number of items to be returned with each call. The default value is 50 and the maximum value is 100.</p>", + "DescribeScalingActivitiesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 100.</p>", + "DescribeScheduledActionsType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>", + "DescribeTagsType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>", + "LaunchConfigurationNamesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>" } }, "MetricCollectionType": { @@ -857,7 +857,7 @@ "MonitoringEnabled": { "base": null, "refs": { - "InstanceMonitoring$Enabled": "<p>If <code>True</code>, instance monitoring is enabled.</p>" + "InstanceMonitoring$Enabled": "<p>If <code>true</code>, detailed monitoring is enabled. Otherwise, basic monitoring is enabled.</p>" } }, "NoDevice": { @@ -897,12 +897,12 @@ } }, "PoliciesType": { - "base": "<p>Contains the output of DescribePolicies.</p>", + "base": null, "refs": { } }, "PolicyARNType": { - "base": "<p>Contains the output of PutScalingPolicy.</p>", + "base": null, "refs": { } }, @@ -945,7 +945,7 @@ } }, "ProcessesType": { - "base": "<p>Contains the output of DescribeScalingProcessTypes.</p>", + "base": null, "refs": { } }, @@ -969,37 +969,37 @@ } }, "PutLifecycleHookAnswer": { - "base": "<p>Contains the output of PutLifecycleHook.</p>", + "base": null, "refs": { } }, "PutLifecycleHookType": { - "base": "<p>Contains the parameters for PutLifecycleHook.</p>", + "base": null, "refs": { } }, "PutNotificationConfigurationType": { - "base": "<p>Contains the parameters for PutNotificationConfiguration.</p>", + "base": null, "refs": { } }, "PutScalingPolicyType": { - "base": "<p>Contains the parameters for PutScalingPolicy.</p>", + "base": null, "refs": { } }, "PutScheduledUpdateGroupActionType": { - "base": "<p>Contains the parameters for PutScheduledUpdateGroupAction.</p>", + "base": null, "refs": { } }, "RecordLifecycleActionHeartbeatAnswer": { - "base": "<p>Contains the output of RecordLifecycleActionHeartBeat.</p>", + "base": null, "refs": { } }, "RecordLifecycleActionHeartbeatType": { - "base": "<p>Contains the parameters for RecordLifecycleActionHeartbeat.</p>", + "base": null, "refs": { } }, @@ -1098,7 +1098,7 @@ } }, "ScalingProcessQuery": { - "base": "<p>Contains the parameters for SuspendProcesses and ResumeProcesses.</p>", + "base": null, "refs": { } }, @@ -1109,7 +1109,7 @@ } }, "ScheduledActionsType": { - "base": "<p>Contains the output of DescribeScheduledActions.</p>", + "base": null, "refs": { } }, @@ -1133,22 +1133,22 @@ } }, "SetDesiredCapacityType": { - "base": "<p>Contains the parameters for SetDesiredCapacity.</p>", + "base": null, "refs": { } }, "SetInstanceHealthQuery": { - "base": "<p>Contains the parameters for SetInstanceHealth.</p>", + "base": null, "refs": { } }, "SetInstanceProtectionAnswer": { - "base": "<p>Contains the output of SetInstanceProtection.</p>", + "base": null, "refs": { } }, "SetInstanceProtectionQuery": { - "base": "<p>Contains the parameters for SetInstanceProtection.</p>", + "base": null, "refs": { } }, @@ -1240,7 +1240,7 @@ } }, "TagsType": { - "base": "<p>Contains the output of DescribeTags.</p>", + "base": null, "refs": { } }, @@ -1254,7 +1254,7 @@ } }, "TerminateInstanceInAutoScalingGroupType": { - "base": "<p>Contains the parameters for TerminateInstanceInAutoScalingGroup.</p>", + "base": null, "refs": { } }, @@ -1285,7 +1285,7 @@ } }, "UpdateAutoScalingGroupType": { - "base": "<p>Contains the parameters for UpdateAutoScalingGroup.</p>", + "base": null, "refs": { } }, @@ -1353,7 +1353,7 @@ "AutoScalingInstanceDetails$InstanceId": "<p>The ID of the instance.</p>", "CompleteLifecycleActionType$InstanceId": "<p>The ID of the instance.</p>", "CreateAutoScalingGroupType$InstanceId": "<p>The ID of the instance used to create a launch configuration for the group. Alternatively, specify a launch configuration instead of an EC2 instance.</p> <p>When you specify an ID of an instance, Auto Scaling creates a new launch configuration and associates it with the group. This launch configuration derives its attributes from the specified instance, with the exception of the block device mapping.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html\">Create an Auto Scaling Group Using an EC2 Instance</a> in the <i>Auto Scaling User Guide</i>.</p>", - "CreateLaunchConfigurationType$InstanceId": "<p>The ID of the instance to use to create the launch configuration.</p> <p>The new launch configuration derives attributes from the instance, with the exception of the block device mapping.</p> <p>To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-lc-with-instanceID.html\">Create a Launch Configuration Using an EC2 Instance</a> in the <i>Auto Scaling User Guide</i>.</p>", + "CreateLaunchConfigurationType$InstanceId": "<p>The ID of the instance to use to create the launch configuration. The new launch configuration derives attributes from the instance, with the exception of the block device mapping.</p> <p>If you do not specify <code>InstanceId</code>, you must specify both <code>ImageId</code> and <code>InstanceType</code>.</p> <p>To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-lc-with-instanceID.html\">Create a Launch Configuration Using an EC2 Instance</a> in the <i>Auto Scaling User Guide</i>.</p>", "Instance$InstanceId": "<p>The ID of the instance.</p>", "InstanceIds$member": null, "RecordLifecycleActionHeartbeatType$InstanceId": "<p>The ID of the instance.</p>", @@ -1383,7 +1383,7 @@ "AutoScalingGroup$Status": "<p>The current state of the group when <a>DeleteAutoScalingGroup</a> is in progress.</p>", "AutoScalingInstanceDetails$AutoScalingGroupName": "<p>The name of the Auto Scaling group associated with the instance.</p>", "AutoScalingInstanceDetails$AvailabilityZone": "<p>The Availability Zone for the instance.</p>", - "AutoScalingInstanceDetails$LaunchConfigurationName": "<p>The launch configuration associated with the instance.</p>", + "AutoScalingInstanceDetails$LaunchConfigurationName": "<p>The launch configuration used to launch the instance. This value is not available if you attached the instance to the Auto Scaling group.</p>", "AutoScalingNotificationTypes$member": null, "AvailabilityZones$member": null, "BlockDeviceMapping$VirtualName": "<p>The name of the virtual device (for example, <code>ephemeral0</code>).</p>", @@ -1392,10 +1392,10 @@ "CreateAutoScalingGroupType$AutoScalingGroupName": "<p>The name of the group. This name must be unique within the scope of your AWS account.</p>", "CreateAutoScalingGroupType$PlacementGroup": "<p>The name of the placement group into which you'll launch your instances, if any. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html\">Placement Groups</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>", "CreateLaunchConfigurationType$LaunchConfigurationName": "<p>The name of the launch configuration. This name must be unique within the scope of your AWS account.</p>", - "CreateLaunchConfigurationType$ImageId": "<p>The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html\">Finding an AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>", + "CreateLaunchConfigurationType$ImageId": "<p>The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.</p> <p>If you do not specify <code>InstanceId</code>, you must specify <code>ImageId</code>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html\">Finding an AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>", "CreateLaunchConfigurationType$KeyName": "<p>The name of the key pair. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html\">Amazon EC2 Key Pairs</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>", "CreateLaunchConfigurationType$ClassicLinkVPCId": "<p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. This parameter is supported only if you are launching EC2-Classic instances. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html\">ClassicLink</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>", - "CreateLaunchConfigurationType$InstanceType": "<p>The instance type of the EC2 instance. For information about available instance types, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes\"> Available Instance Types</a> in the <i>Amazon Elastic Compute Cloud User Guide.</i> </p>", + "CreateLaunchConfigurationType$InstanceType": "<p>The instance type of the EC2 instance.</p> <p>If you do not specify <code>InstanceId</code>, you must specify <code>InstanceType</code>.</p> <p>For information about available instance types, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes\">Available Instance Types</a> in the <i>Amazon Elastic Compute Cloud User Guide.</i> </p>", "CreateLaunchConfigurationType$KernelId": "<p>The ID of the kernel associated with the AMI.</p>", "CreateLaunchConfigurationType$RamdiskId": "<p>The ID of the RAM disk associated with the AMI.</p>", "Ebs$SnapshotId": "<p>The ID of the snapshot.</p>", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/examples-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/examples-1.json index 9dcaf88d..33ffc9c0 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/examples-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/examples-1.json @@ -410,7 +410,8 @@ "HealthStatus": "Healthy", "InstanceId": "i-4ba0837f", "LaunchConfigurationName": "my-launch-config", - "LifecycleState": "InService" + "LifecycleState": "InService", + "ProtectedFromScaleIn": false } ], "LaunchConfigurationName": "my-launch-config", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/paginators-1.json index 31bc0944..1b838597 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/paginators-1.json @@ -2,51 +2,51 @@ "pagination": { "DescribeAutoScalingGroups": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "AutoScalingGroups" }, "DescribeAutoScalingInstances": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "AutoScalingInstances" }, "DescribeLaunchConfigurations": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "LaunchConfigurations" }, "DescribeNotificationConfigurations": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "NotificationConfigurations" }, "DescribePolicies": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "ScalingPolicies" }, "DescribeScalingActivities": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "Activities" }, "DescribeScheduledActions": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "ScheduledUpdateGroupActions" }, "DescribeTags": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxRecords", + "output_token": "NextToken", "result_key": "Tags" } } -} +}
\ No newline at end of file diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/api-2.json index 1a923acc..517a91e0 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/api-2.json @@ -16,7 +16,10 @@ "method":"POST", "requestUri":"/" }, - "input":{"shape":"CancelUpdateStackInput"} + "input":{"shape":"CancelUpdateStackInput"}, + "errors":[ + {"shape":"TokenAlreadyExistsException"} + ] }, "ContinueUpdateRollback":{ "name":"ContinueUpdateRollback", @@ -28,7 +31,10 @@ "output":{ "shape":"ContinueUpdateRollbackOutput", "resultWrapper":"ContinueUpdateRollbackResult" - } + }, + "errors":[ + {"shape":"TokenAlreadyExistsException"} + ] }, "CreateChangeSet":{ "name":"CreateChangeSet", @@ -61,6 +67,7 @@ "errors":[ {"shape":"LimitExceededException"}, {"shape":"AlreadyExistsException"}, + {"shape":"TokenAlreadyExistsException"}, {"shape":"InsufficientCapabilitiesException"} ] }, @@ -85,7 +92,10 @@ "method":"POST", "requestUri":"/" }, - "input":{"shape":"DeleteStackInput"} + "input":{"shape":"DeleteStackInput"}, + "errors":[ + {"shape":"TokenAlreadyExistsException"} + ] }, "DescribeAccountLimits":{ "name":"DescribeAccountLimits", @@ -188,7 +198,8 @@ "errors":[ {"shape":"InvalidChangeSetStatusException"}, {"shape":"ChangeSetNotFoundException"}, - {"shape":"InsufficientCapabilitiesException"} + {"shape":"InsufficientCapabilitiesException"}, + {"shape":"TokenAlreadyExistsException"} ] }, "GetStackPolicy":{ @@ -318,7 +329,8 @@ "resultWrapper":"UpdateStackResult" }, "errors":[ - {"shape":"InsufficientCapabilitiesException"} + {"shape":"InsufficientCapabilitiesException"}, + {"shape":"TokenAlreadyExistsException"} ] }, "ValidateTemplate":{ @@ -366,7 +378,8 @@ "type":"structure", "required":["StackName"], "members":{ - "StackName":{"shape":"StackName"} + "StackName":{"shape":"StackName"}, + "ClientRequestToken":{"shape":"ClientRequestToken"} } }, "Capabilities":{ @@ -479,6 +492,12 @@ "type":"list", "member":{"shape":"Change"} }, + "ClientRequestToken":{ + "type":"string", + "max":128, + "min":1, + "pattern":"[a-zA-Z][-a-zA-Z0-9]*" + }, "ClientToken":{ "type":"string", "max":128, @@ -490,7 +509,8 @@ "members":{ "StackName":{"shape":"StackNameOrId"}, "RoleARN":{"shape":"RoleARN"}, - "ResourcesToSkip":{"shape":"ResourcesToSkip"} + "ResourcesToSkip":{"shape":"ResourcesToSkip"}, + "ClientRequestToken":{"shape":"ClientRequestToken"} } }, "ContinueUpdateRollbackOutput":{ @@ -545,7 +565,8 @@ "OnFailure":{"shape":"OnFailure"}, "StackPolicyBody":{"shape":"StackPolicyBody"}, "StackPolicyURL":{"shape":"StackPolicyURL"}, - "Tags":{"shape":"Tags"} + "Tags":{"shape":"Tags"}, + "ClientRequestToken":{"shape":"ClientRequestToken"} } }, "CreateStackOutput":{ @@ -574,7 +595,8 @@ "members":{ "StackName":{"shape":"StackName"}, "RetainResources":{"shape":"RetainResources"}, - "RoleARN":{"shape":"RoleARN"} + "RoleARN":{"shape":"RoleARN"}, + "ClientRequestToken":{"shape":"ClientRequestToken"} } }, "DeletionTime":{"type":"timestamp"}, @@ -712,7 +734,8 @@ "required":["ChangeSetName"], "members":{ "ChangeSetName":{"shape":"ChangeSetNameOrId"}, - "StackName":{"shape":"StackNameOrId"} + "StackName":{"shape":"StackNameOrId"}, + "ClientRequestToken":{"shape":"ClientRequestToken"} } }, "ExecuteChangeSetOutput":{ @@ -1167,7 +1190,8 @@ "Timestamp":{"shape":"Timestamp"}, "ResourceStatus":{"shape":"ResourceStatus"}, "ResourceStatusReason":{"shape":"ResourceStatusReason"}, - "ResourceProperties":{"shape":"ResourceProperties"} + "ResourceProperties":{"shape":"ResourceProperties"}, + "ClientRequestToken":{"shape":"ClientRequestToken"} } }, "StackEvents":{ @@ -1372,6 +1396,17 @@ "min":1 }, "Timestamp":{"type":"timestamp"}, + "TokenAlreadyExistsException":{ + "type":"structure", + "members":{ + }, + "error":{ + "code":"TokenAlreadyExistsException", + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, "TransformName":{"type":"string"}, "TransformsList":{ "type":"list", @@ -1394,7 +1429,8 @@ "StackPolicyBody":{"shape":"StackPolicyBody"}, "StackPolicyURL":{"shape":"StackPolicyURL"}, "NotificationARNs":{"shape":"NotificationARNs"}, - "Tags":{"shape":"Tags"} + "Tags":{"shape":"Tags"}, + "ClientRequestToken":{"shape":"ClientRequestToken"} } }, "UpdateStackOutput":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/docs-2.json index b4e0c337..18072cbf 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/docs-2.json @@ -1,10 +1,10 @@ { "version": "2.0", - "service": "<fullname>AWS CloudFormation</fullname> <p>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.</p> <p>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.</p> <p>For more information about AWS CloudFormation, see the <a href=\"http://aws.amazon.com/cloudformation/\">AWS CloudFormation Product Page</a>.</p> <p>Amazon CloudFormation makes use of other AWS products. For additional technical information about a specific AWS product, see its <a href=\"http://docs.aws.amazon.com/\">technical documentation</a>.</p>", + "service": "<fullname>AWS CloudFormation</fullname> <p>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.</p> <p>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.</p> <p>For more information about AWS CloudFormation, see the <a href=\"http://aws.amazon.com/cloudformation/\">AWS CloudFormation Product Page</a>.</p> <p>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 <a href=\"http://docs.aws.amazon.com/\">docs.aws.amazon.com</a>.</p>", "operations": { "CancelUpdateStack": "<p>Cancels an update on the specified stack. If the call completes successfully, the stack rolls back the update and reverts to the previous stack configuration.</p> <note> <p>You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.</p> </note>", "ContinueUpdateRollback": "<p>For a specified stack that is in the <code>UPDATE_ROLLBACK_FAILED</code> state, continues rolling it back to the <code>UPDATE_ROLLBACK_COMPLETE</code> state. Depending on the cause of the failure, you can manually <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed\"> fix the error</a> and continue the rollback. By continuing the rollback, you can return your stack to a working state (the <code>UPDATE_ROLLBACK_COMPLETE</code> state), and then try to update the stack again.</p> <p>A stack goes into the <code>UPDATE_ROLLBACK_FAILED</code> state when AWS CloudFormation cannot roll back all changes after a failed stack update. For example, you might have a stack that is rolling back to an old database instance that was deleted outside of AWS CloudFormation. Because AWS CloudFormation doesn't know the database was deleted, it assumes that the database instance still exists and attempts to roll back to it, causing the update rollback to fail.</p>", - "CreateChangeSet": "<p>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.</p> <p>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 <a>ExecuteChangeSet</a> action.</p> <p>After the call successfully completes, AWS CloudFormation starts creating the change set. To check the status of the change set, use the <a>DescribeChangeSet</a> action.</p>", + "CreateChangeSet": "<p>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.</p> <p>To create a change set for a stack that doesn't exist, for the <code>ChangeSetType</code> parameter, specify <code>CREATE</code>. To create a change set for an existing stack, specify <code>UPDATE</code> for the <code>ChangeSetType</code> parameter. After the <code>CreateChangeSet</code> call successfully completes, AWS CloudFormation starts creating the change set. To check the status of the change set or to review it, use the <a>DescribeChangeSet</a> action.</p> <p>When you are satisfied with the changes the change set will make, execute the change set by using the <a>ExecuteChangeSet</a> action. AWS CloudFormation doesn't make changes until you execute the change set.</p>", "CreateStack": "<p>Creates a stack as specified in the template. After the call completes successfully, the stack creation starts. You can check the status of the stack via the <a>DescribeStacks</a> API.</p>", "DeleteChangeSet": "<p>Deletes the specified change set. Deleting change sets ensures that no one executes the wrong change set.</p> <p>If the call successfully completes, AWS CloudFormation successfully deleted the change set.</p>", "DeleteStack": "<p>Deletes a specified stack. Once the call completes successfully, stack deletion starts. Deleted stacks do not show up in the <a>DescribeStacks</a> API if the deletion has been completed successfully.</p>", @@ -188,6 +188,18 @@ "DescribeChangeSetOutput$Changes": "<p>A list of <code>Change</code> structures that describes the resources AWS CloudFormation changes if you execute the change set.</p>" } }, + "ClientRequestToken": { + "base": null, + "refs": { + "CancelUpdateStackInput$ClientRequestToken": "<p>A unique identifier for this <code>CancelUpdateStack</code> 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 <code>CancelUpdateStack</code> requests to ensure that AWS CloudFormation successfully received them.</p>", + "ContinueUpdateRollbackInput$ClientRequestToken": "<p>A unique identifier for this <code>ContinueUpdateRollback</code> 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 <code>ContinueUpdateRollback</code> requests to ensure that AWS CloudFormation successfully received them.</p>", + "CreateStackInput$ClientRequestToken": "<p>A unique identifier for this <code>CreateStack</code> 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 <code>CreateStack</code> requests to ensure that AWS CloudFormation successfully received them.</p>", + "DeleteStackInput$ClientRequestToken": "<p>A unique identifier for this <code>DeleteStack</code> 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 <code>DeleteStack</code> requests to ensure that AWS CloudFormation successfully received them.</p>", + "ExecuteChangeSetInput$ClientRequestToken": "<p>A unique identifier for this <code>ExecuteChangeSet</code> 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 <code>ExecuteChangeSet</code> requests to ensure that AWS CloudFormation successfully received them.</p>", + "StackEvent$ClientRequestToken": "<p>The token passed to the operation that generated this event.</p> <p>For example, if you execute a <code>CreateStack</code> operation with the token <code>token1</code>, then all the <code>StackEvents</code> generated by that operation will have <code>ClientRequestToken</code> set as <code>token1</code>.</p>", + "UpdateStackInput$ClientRequestToken": "<p>A unique identifier for this <code>UpdateStack</code> 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 <code>UpdateStack</code> requests to ensure that AWS CloudFormation successfully received them.</p>" + } + }, "ClientToken": { "base": null, "refs": { @@ -582,7 +594,7 @@ "base": null, "refs": { "CreateChangeSetInput$NotificationARNs": "<p>The Amazon Resource Names (ARNs) of Amazon Simple Notification Service (Amazon SNS) topics that AWS CloudFormation associates with the stack. To remove all associated notification topics, specify an empty list.</p>", - "CreateStackInput$NotificationARNs": "<p>The Simple Notification Service (SNS) topic ARNs to publish stack related events. You can find your SNS topic ARNs using the <a href=\"https://console.aws.amazon.com/sns\">SNS console</a> or your Command Line Interface (CLI).</p>", + "CreateStackInput$NotificationARNs": "<p>The Simple Notification Service (SNS) topic ARNs to publish stack related events. You can find your SNS topic ARNs using the SNS console or your Command Line Interface (CLI).</p>", "DescribeChangeSetOutput$NotificationARNs": "<p>The ARNs of the Amazon Simple Notification Service (Amazon SNS) topics that will be associated with the stack if you execute the change set.</p>", "Stack$NotificationARNs": "<p>SNS topic ARNs to which stack related events are published.</p>", "UpdateStackInput$NotificationARNs": "<p>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.</p>" @@ -800,7 +812,7 @@ "ResourcesToSkip": { "base": null, "refs": { - "ContinueUpdateRollbackInput$ResourcesToSkip": "<p>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 <code>UPDATE_FAILED</code> state because a rollback failed. You can't specify resources that are in the <code>UPDATE_FAILED</code> state for other reasons, for example, because an update was canceled. To check why a resource update failed, use the <a>DescribeStackResources</a> action, and view the resource status reason. </p> <important> <p>Specify this property to skip rolling back resources that AWS CloudFormation can't successfully roll back. We recommend that you <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed\"> troubleshoot</a> resources before skipping them. AWS CloudFormation sets the status of the specified resources to <code>UPDATE_COMPLETE</code> and continues to roll back the stack. After the rollback is complete, the state of the skipped resources will be inconsistent with the state of the resources in the stack template. Before performing another stack update, you must update the stack or resources to be consistent with each other. If you don't, subsequent stack updates might fail, and the stack will become unrecoverable. </p> </important> <p>Specify the minimum number of resources required to successfully roll back your stack. For example, a failed resource update might cause dependent resources to fail. In this case, it might not be necessary to skip the dependent resources. </p> <p>To specify resources in a nested stack, use the following format: <code>NestedStackName.ResourceLogicalID</code>. You can specify a nested stack resource (the logical ID of an <code>AWS::CloudFormation::Stack</code> resource) only if it's in one of the following states: <code>DELETE_IN_PROGRESS</code>, <code>DELETE_COMPLETE</code>, or <code>DELETE_FAILED</code>. </p>" + "ContinueUpdateRollbackInput$ResourcesToSkip": "<p>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 <code>UPDATE_FAILED</code> state because a rollback failed. You can't specify resources that are in the <code>UPDATE_FAILED</code> state for other reasons, for example, because an update was canceled. To check why a resource update failed, use the <a>DescribeStackResources</a> action, and view the resource status reason. </p> <important> <p>Specify this property to skip rolling back resources that AWS CloudFormation can't successfully roll back. We recommend that you <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html#troubleshooting-errors-update-rollback-failed\"> troubleshoot</a> resources before skipping them. AWS CloudFormation sets the status of the specified resources to <code>UPDATE_COMPLETE</code> and continues to roll back the stack. After the rollback is complete, the state of the skipped resources will be inconsistent with the state of the resources in the stack template. Before performing another stack update, you must update the stack or resources to be consistent with each other. If you don't, subsequent stack updates might fail, and the stack will become unrecoverable. </p> </important> <p>Specify the minimum number of resources required to successfully roll back your stack. For example, a failed resource update might cause dependent resources to fail. In this case, it might not be necessary to skip the dependent resources. </p> <p>To specify resources in a nested stack, use the following format: <code>NestedStackName.ResourceLogicalID</code>. If the <code>ResourceLogicalID</code> is a stack resource (<code>Type: AWS::CloudFormation::Stack</code>), it must be in one of the following states: <code>DELETE_IN_PROGRESS</code>, <code>DELETE_COMPLETE</code>, or <code>DELETE_FAILED</code>. </p>" } }, "RetainResources": { @@ -1048,7 +1060,7 @@ "EstimateTemplateCostInput$TemplateBody": "<p>Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.)</p> <p>Conditional: You must pass <code>TemplateBody</code> or <code>TemplateURL</code>. If both are passed, only <code>TemplateBody</code> is used.</p>", "GetTemplateOutput$TemplateBody": "<p>Structure containing the template body. (For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.)</p> <p>AWS CloudFormation returns the same template that was used when the stack was created.</p>", "GetTemplateSummaryInput$TemplateBody": "<p>Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information about templates, see <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must specify only one of the following parameters: <code>StackName</code>, <code>TemplateBody</code>, or <code>TemplateURL</code>.</p>", - "UpdateStackInput$TemplateBody": "<p>Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.)</p> <p>Conditional: You must specify either the <code>TemplateBody</code> or the <code>TemplateURL</code> parameter, but not both.</p>", + "UpdateStackInput$TemplateBody": "<p>Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. (For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.)</p> <p>Conditional: You must specify only one of the following parameters: <code>TemplateBody</code>, <code>TemplateURL</code>, or set the <code>UsePreviousTemplate</code> to <code>true</code>.</p>", "ValidateTemplateInput$TemplateBody": "<p>Structure containing the template body with a minimum length of 1 byte and a maximum length of 51,200 bytes. For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must pass <code>TemplateURL</code> or <code>TemplateBody</code>. If both are passed, only <code>TemplateBody</code> is used.</p>" } }, @@ -1084,7 +1096,7 @@ "CreateStackInput$TemplateURL": "<p>Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to the <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must specify either the <code>TemplateBody</code> or the <code>TemplateURL</code> parameter, but not both.</p>", "EstimateTemplateCostInput$TemplateURL": "<p>Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must pass <code>TemplateURL</code> or <code>TemplateBody</code>. If both are passed, only <code>TemplateBody</code> is used.</p>", "GetTemplateSummaryInput$TemplateURL": "<p>Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information about templates, see <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must specify only one of the following parameters: <code>StackName</code>, <code>TemplateBody</code>, or <code>TemplateURL</code>.</p>", - "UpdateStackInput$TemplateURL": "<p>Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must specify either the <code>TemplateBody</code> or the <code>TemplateURL</code> parameter, but not both.</p>", + "UpdateStackInput$TemplateURL": "<p>Location of file containing the template body. The URL must point to a template that is located in an Amazon S3 bucket. For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must specify only one of the following parameters: <code>TemplateBody</code>, <code>TemplateURL</code>, or set the <code>UsePreviousTemplate</code> to <code>true</code>.</p>", "ValidateTemplateInput$TemplateURL": "<p>Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket. For more information, go to <a href=\"http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html\">Template Anatomy</a> in the AWS CloudFormation User Guide.</p> <p>Conditional: You must pass <code>TemplateURL</code> or <code>TemplateBody</code>. If both are passed, only <code>TemplateBody</code> is used.</p>" } }, @@ -1104,6 +1116,11 @@ "StackResourceSummary$LastUpdatedTimestamp": "<p>Time the status was updated.</p>" } }, + "TokenAlreadyExistsException": { + "base": "<p>A client request token already exists.</p>", + "refs": { + } + }, "TransformName": { "base": null, "refs": { @@ -1137,7 +1154,7 @@ "base": null, "refs": { "CreateChangeSetInput$UsePreviousTemplate": "<p>Whether to reuse the template that is associated with the stack to create the change set.</p>", - "UpdateStackInput$UsePreviousTemplate": "<p>Reuse the existing template that is associated with the stack that you are updating.</p>" + "UpdateStackInput$UsePreviousTemplate": "<p>Reuse the existing template that is associated with the stack that you are updating.</p> <p>Conditional: You must specify only one of the following parameters: <code>TemplateBody</code>, <code>TemplateURL</code>, or set the <code>UsePreviousTemplate</code> to <code>true</code>.</p>" } }, "UsePreviousValue": { diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/examples-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/examples-1.json index e7802626..0ea7e3b0 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/examples-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/cloudformation/2010-05-15/examples-1.json @@ -1,158 +1,5 @@ { "version": "1.0", "examples": { - "CancelUpdateStack": [ - { - "input": { - "StackName": "MyStack" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example cancels an update of the specified stack.", - "id": "to-cancel-a-stack-update-that-is-in-progress-1472747085196", - "title": "To cancel a stack update in progress" - } - ], - "UpdateStack": [ - { - "input": { - "NotificationARNs": [ - - ], - "Parameters": [ - { - "ParameterKey": "KeyPairName", - "ParameterValue": "ExampleKeyPair" - }, - { - "ParameterKey": "SubnetIDs", - "ParameterValue": "ExampleSubnetID1, ExampleSubnetID2" - } - ], - "ResourceTypes": [ - - ], - "StackName": "MyStack", - "Tags": [ - - ], - "TemplateURL": "https://s3.amazonaws.com/example/updated.template" - }, - "output": { - "StackId": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates the template and input parameters for the specified stack.", - "id": "to-update-an-aws-cloudformation-stack-1472841931621", - "title": "To update an AWS CloudFormation stack" - }, - { - "input": { - "NotificationARNs": [ - - ], - "Parameters": [ - { - "ParameterKey": "KeyPairName", - "UsePreviousValue": true - }, - { - "ParameterKey": "SubnetIDs", - "ParameterValue": "SampleSubnetID1, UpdatedSampleSubnetID2" - } - ], - "ResourceTypes": [ - - ], - "StackName": "MyStack", - "Tags": [ - - ], - "TemplateURL": "https://s3.amazonaws.com/example/updated.template" - }, - "output": { - "StackId": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example updates only the the specified parameter value for the specified stack. If you don't specify a parameter value, AWS CloudFormation uses the default value from the template.", - "id": "to-update-an-aws-cloudformation-stack-1472841931621", - "title": "To update an AWS CloudFormation stack" - }, - { - "input": { - "Capabilities": [ - - ], - "NotificationARNs": [ - "arn:aws:sns:use-east-1:123456789012:mytopic1", - "arn:aws:sns:us-east-1:123456789012:mytopic2" - ], - "Parameters": [ - - ], - "ResourceTypes": [ - - ], - "StackName": "MyStack", - "Tags": [ - - ], - "TemplateURL": "https://s3.amazonaws.com/example/updated.template", - "UsePreviousTemplate": true - }, - "output": { - "StackId": "" - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example adds two stack notification topics to the specified stack.", - "id": "to-update-an-aws-cloudformation-stack-1472841931621", - "title": "To update an AWS CloudFormation stack" - } - ], - "ValidateTemplate": [ - { - "input": { - "TemplateBody": "MyTemplate.json" - }, - "output": { - "Capabilities": [ - - ], - "CapabilitiesReason": "", - "Description": "AWS CloudFormation Example Template S3_Bucket: An example template that shows how to create a publicly-accessible S3 bucket. IMPORTANT: This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", - "Parameters": [ - - ] - }, - "comments": { - "input": { - }, - "output": { - } - }, - "description": "This example validates the specified template.", - "id": "to-validate-an-aws-cloudformation-template-1472839072307", - "title": "To validate an AWS CloudFormation template" - } - ] } } diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/api-2.json index 9d4d49b2..0812c796 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/api-2.json @@ -178,7 +178,8 @@ {"shape":"DeploymentLimitExceededException"}, {"shape":"InvalidTargetInstancesException"}, {"shape":"InvalidAutoRollbackConfigException"}, - {"shape":"InvalidLoadBalancerInfoException"} + {"shape":"InvalidLoadBalancerInfoException"}, + {"shape":"InvalidFileExistsBehaviorException"} ] }, "CreateDeploymentConfig":{ @@ -467,7 +468,8 @@ {"shape":"InvalidNextTokenException"}, {"shape":"InvalidDeploymentIdException"}, {"shape":"InvalidInstanceStatusException"}, - {"shape":"InvalidInstanceTypeException"} + {"shape":"InvalidInstanceTypeException"}, + {"shape":"InvalidDeploymentInstanceTypeException"} ] }, "ListDeployments":{ @@ -966,7 +968,8 @@ "ignoreApplicationStopFailures":{"shape":"Boolean"}, "targetInstances":{"shape":"TargetInstances"}, "autoRollbackConfiguration":{"shape":"AutoRollbackConfiguration"}, - "updateOutdatedInstancesOnly":{"shape":"Boolean"} + "updateOutdatedInstancesOnly":{"shape":"Boolean"}, + "fileExistsBehavior":{"shape":"FileExistsBehavior"} } }, "CreateDeploymentOutput":{ @@ -1147,6 +1150,7 @@ "deploymentGroupName":{"shape":"DeploymentGroupName"}, "deploymentConfigName":{"shape":"DeploymentConfigName"}, "deploymentId":{"shape":"DeploymentId"}, + "previousRevision":{"shape":"RevisionLocation"}, "revision":{"shape":"RevisionLocation"}, "status":{"shape":"DeploymentStatus"}, "errorInformation":{"shape":"ErrorInformation"}, @@ -1165,7 +1169,8 @@ "instanceTerminationWaitTimeStarted":{"shape":"Boolean"}, "blueGreenDeploymentConfiguration":{"shape":"BlueGreenDeploymentConfiguration"}, "loadBalancerInfo":{"shape":"LoadBalancerInfo"}, - "additionalDeploymentStatusInfo":{"shape":"AdditionalDeploymentStatusInfo"} + "additionalDeploymentStatusInfo":{"shape":"AdditionalDeploymentStatusInfo"}, + "fileExistsBehavior":{"shape":"FileExistsBehavior"} } }, "DeploymentIsNotInReadyStateException":{ @@ -1343,6 +1348,14 @@ } }, "ErrorMessage":{"type":"string"}, + "FileExistsBehavior":{ + "type":"string", + "enum":[ + "DISALLOW", + "OVERWRITE", + "RETAIN" + ] + }, "GenericRevisionInfo":{ "type":"structure", "members":{ @@ -1677,6 +1690,12 @@ }, "exception":true }, + "InvalidDeploymentInstanceTypeException":{ + "type":"structure", + "members":{ + }, + "exception":true + }, "InvalidDeploymentStatusException":{ "type":"structure", "members":{ @@ -1695,6 +1714,12 @@ }, "exception":true }, + "InvalidFileExistsBehaviorException":{ + "type":"structure", + "members":{ + }, + "exception":true + }, "InvalidIamSessionArnException":{ "type":"structure", "members":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/docs-2.json index bbf8cd26..e41e7515 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "<fullname>AWS CodeDeploy</fullname> <p> <b>Overview</b> </p> <p>This reference guide provides descriptions of the AWS CodeDeploy APIs. For more information about AWS CodeDeploy, see the <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide\">AWS CodeDeploy User Guide</a>.</p> <p> <b>Using the APIs</b> </p> <p>You can use the AWS CodeDeploy APIs to work with the following:</p> <ul> <li> <p>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.</p> <p>You can use the AWS CodeDeploy APIs to create, delete, get, list, and update applications.</p> </li> <li> <p>Deployment configurations are sets of deployment rules and success and failure conditions used by AWS CodeDeploy during deployments.</p> <p>You can use the AWS CodeDeploy APIs to create, delete, get, and list deployment configurations.</p> </li> <li> <p>Deployment groups are groups of instances to which application revisions can be deployed.</p> <p>You can use the AWS CodeDeploy APIs to create, delete, get, list, and update deployment groups.</p> </li> <li> <p>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.</p> <p>You can use the AWS CodeDeploy APIs to get and list instance.</p> </li> <li> <p>Deployments represent the process of deploying revisions to instances.</p> <p>You can use the AWS CodeDeploy APIs to create, get, list, and stop deployments.</p> </li> <li> <p>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.</p> <p>You can use the AWS CodeDeploy APIs to get, list, and register application revisions.</p> </li> </ul>", + "service": "<fullname>AWS CodeDeploy</fullname> <p>AWS CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances or on-premises instances running in your own facility.</p> <p>You can deploy a nearly unlimited variety of application content, such as code, web and configuration files, executables, packages, scripts, multimedia files, and so on. AWS CodeDeploy can deploy application content stored in Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need to make changes to your existing code before you can use AWS CodeDeploy.</p> <p>AWS CodeDeploy makes it easier for you to rapidly release new features, helps you avoid downtime during application deployment, and handles the complexity of updating your applications, without many of the risks associated with error-prone manual deployments.</p> <p> <b>AWS CodeDeploy Components</b> </p> <p>Use the information in this guide to help you work with the following AWS CodeDeploy components:</p> <ul> <li> <p> <b>Application</b>: A name that uniquely identifies the application you want to deploy. AWS CodeDeploy uses this name, which functions as a container, to ensure the correct combination of revision, deployment configuration, and deployment group are referenced during a deployment.</p> </li> <li> <p> <b>Deployment group</b>: A set of individual instances. A deployment group contains individually tagged instances, Amazon EC2 instances in Auto Scaling groups, or both. </p> </li> <li> <p> <b>Deployment configuration</b>: A set of deployment rules and deployment success and failure conditions used by AWS CodeDeploy during a deployment.</p> </li> <li> <p> <b>Deployment</b>: The process, and the components involved in the process, of installing content on one or more instances. </p> </li> <li> <p> <b>Application revisions</b>: An archive file containing source content—source code, web pages, executable files, and deployment scripts—along with an application specification file (AppSpec file). Revisions are stored in Amazon S3 buckets or GitHub repositories. For Amazon S3, a revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. For GitHub, a revision is uniquely identified by its commit ID.</p> </li> </ul> <p>This guide also contains information to help you get details about the instances in your deployments and to make on-premises instances available for AWS CodeDeploy deployments.</p> <p> <b>AWS CodeDeploy Information Resources</b> </p> <ul> <li> <p> <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide\">AWS CodeDeploy User Guide</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/codedeploy/latest/APIReference/\">AWS CodeDeploy API Reference Guide</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/cli/latest/reference/deploy/index.html\">AWS CLI Reference for AWS CodeDeploy</a> </p> </li> <li> <p> <a href=\"https://forums.aws.amazon.com/forum.jspa?forumID=179\">AWS CodeDeploy Developer Forum</a> </p> </li> </ul>", "operations": { "AddTagsToOnPremisesInstances": "<p>Adds tags to on-premises instances.</p>", "BatchGetApplicationRevisions": "<p>Gets information about one or more application revisions.</p>", @@ -9,7 +9,7 @@ "BatchGetDeploymentInstances": "<p>Gets information about one or more instance that are part of a deployment group.</p>", "BatchGetDeployments": "<p>Gets information about one or more deployments.</p>", "BatchGetOnPremisesInstances": "<p>Gets information about one or more on-premises instances.</p>", - "ContinueDeployment": "<p>Starts the process of rerouting traffic from instances in the original environment to instances in thereplacement environment without waiting for a specified wait time to elapse. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.) </p>", + "ContinueDeployment": "<p>For a blue/green deployment, starts the process of rerouting traffic from instances in the original environment to instances in the replacement environment without waiting for a specified wait time to elapse. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.) </p>", "CreateApplication": "<p>Creates an application.</p>", "CreateDeployment": "<p>Deploys an application revision through the specified deployment group.</p>", "CreateDeploymentConfig": "<p>Creates a deployment configuration.</p>", @@ -61,9 +61,9 @@ "AlarmConfiguration": { "base": "<p>Information about alarms associated with the deployment group.</p>", "refs": { - "CreateDeploymentGroupInput$alarmConfiguration": "<p>Information to add about Amazon CloudWatch alarms when the deployment group is created. </p>", + "CreateDeploymentGroupInput$alarmConfiguration": "<p>Information to add about Amazon CloudWatch alarms when the deployment group is created.</p>", "DeploymentGroupInfo$alarmConfiguration": "<p>A list of alarms associated with the deployment group.</p>", - "UpdateDeploymentGroupInput$alarmConfiguration": "<p>Information to add or change about Amazon CloudWatch alarms when the deployment group is updated. </p>" + "UpdateDeploymentGroupInput$alarmConfiguration": "<p>Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.</p>" } }, "AlarmList": { @@ -440,7 +440,7 @@ "base": null, "refs": { "CreateDeploymentConfigInput$deploymentConfigName": "<p>The name of the deployment configuration to create.</p>", - "CreateDeploymentGroupInput$deploymentConfigName": "<p>If specified, the deployment configuration name can be either one of the predefined configurations provided with AWS CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.</p> <p>CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or the deployment group.</p> <p>For more information about the predefined deployment configurations in AWS CodeDeploy, see see <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html\">Working with Deployment Groups in AWS CodeDeploy</a> in the AWS CodeDeploy User Guide.</p>", + "CreateDeploymentGroupInput$deploymentConfigName": "<p>If specified, the deployment configuration name can be either one of the predefined configurations provided with AWS CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.</p> <p>CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or the deployment group.</p> <p>For more information about the predefined deployment configurations in AWS CodeDeploy, see <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html\">Working with Deployment Groups in AWS CodeDeploy</a> in the AWS CodeDeploy User Guide.</p>", "CreateDeploymentInput$deploymentConfigName": "<p>The name of a deployment configuration associated with the applicable IAM user or AWS account.</p> <p>If not specified, the value configured in the deployment group will be used as the default. If the deployment group does not have a deployment configuration associated with it, then CodeDeployDefault.OneAtATime will be used by default.</p>", "DeleteDeploymentConfigInput$deploymentConfigName": "<p>The name of a deployment configuration associated with the applicable IAM user or AWS account.</p>", "DeploymentConfigInfo$deploymentConfigName": "<p>The deployment configuration name.</p>", @@ -619,18 +619,18 @@ } }, "DeploymentStyle": { - "base": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>", + "base": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>", "refs": { - "CreateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, standard or blue/green, that you want to run and whether to route deployment traffic behind a load balancer.</p>", - "DeploymentGroupInfo$deploymentStyle": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>", - "DeploymentInfo$deploymentStyle": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>", - "UpdateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>" + "CreateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, in-place or blue/green, that you want to run and whether to route deployment traffic behind a load balancer.</p>", + "DeploymentGroupInfo$deploymentStyle": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>", + "DeploymentInfo$deploymentStyle": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>", + "UpdateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>" } }, "DeploymentType": { "base": null, "refs": { - "DeploymentStyle$deploymentType": "<p>Indicates whether to run a standard deployment or a blue/green deployment.</p>" + "DeploymentStyle$deploymentType": "<p>Indicates whether to run an in-place deployment or a blue/green deployment.</p>" } }, "DeploymentsInfoList": { @@ -680,7 +680,7 @@ } }, "EC2TagFilter": { - "base": "<p>Information about a tag filter.</p>", + "base": "<p>Information about an EC2 tag filter.</p>", "refs": { "EC2TagFilterList$member": null } @@ -688,7 +688,7 @@ "EC2TagFilterList": { "base": null, "refs": { - "CreateDeploymentGroupInput$ec2TagFilters": "<p>The Amazon EC2 tags on which to filter.</p>", + "CreateDeploymentGroupInput$ec2TagFilters": "<p>The Amazon EC2 tags on which to filter. The deployment group will include EC2 instances with any of the specified tags.</p>", "DeploymentGroupInfo$ec2TagFilters": "<p>The Amazon EC2 tags on which to filter.</p>", "TargetInstances$tagFilters": "<p>The tag filter key, type, and value used to identify Amazon EC2 instances in a replacement environment for a blue/green deployment.</p>", "UpdateDeploymentGroupInput$ec2TagFilters": "<p>The replacement set of Amazon EC2 tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.</p>" @@ -701,7 +701,7 @@ } }, "ELBInfo": { - "base": "<p>Information about a load balancer in Elastic Load Balancing to use in a blue/green deployment.</p>", + "base": "<p>Information about a load balancer in Elastic Load Balancing to use in a deployment.</p>", "refs": { "ELBInfoList$member": null } @@ -709,13 +709,13 @@ "ELBInfoList": { "base": null, "refs": { - "LoadBalancerInfo$elbInfoList": "<p>An array containing information about the load balancer in Elastic Load Balancing to use in a blue/green deployment.</p>" + "LoadBalancerInfo$elbInfoList": "<p>An array containing information about the load balancer in Elastic Load Balancing to use in a deployment.</p>" } }, "ELBName": { "base": null, "refs": { - "ELBInfo$name": "<p>The name of the load balancer that will be used to route traffic from original instances to replacement instances in a blue/green deployment.</p>" + "ELBInfo$name": "<p>For blue/green deployments, the name of the load balancer that will be used to route traffic from original instances to replacement instances in a blue/green deployment. For in-place deployments, the name of the load balancer that instances are deregistered from so they are not serving traffic during a deployment, and then re-registered with after the deployment completes.</p>" } }, "ETag": { @@ -745,6 +745,13 @@ "ErrorInformation$message": "<p>An accompanying error message.</p>" } }, + "FileExistsBehavior": { + "base": null, + "refs": { + "CreateDeploymentInput$fileExistsBehavior": "<p>Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.</p> <p>The fileExistsBehavior parameter takes any of the following values:</p> <ul> <li> <p>DISALLOW: The deployment fails. This is also the default behavior if no option is specified.</p> </li> <li> <p>OVERWRITE: The version of the file from the application revision currently being deployed replaces the version already on the instance.</p> </li> <li> <p>RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.</p> </li> </ul>", + "DeploymentInfo$fileExistsBehavior": "<p>Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.</p> <ul> <li> <p>DISALLOW: The deployment fails. This is also the default behavior if no option is specified.</p> </li> <li> <p>OVERWRITE: The version of the file from the application revision currently being deployed replaces the version already on the instance.</p> </li> <li> <p>RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.</p> </li> </ul>" + } + }, "GenericRevisionInfo": { "base": "<p>Information about an application revision.</p>", "refs": { @@ -1063,13 +1070,18 @@ "refs": { } }, + "InvalidDeploymentInstanceTypeException": { + "base": "<p>An instance type was specified for an in-place deployment. Instance types are supported for blue/green deployments only.</p>", + "refs": { + } + }, "InvalidDeploymentStatusException": { "base": "<p>The specified deployment status doesn't exist or cannot be determined.</p>", "refs": { } }, "InvalidDeploymentStyleException": { - "base": "<p>An invalid deployment style was specified. Valid deployment types include \"IN_PLACE\" and \"BLUE_GREEN\". Valid deployment options for blue/green deployments include \"WITH_TRAFFIC_CONTROL\" and \"WITHOUT_TRAFFIC_CONTROL\".</p>", + "base": "<p>An invalid deployment style was specified. Valid deployment types include \"IN_PLACE\" and \"BLUE_GREEN\". Valid deployment options include \"WITH_TRAFFIC_CONTROL\" and \"WITHOUT_TRAFFIC_CONTROL\".</p>", "refs": { } }, @@ -1078,6 +1090,11 @@ "refs": { } }, + "InvalidFileExistsBehaviorException": { + "base": "<p>An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy handles files or directories that already exist in a deployment target location but weren't part of the previous successful deployment. Valid values include \"DISALLOW\", \"OVERWRITE\", and \"RETAIN\".</p>", + "refs": { + } + }, "InvalidIamSessionArnException": { "base": "<p>The IAM session ARN was specified in an invalid format.</p>", "refs": { @@ -1304,12 +1321,12 @@ } }, "LoadBalancerInfo": { - "base": "<p>Information about the load balancer used in a blue/green deployment.</p>", + "base": "<p>Information about the load balancer used in a deployment.</p>", "refs": { - "CreateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a blue/green deployment.</p>", - "DeploymentGroupInfo$loadBalancerInfo": "<p>Information about the load balancer to use in a blue/green deployment.</p>", - "DeploymentInfo$loadBalancerInfo": "<p>Information about the load balancer used in this blue/green deployment.</p>", - "UpdateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a blue/green deployment.</p>" + "CreateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a deployment.</p>", + "DeploymentGroupInfo$loadBalancerInfo": "<p>Information about the load balancer to use in a deployment.</p>", + "DeploymentInfo$loadBalancerInfo": "<p>Information about the load balancer used in the deployment.</p>", + "UpdateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a deployment.</p>" } }, "LogTail": { @@ -1334,7 +1351,7 @@ "MinimumHealthyHostsType": { "base": null, "refs": { - "MinimumHealthyHosts$type": "<p>The minimum healthy instance type:</p> <ul> <li> <p>HOST_COUNT: The minimum number of healthy instance as an absolute value.</p> </li> <li> <p>FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.</p> </li> </ul> <p>In an example of nine instance, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment will be successful if six or more instances are deployed to successfully; otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instance at a time. The deployment will be successful if four or more instance are deployed to successfully; otherwise, the deployment fails.</p> <note> <p>In a call to the get deployment configuration operation, CodeDeployDefault.OneAtATime will return a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy will try to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment still succeeds.</p> </note>" + "MinimumHealthyHosts$type": "<p>The minimum healthy instance type:</p> <ul> <li> <p>HOST_COUNT: The minimum number of healthy instance as an absolute value.</p> </li> <li> <p>FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.</p> </li> </ul> <p>In an example of nine instance, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment will be successful if six or more instances are deployed to successfully; otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instance at a time. The deployment will be successful if four or more instance are deployed to successfully; otherwise, the deployment fails.</p> <note> <p>In a call to the get deployment configuration operation, CodeDeployDefault.OneAtATime will return a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy will try to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment still succeeds.</p> </note> <p>For more information, see <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide/instances-health.html\">AWS CodeDeploy Instance Health</a> in the <i>AWS CodeDeploy User Guide</i>.</p>" } }, "MinimumHealthyHostsValue": { @@ -1422,6 +1439,7 @@ "refs": { "CreateDeploymentInput$revision": "<p>The type and location of the revision to deploy.</p>", "DeploymentGroupInfo$targetRevision": "<p>Information about the deployment group's target revision, including type and location.</p>", + "DeploymentInfo$previousRevision": "<p>Information about the application revision that was deployed to the deployment group before the most recent successful deployment.</p>", "DeploymentInfo$revision": "<p>Information about the location of stored application artifacts and the service from which to retrieve them.</p>", "GetApplicationRevisionInput$revision": "<p>Information about the application revision to get, including type and location.</p>", "GetApplicationRevisionOutput$revision": "<p>Additional information about the revision, including type and location.</p>", @@ -1535,7 +1553,7 @@ "TagFilterList": { "base": null, "refs": { - "CreateDeploymentGroupInput$onPremisesInstanceTagFilters": "<p>The on-premises instance tags on which to filter.</p>", + "CreateDeploymentGroupInput$onPremisesInstanceTagFilters": "<p>The on-premises instance tags on which to filter. The deployment group will include on-premises instances with any of the specified tags.</p>", "DeploymentGroupInfo$onPremisesInstanceTagFilters": "<p>The on-premises instance tags on which to filter.</p>", "ListOnPremisesInstancesInput$tagFilters": "<p>The on-premises instance tags that will be used to restrict the corresponding on-premises instance names returned.</p>", "UpdateDeploymentGroupInput$onPremisesInstanceTagFilters": "<p>The replacement set of on-premises instance tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.</p>" diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/codestar/2017-04-19/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/codestar/2017-04-19/docs-2.json index 43c12d51..76591736 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/codestar/2017-04-19/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/codestar/2017-04-19/docs-2.json @@ -1,9 +1,9 @@ { "version": "2.0", - "service": "<fullname>AWS CodeStar</fullname> <p>This is the API reference for AWS CodeStar. This reference provides descriptions of the operations and data types for the AWS CodeStar API along with usage examples.</p> <p>You can use the AWS CodeStar API to work with:</p> <p>Projects and their resources, by calling the following:</p> <ul> <li> <p> <a>CreateProject</a>, which creates an empty project in AWS CodeStar with no resources.</p> </li> <li> <p> <a>DeleteProject</a>, which deletes a project in AWS CodeStar.</p> </li> <li> <p> <a>DescribeProject</a>, which lists the attributes of a project.</p> </li> <li> <p> <a>ListProjects</a>, which lists all AWS CodeStar projects associated with your AWS account.</p> </li> <li> <p> <a>ListResources</a>, which lists the resources associated with an AWS CodeStar project.</p> </li> <li> <p> <a>UpdateProject</a>, which updates the attributes of an AWS CodeStar project.</p> </li> </ul> <p>Teams and team members, by calling the following:</p> <ul> <li> <p> <a>AssociateTeamMember</a>, which adds an IAM user to the team for an AWS CodeStar project.</p> </li> <li> <p> <a>DisassociateTeamMember</a>, which removes an IAM user from the team for an AWS CodeStar project.</p> </li> <li> <p> <a>ListTeamMembers</a>, which lists all the IAM users in the team for an AWS CodeStar project, including their roles and attributes.</p> </li> </ul> <p>Users, by calling the following:</p> <ul> <li> <p> <a>CreateUserProfile</a>, which creates a user profile that contains data associated with the user across all AWS CodeStar projects.</p> </li> <li> <p> <a>DeleteUserProfile</a>, which deletes all user profile information across all AWS CodeStar projects.</p> </li> <li> <p> <a>DescribeUserProfile</a>, which describes the profile of a user.</p> </li> <li> <p> <a>ListUserProfiles</a>, which lists all AWS CodeStar user profiles.</p> </li> <li> <p> <a>UpdateUserProfile</a>, which updates the profile for an AWS CodeStar user. </p> </li> </ul>", + "service": "<fullname>AWS CodeStar</fullname> <p>This is the API reference for AWS CodeStar. This reference provides descriptions of the operations and data types for the AWS CodeStar API along with usage examples.</p> <p>You can use the AWS CodeStar API to work with:</p> <p>Projects and their resources, by calling the following:</p> <ul> <li> <p> <a>DeleteProject</a>, which deletes a project in AWS CodeStar.</p> </li> <li> <p> <a>DescribeProject</a>, which lists the attributes of a project.</p> </li> <li> <p> <a>ListProjects</a>, which lists all AWS CodeStar projects associated with your AWS account.</p> </li> <li> <p> <a>ListResources</a>, which lists the resources associated with an AWS CodeStar project.</p> </li> <li> <p> <a>UpdateProject</a>, which updates the attributes of an AWS CodeStar project.</p> </li> </ul> <p>Teams and team members, by calling the following:</p> <ul> <li> <p> <a>AssociateTeamMember</a>, which adds an IAM user to the team for an AWS CodeStar project.</p> </li> <li> <p> <a>DisassociateTeamMember</a>, which removes an IAM user from the team for an AWS CodeStar project.</p> </li> <li> <p> <a>ListTeamMembers</a>, which lists all the IAM users in the team for an AWS CodeStar project, including their roles and attributes.</p> </li> </ul> <p>Users, by calling the following:</p> <ul> <li> <p> <a>CreateUserProfile</a>, which creates a user profile that contains data associated with the user across all AWS CodeStar projects.</p> </li> <li> <p> <a>DeleteUserProfile</a>, which deletes all user profile information across all AWS CodeStar projects.</p> </li> <li> <p> <a>DescribeUserProfile</a>, which describes the profile of a user.</p> </li> <li> <p> <a>ListUserProfiles</a>, which lists all AWS CodeStar user profiles.</p> </li> <li> <p> <a>UpdateUserProfile</a>, which updates the profile for an AWS CodeStar user. </p> </li> </ul>", "operations": { "AssociateTeamMember": "<p>Adds an IAM user to the team for an AWS CodeStar project.</p>", - "CreateProject": "<p>Creates a project in AWS CodeStar with minimal structure and no resources.</p>", + "CreateProject": "<p>Reserved for future use. To create a project, use the AWS CodeStar console.</p>", "CreateUserProfile": "<p>Creates a profile for a user that includes user preferences, such as the display name and email address assocciated with the user, in AWS CodeStar. The user profile is not project-specific. Information in the user profile is displayed wherever the user's information appears to other users in AWS CodeStar.</p>", "DeleteProject": "<p>Deletes a project, including project resources. Does not delete users associated with the project, but does delete the IAM roles that allowed access to the project.</p>", "DeleteUserProfile": "<p>Deletes a user profile in AWS CodeStar, including all personal preference data associated with that profile, such as display name and email address. It does not delete the history of that user, for example the history of commits made by that user.</p>", @@ -34,8 +34,8 @@ "refs": { "AssociateTeamMemberRequest$clientRequestToken": "<p>A user- or system-generated token that identifies the entity that requested the team member association to the project. This token can be used to repeat the request. </p>", "AssociateTeamMemberResult$clientRequestToken": "<p>The user- or system-generated token from the initial request that can be used to repeat the request. </p>", - "CreateProjectRequest$clientRequestToken": "<p>A user- or system-generated token that identifies the entity that requested project creation. This token can be used to repeat the request. It can also be used to identify which user or system made the request in DescribeProject and ListProjects.</p>", - "CreateProjectResult$clientRequestToken": "<p>The user- or system-generated token from the initial request that can be used to repeat the request. It can also be used to identify which user or system made the request in DescribeProject and ListProjects.</p>", + "CreateProjectRequest$clientRequestToken": "<p>Reserved for future use.</p>", + "CreateProjectResult$clientRequestToken": "<p>Reserved for future use.</p>", "DeleteProjectRequest$clientRequestToken": "<p>A user- or system-generated token that identifies the entity that requested project deletion. This token can be used to repeat the request. </p>", "DescribeProjectResult$clientRequestToken": "<p>A user- or system-generated token that identifies the entity that requested project creation. </p>" } @@ -234,7 +234,7 @@ "ProjectArn": { "base": null, "refs": { - "CreateProjectResult$arn": "<p>The Amazon Resource Name (ARN) for the project.</p>", + "CreateProjectResult$arn": "<p>Reserved for future use.</p>", "DeleteProjectResult$projectArn": "<p>The Amazon Resource Name (ARN) of the deleted project.</p>", "DescribeProjectResult$arn": "<p>The Amazon Resource Name (ARN) for the project.</p>", "ProjectSummary$projectArn": "<p>The Amazon Resource Name (ARN) of the project.</p>" @@ -253,7 +253,7 @@ "ProjectDescription": { "base": null, "refs": { - "CreateProjectRequest$description": "<p>Optional. The description for the project.</p>", + "CreateProjectRequest$description": "<p>Reserved for future use.</p>", "DescribeProjectResult$description": "<p>The description of the project, if any.</p>", "UpdateProjectRequest$description": "<p>The description of the project, if any.</p>" } @@ -262,8 +262,8 @@ "base": null, "refs": { "AssociateTeamMemberRequest$projectId": "<p>The ID of the project to which you will add the IAM user.</p>", - "CreateProjectRequest$id": "<p>The ID for the AWS CodeStar project. Project IDs must be unique within an AWS account. Project IDs cannot exceed 15 characters and cannot contain capital letters and other restricted symbols. For more information, see <a href=\"http://docs.aws.amazon.com/codestar/latest/userguide/limits.html\">Limits</a> in the AWS CodeStar User Guide.</p>", - "CreateProjectResult$id": "<p>The ID for the project.</p>", + "CreateProjectRequest$id": "<p>Reserved for future use.</p>", + "CreateProjectResult$id": "<p>Reserved for future use.</p>", "DeleteProjectRequest$id": "<p>The ID of the project to be deleted in AWS CodeStar.</p>", "DescribeProjectRequest$id": "<p>The ID of the project.</p>", "DescribeProjectResult$id": "<p>The ID of the project.</p>", @@ -278,7 +278,7 @@ "ProjectName": { "base": null, "refs": { - "CreateProjectRequest$name": "<p>The friendly name for the project. This friendly name serves as the basis for the names for resources associated with the project, such as a repository name in AWS CodeCommit. The name is limited to 100 characters and cannot contain certain restricted symbols. For more information, see <a href=\"http://docs.aws.amazon.com/codestar/latest/userguide/limits.html\">Limits</a> in the AWS CodeStar User Guide.</p>", + "CreateProjectRequest$name": "<p>Reserved for future use.</p>", "DescribeProjectResult$name": "<p>The display name for the project.</p>", "UpdateProjectRequest$name": "<p>The name of the project you want to update.</p>" } @@ -297,7 +297,7 @@ "ProjectTemplateId": { "base": null, "refs": { - "CreateProjectResult$projectTemplateId": "<p>The ID for the AWS CodeStar project template used to create the project.</p>", + "CreateProjectResult$projectTemplateId": "<p>Reserved for future use.</p>", "DescribeProjectResult$projectTemplateId": "<p>The ID for the AWS CodeStar project template used to create the project.</p>" } }, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/api-2.json index 80980a38..7e1a247a 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/api-2.json @@ -611,7 +611,8 @@ "runningTasksCount":{"shape":"Integer"}, "pendingTasksCount":{"shape":"Integer"}, "agentUpdateStatus":{"shape":"AgentUpdateStatus"}, - "attributes":{"shape":"Attributes"} + "attributes":{"shape":"Attributes"}, + "registeredAt":{"shape":"Timestamp"} } }, "ContainerInstanceStatus":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/docs-2.json index 97c8b881..ef6f9717 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/docs-2.json @@ -3,19 +3,19 @@ "service": "<p>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.</p> <p>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.</p>", "operations": { "CreateCluster": "<p>Creates a new Amazon ECS cluster. By default, your account receives a <code>default</code> cluster when you launch your first container instance. However, you can create your own cluster with a unique name with the <code>CreateCluster</code> action.</p>", - "CreateService": "<p>Runs and maintains a desired number of tasks from a specified task definition. If the number of tasks running in a service drops below <code>desiredCount</code>, Amazon ECS spawns another copy of the task in the specified cluster. To update an existing service, see <a>UpdateService</a>.</p> <p>In addition to maintaining the desired count of tasks in your service, you can optionally run your service behind a load balancer. The load balancer distributes traffic across the tasks that are associated with the service. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html\">Service Load Balancing</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p> <p>You can optionally specify a deployment configuration for your service. During a deployment (which is triggered by changing the task definition or the desired count of a service with an <a>UpdateService</a> operation), the service scheduler uses the <code>minimumHealthyPercent</code> and <code>maximumPercent</code> parameters to determine the deployment strategy.</p> <p>The <code>minimumHealthyPercent</code> represents a lower limit on the number of your service's tasks that must remain in the <code>RUNNING</code> state during a deployment, as a percentage of the <code>desiredCount</code> (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if <code>desiredCount</code> 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 <code>RUNNING</code> state. Tasks for services that use a load balancer are considered healthy if they are in the <code>RUNNING</code> 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.</p> <p>The <code>maximumPercent</code> parameter represents an upper limit on the number of your service's tasks that are allowed in the <code>RUNNING</code> or <code>PENDING</code> state during a deployment, as a percentage of the <code>desiredCount</code> (rounded down to the nearest integer). This parameter enables you to define the deployment batch size. For example, if <code>desiredCount</code> 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%.</p> <p>When the service scheduler launches new tasks, it determines task placement in your cluster using the following logic:</p> <ul> <li> <p>Determine which of the container instances in your cluster can support your service's task definition (for example, they have the required CPU, memory, ports, and container instance attributes).</p> </li> <li> <p>By default, the service scheduler attempts to balance tasks across Availability Zones in this manner (although you can choose a different placement strategy):</p> <ul> <li> <p>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, if zone A has one running service task and zones B and C each have zero, valid container instances in either zone B or C are considered optimal for placement.</p> </li> <li> <p>Place the new service task on a valid container instance in an optimal Availability Zone (based on the previous steps), favoring container instances with the fewest number of running tasks for this service.</p> </li> </ul> </li> </ul>", + "CreateService": "<p>Runs and maintains a desired number of tasks from a specified task definition. If the number of tasks running in a service drops below <code>desiredCount</code>, Amazon ECS spawns another copy of the task in the specified cluster. To update an existing service, see <a>UpdateService</a>.</p> <p>In addition to maintaining the desired count of tasks in your service, you can optionally run your service behind a load balancer. The load balancer distributes traffic across the tasks that are associated with the service. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html\">Service Load Balancing</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p> <p>You can optionally specify a deployment configuration for your service. During a deployment (which is triggered by changing the task definition or the desired count of a service with an <a>UpdateService</a> operation), the service scheduler uses the <code>minimumHealthyPercent</code> and <code>maximumPercent</code> parameters to determine the deployment strategy.</p> <p>The <code>minimumHealthyPercent</code> represents a lower limit on the number of your service's tasks that must remain in the <code>RUNNING</code> state during a deployment, as a percentage of the <code>desiredCount</code> (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if your service has a <code>desiredCount</code> of four tasks and a <code>minimumHealthyPercent</code> of 50%, the scheduler can stop two existing tasks to free up cluster capacity before starting two new tasks. Tasks for services that <i>do not</i> use a load balancer are considered healthy if they are in the <code>RUNNING</code> state. Tasks for services that <i>do</i> use a load balancer are considered healthy if they are in the <code>RUNNING</code> state and the container instance they are hosted on is reported as healthy by the load balancer. The default value for <code>minimumHealthyPercent</code> is 50% in the console and 100% for the AWS CLI, the AWS SDKs, and the APIs.</p> <p>The <code>maximumPercent</code> parameter represents an upper limit on the number of your service's tasks that are allowed in the <code>RUNNING</code> or <code>PENDING</code> state during a deployment, as a percentage of the <code>desiredCount</code> (rounded down to the nearest integer). This parameter enables you to define the deployment batch size. For example, if your service has a <code>desiredCount</code> of four tasks and a <code>maximumPercent</code> 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 <code>maximumPercent</code> is 200%.</p> <p>When the service scheduler launches new tasks, it determines task placement in your cluster using the following logic:</p> <ul> <li> <p>Determine which of the container instances in your cluster can support your service's task definition (for example, they have the required CPU, memory, ports, and container instance attributes).</p> </li> <li> <p>By default, the service scheduler attempts to balance tasks across Availability Zones in this manner (although you can choose a different placement strategy) with the <code>placementStrategy</code> parameter):</p> <ul> <li> <p>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, if zone A has one running service task and zones B and C each have zero, valid container instances in either zone B or C are considered optimal for placement.</p> </li> <li> <p>Place the new service task on a valid container instance in an optimal Availability Zone (based on the previous steps), favoring container instances with the fewest number of running tasks for this service.</p> </li> </ul> </li> </ul>", "DeleteAttributes": "<p>Deletes one or more custom attributes from an Amazon ECS resource.</p>", "DeleteCluster": "<p>Deletes the specified cluster. You must deregister all container instances from this cluster before you may delete it. You can list the container instances in a cluster with <a>ListContainerInstances</a> and deregister them with <a>DeregisterContainerInstance</a>.</p>", "DeleteService": "<p>Deletes a specified service within a cluster. You can delete a service if you have no running tasks in it and the desired task count is zero. If the service is actively maintaining tasks, you cannot delete it, and you must update the service to a desired task count of zero. For more information, see <a>UpdateService</a>.</p> <note> <p>When you delete a service, if there are still running tasks that require cleanup, the service status moves from <code>ACTIVE</code> to <code>DRAINING</code>, and the service is no longer visible in the console or in <a>ListServices</a> API operations. After the tasks have stopped, then the service status moves from <code>DRAINING</code> to <code>INACTIVE</code>. Services in the <code>DRAINING</code> or <code>INACTIVE</code> status can still be viewed with <a>DescribeServices</a> API operations; however, in the future, <code>INACTIVE</code> services may be cleaned up and purged from Amazon ECS record keeping, and <a>DescribeServices</a> API operations on those services will return a <code>ServiceNotFoundException</code> error.</p> </note>", "DeregisterContainerInstance": "<p>Deregisters an Amazon ECS container instance from the specified cluster. This instance is no longer available to run tasks.</p> <p>If you intend to use the container instance for some other purpose after deregistration, you should stop all of the tasks running on the container instance before deregistration to avoid any orphaned tasks from consuming resources.</p> <p>Deregistering a container instance removes the instance from a cluster, but it does not terminate the EC2 instance; if you are finished using the instance, be sure to terminate it in the Amazon EC2 console to stop billing.</p> <note> <p>If you terminate a running container instance, Amazon ECS automatically deregisters the instance from your cluster (stopped container instances or instances with disconnected agents are not automatically deregistered when terminated).</p> </note>", - "DeregisterTaskDefinition": "<p>Deregisters the specified task definition by family and revision. Upon deregistration, the task definition is marked as <code>INACTIVE</code>. Existing tasks and services that reference an <code>INACTIVE</code> task definition continue to run without disruption. Existing services that reference an <code>INACTIVE</code> task definition can still scale up or down by modifying the service's desired count.</p> <p>You cannot use an <code>INACTIVE</code> task definition to run new tasks or create new services, and you cannot update an existing service to reference an <code>INACTIVE</code> task definition (although there may be up to a 10 minute window following deregistration where these restrictions have not yet taken effect).</p>", + "DeregisterTaskDefinition": "<p>Deregisters the specified task definition by family and revision. Upon deregistration, the task definition is marked as <code>INACTIVE</code>. Existing tasks and services that reference an <code>INACTIVE</code> task definition continue to run without disruption. Existing services that reference an <code>INACTIVE</code> task definition can still scale up or down by modifying the service's desired count.</p> <p>You cannot use an <code>INACTIVE</code> task definition to run new tasks or create new services, and you cannot update an existing service to reference an <code>INACTIVE</code> task definition (although there may be up to a 10 minute window following deregistration where these restrictions have not yet taken effect).</p> <note> <p>At this time, <code>INACTIVE</code> task definitions remain discoverable in your account indefinitely; however, this behavior is subject to change in the future, so you should not rely on <code>INACTIVE</code> task definitions persisting beyond the life cycle of any associated tasks and services.</p> </note>", "DescribeClusters": "<p>Describes one or more of your clusters.</p>", "DescribeContainerInstances": "<p>Describes Amazon EC2 Container Service container instances. Returns metadata about registered and remaining resources on each container instance requested.</p>", "DescribeServices": "<p>Describes the specified services running in your cluster.</p>", "DescribeTaskDefinition": "<p>Describes a task definition. You can specify a <code>family</code> and <code>revision</code> to find information about a specific task definition, or you can simply specify the family to find the latest <code>ACTIVE</code> revision in that family.</p> <note> <p>You can only describe <code>INACTIVE</code> task definitions while an active task or service references them.</p> </note>", "DescribeTasks": "<p>Describes a specified task or tasks.</p>", "DiscoverPollEndpoint": "<note> <p>This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.</p> </note> <p>Returns an endpoint for the Amazon EC2 Container Service agent to poll for updates.</p>", - "ListAttributes": "<p>Lists the attributes for Amazon ECS resources within a specified target type and cluster. When you specify a target type and cluster, <code>LisAttributes</code> 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 name and value, for example, to see which container instances in a cluster are running a Linux AMI (<code>ecs.os-type=linux</code>). </p>", + "ListAttributes": "<p>Lists the attributes for Amazon ECS resources within a specified target type and cluster. When you specify a target type and cluster, <code>ListAttributes</code> 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 name and value, for example, to see which container instances in a cluster are running a Linux AMI (<code>ecs.os-type=linux</code>). </p>", "ListClusters": "<p>Returns a list of existing clusters.</p>", "ListContainerInstances": "<p>Returns a list of container instances in a specified cluster. You can filter the results of a <code>ListContainerInstances</code> operation with cluster query language statements inside the <code>filter</code> parameter. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-query-language.html\">Cluster Query Language</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p>", "ListServices": "<p>Lists the services that are running in a specified cluster.</p>", @@ -27,7 +27,7 @@ "RegisterTaskDefinition": "<p>Registers a new task definition from the supplied <code>family</code> and <code>containerDefinitions</code>. Optionally, you can add data volumes to your containers with the <code>volumes</code> parameter. For more information about task definition parameters and defaults, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html\">Amazon ECS Task Definitions</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p> <p>You can specify an IAM role for your task with the <code>taskRoleArn</code> parameter. When you specify an IAM role for a task, its containers can then use the latest versions of the AWS CLI or SDKs to make API requests to the AWS services that are specified in the IAM policy associated with the role. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html\">IAM Roles for Tasks</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p> <p>You can specify a Docker networking mode for the containers in your task definition with the <code>networkMode</code> parameter. The available network modes correspond to those described in <a href=\"https://docs.docker.com/engine/reference/run/#/network-settings\">Network settings</a> in the Docker run reference.</p>", "RunTask": "<p>Starts a new task using the specified task definition.</p> <p>You can allow Amazon ECS to place tasks for you, or you can customize how Amazon ECS places tasks using placement constraints and placement strategies. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html\">Scheduling Tasks</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p> <p>Alternatively, you can use <a>StartTask</a> to use your own scheduler or place tasks manually on specific container instances.</p>", "StartTask": "<p>Starts a new task from the specified task definition on the specified container instance or instances.</p> <p>Alternatively, you can use <a>RunTask</a> to place tasks for you. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html\">Scheduling Tasks</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p>", - "StopTask": "<p>Stops a running task.</p> <p>When <a>StopTask</a> is called on a task, the equivalent of <code>docker stop</code> is issued to the containers running in the task. This results in a <code>SIGTERM</code> and a 30-second timeout, after which <code>SIGKILL</code> is sent and the containers are forcibly stopped. If the container handles the <code>SIGTERM</code> gracefully and exits within 30 seconds from receiving it, no <code>SIGKILL</code> is sent.</p>", + "StopTask": "<p>Stops a running task.</p> <p>When <a>StopTask</a> is called on a task, the equivalent of <code>docker stop</code> is issued to the containers running in the task. This results in a <code>SIGTERM</code> and a default 30-second timeout, after which <code>SIGKILL</code> is sent and the containers are forcibly stopped. If the container handles the <code>SIGTERM</code> gracefully and exits within 30 seconds from receiving it, no <code>SIGKILL</code> is sent.</p> <note> <p>The default 30-second timeout can be configured on the Amazon ECS container agent with the <code>ECS_CONTAINER_STOP_TIMEOUT</code> variable. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html\">Amazon ECS Container Agent Configuration</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p> </note>", "SubmitContainerStateChange": "<note> <p>This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.</p> </note> <p>Sent to acknowledge that a container changed states.</p>", "SubmitTaskStateChange": "<note> <p>This action is only used by the Amazon EC2 Container Service agent, and it is not intended for use outside of the agent.</p> </note> <p>Sent to acknowledge that a task changed states.</p>", "UpdateContainerAgent": "<p>Updates the Amazon ECS container agent on a specified container instance. Updating the Amazon ECS container agent does not interrupt running tasks or services on the container instance. The process for updating the agent differs depending on whether your container instance was launched with the Amazon ECS-optimized AMI or another operating system.</p> <p> <code>UpdateContainerAgent</code> requires the Amazon ECS-optimized AMI or Amazon Linux with the <code>ecs-init</code> service installed and running. For help updating the Amazon ECS container agent on other operating systems, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html#manually_update_agent\">Manually Updating the Amazon ECS Container Agent</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p>", @@ -174,7 +174,7 @@ "ContainerInstanceStatus": { "base": null, "refs": { - "ListContainerInstancesRequest$status": "<p>The container instance status with which to filter the <code>ListContainerInstances</code> results. Specifying a container instance status of <code>DRAINING</code> limits the results to container instances that have been set to drain with the <a>UpdateContainerInstancesState</a> operation.</p>", + "ListContainerInstancesRequest$status": "<p>Filters the container instances by status. For example, if you specify the <code>DRAINING</code> status, the results include only container instances that have been set to <code>DRAINING</code> using <a>UpdateContainerInstancesState</a>. If you do not specify this parameter, the default is to include container instances set to <code>ACTIVE</code> and <code>DRAINING</code>.</p>", "UpdateContainerInstancesStateRequest$status": "<p>The container instance state with which to update the container instance.</p>" } }, @@ -375,7 +375,7 @@ "base": null, "refs": { "ContainerDefinition$environment": "<p>The environment variables to pass to a container. This parameter maps to <code>Env</code> in the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/#create-a-container\">Create a container</a> section of the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/\">Docker Remote API</a> and the <code>--env</code> option to <a href=\"https://docs.docker.com/engine/reference/run/\">docker run</a>.</p> <important> <p>We do not recommend using plain text environment variables for sensitive information, such as credential data.</p> </important>", - "ContainerOverride$environment": "<p>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.</p>" + "ContainerOverride$environment": "<p>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.</p>" } }, "Failure": { @@ -800,17 +800,17 @@ "ContainerDefinition$workingDirectory": "<p>The working directory in which to run commands inside the container. This parameter maps to <code>WorkingDir</code> in the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/#create-a-container\">Create a container</a> section of the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/\">Docker Remote API</a> and the <code>--workdir</code> option to <a href=\"https://docs.docker.com/engine/reference/run/\">docker run</a>.</p>", "ContainerInstance$containerInstanceArn": "<p>The Amazon Resource Name (ARN) of the container instance. The ARN contains the <code>arn:aws:ecs</code> namespace, followed by the region of the container instance, the AWS account ID of the container instance owner, the <code>container-instance</code> namespace, and then the container instance ID. For example, <code>arn:aws:ecs:<i>region</i>:<i>aws_account_id</i>:container-instance/<i>container_instance_ID</i> </code>.</p>", "ContainerInstance$ec2InstanceId": "<p>The EC2 instance ID of the container instance.</p>", - "ContainerInstance$status": "<p>The status of the container instance. The valid values are <code>ACTIVE</code> or <code>INACTIVE</code>. <code>ACTIVE</code> indicates that the container instance can accept tasks.</p>", - "ContainerOverride$name": "<p>The name of the container that receives the override.</p>", + "ContainerInstance$status": "<p>The status of the container instance. The valid values are <code>ACTIVE</code>, <code>INACTIVE</code>, or <code>DRAINING</code>. <code>ACTIVE</code> indicates that the container instance can accept tasks. <code>DRAINING</code> 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 <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-draining.html\">Container Instance Draining</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p>", + "ContainerOverride$name": "<p>The name of the container that receives the override. This parameter is required if a command or environment variable is specified.</p>", "CreateClusterRequest$clusterName": "<p>The name of your cluster. If you do not specify a name for your cluster, you create a cluster named <code>default</code>. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.</p>", "CreateServiceRequest$cluster": "<p>The short name or full Amazon Resource Name (ARN) of the cluster on which to run your service. If you do not specify a cluster, the default cluster is assumed.</p>", "CreateServiceRequest$serviceName": "<p>The name of your service. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. Service names must be unique within a cluster, but you can have similarly named services in multiple clusters within a region or across multiple regions.</p>", "CreateServiceRequest$taskDefinition": "<p>The <code>family</code> and <code>revision</code> (<code>family:revision</code>) or full Amazon Resource Name (ARN) of the task definition to run in your service. If a <code>revision</code> is not specified, the latest <code>ACTIVE</code> revision is used.</p>", "CreateServiceRequest$clientToken": "<p>Unique, case-sensitive identifier you provide to ensure the idempotency of the request. Up to 32 ASCII characters are allowed.</p>", "CreateServiceRequest$role": "<p>The name or full Amazon Resource Name (ARN) of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service. If you specify the <code>role</code> parameter, you must also specify a load balancer object with the <code>loadBalancers</code> parameter.</p> <p>If your specified role has a path other than <code>/</code>, then you must either specify the full role ARN (this is recommended) or prefix the role name with the path. For example, if a role with the name <code>bar</code> has a path of <code>/foo/</code> then you would specify <code>/foo/bar</code> as the role name. For more information, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names\">Friendly Names and Paths</a> in the <i>IAM User Guide</i>.</p>", - "DeleteAttributesRequest$cluster": "<p>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 cluster is assumed.</p>", + "DeleteAttributesRequest$cluster": "<p>The short name or full Amazon Resource Name (ARN) of the cluster that contains the resource to delete attributes. If you do not specify a cluster, the default cluster is assumed.</p>", "DeleteClusterRequest$cluster": "<p>The short name or full Amazon Resource Name (ARN) of the cluster to delete.</p>", - "DeleteServiceRequest$cluster": "<p>The name of the cluster that hosts the service to delete. If you do not specify a cluster, the default cluster is assumed.</p>", + "DeleteServiceRequest$cluster": "<p>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.</p>", "DeleteServiceRequest$service": "<p>The name of the service to delete.</p>", "Deployment$id": "<p>The ID of the deployment.</p>", "Deployment$status": "<p>The status of the deployment. Valid values are <code>PRIMARY</code> (for the most recent deployment), <code>ACTIVE</code> (for previous deployments that still have tasks running, but are being replaced with the <code>PRIMARY</code> deployment), and <code>INACTIVE</code> (for deployments that have been completely replaced).</p>", @@ -819,11 +819,11 @@ "DeregisterContainerInstanceRequest$containerInstance": "<p>The container instance ID or full Amazon Resource Name (ARN) of the container instance to deregister. The ARN contains the <code>arn:aws:ecs</code> namespace, followed by the region of the container instance, the AWS account ID of the container instance owner, the <code>container-instance</code> namespace, and then the container instance ID. For example, <code>arn:aws:ecs:<i>region</i>:<i>aws_account_id</i>:container-instance/<i>container_instance_ID</i> </code>.</p>", "DeregisterTaskDefinitionRequest$taskDefinition": "<p>The <code>family</code> and <code>revision</code> (<code>family:revision</code>) or full Amazon Resource Name (ARN) of the task definition to deregister. You must specify a <code>revision</code>.</p>", "DescribeContainerInstancesRequest$cluster": "<p>The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to describe. If you do not specify a cluster, the default cluster is assumed.</p>", - "DescribeServicesRequest$cluster": "<p>The name of the cluster that hosts the service to describe. If you do not specify a cluster, the default cluster is assumed.</p>", + "DescribeServicesRequest$cluster": "<p>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.</p>", "DescribeTaskDefinitionRequest$taskDefinition": "<p>The <code>family</code> for the latest <code>ACTIVE</code> revision, <code>family</code> and <code>revision</code> (<code>family:revision</code>) for a specific revision in the family, or full Amazon Resource Name (ARN) of the task definition to describe.</p>", "DescribeTasksRequest$cluster": "<p>The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task to describe. If you do not specify a cluster, the default cluster is assumed.</p>", "DiscoverPollEndpointRequest$containerInstance": "<p>The container instance ID or full Amazon Resource Name (ARN) of the container instance. The ARN contains the <code>arn:aws:ecs</code> namespace, followed by the region of the container instance, the AWS account ID of the container instance owner, the <code>container-instance</code> namespace, and then the container instance ID. For example, <code>arn:aws:ecs:<i>region</i>:<i>aws_account_id</i>:container-instance/<i>container_instance_ID</i> </code>.</p>", - "DiscoverPollEndpointRequest$cluster": "<p>The cluster that the container instance belongs to.</p>", + "DiscoverPollEndpointRequest$cluster": "<p>The short name or full Amazon Resource Name (ARN) of the cluster that the container instance belongs to.</p>", "DiscoverPollEndpointResponse$endpoint": "<p>The endpoint for the Amazon ECS agent to poll.</p>", "DiscoverPollEndpointResponse$telemetryEndpoint": "<p>The telemetry endpoint for the Amazon ECS agent.</p>", "DockerLabelsMap$key": null, @@ -863,7 +863,7 @@ "ListTasksRequest$serviceName": "<p>The name of the service with which to filter the <code>ListTasks</code> results. Specifying a <code>serviceName</code> limits the results to tasks that belong to that service.</p>", "ListTasksResponse$nextToken": "<p>The <code>nextToken</code> value to include in a future <code>ListTasks</code> request. When the results of a <code>ListTasks</code> request exceed <code>maxResults</code>, this value can be used to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.</p>", "LoadBalancer$targetGroupArn": "<p>The full Amazon Resource Name (ARN) of the Elastic Load Balancing target group associated with a service.</p>", - "LoadBalancer$loadBalancerName": "<p>The name of the load balancer.</p>", + "LoadBalancer$loadBalancerName": "<p>The name of a Classic load balancer.</p>", "LoadBalancer$containerName": "<p>The name of the container (as it appears in a container definition) to associate with the load balancer.</p>", "LogConfigurationOptionsMap$key": null, "LogConfigurationOptionsMap$value": null, @@ -937,7 +937,7 @@ "VersionInfo$agentHash": "<p>The Git commit hash for the Amazon ECS container agent build on the <a href=\"https://github.com/aws/amazon-ecs-agent/commits/master\">amazon-ecs-agent </a> GitHub repository.</p>", "VersionInfo$dockerVersion": "<p>The Docker version running on the container instance.</p>", "Volume$name": "<p>The name of the volume. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. This name is referenced in the <code>sourceVolume</code> parameter of container definition <code>mountPoints</code>.</p>", - "VolumeFrom$sourceContainer": "<p>The name of the container to mount volumes from.</p>" + "VolumeFrom$sourceContainer": "<p>The name of another container within the same task definition to mount volumes from.</p>" } }, "StringList": { @@ -949,11 +949,11 @@ "ContainerDefinition$dnsServers": "<p>A list of DNS servers that are presented to the container. This parameter maps to <code>Dns</code> in the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/#create-a-container\">Create a container</a> section of the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/\">Docker Remote API</a> and the <code>--dns</code> option to <a href=\"https://docs.docker.com/engine/reference/run/\">docker run</a>.</p>", "ContainerDefinition$dnsSearchDomains": "<p>A list of DNS search domains that are presented to the container. This parameter maps to <code>DnsSearch</code> in the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/#create-a-container\">Create a container</a> section of the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/\">Docker Remote API</a> and the <code>--dns-search</code> option to <a href=\"https://docs.docker.com/engine/reference/run/\">docker run</a>.</p>", "ContainerDefinition$dockerSecurityOptions": "<p>A list of strings to provide custom labels for SELinux and AppArmor multi-level security systems. This parameter maps to <code>SecurityOpt</code> in the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/#create-a-container\">Create a container</a> section of the <a href=\"https://docs.docker.com/engine/reference/api/docker_remote_api_v1.23/\">Docker Remote API</a> and the <code>--security-opt</code> option to <a href=\"https://docs.docker.com/engine/reference/run/\">docker run</a>.</p> <note> <p>The Amazon ECS container agent running on a container instance must register with the <code>ECS_SELINUX_CAPABLE=true</code> or <code>ECS_APPARMOR_CAPABLE=true</code> environment variables before containers placed on that instance can use these security options. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html\">Amazon ECS Container Agent Configuration</a> in the <i>Amazon EC2 Container Service Developer Guide</i>.</p> </note>", - "ContainerOverride$command": "<p>The command to send to the container that overrides the default command from the Docker image or the task definition.</p>", - "DescribeClustersRequest$clusters": "<p>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.</p>", - "DescribeContainerInstancesRequest$containerInstances": "<p>A space-separated list of container instance IDs or full Amazon Resource Name (ARN) entries.</p>", + "ContainerOverride$command": "<p>The command to send to the container that overrides the default command from the Docker image or the task definition. You must also specify a container name.</p>", + "DescribeClustersRequest$clusters": "<p>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.</p>", + "DescribeContainerInstancesRequest$containerInstances": "<p>A list of container instance IDs or full Amazon Resource Name (ARN) entries.</p>", "DescribeServicesRequest$services": "<p>A list of services to describe. You may specify up to 10 services to describe in a single operation.</p>", - "DescribeTasksRequest$tasks": "<p>A space-separated list of task IDs or full Amazon Resource Name (ARN) entries.</p>", + "DescribeTasksRequest$tasks": "<p>A list of up to 100 task IDs or full Amazon Resource Name (ARN) entries.</p>", "ListClustersResponse$clusterArns": "<p>The list of full Amazon Resource Name (ARN) entries for each cluster associated with your account.</p>", "ListContainerInstancesResponse$containerInstanceArns": "<p>The list of container instances with full Amazon Resource Name (ARN) entries for each container instance associated with the specified cluster.</p>", "ListServicesResponse$serviceArns": "<p>The list of full Amazon Resource Name (ARN) entries for each service associated with the specified cluster.</p>", @@ -962,7 +962,7 @@ "ListTasksResponse$taskArns": "<p>The list of task Amazon Resource Name (ARN) entries for the <code>ListTasks</code> request.</p>", "Resource$stringSetValue": "<p>When the <code>stringSetValue</code> type is set, the value of the resource must be a string type.</p>", "StartTaskRequest$containerInstances": "<p>The container instance IDs or full Amazon Resource Name (ARN) entries for the container instances on which you would like to place your task. You can specify up to 10 container instances.</p>", - "UpdateContainerInstancesStateRequest$containerInstances": "<p>A space-separated list of container instance IDs or full Amazon Resource Name (ARN) entries.</p>" + "UpdateContainerInstancesStateRequest$containerInstances": "<p>A list of container instance IDs or full Amazon Resource Name (ARN) entries.</p>" } }, "SubmitContainerStateChangeRequest": { @@ -1063,6 +1063,7 @@ "Timestamp": { "base": null, "refs": { + "ContainerInstance$registeredAt": "<p>The Unix timestamp for when the container instance was registered.</p>", "Deployment$createdAt": "<p>The Unix timestamp for when the service was created.</p>", "Deployment$updatedAt": "<p>The Unix timestamp for when the service was last updated.</p>", "Service$createdAt": "<p>The Unix timestamp for when the service was created.</p>", @@ -1146,7 +1147,7 @@ } }, "VolumeFrom": { - "base": "<p>Details on a data volume from another container.</p>", + "base": "<p>Details on a data volume from another container in the same task definition.</p>", "refs": { "VolumeFromList$member": null } diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/paginators-1.json index 081a2df0..46cea2a6 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/ecs/2014-11-13/paginators-1.json @@ -1,40 +1,40 @@ { - "pagination": { - "ListClusters": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "clusterArns" - }, - "ListContainerInstances": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "containerInstanceArns" - }, - "ListTaskDefinitions": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "taskDefinitionArns" - }, - "ListTaskDefinitionFamilies": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "families" - }, - "ListTasks": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "taskArns" - }, - "ListServices": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "serviceArns" - } - } -} + "pagination": { + "ListClusters": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "clusterArns" + }, + "ListContainerInstances": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "containerInstanceArns" + }, + "ListServices": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "serviceArns" + }, + "ListTaskDefinitionFamilies": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "families" + }, + "ListTaskDefinitions": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "taskDefinitionArns" + }, + "ListTasks": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "taskArns" + } + } +}
\ No newline at end of file diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/api-2.json index ec880316..5a4e9ba7 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/api-2.json @@ -1,12 +1,12 @@ { "version":"2.0", "metadata":{ - "uid":"elasticloadbalancing-2012-06-01", "apiVersion":"2012-06-01", "endpointPrefix":"elasticloadbalancing", "protocol":"query", "serviceFullName":"Elastic Load Balancing", "signatureVersion":"v4", + "uid":"elasticloadbalancing-2012-06-01", "xmlNamespace":"http://elasticloadbalancing.amazonaws.com/doc/2012-06-01/" }, "operations":{ @@ -235,6 +235,18 @@ {"shape":"InvalidEndPointException"} ] }, + "DescribeAccountLimits":{ + "name":"DescribeAccountLimits", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeAccountLimitsInput"}, + "output":{ + "shape":"DescribeAccountLimitsOutput", + "resultWrapper":"DescribeAccountLimitsResult" + } + }, "DescribeInstanceHealth":{ "name":"DescribeInstanceHealth", "http":{ @@ -863,6 +875,20 @@ "NextMarker":{"shape":"Marker"} } }, + "DescribeAccountLimitsInput":{ + "type":"structure", + "members":{ + "Marker":{"shape":"Marker"}, + "PageSize":{"shape":"PageSize"} + } + }, + "DescribeAccountLimitsOutput":{ + "type":"structure", + "members":{ + "Limits":{"shape":"Limits"}, + "NextMarker":{"shape":"Marker"} + } + }, "DescribeEndPointStateInput":{ "type":"structure", "required":["LoadBalancerName"], @@ -1124,6 +1150,17 @@ "CookieExpirationPeriod":{"shape":"CookieExpirationPeriod"} } }, + "Limit":{ + "type":"structure", + "members":{ + "Name":{"shape":"Name"}, + "Max":{"shape":"Max"} + } + }, + "Limits":{ + "type":"list", + "member":{"shape":"Limit"} + }, "Listener":{ "type":"structure", "required":[ @@ -1223,6 +1260,7 @@ }, "LoadBalancerScheme":{"type":"string"}, "Marker":{"type":"string"}, + "Max":{"type":"string"}, "ModifyLoadBalancerAttributesInput":{ "type":"structure", "required":[ @@ -1241,6 +1279,7 @@ "LoadBalancerAttributes":{"shape":"LoadBalancerAttributes"} } }, + "Name":{"type":"string"}, "PageSize":{ "type":"integer", "max":400, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/docs-2.json index 34866b0a..29953b5a 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/docs-2.json @@ -1,20 +1,21 @@ { "version": "2.0", - "service": "<fullname>Elastic Load Balancing</fullname> <p>A load balancer distributes incoming traffic across your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered instances and ensures that it routes traffic only to healthy instances. You configure your load balancer to accept incoming traffic by specifying one or more listeners, which are configured with a protocol and port number for connections from clients to the load balancer and a protocol and port number for connections from the load balancer to the instances.</p> <p>Elastic Load Balancing supports two types of load balancers: Classic load balancers and Application load balancers (new). A Classic load balancer makes routing and load balancing decisions either at the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS), and supports either EC2-Classic or a VPC. An Application load balancer makes routing and load balancing decisions at the application layer (HTTP/HTTPS), supports path-based routing, and can route requests to one or more ports on each EC2 instance or container instance in your virtual private cloud (VPC). For more information, see the .</p> <p>This reference covers the 2012-06-01 API, which supports Classic load balancers. The 2015-12-01 API supports Application load balancers.</p> <p>To get started, create a load balancer with one or more listeners using <a>CreateLoadBalancer</a>. Register your instances with the load balancer using <a>RegisterInstancesWithLoadBalancer</a>.</p> <p>All Elastic Load Balancing operations are <i>idempotent</i>, which means that they complete at most one time. If you repeat an operation, it succeeds with a 200 OK response code.</p>", + "service": "<fullname>Elastic Load Balancing</fullname> <p>A load balancer distributes incoming traffic across your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered instances and ensures that it routes traffic only to healthy instances. You configure your load balancer to accept incoming traffic by specifying one or more listeners, which are configured with a protocol and port number for connections from clients to the load balancer and a protocol and port number for connections from the load balancer to the instances.</p> <p>Elastic Load Balancing supports two types of load balancers: Classic Load Balancers and Application Load Balancers (new). A Classic Load Balancer makes routing and load balancing decisions either at the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS), and supports either EC2-Classic or a VPC. An Application Load Balancer makes routing and load balancing decisions at the application layer (HTTP/HTTPS), supports path-based routing, and can route requests to one or more ports on each EC2 instance or container instance in your virtual private cloud (VPC). For more information, see the <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/what-is-load-balancing.html\">Elastic Load Balancing User Guide</a>.</p> <p>This reference covers the 2012-06-01 API, which supports Classic Load Balancers. The 2015-12-01 API supports Application Load Balancers.</p> <p>To get started, create a load balancer with one or more listeners using <a>CreateLoadBalancer</a>. Register your instances with the load balancer using <a>RegisterInstancesWithLoadBalancer</a>.</p> <p>All Elastic Load Balancing operations are <i>idempotent</i>, which means that they complete at most one time. If you repeat an operation, it succeeds with a 200 OK response code.</p>", "operations": { - "AddTags": "<p>Adds the specified tags to the specified load balancer. Each load balancer can have a maximum of 10 tags.</p> <p>Each tag consists of a key and an optional value. If a tag with the same key is already associated with the load balancer, <code>AddTags</code> updates its value.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/add-remove-tags.html\">Tag Your Classic Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "ApplySecurityGroupsToLoadBalancer": "<p>Associates one or more security groups with your load balancer in a virtual private cloud (VPC). The specified security groups override the previously associated security groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html#elb-vpc-security-groups\">Security Groups for Load Balancers in a VPC</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "AttachLoadBalancerToSubnets": "<p>Adds one or more subnets to the set of configured subnets for the specified load balancer.</p> <p>The load balancer evenly distributes requests across all registered subnets. For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-manage-subnets.html\">Add or Remove Subnets for Your Load Balancer in a VPC</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "ConfigureHealthCheck": "<p>Specifies the health check settings to use when evaluating the health state of your EC2 instances.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-healthchecks.html\">Configure Health Checks for Your Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "CreateAppCookieStickinessPolicy": "<p>Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. This policy can be associated only with HTTP/HTTPS listeners.</p> <p>This policy is similar to the policy created by <a>CreateLBCookieStickinessPolicy</a>, except that the lifetime of the special Elastic Load Balancing cookie, <code>AWSELB</code>, follows the lifetime of the application-generated cookie specified in the policy configuration. The load balancer only inserts a new stickiness cookie when the application response includes a new application cookie.</p> <p>If the application cookie is explicitly removed or expires, the session stops being sticky until a new application cookie is issued.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-application\">Application-Controlled Session Stickiness</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "CreateLBCookieStickinessPolicy": "<p>Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. This policy can be associated only with HTTP/HTTPS listeners.</p> <p>When a load balancer implements this policy, the load balancer uses a special cookie to track the instance for each request. When the load balancer receives a request, it first checks to see if this cookie is present in the request. If so, the load balancer sends the request to the application server specified in the cookie. If not, the load balancer sends the request to a server that is chosen based on the existing load-balancing algorithm.</p> <p>A cookie is inserted into the response for binding subsequent requests from the same user to that server. The validity of the cookie is based on the cookie expiration time, which is specified in the policy configuration.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-duration\">Duration-Based Session Stickiness</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "CreateLoadBalancer": "<p>Creates a Classic load balancer.</p> <p>You can add listeners, security groups, subnets, and tags when you create your load balancer, or you can add them later using <a>CreateLoadBalancerListeners</a>, <a>ApplySecurityGroupsToLoadBalancer</a>, <a>AttachLoadBalancerToSubnets</a>, and <a>AddTags</a>.</p> <p>To describe your current load balancers, see <a>DescribeLoadBalancers</a>. When you are finished with a load balancer, you can delete it using <a>DeleteLoadBalancer</a>.</p> <p>You can create up to 20 load balancers per region per account. You can request an increase for the number of load balancers for your account. For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-limits.html\">Limits for Your Classic Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "CreateLoadBalancerListeners": "<p>Creates one or more listeners for the specified load balancer. If a listener with the specified port does not already exist, it is created; otherwise, the properties of the new listener must match the properties of the existing listener.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html\">Listeners for Your Classic Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", + "AddTags": "<p>Adds the specified tags to the specified load balancer. Each load balancer can have a maximum of 10 tags.</p> <p>Each tag consists of a key and an optional value. If a tag with the same key is already associated with the load balancer, <code>AddTags</code> updates its value.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/add-remove-tags.html\">Tag Your Classic Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "ApplySecurityGroupsToLoadBalancer": "<p>Associates one or more security groups with your load balancer in a virtual private cloud (VPC). The specified security groups override the previously associated security groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html#elb-vpc-security-groups\">Security Groups for Load Balancers in a VPC</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "AttachLoadBalancerToSubnets": "<p>Adds one or more subnets to the set of configured subnets for the specified load balancer.</p> <p>The load balancer evenly distributes requests across all registered subnets. For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-manage-subnets.html\">Add or Remove Subnets for Your Load Balancer in a VPC</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "ConfigureHealthCheck": "<p>Specifies the health check settings to use when evaluating the health state of your EC2 instances.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-healthchecks.html\">Configure Health Checks for Your Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "CreateAppCookieStickinessPolicy": "<p>Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. This policy can be associated only with HTTP/HTTPS listeners.</p> <p>This policy is similar to the policy created by <a>CreateLBCookieStickinessPolicy</a>, except that the lifetime of the special Elastic Load Balancing cookie, <code>AWSELB</code>, follows the lifetime of the application-generated cookie specified in the policy configuration. The load balancer only inserts a new stickiness cookie when the application response includes a new application cookie.</p> <p>If the application cookie is explicitly removed or expires, the session stops being sticky until a new application cookie is issued.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-application\">Application-Controlled Session Stickiness</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "CreateLBCookieStickinessPolicy": "<p>Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. This policy can be associated only with HTTP/HTTPS listeners.</p> <p>When a load balancer implements this policy, the load balancer uses a special cookie to track the instance for each request. When the load balancer receives a request, it first checks to see if this cookie is present in the request. If so, the load balancer sends the request to the application server specified in the cookie. If not, the load balancer sends the request to a server that is chosen based on the existing load-balancing algorithm.</p> <p>A cookie is inserted into the response for binding subsequent requests from the same user to that server. The validity of the cookie is based on the cookie expiration time, which is specified in the policy configuration.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-duration\">Duration-Based Session Stickiness</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "CreateLoadBalancer": "<p>Creates a Classic Load Balancer.</p> <p>You can add listeners, security groups, subnets, and tags when you create your load balancer, or you can add them later using <a>CreateLoadBalancerListeners</a>, <a>ApplySecurityGroupsToLoadBalancer</a>, <a>AttachLoadBalancerToSubnets</a>, and <a>AddTags</a>.</p> <p>To describe your current load balancers, see <a>DescribeLoadBalancers</a>. When you are finished with a load balancer, you can delete it using <a>DeleteLoadBalancer</a>.</p> <p>You can create up to 20 load balancers per region per account. You can request an increase for the number of load balancers for your account. For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-limits.html\">Limits for Your Classic Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "CreateLoadBalancerListeners": "<p>Creates one or more listeners for the specified load balancer. If a listener with the specified port does not already exist, it is created; otherwise, the properties of the new listener must match the properties of the existing listener.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html\">Listeners for Your Classic Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", "CreateLoadBalancerPolicy": "<p>Creates a policy with the specified attributes for the specified load balancer.</p> <p>Policies are settings that are saved for your load balancer and that can be applied to the listener or the application server, depending on the policy type.</p>", "DeleteLoadBalancer": "<p>Deletes the specified load balancer.</p> <p>If you are attempting to recreate a load balancer, you must reconfigure all settings. The DNS name associated with a deleted load balancer are no longer usable. The name and associated DNS record of the deleted load balancer no longer exist and traffic sent to any of its IP addresses is no longer delivered to your instances.</p> <p>If the load balancer does not exist or has already been deleted, the call to <code>DeleteLoadBalancer</code> still succeeds.</p>", "DeleteLoadBalancerListeners": "<p>Deletes the specified listeners from the specified load balancer.</p>", "DeleteLoadBalancerPolicy": "<p>Deletes the specified policy from the specified load balancer. This policy must not be enabled for any listeners.</p>", - "DeregisterInstancesFromLoadBalancer": "<p>Deregisters the specified instances from the specified load balancer. After the instance is deregistered, it no longer receives traffic from the load balancer.</p> <p>You can use <a>DescribeLoadBalancers</a> to verify that the instance is deregistered from the load balancer.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-deregister-register-instances.html\">Register or De-Register EC2 Instances</a> in the <i>Classic Load Balancers Guide</i>.</p>", + "DeregisterInstancesFromLoadBalancer": "<p>Deregisters the specified instances from the specified load balancer. After the instance is deregistered, it no longer receives traffic from the load balancer.</p> <p>You can use <a>DescribeLoadBalancers</a> to verify that the instance is deregistered from the load balancer.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-deregister-register-instances.html\">Register or De-Register EC2 Instances</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "DescribeAccountLimits": "<p>Describes the current Elastic Load Balancing resource limits for your AWS account.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-limits.html\">Limits for Your Classic Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", "DescribeInstanceHealth": "<p>Describes the state of the specified instances with respect to the specified load balancer. If no instances are specified, the call describes the state of all instances that are currently registered with the load balancer. If instances are specified, their state is returned even if they are no longer registered with the load balancer. The state of terminated instances is not returned.</p>", "DescribeLoadBalancerAttributes": "<p>Describes the attributes for the specified load balancer.</p>", "DescribeLoadBalancerPolicies": "<p>Describes the specified policies.</p> <p>If you specify a load balancer name, the action returns the descriptions of all policies created for the load balancer. If you specify a policy name associated with your load balancer, the action returns the description of that policy. If you don't specify a load balancer name, the action returns descriptions of the specified sample policies, or descriptions of all sample policies. The names of the sample policies have the <code>ELBSample-</code> prefix.</p>", @@ -22,20 +23,20 @@ "DescribeLoadBalancers": "<p>Describes the specified the load balancers. If no load balancers are specified, the call describes all of your load balancers.</p>", "DescribeTags": "<p>Describes the tags associated with the specified load balancers.</p>", "DetachLoadBalancerFromSubnets": "<p>Removes the specified subnets from the set of configured subnets for the load balancer.</p> <p>After a subnet is removed, all EC2 instances registered with the load balancer in the removed subnet go into the <code>OutOfService</code> state. Then, the load balancer balances the traffic among the remaining routable subnets.</p>", - "DisableAvailabilityZonesForLoadBalancer": "<p>Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer.</p> <p>There must be at least one Availability Zone registered with a load balancer at all times. After an Availability Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go into the <code>OutOfService</code> state. Then, the load balancer attempts to equally balance the traffic among its remaining Availability Zones.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html\">Add or Remove Availability Zones</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "EnableAvailabilityZonesForLoadBalancer": "<p>Adds the specified Availability Zones to the set of Availability Zones for the specified load balancer.</p> <p>The load balancer evenly distributes requests across all its registered Availability Zones that contain instances.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html\">Add or Remove Availability Zones</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "ModifyLoadBalancerAttributes": "<p>Modifies the attributes of the specified load balancer.</p> <p>You can modify the load balancer attributes, such as <code>AccessLogs</code>, <code>ConnectionDraining</code>, and <code>CrossZoneLoadBalancing</code> by either enabling or disabling them. Or, you can modify the load balancer attribute <code>ConnectionSettings</code> by specifying an idle connection timeout value for your load balancer.</p> <p>For more information, see the following in the <i>Classic Load Balancers Guide</i>:</p> <ul> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html\">Cross-Zone Load Balancing</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html\">Connection Draining</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/access-log-collection.html\">Access Logs</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html\">Idle Connection Timeout</a> </p> </li> </ul>", - "RegisterInstancesWithLoadBalancer": "<p>Adds the specified instances to the specified load balancer.</p> <p>The instance must be a running instance in the same network as the load balancer (EC2-Classic or the same VPC). If you have EC2-Classic instances and a load balancer in a VPC with ClassicLink enabled, you can link the EC2-Classic instances to that VPC and then register the linked EC2-Classic instances with the load balancer in the VPC.</p> <p>Note that <code>RegisterInstanceWithLoadBalancer</code> completes when the request has been registered. Instance registration takes a little time to complete. To check the state of the registered instances, use <a>DescribeLoadBalancers</a> or <a>DescribeInstanceHealth</a>.</p> <p>After the instance is registered, it starts receiving traffic and requests from the load balancer. Any instance that is not in one of the Availability Zones registered for the load balancer is moved to the <code>OutOfService</code> state. If an Availability Zone is added to the load balancer later, any instances registered with the load balancer move to the <code>InService</code> state.</p> <p>To deregister instances from a load balancer, use <a>DeregisterInstancesFromLoadBalancer</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-deregister-register-instances.html\">Register or De-Register EC2 Instances</a> in the <i>Classic Load Balancers Guide</i>.</p>", + "DisableAvailabilityZonesForLoadBalancer": "<p>Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer.</p> <p>There must be at least one Availability Zone registered with a load balancer at all times. After an Availability Zone is removed, all instances registered with the load balancer that are in the removed Availability Zone go into the <code>OutOfService</code> state. Then, the load balancer attempts to equally balance the traffic among its remaining Availability Zones.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html\">Add or Remove Availability Zones</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "EnableAvailabilityZonesForLoadBalancer": "<p>Adds the specified Availability Zones to the set of Availability Zones for the specified load balancer.</p> <p>The load balancer evenly distributes requests across all its registered Availability Zones that contain instances.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html\">Add or Remove Availability Zones</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "ModifyLoadBalancerAttributes": "<p>Modifies the attributes of the specified load balancer.</p> <p>You can modify the load balancer attributes, such as <code>AccessLogs</code>, <code>ConnectionDraining</code>, and <code>CrossZoneLoadBalancing</code> by either enabling or disabling them. Or, you can modify the load balancer attribute <code>ConnectionSettings</code> by specifying an idle connection timeout value for your load balancer.</p> <p>For more information, see the following in the <i>Classic Load Balancer Guide</i>:</p> <ul> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html\">Cross-Zone Load Balancing</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html\">Connection Draining</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/access-log-collection.html\">Access Logs</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html\">Idle Connection Timeout</a> </p> </li> </ul>", + "RegisterInstancesWithLoadBalancer": "<p>Adds the specified instances to the specified load balancer.</p> <p>The instance must be a running instance in the same network as the load balancer (EC2-Classic or the same VPC). If you have EC2-Classic instances and a load balancer in a VPC with ClassicLink enabled, you can link the EC2-Classic instances to that VPC and then register the linked EC2-Classic instances with the load balancer in the VPC.</p> <p>Note that <code>RegisterInstanceWithLoadBalancer</code> completes when the request has been registered. Instance registration takes a little time to complete. To check the state of the registered instances, use <a>DescribeLoadBalancers</a> or <a>DescribeInstanceHealth</a>.</p> <p>After the instance is registered, it starts receiving traffic and requests from the load balancer. Any instance that is not in one of the Availability Zones registered for the load balancer is moved to the <code>OutOfService</code> state. If an Availability Zone is added to the load balancer later, any instances registered with the load balancer move to the <code>InService</code> state.</p> <p>To deregister instances from a load balancer, use <a>DeregisterInstancesFromLoadBalancer</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-deregister-register-instances.html\">Register or De-Register EC2 Instances</a> in the <i>Classic Load Balancer Guide</i>.</p>", "RemoveTags": "<p>Removes one or more tags from the specified load balancer.</p>", - "SetLoadBalancerListenerSSLCertificate": "<p>Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces any prior certificate that was used on the same load balancer and port.</p> <p>For more information about updating your SSL certificate, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-update-ssl-cert.html\">Replace the SSL Certificate for Your Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "SetLoadBalancerPoliciesForBackendServer": "<p>Replaces the set of policies associated with the specified port on which the EC2 instance is listening with a new set of policies. At this time, only the back-end server authentication policy type can be applied to the instance ports; this policy type is composed of multiple public key policies.</p> <p>Each time you use <code>SetLoadBalancerPoliciesForBackendServer</code> to enable the policies, use the <code>PolicyNames</code> parameter to list the policies that you want to enable.</p> <p>You can use <a>DescribeLoadBalancers</a> or <a>DescribeLoadBalancerPolicies</a> to verify that the policy is associated with the EC2 instance.</p> <p>For more information about enabling back-end instance authentication, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-create-https-ssl-load-balancer.html#configure_backendauth_clt\">Configure Back-end Instance Authentication</a> in the <i>Classic Load Balancers Guide</i>. For more information about Proxy Protocol, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-proxy-protocol.html\">Configure Proxy Protocol Support</a> in the <i>Classic Load Balancers Guide</i>.</p>", - "SetLoadBalancerPoliciesOfListener": "<p>Replaces the current set of policies for the specified load balancer port with the specified set of policies.</p> <p>To enable back-end server authentication, use <a>SetLoadBalancerPoliciesForBackendServer</a>.</p> <p>For more information about setting policies, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/ssl-config-update.html\">Update the SSL Negotiation Configuration</a>, <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-duration\">Duration-Based Session Stickiness</a>, and <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-application\">Application-Controlled Session Stickiness</a> in the <i>Classic Load Balancers Guide</i>.</p>" + "SetLoadBalancerListenerSSLCertificate": "<p>Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces any prior certificate that was used on the same load balancer and port.</p> <p>For more information about updating your SSL certificate, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-update-ssl-cert.html\">Replace the SSL Certificate for Your Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "SetLoadBalancerPoliciesForBackendServer": "<p>Replaces the set of policies associated with the specified port on which the EC2 instance is listening with a new set of policies. At this time, only the back-end server authentication policy type can be applied to the instance ports; this policy type is composed of multiple public key policies.</p> <p>Each time you use <code>SetLoadBalancerPoliciesForBackendServer</code> to enable the policies, use the <code>PolicyNames</code> parameter to list the policies that you want to enable.</p> <p>You can use <a>DescribeLoadBalancers</a> or <a>DescribeLoadBalancerPolicies</a> to verify that the policy is associated with the EC2 instance.</p> <p>For more information about enabling back-end instance authentication, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-create-https-ssl-load-balancer.html#configure_backendauth_clt\">Configure Back-end Instance Authentication</a> in the <i>Classic Load Balancer Guide</i>. For more information about Proxy Protocol, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-proxy-protocol.html\">Configure Proxy Protocol Support</a> in the <i>Classic Load Balancer Guide</i>.</p>", + "SetLoadBalancerPoliciesOfListener": "<p>Replaces the current set of policies for the specified load balancer port with the specified set of policies.</p> <p>To enable back-end server authentication, use <a>SetLoadBalancerPoliciesForBackendServer</a>.</p> <p>For more information about setting policies, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/ssl-config-update.html\">Update the SSL Negotiation Configuration</a>, <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-duration\">Duration-Based Session Stickiness</a>, and <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-application\">Application-Controlled Session Stickiness</a> in the <i>Classic Load Balancer Guide</i>.</p>" }, "shapes": { "AccessLog": { "base": "<p>Information about the <code>AccessLog</code> attribute.</p>", "refs": { - "LoadBalancerAttributes$AccessLog": "<p>If enabled, the load balancer captures detailed information of all requests and delivers the information to the Amazon S3 bucket that you specify.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-access-logs.html\">Enable Access Logs</a> in the <i>Classic Load Balancers Guide</i>.</p>" + "LoadBalancerAttributes$AccessLog": "<p>If enabled, the load balancer captures detailed information of all requests and delivers the information to the Amazon S3 bucket that you specify.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-access-logs.html\">Enable Access Logs</a> in the <i>Classic Load Balancer Guide</i>.</p>" } }, "AccessLogEnabled": { @@ -253,7 +254,7 @@ "ConnectionDraining": { "base": "<p>Information about the <code>ConnectionDraining</code> attribute.</p>", "refs": { - "LoadBalancerAttributes$ConnectionDraining": "<p>If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html\">Configure Connection Draining</a> in the <i>Classic Load Balancers Guide</i>.</p>" + "LoadBalancerAttributes$ConnectionDraining": "<p>If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html\">Configure Connection Draining</a> in the <i>Classic Load Balancer Guide</i>.</p>" } }, "ConnectionDrainingEnabled": { @@ -271,7 +272,7 @@ "ConnectionSettings": { "base": "<p>Information about the <code>ConnectionSettings</code> attribute.</p>", "refs": { - "LoadBalancerAttributes$ConnectionSettings": "<p>If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.</p> <p>By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html\">Configure Idle Connection Timeout</a> in the <i>Classic Load Balancers Guide</i>.</p>" + "LoadBalancerAttributes$ConnectionSettings": "<p>If enabled, the load balancer allows the connections to remain idle (no data is sent over the connection) for the specified duration.</p> <p>By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html\">Configure Idle Connection Timeout</a> in the <i>Classic Load Balancer Guide</i>.</p>" } }, "CookieExpirationPeriod": { @@ -347,7 +348,7 @@ "CrossZoneLoadBalancing": { "base": "<p>Information about the <code>CrossZoneLoadBalancing</code> attribute.</p>", "refs": { - "LoadBalancerAttributes$CrossZoneLoadBalancing": "<p>If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html\">Configure Cross-Zone Load Balancing</a> in the <i>Classic Load Balancers Guide</i>.</p>" + "LoadBalancerAttributes$CrossZoneLoadBalancing": "<p>If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html\">Configure Cross-Zone Load Balancing</a> in the <i>Classic Load Balancer Guide</i>.</p>" } }, "CrossZoneLoadBalancingEnabled": { @@ -361,7 +362,7 @@ "refs": { "CreateAccessPointOutput$DNSName": "<p>The DNS name of the load balancer.</p>", "LoadBalancerDescription$DNSName": "<p>The DNS name of the load balancer.</p>", - "LoadBalancerDescription$CanonicalHostedZoneName": "<p>The DNS name of the load balancer.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/using-domain-names-with-elb.html\">Configure a Custom Domain Name</a> in the <i>Classic Load Balancers Guide</i>.</p>", + "LoadBalancerDescription$CanonicalHostedZoneName": "<p>The DNS name of the load balancer.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/using-domain-names-with-elb.html\">Configure a Custom Domain Name</a> in the <i>Classic Load Balancer Guide</i>.</p>", "LoadBalancerDescription$CanonicalHostedZoneNameID": "<p>The ID of the Amazon Route 53 hosted zone for the load balancer.</p>" } }, @@ -426,6 +427,16 @@ "refs": { } }, + "DescribeAccountLimitsInput": { + "base": null, + "refs": { + } + }, + "DescribeAccountLimitsOutput": { + "base": null, + "refs": { + } + }, "DescribeEndPointStateInput": { "base": "<p>Contains the parameters for DescribeInstanceHealth.</p>", "refs": { @@ -638,10 +649,22 @@ "LBCookieStickinessPolicies$member": null } }, + "Limit": { + "base": "<p>Information about an Elastic Load Balancing resource limit for your AWS account.</p>", + "refs": { + "Limits$member": null + } + }, + "Limits": { + "base": null, + "refs": { + "DescribeAccountLimitsOutput$Limits": "<p>Information about the limits.</p>" + } + }, "Listener": { - "base": "<p>Information about a listener.</p> <p>For information about the protocols and the ports supported by Elastic Load Balancing, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html\">Listeners for Your Classic Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", + "base": "<p>Information about a listener.</p> <p>For information about the protocols and the ports supported by Elastic Load Balancing, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html\">Listeners for Your Classic Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", "refs": { - "ListenerDescription$Listener": null, + "ListenerDescription$Listener": "<p>The listener.</p>", "Listeners$member": null } }, @@ -665,7 +688,7 @@ "Listeners": { "base": null, "refs": { - "CreateAccessPointInput$Listeners": "<p>The listeners.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html\">Listeners for Your Classic Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", + "CreateAccessPointInput$Listeners": "<p>The listeners.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html\">Listeners for Your Classic Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", "CreateLoadBalancerListenerInput$Listeners": "<p>The listeners.</p>" } }, @@ -678,8 +701,8 @@ "base": "<p>The attributes for a load balancer.</p>", "refs": { "DescribeLoadBalancerAttributesOutput$LoadBalancerAttributes": "<p>Information about the load balancer attributes.</p>", - "ModifyLoadBalancerAttributesInput$LoadBalancerAttributes": "<p>The attributes of the load balancer.</p>", - "ModifyLoadBalancerAttributesOutput$LoadBalancerAttributes": null + "ModifyLoadBalancerAttributesInput$LoadBalancerAttributes": "<p>The attributes for the load balancer.</p>", + "ModifyLoadBalancerAttributesOutput$LoadBalancerAttributes": "<p>Information about the load balancer attributes.</p>" } }, "LoadBalancerDescription": { @@ -719,7 +742,15 @@ "base": null, "refs": { "DescribeAccessPointsInput$Marker": "<p>The marker for the next set of results. (You received this marker from a previous call.)</p>", - "DescribeAccessPointsOutput$NextMarker": "<p>The marker to use when requesting the next set of results. If there are no additional results, the string is empty.</p>" + "DescribeAccessPointsOutput$NextMarker": "<p>The marker to use when requesting the next set of results. If there are no additional results, the string is empty.</p>", + "DescribeAccountLimitsInput$Marker": "<p>The marker for the next set of results. (You received this marker from a previous call.)</p>", + "DescribeAccountLimitsOutput$NextMarker": "<p>The marker to use when requesting the next set of results. If there are no additional results, the string is empty.</p>" + } + }, + "Max": { + "base": null, + "refs": { + "Limit$Max": "<p>The maximum value of the limit.</p>" } }, "ModifyLoadBalancerAttributesInput": { @@ -732,10 +763,17 @@ "refs": { } }, + "Name": { + "base": null, + "refs": { + "Limit$Name": "<p>The name of the limit. The possible values are:</p> <ul> <li> <p>classic-listeners</p> </li> <li> <p>classic-load-balancers</p> </li> </ul>" + } + }, "PageSize": { "base": null, "refs": { - "DescribeAccessPointsInput$PageSize": "<p>The maximum number of results to return with this call (a number from 1 to 400). The default is 400.</p>" + "DescribeAccessPointsInput$PageSize": "<p>The maximum number of results to return with this call (a number from 1 to 400). The default is 400.</p>", + "DescribeAccountLimitsInput$PageSize": "<p>The maximum number of results to return with this call.</p>" } }, "Policies": { @@ -1047,7 +1085,7 @@ "base": null, "refs": { "AddTagsInput$Tags": "<p>The tags.</p>", - "CreateAccessPointInput$Tags": "<p>A list of tags to assign to the load balancer.</p> <p>For more information about tagging your load balancer, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/add-remove-tags.html\">Tag Your Classic Load Balancer</a> in the <i>Classic Load Balancers Guide</i>.</p>", + "CreateAccessPointInput$Tags": "<p>A list of tags to assign to the load balancer.</p> <p>For more information about tagging your load balancer, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/add-remove-tags.html\">Tag Your Classic Load Balancer</a> in the <i>Classic Load Balancer Guide</i>.</p>", "TagDescription$Tags": "<p>The tags.</p>" } }, @@ -1079,7 +1117,7 @@ } }, "UnsupportedProtocolException": { - "base": null, + "base": "<p>The specified protocol or signature version is not supported.</p>", "refs": { } }, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/paginators-1.json index 82113a70..85742cce 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancing/2012-06-01/paginators-1.json @@ -15,4 +15,4 @@ "result_key": "LoadBalancerDescriptions" } } -} +}
\ No newline at end of file diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/api-2.json index b2612fb2..a062dbe3 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/api-2.json @@ -194,6 +194,18 @@ {"shape":"InvalidTargetException"} ] }, + "DescribeAccountLimits":{ + "name":"DescribeAccountLimits", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeAccountLimitsInput"}, + "output":{ + "shape":"DescribeAccountLimitsOutput", + "resultWrapper":"DescribeAccountLimitsResult" + } + }, "DescribeListeners":{ "name":"DescribeListeners", "http":{ @@ -781,6 +793,20 @@ "members":{ } }, + "DescribeAccountLimitsInput":{ + "type":"structure", + "members":{ + "Marker":{"shape":"Marker"}, + "PageSize":{"shape":"PageSize"} + } + }, + "DescribeAccountLimitsOutput":{ + "type":"structure", + "members":{ + "Limits":{"shape":"Limits"}, + "NextMarker":{"shape":"Marker"} + } + }, "DescribeListenersInput":{ "type":"structure", "members":{ @@ -1057,6 +1083,17 @@ ] }, "IsDefault":{"type":"boolean"}, + "Limit":{ + "type":"structure", + "members":{ + "Name":{"shape":"Name"}, + "Max":{"shape":"Max"} + } + }, + "Limits":{ + "type":"list", + "member":{"shape":"Limit"} + }, "ListOfString":{ "type":"list", "member":{"shape":"StringValue"} @@ -1190,6 +1227,7 @@ "HttpCode":{"shape":"HttpCode"} } }, + "Max":{"type":"string"}, "ModifyListenerInput":{ "type":"structure", "required":["ListenerArn"], @@ -1278,6 +1316,7 @@ "TargetGroups":{"shape":"TargetGroups"} } }, + "Name":{"type":"string"}, "OperationNotPermittedException":{ "type":"structure", "members":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/docs-2.json index d0bfdbff..0f771841 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/elasticloadbalancingv2/2015-12-01/docs-2.json @@ -12,6 +12,7 @@ "DeleteRule": "<p>Deletes the specified rule.</p>", "DeleteTargetGroup": "<p>Deletes the specified target group.</p> <p>You can delete a target group if it is not referenced by any actions. Deleting a target group also deletes any associated health checks.</p>", "DeregisterTargets": "<p>Deregisters the specified targets from the specified target group. After the targets are deregistered, they no longer receive traffic from the load balancer.</p>", + "DescribeAccountLimits": "<p>Describes the current Elastic Load Balancing resource limits for your AWS account.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-limits.html\">Limits for Your Application Load Balancer</a> in the <i>Application Load Balancer Guide</i>.</p>", "DescribeListeners": "<p>Describes the specified listeners or the listeners for the specified Application Load Balancer. You must specify either a load balancer or one or more listeners.</p>", "DescribeLoadBalancerAttributes": "<p>Describes the attributes for the specified Application Load Balancer.</p>", "DescribeLoadBalancers": "<p>Describes the specified Application Load Balancers or all of your Application Load Balancers.</p> <p>To describe the listeners for a load balancer, use <a>DescribeListeners</a>. To describe the attributes for a load balancer, use <a>DescribeLoadBalancerAttributes</a>.</p>", @@ -243,6 +244,16 @@ "refs": { } }, + "DescribeAccountLimitsInput": { + "base": null, + "refs": { + } + }, + "DescribeAccountLimitsOutput": { + "base": null, + "refs": { + } + }, "DescribeListenersInput": { "base": null, "refs": { @@ -451,6 +462,18 @@ "Rule$IsDefault": "<p>Indicates whether this is the default rule.</p>" } }, + "Limit": { + "base": "<p>Information about an Elastic Load Balancing resource limit for your AWS account.</p>", + "refs": { + "Limits$member": null + } + }, + "Limits": { + "base": null, + "refs": { + "DescribeAccountLimitsOutput$Limits": "<p>Information about the limits.</p>" + } + }, "ListOfString": { "base": null, "refs": { @@ -603,6 +626,8 @@ "Marker": { "base": null, "refs": { + "DescribeAccountLimitsInput$Marker": "<p>The marker for the next set of results. (You received this marker from a previous call.)</p>", + "DescribeAccountLimitsOutput$NextMarker": "<p>The marker to use when requesting the next set of results. If there are no additional results, the string is empty.</p>", "DescribeListenersInput$Marker": "<p>The marker for the next set of results. (You received this marker from a previous call.)</p>", "DescribeListenersOutput$NextMarker": "<p>The marker to use when requesting the next set of results. If there are no additional results, the string is empty.</p>", "DescribeLoadBalancersInput$Marker": "<p>The marker for the next set of results. (You received this marker from a previous call.)</p>", @@ -621,6 +646,12 @@ "TargetGroup$Matcher": "<p>The HTTP codes to use when checking for a successful response from a target.</p>" } }, + "Max": { + "base": null, + "refs": { + "Limit$Max": "<p>The maximum value of the limit.</p>" + } + }, "ModifyListenerInput": { "base": null, "refs": { @@ -671,6 +702,12 @@ "refs": { } }, + "Name": { + "base": null, + "refs": { + "Limit$Name": "<p>The name of the limit. The possible values are:</p> <ul> <li> <p>application-load-balancers</p> </li> <li> <p>listeners-per-application-load-balancer</p> </li> <li> <p>rules-per-application-load-balancer</p> </li> <li> <p>target-groups</p> </li> <li> <p>targets-per-application-load-balancer</p> </li> </ul>" + } + }, "OperationNotPermittedException": { "base": "<p>This operation is not allowed.</p>", "refs": { @@ -679,6 +716,7 @@ "PageSize": { "base": null, "refs": { + "DescribeAccountLimitsInput$PageSize": "<p>The maximum number of results to return with this call.</p>", "DescribeListenersInput$PageSize": "<p>The maximum number of results to return with this call.</p>", "DescribeLoadBalancersInput$PageSize": "<p>The maximum number of results to return with this call.</p>", "DescribeSSLPoliciesInput$PageSize": "<p>The maximum number of results to return with this call.</p>", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/api-2.json new file mode 100644 index 00000000..bf13c175 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/api-2.json @@ -0,0 +1,128 @@ +{ + "version":"2.0", + "metadata":{ + "apiVersion":"2017-01-11", + "endpointPrefix":"entitlement.marketplace", + "jsonVersion":"1.1", + "protocol":"json", + "serviceFullName":"AWS Marketplace Entitlement Service", + "signatureVersion":"v4", + "signingName":"aws-marketplace", + "targetPrefix":"AWSMPEntitlementService", + "uid":"entitlement.marketplace-2017-01-11" + }, + "operations":{ + "GetEntitlements":{ + "name":"GetEntitlements", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetEntitlementsRequest"}, + "output":{"shape":"GetEntitlementsResult"}, + "errors":[ + {"shape":"InvalidParameterException"}, + {"shape":"ThrottlingException"}, + {"shape":"InternalServiceErrorException"} + ] + } + }, + "shapes":{ + "Boolean":{"type":"boolean"}, + "Double":{"type":"double"}, + "Entitlement":{ + "type":"structure", + "members":{ + "ProductCode":{"shape":"ProductCode"}, + "Dimension":{"shape":"NonEmptyString"}, + "CustomerIdentifier":{"shape":"NonEmptyString"}, + "Value":{"shape":"EntitlementValue"}, + "ExpirationDate":{"shape":"Timestamp"} + } + }, + "EntitlementList":{ + "type":"list", + "member":{"shape":"Entitlement"}, + "min":0 + }, + "EntitlementValue":{ + "type":"structure", + "members":{ + "IntegerValue":{"shape":"Integer"}, + "DoubleValue":{"shape":"Double"}, + "BooleanValue":{"shape":"Boolean"}, + "StringValue":{"shape":"String"} + } + }, + "ErrorMessage":{"type":"string"}, + "FilterValue":{"type":"string"}, + "FilterValueList":{ + "type":"list", + "member":{"shape":"FilterValue"}, + "min":1 + }, + "GetEntitlementFilterName":{ + "type":"string", + "enum":[ + "CUSTOMER_IDENTIFIER", + "DIMENSION" + ] + }, + "GetEntitlementFilters":{ + "type":"map", + "key":{"shape":"GetEntitlementFilterName"}, + "value":{"shape":"FilterValueList"} + }, + "GetEntitlementsRequest":{ + "type":"structure", + "required":["ProductCode"], + "members":{ + "ProductCode":{"shape":"ProductCode"}, + "Filter":{"shape":"GetEntitlementFilters"}, + "NextToken":{"shape":"NonEmptyString"}, + "MaxResults":{"shape":"Integer"} + } + }, + "GetEntitlementsResult":{ + "type":"structure", + "members":{ + "Entitlements":{"shape":"EntitlementList"}, + "NextToken":{"shape":"NonEmptyString"} + } + }, + "Integer":{"type":"integer"}, + "InternalServiceErrorException":{ + "type":"structure", + "members":{ + "message":{"shape":"ErrorMessage"} + }, + "exception":true, + "fault":true + }, + "InvalidParameterException":{ + "type":"structure", + "members":{ + "message":{"shape":"ErrorMessage"} + }, + "exception":true + }, + "NonEmptyString":{ + "type":"string", + "pattern":"\\S+" + }, + "ProductCode":{ + "type":"string", + "max":255, + "min":1 + }, + "String":{"type":"string"}, + "ThrottlingException":{ + "type":"structure", + "members":{ + "message":{"shape":"ErrorMessage"} + }, + "exception":true + }, + "Timestamp":{"type":"timestamp"} + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/docs-2.json new file mode 100644 index 00000000..8edbaf96 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/docs-2.json @@ -0,0 +1,131 @@ +{ + "version": "2.0", + "service": "<fullname>AWS Marketplace Entitlement Service</fullname> <p>This reference provides descriptions of the AWS Marketplace Entitlement Service API.</p> <p>AWS Marketplace Entitlement Service is used to determine the entitlement of a customer to a given product. An entitlement represents capacity in a product owned by the customer. For example, a customer might own some number of users or seats in an SaaS application or some amount of data capacity in a multi-tenant database.</p> <p> <b>Getting Entitlement Records</b> </p> <ul> <li> <p> <i>GetEntitlements</i>- Gets the entitlements for a Marketplace product.</p> </li> </ul>", + "operations": { + "GetEntitlements": "<p>GetEntitlements retrieves entitlement values for a given product. The results can be filtered based on customer identifier or product dimensions.</p>" + }, + "shapes": { + "Boolean": { + "base": null, + "refs": { + "EntitlementValue$BooleanValue": "<p>The BooleanValue field will be populated with a boolean value when the entitlement is a boolean type. Otherwise, the field will not be set.</p>" + } + }, + "Double": { + "base": null, + "refs": { + "EntitlementValue$DoubleValue": "<p>The DoubleValue field will be populated with a double value when the entitlement is a double type. Otherwise, the field will not be set.</p>" + } + }, + "Entitlement": { + "base": "<p>An entitlement represents capacity in a product owned by the customer. For example, a customer might own some number of users or seats in an SaaS application or some amount of data capacity in a multi-tenant database.</p>", + "refs": { + "EntitlementList$member": null + } + }, + "EntitlementList": { + "base": null, + "refs": { + "GetEntitlementsResult$Entitlements": "<p>The set of entitlements found through the GetEntitlements operation. If the result contains an empty set of entitlements, NextToken might still be present and should be used.</p>" + } + }, + "EntitlementValue": { + "base": "<p>The EntitlementValue represents the amount of capacity that the customer is entitled to for the product.</p>", + "refs": { + "Entitlement$Value": "<p>The EntitlementValue represents the amount of capacity that the customer is entitled to for the product.</p>" + } + }, + "ErrorMessage": { + "base": null, + "refs": { + "InternalServiceErrorException$message": null, + "InvalidParameterException$message": null, + "ThrottlingException$message": null + } + }, + "FilterValue": { + "base": null, + "refs": { + "FilterValueList$member": null + } + }, + "FilterValueList": { + "base": null, + "refs": { + "GetEntitlementFilters$value": null + } + }, + "GetEntitlementFilterName": { + "base": null, + "refs": { + "GetEntitlementFilters$key": null + } + }, + "GetEntitlementFilters": { + "base": null, + "refs": { + "GetEntitlementsRequest$Filter": "<p>Filter is used to return entitlements for a specific customer or for a specific dimension. Filters are described as keys mapped to a lists of values. Filtered requests are <i>unioned</i> for each value in the value list, and then <i>intersected</i> for each filter key.</p>" + } + }, + "GetEntitlementsRequest": { + "base": "<p>The GetEntitlementsRequest contains parameters for the GetEntitlements operation.</p>", + "refs": { + } + }, + "GetEntitlementsResult": { + "base": "<p>The GetEntitlementsRequest contains results from the GetEntitlements operation.</p>", + "refs": { + } + }, + "Integer": { + "base": null, + "refs": { + "EntitlementValue$IntegerValue": "<p>The IntegerValue field will be populated with an integer value when the entitlement is an integer type. Otherwise, the field will not be set.</p>", + "GetEntitlementsRequest$MaxResults": "<p>The maximum number of items to retrieve from the GetEntitlements operation. For pagination, use the NextToken field in subsequent calls to GetEntitlements.</p>" + } + }, + "InternalServiceErrorException": { + "base": "<p>An internal error has occurred. Retry your request. If the problem persists, post a message with details on the AWS forums.</p>", + "refs": { + } + }, + "InvalidParameterException": { + "base": "<p>One or more parameters in your request was invalid.</p>", + "refs": { + } + }, + "NonEmptyString": { + "base": null, + "refs": { + "Entitlement$Dimension": "<p>The dimension for which the given entitlement applies. Dimensions represent categories of capacity in a product and are specified when the product is listed in AWS Marketplace.</p>", + "Entitlement$CustomerIdentifier": "<p>The customer identifier is a handle to each unique customer in an application. Customer identifiers are obtained through the ResolveCustomer operation in AWS Marketplace Metering Service.</p>", + "GetEntitlementsRequest$NextToken": "<p>For paginated calls to GetEntitlements, pass the NextToken from the previous GetEntitlementsResult.</p>", + "GetEntitlementsResult$NextToken": "<p>For paginated results, use NextToken in subsequent calls to GetEntitlements. If the result contains an empty set of entitlements, NextToken might still be present and should be used.</p>" + } + }, + "ProductCode": { + "base": null, + "refs": { + "Entitlement$ProductCode": "<p>The product code for which the given entitlement applies. Product codes are provided by AWS Marketplace when the product listing is created.</p>", + "GetEntitlementsRequest$ProductCode": "<p>Product code is used to uniquely identify a product in AWS Marketplace. The product code will be provided by AWS Marketplace when the product listing is created.</p>" + } + }, + "String": { + "base": null, + "refs": { + "EntitlementValue$StringValue": "<p>The StringValue field will be populated with a string value when the entitlement is a string type. Otherwise, the field will not be set.</p>" + } + }, + "ThrottlingException": { + "base": "<p>The calls to the GetEntitlements API are throttled.</p>", + "refs": { + } + }, + "Timestamp": { + "base": null, + "refs": { + "Entitlement$ExpirationDate": "<p>The expiration date represents the minimum date through which this entitlement is expected to remain valid. For contractual products listed on AWS Marketplace, the expiration date is the date at which the customer will renew or cancel their contract. Customers who are opting to renew their contract will still have entitlements with an expiration date.</p>" + } + } + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/examples-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/examples-1.json new file mode 100644 index 00000000..0ea7e3b0 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/examples-1.json @@ -0,0 +1,5 @@ +{ + "version": "1.0", + "examples": { + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/paginators-1.json new file mode 100644 index 00000000..5677bd8e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/entitlement.marketplace/2017-01-11/paginators-1.json @@ -0,0 +1,4 @@ +{ + "pagination": { + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/events/2015-10-07/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/events/2015-10-07/docs-2.json index 1ce70eee..86c78c79 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/events/2015-10-07/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/events/2015-10-07/docs-2.json @@ -11,8 +11,8 @@ "ListTargetsByRule": "<p>Lists the targets assigned to the specified rule.</p>", "PutEvents": "<p>Sends custom events to Amazon CloudWatch Events so that they can be matched to rules.</p>", "PutRule": "<p>Creates or updates the specified rule. Rules are enabled by default, or based on value of the state. You can disable a rule using <a>DisableRule</a>.</p> <p>When you create or update a rule, incoming events might not immediately start matching to new or updated rules. Please allow a short period of time for changes to take effect.</p> <p>A rule must contain at least an EventPattern or ScheduleExpression. Rules with EventPatterns are triggered when a matching event is observed. Rules with ScheduleExpressions self-trigger based on the given schedule. A rule can have both an EventPattern and a ScheduleExpression, in which case the rule triggers on matching events as well as on a schedule.</p> <p>Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.</p>", - "PutTargets": "<p>Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule.</p> <p>Targets are the resources that are invoked when a rule is triggered. Example targets include EC2 instances, AWS Lambda functions, Amazon Kinesis streams, Amazon ECS tasks, AWS Step Functions state machines, and built-in targets. Note that creating rules with built-in targets is supported only in the AWS Management Console.</p> <p>For some target types, <code>PutTargets</code> provides target-specific parameters. If the target is an Amazon Kinesis stream, you can optionally specify which shard the event goes to by using the <code>KinesisParameters</code> argument. To invoke a command on multiple EC2 instances with one rule, you can use the <code>RunCommandParameters</code> field.</p> <p>To be able to make API calls against the resources that you own, Amazon CloudWatch Events needs the appropriate permissions. For AWS Lambda and Amazon SNS resources, CloudWatch Events relies on resource-based policies. For EC2 instances, Amazon Kinesis streams, and AWS Step Functions state machines, CloudWatch Events relies on IAM roles that you specify in the <code>RoleARN</code> argument in <code>PutTarget</code>. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/auth-and-access-control-cwe.html\">Authentication and Access Control</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p> <p> <b>Input</b>, <b>InputPath</b> and <b>InputTransformer</b> are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event:</p> <ul> <li> <p>If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON form (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target).</p> </li> <li> <p>If <b>Input</b> is specified in the form of valid JSON, then the matched event is overridden with this constant.</p> </li> <li> <p>If <b>InputPath</b> is specified in the form of JSONPath (for example, <code>$.detail</code>), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed). </p> </li> <li> <p>If <b>InputTransformer</b> is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target.</p> </li> </ul> <p>When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Please allow a short period of time for changes to take effect.</p>", - "RemoveTargets": "<p>Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.</p> <p>When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Please allow a short period of time for changes to take effect.</p>", + "PutTargets": "<p>Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule.</p> <p>Targets are the resources that are invoked when a rule is triggered. Example targets include EC2 instances, AWS Lambda functions, Amazon Kinesis streams, Amazon ECS tasks, AWS Step Functions state machines, and built-in targets. Note that creating rules with built-in targets is supported only in the AWS Management Console.</p> <p>For some target types, <code>PutTargets</code> provides target-specific parameters. If the target is an Amazon Kinesis stream, you can optionally specify which shard the event goes to by using the <code>KinesisParameters</code> argument. To invoke a command on multiple EC2 instances with one rule, you can use the <code>RunCommandParameters</code> field.</p> <p>To be able to make API calls against the resources that you own, Amazon CloudWatch Events needs the appropriate permissions. For AWS Lambda and Amazon SNS resources, CloudWatch Events relies on resource-based policies. For EC2 instances, Amazon Kinesis streams, and AWS Step Functions state machines, CloudWatch Events relies on IAM roles that you specify in the <code>RoleARN</code> argument in <code>PutTarget</code>. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/auth-and-access-control-cwe.html\">Authentication and Access Control</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p> <p> <b>Input</b>, <b>InputPath</b> and <b>InputTransformer</b> are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event:</p> <ul> <li> <p>If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON form (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target).</p> </li> <li> <p>If <b>Input</b> is specified in the form of valid JSON, then the matched event is overridden with this constant.</p> </li> <li> <p>If <b>InputPath</b> is specified in the form of JSONPath (for example, <code>$.detail</code>), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed).</p> </li> <li> <p>If <b>InputTransformer</b> is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target.</p> </li> </ul> <p>When you specify <code>Input</code>, <code>InputPath</code>, or <code>InputTransformer</code>, you must use JSON dot notation, not bracket notation.</p> <p>When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Please allow a short period of time for changes to take effect.</p> <p>This action can partially fail if too many requests are made at the same time. If that happens, <code>FailedEntryCount</code> is non-zero in the response and each entry in <code>FailedEntries</code> provides the ID of the failed target and the error code.</p>", + "RemoveTargets": "<p>Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.</p> <p>When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Please allow a short period of time for changes to take effect.</p> <p>This action can partially fail if too many requests are made at the same time. If that happens, <code>FailedEntryCount</code> is non-zero in the response and each entry in <code>FailedEntries</code> provides the ID of the failed target and the error code.</p>", "TestEventPattern": "<p>Tests whether the specified event pattern matches the provided event.</p> <p>Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.</p>" }, "shapes": { @@ -68,8 +68,8 @@ "base": null, "refs": { "PutEventsResultEntry$ErrorCode": "<p>The error code that indicates why the event submission failed.</p>", - "PutTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target addition failed.</p>", - "RemoveTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target removal failed.</p>" + "PutTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target addition failed. If the value is <code>ConcurrentModificationException</code>, too many requests were made at the same time.</p>", + "RemoveTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target removal failed. If the value is <code>ConcurrentModificationException</code>, too many requests were made at the same time.</p>" } }, "ErrorMessage": { @@ -89,10 +89,10 @@ "EventPattern": { "base": null, "refs": { - "DescribeRuleResponse$EventPattern": "<p>The event pattern.</p>", - "PutRuleRequest$EventPattern": "<p>The event pattern.</p>", - "Rule$EventPattern": "<p>The event pattern of the rule.</p>", - "TestEventPatternRequest$EventPattern": "<p>The event pattern.</p>" + "DescribeRuleResponse$EventPattern": "<p>The event pattern. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>", + "PutRuleRequest$EventPattern": "<p>The event pattern. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>", + "Rule$EventPattern": "<p>The event pattern of the rule. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>", + "TestEventPatternRequest$EventPattern": "<p>The event pattern. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>" } }, "EventResource": { @@ -454,13 +454,13 @@ "TargetInput": { "base": null, "refs": { - "Target$Input": "<p>Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. For more information, see <a href=\"http://www.rfc-editor.org/rfc/rfc7159.txt\">The JavaScript Object Notation (JSON) Data Interchange Format</a>.</p>" + "Target$Input": "<p>Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. You must use JSON dot notation, not bracket notation. For more information, see <a href=\"http://www.rfc-editor.org/rfc/rfc7159.txt\">The JavaScript Object Notation (JSON) Data Interchange Format</a>.</p>" } }, "TargetInputPath": { "base": null, "refs": { - "Target$InputPath": "<p>The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. For more information about JSON paths, see <a href=\"http://goessner.net/articles/JsonPath/\">JSONPath</a>.</p>", + "Target$InputPath": "<p>The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. You must use JSON dot notation, not bracket notation. For more information about JSON paths, see <a href=\"http://goessner.net/articles/JsonPath/\">JSONPath</a>.</p>", "TransformerPaths$value": null } }, @@ -496,7 +496,7 @@ "TransformerPaths": { "base": null, "refs": { - "InputTransformer$InputPathsMap": "<p>Map of JSON paths to be extracted from the event. These are key-value pairs, where each value is a JSON path.</p>" + "InputTransformer$InputPathsMap": "<p>Map of JSON paths to be extracted from the event. These are key-value pairs, where each value is a JSON path. You must use JSON dot notation, not bracket notation.</p>" } } } diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/api-2.json index e0d43925..0bfd775f 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/api-2.json @@ -91,7 +91,8 @@ "errors":[ {"shape":"InternalServiceException"}, {"shape":"InvalidRequestException"}, - {"shape":"UnauthorizedException"} + {"shape":"UnauthorizedException"}, + {"shape":"LimitExceededException"} ] }, "CreatePlayerSession":{ @@ -874,7 +875,8 @@ "EC2InboundPermissions":{"shape":"IpPermissionsList"}, "NewGameSessionProtectionPolicy":{"shape":"ProtectionPolicy"}, "RuntimeConfiguration":{"shape":"RuntimeConfiguration"}, - "ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"} + "ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"}, + "MetricGroups":{"shape":"MetricGroupList"} } }, "CreateFleetOutput":{ @@ -1372,7 +1374,8 @@ "LogPaths":{"shape":"StringList"}, "NewGameSessionProtectionPolicy":{"shape":"ProtectionPolicy"}, "OperatingSystem":{"shape":"OperatingSystem"}, - "ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"} + "ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"}, + "MetricGroups":{"shape":"MetricGroupList"} } }, "FleetAttributesList":{ @@ -1479,6 +1482,11 @@ "CreatorId":{"shape":"NonZeroAndMaxString"} } }, + "GameSessionActivationTimeoutSeconds":{ + "type":"integer", + "max":600, + "min":1 + }, "GameSessionDetail":{ "type":"structure", "members":{ @@ -1774,15 +1782,33 @@ "NextToken":{"shape":"NonZeroAndMaxString"} } }, + "MaxConcurrentGameSessionActivations":{ + "type":"integer", + "max":2147483647, + "min":1 + }, + "MetricGroup":{ + "type":"string", + "max":255, + "min":1 + }, + "MetricGroupList":{ + "type":"list", + "member":{"shape":"MetricGroup"}, + "max":1 + }, "MetricName":{ "type":"string", "enum":[ "ActivatingGameSessions", "ActiveGameSessions", "ActiveInstances", + "AvailableGameSessions", "AvailablePlayerSessions", "CurrentPlayerSessions", "IdleInstances", + "PercentAvailableGameSessions", + "PercentIdleInstances", "QueueDepth", "WaitTime" ] @@ -2010,7 +2036,9 @@ "RuntimeConfiguration":{ "type":"structure", "members":{ - "ServerProcesses":{"shape":"ServerProcessList"} + "ServerProcesses":{"shape":"ServerProcessList"}, + "MaxConcurrentGameSessionActivations":{"shape":"MaxConcurrentGameSessionActivations"}, + "GameSessionActivationTimeoutSeconds":{"shape":"GameSessionActivationTimeoutSeconds"} } }, "S3Location":{ @@ -2189,7 +2217,8 @@ "Name":{"shape":"NonZeroAndMaxString"}, "Description":{"shape":"NonZeroAndMaxString"}, "NewGameSessionProtectionPolicy":{"shape":"ProtectionPolicy"}, - "ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"} + "ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"}, + "MetricGroups":{"shape":"MetricGroupList"} } }, "UpdateFleetAttributesOutput":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/docs-2.json index d7ef0607..5e3aa7e6 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/docs-2.json @@ -4,7 +4,7 @@ "operations": { "CreateAlias": "<p>Creates an alias and sets a target fleet. A fleet alias can be used in place of a fleet ID, such as when calling <code>CreateGameSession</code> from a game client or game service or adding destinations to a game session queue. By changing an alias's target fleet, you can switch your players to the new fleet without changing any other component. In production, this feature is particularly useful to redirect your player base seamlessly to the latest game server update. </p> <p>Amazon GameLift supports two types of routing strategies for aliases: simple and terminal. Use a simple alias to point to an active fleet. Use a terminal alias to display a message to incoming traffic instead of routing players to an active fleet. This option is useful when a game server is no longer supported but you want to provide better messaging than a standard 404 error.</p> <p>To create a fleet alias, specify an alias name, routing strategy, and optional description. If successful, a new alias record is returned, including an alias ID, which you can reference when creating a game session. To reassign the alias to another fleet ID, call <a>UpdateAlias</a>.</p>", "CreateBuild": "<p>Creates a new Amazon GameLift build from a set of game server binary files stored in an Amazon Simple Storage Service (Amazon S3) location. When using this API call, you must create a <code>.zip</code> file containing all of the build files and store it in an Amazon S3 bucket under your AWS account. For help on packaging your build files and creating a build, see <a href=\"http://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-intro.html\">Uploading Your Game to Amazon GameLift</a>.</p> <important> <p>Use this API action ONLY if you are storing your game build files in an Amazon S3 bucket in your AWS account. To create a build using files stored in a directory, use the CLI command <a href=\"http://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html\"> <code>upload-build</code> </a>, which uploads the build files from a file location you specify and creates a build.</p> </important> <p>To create a new build using <code>CreateBuild</code>, identify the storage location and operating system of your game build. You also have the option of specifying a build name and version. If successful, this action creates a new build record with an unique build ID and in <code>INITIALIZED</code> status. Use the API call <a>DescribeBuild</a> to check the status of your build. A build must be in <code>READY</code> status before it can be used to create fleets to host your game.</p>", - "CreateFleet": "<p>Creates a new fleet to run your game servers. A fleet is a set of Amazon Elastic Compute Cloud (Amazon EC2) instances, each of which can run multiple server processes to host game sessions. You configure a fleet to create instances with certain hardware specifications (see <a href=\"http://aws.amazon.com/ec2/instance-types/\">Amazon EC2 Instance Types</a> for more information), and deploy a specified game build to each instance. A newly created fleet passes through several statuses; once it reaches the <code>ACTIVE</code> status, it can begin hosting game sessions.</p> <p>To create a new fleet, provide a fleet name, an EC2 instance type, and a build ID of the game build to deploy. You can also configure the new fleet with the following settings: (1) a runtime configuration describing what server processes to run on each instance in the fleet (required to create fleet), (2) access permissions for inbound traffic, (3) fleet-wide game session protection, and (4) the location of default log files for Amazon GameLift to upload and store.</p> <p>If the CreateFleet call is successful, Amazon GameLift performs the following tasks:</p> <ul> <li> <p>Creates a fleet record and sets the status to <code>NEW</code> (followed by other statuses as the fleet is activated).</p> </li> <li> <p>Sets the fleet's capacity to 1 \"desired\", which causes Amazon GameLift to start one new EC2 instance.</p> </li> <li> <p>Starts launching server processes on the instance. If the fleet is configured to run multiple server processes per instance, Amazon GameLift staggers each launch by a few seconds.</p> </li> <li> <p>Begins writing events to the fleet event log, which can be accessed in the Amazon GameLift console.</p> </li> <li> <p>Sets the fleet's status to <code>ACTIVE</code> once one server process in the fleet is ready to host a game session.</p> </li> </ul> <p>After a fleet is created, use the following actions to change fleet properties and configuration:</p> <ul> <li> <p> <a>UpdateFleetAttributes</a> -- Update fleet metadata, including name and description.</p> </li> <li> <p> <a>UpdateFleetCapacity</a> -- Increase or decrease the number of instances you want the fleet to maintain.</p> </li> <li> <p> <a>UpdateFleetPortSettings</a> -- Change the IP address and port ranges that allow access to incoming traffic.</p> </li> <li> <p> <a>UpdateRuntimeConfiguration</a> -- Change how server processes are launched in the fleet, including launch path, launch parameters, and the number of concurrent processes.</p> </li> <li> <p> <a>PutScalingPolicy</a> -- Create or update rules that are used to set the fleet's capacity (autoscaling).</p> </li> </ul>", + "CreateFleet": "<p>Creates a new fleet to run your game servers. A fleet is a set of Amazon Elastic Compute Cloud (Amazon EC2) instances, each of which can run multiple server processes to host game sessions. You configure a fleet to create instances with certain hardware specifications (see <a href=\"http://aws.amazon.com/ec2/instance-types/\">Amazon EC2 Instance Types</a> for more information), and deploy a specified game build to each instance. A newly created fleet passes through several statuses; once it reaches the <code>ACTIVE</code> status, it can begin hosting game sessions.</p> <p>To create a new fleet, you must specify the following: (1) fleet name, (2) build ID of an uploaded game build, (3) an EC2 instance type, and (4) a runtime configuration that describes which server processes to run on each instance in the fleet. (Although the runtime configuration is not a required parameter, the fleet cannot be successfully created without it.) You can also configure the new fleet with the following settings: fleet description, access permissions for inbound traffic, fleet-wide game session protection, and resource creation limit. If you use Amazon CloudWatch for metrics, you can add the new fleet to a metric group, which allows you to view aggregated metrics for a set of fleets. Once you specify a metric group, the new fleet's metrics are included in the metric group's data.</p> <p>If the CreateFleet call is successful, Amazon GameLift performs the following tasks:</p> <ul> <li> <p>Creates a fleet record and sets the status to <code>NEW</code> (followed by other statuses as the fleet is activated).</p> </li> <li> <p>Sets the fleet's capacity to 1 \"desired\", which causes Amazon GameLift to start one new EC2 instance.</p> </li> <li> <p>Starts launching server processes on the instance. If the fleet is configured to run multiple server processes per instance, Amazon GameLift staggers each launch by a few seconds.</p> </li> <li> <p>Begins writing events to the fleet event log, which can be accessed in the Amazon GameLift console.</p> </li> <li> <p>Sets the fleet's status to <code>ACTIVE</code> once one server process in the fleet is ready to host a game session.</p> </li> </ul> <p>After a fleet is created, use the following actions to change fleet properties and configuration:</p> <ul> <li> <p> <a>UpdateFleetAttributes</a> -- Update fleet metadata, including name and description.</p> </li> <li> <p> <a>UpdateFleetCapacity</a> -- Increase or decrease the number of instances you want the fleet to maintain.</p> </li> <li> <p> <a>UpdateFleetPortSettings</a> -- Change the IP address and port ranges that allow access to incoming traffic.</p> </li> <li> <p> <a>UpdateRuntimeConfiguration</a> -- Change how server processes are launched in the fleet, including launch path, launch parameters, and the number of concurrent processes.</p> </li> <li> <p> <a>PutScalingPolicy</a> -- Create or update rules that are used to set the fleet's capacity (autoscaling).</p> </li> </ul>", "CreateGameSession": "<p>Creates a multiplayer game session for players. This action creates a game session record and assigns an available server process in the specified fleet to host the game session. A fleet must have an <code>ACTIVE</code> status before a game session can be created in it.</p> <p>To create a game session, specify either fleet ID or alias ID and indicate a maximum number of players to allow in the game session. You can also provide a name and game-specific properties for this game session. If successful, a <a>GameSession</a> object is returned containing game session properties, including a game session ID with the custom string you provided.</p> <p> <b>Idempotency tokens.</b> You can add a token that uniquely identifies game session requests. This is useful for ensuring that game session requests are idempotent. Multiple requests with the same idempotency token are processed only once; subsequent requests return the original result. All response values are the same with the exception of game session status, which may change.</p> <p> <b>Resource creation limits.</b> If you are creating a game session on a fleet with a resource creation limit policy in force, then you must specify a creator ID. Without this ID, Amazon GameLift has no way to evaluate the policy for this new game session request.</p> <p> By default, newly created game sessions allow new players to join. Use <a>UpdateGameSession</a> to change the game session's player session creation policy.</p> <p> <i>Available in Amazon GameLift Local.</i> </p>", "CreateGameSessionQueue": "<p>Establishes a new queue for processing requests to place new game sessions. A queue identifies where new game sessions can be hosted -- by specifying a list of destinations (fleets or aliases) -- and how long requests can wait in the queue before timing out. You can set up a queue to try to place game sessions on fleets in multiple regions. To add placement requests to a queue, call <a>StartGameSessionPlacement</a> and reference the queue name.</p> <p> <b>Destination order.</b> When processing a request for a game session, Amazon GameLift tries each destination in order until it finds one with available resources to host the new game session. A queue's default order is determined by how destinations are listed. The default order is overridden when a game session placement request provides player latency information. Player latency information enables Amazon GameLift to prioritize destinations where players report the lowest average latency, as a result placing the new game session where the majority of players will have the best possible gameplay experience.</p> <p> <b>Player latency policies.</b> For placement requests containing player latency information, use player latency policies to protect individual players from very high latencies. With a latency cap, even when a destination can deliver a low latency for most players, the game is not placed where any individual player is reporting latency higher than a policy's maximum. A queue can have multiple latency policies, which are enforced consecutively starting with the policy with the lowest latency cap. Use multiple policies to gradually relax latency controls; for example, you might set a policy with a low latency cap for the first 60 seconds, a second policy with a higher cap for the next 60 seconds, etc. </p> <p>To create a new queue, provide a name, timeout value, a list of destinations and, if desired, a set of latency policies. If successful, a new queue object is returned.</p>", "CreatePlayerSession": "<p>Adds a player to a game session and creates a player session record. Before a player can be added, a game session must have an <code>ACTIVE</code> status, have a creation policy of <code>ALLOW_ALL</code>, and have an open player slot. To add a group of players to a game session, use <a>CreatePlayerSessions</a>.</p> <p>To create a player session, specify a game session ID, player ID, and optionally a string of player data. If successful, the player is added to the game session and a new <a>PlayerSession</a> object is returned. Player sessions cannot be updated. </p> <p> <i>Available in Amazon GameLift Local.</i> </p>", @@ -39,7 +39,7 @@ "RequestUploadCredentials": "<p> <i>This API call is not currently in use. </i> Retrieves a fresh set of upload credentials and the assigned Amazon S3 storage location for a specific build. Valid credentials are required to upload your game build files to Amazon S3.</p>", "ResolveAlias": "<p>Retrieves the fleet ID that a specified alias is currently pointing to.</p>", "SearchGameSessions": "<p>Retrieves a set of game sessions that match a set of search criteria and sorts them in a specified order. Currently a game session search is limited to a single fleet. Search results include only game sessions that are in <code>ACTIVE</code> status. If you need to retrieve game sessions with a status other than active, use <a>DescribeGameSessions</a>. If you need to retrieve the protection policy for each game session, use <a>DescribeGameSessionDetails</a>.</p> <p>You can search or sort by the following game session attributes:</p> <ul> <li> <p> <b>gameSessionId</b> -- Unique identifier for the game session. You can use either a <code>GameSessionId</code> or <code>GameSessionArn</code> value. </p> </li> <li> <p> <b>gameSessionName</b> -- Name assigned to a game session. This value is set when requesting a new game session with <a>CreateGameSession</a> or updating with <a>UpdateGameSession</a>. Game session names do not need to be unique to a game session.</p> </li> <li> <p> <b>creationTimeMillis</b> -- Value indicating when a game session was created. It is expressed in Unix time as milliseconds.</p> </li> <li> <p> <b>playerSessionCount</b> -- Number of players currently connected to a game session. This value changes rapidly as players join the session or drop out.</p> </li> <li> <p> <b>maximumSessions</b> -- Maximum number of player sessions allowed for a game session. This value is set when requesting a new game session with <a>CreateGameSession</a> or updating with <a>UpdateGameSession</a>.</p> </li> <li> <p> <b>hasAvailablePlayerSessions</b> -- Boolean value indicating whether or not a game session has reached its maximum number of players. When searching with this attribute, the search value must be <code>true</code> or <code>false</code>. It is highly recommended that all search requests include this filter attribute to optimize search performance and return only sessions that players can join. </p> </li> </ul> <p>To search or sort, specify either a fleet ID or an alias ID, and provide a search filter expression, a sort expression, or both. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a collection of <a>GameSession</a> objects matching the request is returned.</p> <note> <p>Returned values for <code>playerSessionCount</code> and <code>hasAvailablePlayerSessions</code> change quickly as players join sessions and others drop out. Results should be considered a snapshot in time. Be sure to refresh search results often, and handle sessions that fill up before a player can join. </p> </note> <p> <i>Available in Amazon GameLift Local.</i> </p>", - "StartGameSessionPlacement": "<p>Places a request for a new game session in a queue (see <a>CreateGameSessionQueue</a>). When processing a placement request, Amazon GameLift searches for available resources on the queue's destinations, scanning each until it finds resources or the placement request times out. A game session placement request can also request player sessions. When a new game session is successfully created, Amazon GameLift creates a player session for each player included in the request.</p> <p>When placing a game session, by default Amazon GameLift tries each fleet in the order they are listed in the queue configuration. Ideally, a queue's destinations are listed in preference order. Alternatively, when requesting a game session with players, you can also provide latency data for each player in relevant regions. Latency data indicates the performance lag a player experiences when connected to a fleet in the region. Amazon GameLift uses latency data to reorder the list of destinations to place the game session in a region with minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each region's average lag for all players and reorders to get the best game play across all players. </p> <p>To place a new game session request, specify the queue name and a set of game session properties and settings. Also provide a unique ID (such as a UUID) for the placement. You'll use this ID to track the status of the placement request. Optionally, provide a set of IDs and player data for each player you want to join to the new game session. To optimize game play for the players, also provide latency data for all players. If successful, a new game session placement is created. To track the status of a placement request, call <a>DescribeGameSessionPlacement</a> and check the request's status. If the status is Fulfilled, a new game session has been created and a game session ARN and region are referenced. If the placement request times out, you have the option of resubmitting the request or retrying it with a different queue. </p>", + "StartGameSessionPlacement": "<p>Places a request for a new game session in a queue (see <a>CreateGameSessionQueue</a>). When processing a placement request, Amazon GameLift searches for available resources on the queue's destinations, scanning each until it finds resources or the placement request times out.</p> <p>A game session placement request can also request player sessions. When a new game session is successfully created, Amazon GameLift creates a player session for each player included in the request.</p> <p>When placing a game session, by default Amazon GameLift tries each fleet in the order they are listed in the queue configuration. Ideally, a queue's destinations are listed in preference order.</p> <p>Alternatively, when requesting a game session with players, you can also provide latency data for each player in relevant regions. Latency data indicates the performance lag a player experiences when connected to a fleet in the region. Amazon GameLift uses latency data to reorder the list of destinations to place the game session in a region with minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each region's average lag for all players and reorders to get the best game play across all players. </p> <p>To place a new game session request, specify the following:</p> <ul> <li> <p>The queue name and a set of game session properties and settings</p> </li> <li> <p>A unique ID (such as a UUID) for the placement. You use this ID to track the status of the placement request</p> </li> <li> <p>(Optional) A set of IDs and player data for each player you want to join to the new game session</p> </li> <li> <p>Latency data for all players (if you want to optimize game play for the players)</p> </li> </ul> <p>If successful, a new game session placement is created.</p> <p>To track the status of a placement request, call <a>DescribeGameSessionPlacement</a> and check the request's status. If the status is <code>Fulfilled</code>, a new game session has been created and a game session ARN and region are referenced. If the placement request times out, you can resubmit the request or retry it with a different queue. </p>", "StopGameSessionPlacement": "<p>Cancels a game session placement that is in Pending status. To stop a placement, provide the placement ID values. If successful, the placement is moved to Cancelled status.</p>", "UpdateAlias": "<p>Updates properties for a fleet alias. To update properties, specify the alias ID to be updated and provide the information to be changed. To reassign an alias to another fleet, provide an updated routing strategy. If successful, the updated alias record is returned.</p>", "UpdateBuild": "<p>Updates metadata in a build record, including the build name and version. To update the metadata, specify the build ID to update and provide the new values. If successful, a build object containing the updated metadata is returned.</p>", @@ -90,7 +90,7 @@ "DescribeGameSessionsInput$GameSessionId": "<p>Unique identifier for the game session to retrieve. You can use either a <code>GameSessionId</code> or <code>GameSessionArn</code> value. </p>", "DescribePlayerSessionsInput$GameSessionId": "<p>Unique identifier for the game session to retrieve player sessions for.</p>", "FleetAttributes$FleetArn": "<p>Identifier for a fleet that is unique across all regions.</p>", - "GameSessionQueue$GameSessionQueueArn": "<p>Amazon Resource Name (<a href=\"http://docs.aws.amazon.com/docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html\">ARN</a>) that is assigned to a game session queue and uniquely identifies it. Format is <code>arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912</code>.</p>", + "GameSessionQueue$GameSessionQueueArn": "<p>Amazon Resource Name (<a href=\"http://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html\">ARN</a>) that is assigned to a game session queue and uniquely identifies it. Format is <code>arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912</code>.</p>", "GameSessionQueueDestination$DestinationArn": "<p>Amazon Resource Name (ARN) assigned to fleet or fleet alias. ARNs, which include a fleet ID or alias ID and a region name, provide a unique identifier across all regions. </p>", "GetGameSessionLogUrlInput$GameSessionId": "<p>Unique identifier for the game session to get logs for.</p>", "UpdateGameSessionInput$GameSessionId": "<p>Unique identifier for the game session to update.</p>" @@ -619,6 +619,12 @@ "UpdateGameSessionOutput$GameSession": "<p>Object that contains the updated game session metadata.</p>" } }, + "GameSessionActivationTimeoutSeconds": { + "base": null, + "refs": { + "RuntimeConfiguration$GameSessionActivationTimeoutSeconds": "<p>Maximum amount of time (in seconds) that a game session can remain in status ACTIVATING. If the game session is not active before the timeout, activation is terminated and the game session status is changed to TERMINATED.</p>" + } + }, "GameSessionDetail": { "base": "<p>A game session's properties plus the protection policy currently in force.</p>", "refs": { @@ -877,6 +883,26 @@ "refs": { } }, + "MaxConcurrentGameSessionActivations": { + "base": null, + "refs": { + "RuntimeConfiguration$MaxConcurrentGameSessionActivations": "<p>Maximum number of game sessions with status ACTIVATING to allow on an instance simultaneously. This setting limits the amount of instance resources that can be used for new game activations at any one time.</p>" + } + }, + "MetricGroup": { + "base": null, + "refs": { + "MetricGroupList$member": null + } + }, + "MetricGroupList": { + "base": null, + "refs": { + "CreateFleetInput$MetricGroups": "<p>Names of metric groups to add this fleet to. Use an existing metric group name to add this fleet to the group, or use a new name to create a new metric group. Currently, a fleet can only be included in one metric group at a time.</p>", + "FleetAttributes$MetricGroups": "<p>Names of metric groups that this fleet is included in. In Amazon CloudWatch, you can view metrics for an individual fleet or aggregated metrics for a fleets that are in a fleet metric group. Currently, a fleet can be included in only one metric group at a time.</p>", + "UpdateFleetAttributesInput$MetricGroups": "<p>Names of metric groups to include this fleet with. A fleet metric group is used in Amazon CloudWatch to aggregate metrics from multiple fleets. Use an existing metric group name to add this fleet to the group, or use a new name to create a new metric group. Currently, a fleet can only be included in one metric group at a time.</p>" + } + }, "MetricName": { "base": null, "refs": { @@ -1283,7 +1309,7 @@ "ServerProcessList": { "base": null, "refs": { - "RuntimeConfiguration$ServerProcesses": "<p>Collection of server process configurations describing what server processes to run on each instance in a fleet</p>" + "RuntimeConfiguration$ServerProcesses": "<p>Collection of server process configurations that describe which server processes to run on each instance in a fleet.</p>" } }, "StartGameSessionPlacementInput": { diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/api-2.json index dc492abe..425f3a75 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/api-2.json @@ -207,6 +207,23 @@ {"shape":"InvalidInputException"} ] }, + "GetAssessmentReport":{ + "name":"GetAssessmentReport", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetAssessmentReportRequest"}, + "output":{"shape":"GetAssessmentReportResponse"}, + "errors":[ + {"shape":"InternalException"}, + {"shape":"InvalidInputException"}, + {"shape":"AccessDeniedException"}, + {"shape":"NoSuchEntityException"}, + {"shape":"AssessmentRunInProgressException"}, + {"shape":"UnsupportedFeatureException"} + ] + }, "GetTelemetryMetadata":{ "name":"GetTelemetryMetadata", "http":{ @@ -656,7 +673,8 @@ "stateChangedAt", "dataCollected", "stateChanges", - "notifications" + "notifications", + "findingCounts" ], "members":{ "arn":{"shape":"Arn"}, @@ -672,7 +690,8 @@ "stateChangedAt":{"shape":"Timestamp"}, "dataCollected":{"shape":"Bool"}, "stateChanges":{"shape":"AssessmentRunStateChangeList"}, - "notifications":{"shape":"AssessmentRunNotificationList"} + "notifications":{"shape":"AssessmentRunNotificationList"}, + "findingCounts":{"shape":"AssessmentRunFindingCounts"} } }, "AssessmentRunAgent":{ @@ -717,6 +736,11 @@ "stateChangeTimeRange":{"shape":"TimestampRange"} } }, + "AssessmentRunFindingCounts":{ + "type":"map", + "key":{"shape":"Severity"}, + "value":{"shape":"FindingCount"} + }, "AssessmentRunInProgressArnList":{ "type":"list", "member":{"shape":"Arn"}, @@ -790,8 +814,10 @@ "COLLECTING_DATA", "STOP_DATA_COLLECTION_PENDING", "DATA_COLLECTED", + "START_EVALUATING_RULES_PENDING", "EVALUATING_RULES", "FAILED", + "ERROR", "COMPLETED", "COMPLETED_WITH_ERRORS" ] @@ -1248,6 +1274,7 @@ "updatedAt":{"shape":"Timestamp"} } }, + "FindingCount":{"type":"integer"}, "FindingFilter":{ "type":"structure", "members":{ @@ -1269,9 +1296,30 @@ "FindingList":{ "type":"list", "member":{"shape":"Finding"}, - "max":10, + "max":100, "min":0 }, + "GetAssessmentReportRequest":{ + "type":"structure", + "required":[ + "assessmentRunArn", + "reportFileFormat", + "reportType" + ], + "members":{ + "assessmentRunArn":{"shape":"Arn"}, + "reportFileFormat":{"shape":"ReportFileFormat"}, + "reportType":{"shape":"ReportType"} + } + }, + "GetAssessmentReportResponse":{ + "type":"structure", + "required":["status"], + "members":{ + "status":{"shape":"ReportStatus"}, + "url":{"shape":"Url"} + } + }, "GetTelemetryMetadataRequest":{ "type":"structure", "required":["assessmentRunArn"], @@ -1710,6 +1758,28 @@ "failedItems":{"shape":"FailedItems"} } }, + "ReportFileFormat":{ + "type":"string", + "enum":[ + "HTML", + "PDF" + ] + }, + "ReportStatus":{ + "type":"string", + "enum":[ + "WORK_IN_PROGRESS", + "FAILED", + "COMPLETED" + ] + }, + "ReportType":{ + "type":"string", + "enum":[ + "FINDING", + "FULL" + ] + }, "ResourceGroup":{ "type":"structure", "required":[ @@ -1931,6 +2001,18 @@ "topicArn":{"shape":"Arn"} } }, + "UnsupportedFeatureException":{ + "type":"structure", + "required":[ + "message", + "canRetry" + ], + "members":{ + "message":{"shape":"ErrorMessage"}, + "canRetry":{"shape":"Bool"} + }, + "exception":true + }, "UpdateAssessmentTargetRequest":{ "type":"structure", "required":[ @@ -1944,6 +2026,10 @@ "resourceGroupArn":{"shape":"Arn"} } }, + "Url":{ + "type":"string", + "max":2048 + }, "UserAttributeKeyList":{ "type":"list", "member":{"shape":"AttributeKey"}, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/docs-2.json index 3c66b1de..71869284 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/docs-2.json @@ -16,6 +16,7 @@ "DescribeFindings": "<p>Describes the findings that are specified by the ARNs of the findings.</p>", "DescribeResourceGroups": "<p>Describes the resource groups that are specified by the ARNs of the resource groups.</p>", "DescribeRulesPackages": "<p>Describes the rules packages that are specified by the ARNs of the rules packages.</p>", + "GetAssessmentReport": "<p>Produces an assessment report that includes detailed and comprehensive results of a specified assessment run. </p>", "GetTelemetryMetadata": "<p>Information about the data that is collected for the specified assessment run.</p>", "ListAssessmentRunAgents": "<p>Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.</p>", "ListAssessmentRuns": "<p>Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates.</p>", @@ -176,6 +177,7 @@ "FailedItems$key": null, "FilterRulesPackageArnList$member": null, "Finding$arn": "<p>The ARN that specifies the finding.</p>", + "GetAssessmentReportRequest$assessmentRunArn": "<p>The ARN that specifies the assessment run for which you want to generate a report.</p>", "GetTelemetryMetadataRequest$assessmentRunArn": "<p>The ARN that specifies the assessment run that has the telemetry data that you want to obtain.</p>", "InspectorServiceAttributes$assessmentRunArn": "<p>The ARN of the assessment run during which the finding is generated.</p>", "InspectorServiceAttributes$rulesPackageArn": "<p>The ARN of the rules package that is used to generate the finding.</p>", @@ -242,6 +244,12 @@ "ListAssessmentRunsRequest$filter": "<p>You can use this parameter to specify a subset of data to be included in the action's response.</p> <p>For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.</p>" } }, + "AssessmentRunFindingCounts": { + "base": null, + "refs": { + "AssessmentRun$findingCounts": "<p>Provides a total count of generated findings per severity.</p>" + } + }, "AssessmentRunInProgressArnList": { "base": null, "refs": { @@ -451,7 +459,8 @@ "InvalidCrossAccountRoleException$canRetry": "<p>You can immediately retry your request.</p>", "InvalidInputException$canRetry": "<p>You can immediately retry your request.</p>", "LimitExceededException$canRetry": "<p>You can immediately retry your request.</p>", - "NoSuchEntityException$canRetry": "<p>You can immediately retry your request.</p>" + "NoSuchEntityException$canRetry": "<p>You can immediately retry your request.</p>", + "UnsupportedFeatureException$canRetry": null } }, "CreateAssessmentTargetRequest": { @@ -581,7 +590,8 @@ "InvalidCrossAccountRoleException$message": "<p>Details of the exception error.</p>", "InvalidInputException$message": "<p>Details of the exception error.</p>", "LimitExceededException$message": "<p>Details of the exception error.</p>", - "NoSuchEntityException$message": "<p>Details of the exception error.</p>" + "NoSuchEntityException$message": "<p>Details of the exception error.</p>", + "UnsupportedFeatureException$message": null } }, "EventSubscription": { @@ -635,6 +645,12 @@ "FindingList$member": null } }, + "FindingCount": { + "base": null, + "refs": { + "AssessmentRunFindingCounts$value": null + } + }, "FindingFilter": { "base": "<p>This data type is used as a request parameter in the <a>ListFindings</a> action.</p>", "refs": { @@ -653,6 +669,16 @@ "DescribeFindingsResponse$findings": "<p>Information about the finding.</p>" } }, + "GetAssessmentReportRequest": { + "base": null, + "refs": { + } + }, + "GetAssessmentReportResponse": { + "base": null, + "refs": { + } + }, "GetTelemetryMetadataRequest": { "base": null, "refs": { @@ -681,7 +707,7 @@ "InspectorServiceAttributes": { "base": "<p>This data type is used in the <a>Finding</a> data type.</p>", "refs": { - "Finding$serviceAttributes": null + "Finding$serviceAttributes": "<p>This data type is used in the <a>Finding</a> data type.</p>" } }, "InternalException": { @@ -873,7 +899,7 @@ "base": null, "refs": { "AssessmentRunAgent$agentHealthDetails": "<p>The description for the agent health code.</p>", - "AssessmentRunNotification$message": null + "AssessmentRunNotification$message": "<p>The message included in the notification.</p>" } }, "MessageType": { @@ -973,6 +999,24 @@ "refs": { } }, + "ReportFileFormat": { + "base": null, + "refs": { + "GetAssessmentReportRequest$reportFileFormat": "<p>Specifies the file format (html or pdf) of the assessment report that you want to generate.</p>" + } + }, + "ReportStatus": { + "base": null, + "refs": { + "GetAssessmentReportResponse$status": "<p>Specifies the status of the request to generate an assessment report. </p>" + } + }, + "ReportType": { + "base": null, + "refs": { + "GetAssessmentReportRequest$reportType": "<p>Specifies the type of the assessment report that you want to generate. There are two types of assessment reports: a finding report and a full report. For more information, see <a href=\"http://docs.aws.amazon.com/inspector/latest/userguide/inspector_reports.html\">Assessment Reports</a>. </p>" + } + }, "ResourceGroup": { "base": "<p>Contains information about a resource group. The resource group defines a set of tags that, when queried, identify the AWS resources that make up the assessment target. This data type is used as the response element in the <a>DescribeResourceGroups</a> action.</p>", "refs": { @@ -1042,6 +1086,7 @@ "Severity": { "base": null, "refs": { + "AssessmentRunFindingCounts$key": null, "Finding$severity": "<p>The finding severity. Values can be set to High, Medium, Low, and Informational.</p>", "SeverityList$member": null } @@ -1168,11 +1213,22 @@ "refs": { } }, + "UnsupportedFeatureException": { + "base": "<p>Used by the <a>GetAssessmentReport</a> API. The request was rejected because you tried to generate a report for an assessment run that existed before reporting was supported in Amazon Inspector. You can only generate reports for assessment runs that took place or will take place after generating reports in Amazon Inspector became available.</p>", + "refs": { + } + }, "UpdateAssessmentTargetRequest": { "base": null, "refs": { } }, + "Url": { + "base": null, + "refs": { + "GetAssessmentReportResponse$url": "<p>Specifies the URL where you can find the generated assessment report. This parameter is only returned if the report is successfully generated.</p>" + } + }, "UserAttributeKeyList": { "base": null, "refs": { diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/examples-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/examples-1.json index 24fcb7a9..d06decc4 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/examples-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/examples-1.json @@ -168,6 +168,13 @@ "createdAt": "1458680170.035", "dataCollected": true, "durationInSeconds": 3600, + "findingCounts": { + "High": 14, + "Informational": 0, + "Low": 0, + "Medium": 2, + "Undefined": 0 + }, "notifications": [ ], diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/paginators-1.json new file mode 100644 index 00000000..5677bd8e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/paginators-1.json @@ -0,0 +1,4 @@ +{ + "pagination": { + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/kms/2014-11-01/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/kms/2014-11-01/docs-2.json index 03fb1866..e1fd0221 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/kms/2014-11-01/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/kms/2014-11-01/docs-2.json @@ -737,7 +737,7 @@ "PrincipalIdType": { "base": null, "refs": { - "CreateGrantRequest$GranteePrincipal": "<p>The principal that is given permission to perform the operations that the grant permits.</p> <p>To specify the principal, use the <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam\">AWS Identity and Access Management (IAM)</a> in the Example ARNs section of the <i>AWS General Reference</i>.</p>", + "CreateGrantRequest$GranteePrincipal": "<p>The principal that is given permission to perform the operations that the grant permits.</p> <p>To specify the principal, use the <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, IAM roles, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam\">AWS Identity and Access Management (IAM)</a> in the Example ARNs section of the <i>AWS General Reference</i>.</p>", "CreateGrantRequest$RetiringPrincipal": "<p>The principal that is given permission to retire the grant by using <a>RetireGrant</a> operation.</p> <p>To specify the principal, use the <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam\">AWS Identity and Access Management (IAM)</a> in the Example ARNs section of the <i>AWS General Reference</i>.</p>", "GrantListEntry$GranteePrincipal": "<p>The principal that receives the grant's permissions.</p>", "GrantListEntry$RetiringPrincipal": "<p>The principal that can retire the grant.</p>", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/api-2.json index 7b68fc98..888c9dd9 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/api-2.json @@ -755,7 +755,6 @@ }, "EnvironmentVariableValue":{ "type":"string", - "pattern":"[^,]*", "sensitive":true }, "EnvironmentVariables":{ @@ -1596,7 +1595,8 @@ "S3Bucket":{"shape":"S3Bucket"}, "S3Key":{"shape":"S3Key"}, "S3ObjectVersion":{"shape":"S3ObjectVersion"}, - "Publish":{"shape":"Boolean"} + "Publish":{"shape":"Boolean"}, + "DryRun":{"shape":"Boolean"} } }, "UpdateFunctionConfigurationRequest":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/docs-2.json index 3b0e236b..075e0b12 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/lambda/2015-03-31/docs-2.json @@ -118,7 +118,8 @@ "base": null, "refs": { "CreateFunctionRequest$Publish": "<p>This boolean parameter can be used to request AWS Lambda to create the Lambda function and publish a version as an atomic operation.</p>", - "UpdateFunctionCodeRequest$Publish": "<p>This boolean parameter can be used to request AWS Lambda to update the Lambda function and publish a version as an atomic operation.</p>" + "UpdateFunctionCodeRequest$Publish": "<p>This boolean parameter can be used to request AWS Lambda to update the Lambda function and publish a version as an atomic operation.</p>", + "UpdateFunctionCodeRequest$DryRun": "<p>This boolean parameter can be used to test your request to AWS Lambda to update the Lambda function and publish a version as an atomic operation. It will do all necessary computation and validation of your code but will not upload it or a publish a version. Each time this operation is invoked, the <code>CodeSha256</code> hash value the provided code will also be computed and returned in the response.</p>" } }, "CodeStorageExceededException": { @@ -244,7 +245,7 @@ "EnvironmentVariables": { "base": null, "refs": { - "Environment$Variables": "<p>The key-value pairs that represent your environment's configuration settings. The value you specify cannot contain a \",\".</p>", + "Environment$Variables": "<p>The key-value pairs that represent your environment's configuration settings.</p>", "EnvironmentResponse$Variables": "<p>The key-value pairs returned that represent your environment's configuration settings or error information.</p>" } }, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/api-2.json index 96e65088..94bf9ae1 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/api-2.json @@ -115,6 +115,23 @@ {"shape":"BadRequestException"} ] }, + "DeleteBotVersion":{ + "name":"DeleteBotVersion", + "http":{ + "method":"DELETE", + "requestUri":"/bots/{name}/versions/{version}", + "responseCode":204 + }, + "input":{"shape":"DeleteBotVersionRequest"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ConflictException"}, + {"shape":"LimitExceededException"}, + {"shape":"InternalFailureException"}, + {"shape":"BadRequestException"}, + {"shape":"ResourceInUseException"} + ] + }, "DeleteIntent":{ "name":"DeleteIntent", "http":{ @@ -132,6 +149,23 @@ {"shape":"ResourceInUseException"} ] }, + "DeleteIntentVersion":{ + "name":"DeleteIntentVersion", + "http":{ + "method":"DELETE", + "requestUri":"/intents/{name}/versions/{version}", + "responseCode":204 + }, + "input":{"shape":"DeleteIntentVersionRequest"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ConflictException"}, + {"shape":"LimitExceededException"}, + {"shape":"InternalFailureException"}, + {"shape":"BadRequestException"}, + {"shape":"ResourceInUseException"} + ] + }, "DeleteSlotType":{ "name":"DeleteSlotType", "http":{ @@ -149,6 +183,23 @@ {"shape":"ResourceInUseException"} ] }, + "DeleteSlotTypeVersion":{ + "name":"DeleteSlotTypeVersion", + "http":{ + "method":"DELETE", + "requestUri":"/slottypes/{name}/version/{version}", + "responseCode":204 + }, + "input":{"shape":"DeleteSlotTypeVersionRequest"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ConflictException"}, + {"shape":"LimitExceededException"}, + {"shape":"InternalFailureException"}, + {"shape":"BadRequestException"}, + {"shape":"ResourceInUseException"} + ] + }, "DeleteUtterances":{ "name":"DeleteUtterances", "http":{ @@ -814,8 +865,26 @@ "shape":"BotName", "location":"uri", "locationName":"name" + } + } + }, + "DeleteBotVersionRequest":{ + "type":"structure", + "required":[ + "name", + "version" + ], + "members":{ + "name":{ + "shape":"BotName", + "location":"uri", + "locationName":"name" }, - "version":{"shape":"Version"} + "version":{ + "shape":"NumericalVersion", + "location":"uri", + "locationName":"version" + } } }, "DeleteIntentRequest":{ @@ -826,8 +895,26 @@ "shape":"IntentName", "location":"uri", "locationName":"name" + } + } + }, + "DeleteIntentVersionRequest":{ + "type":"structure", + "required":[ + "name", + "version" + ], + "members":{ + "name":{ + "shape":"IntentName", + "location":"uri", + "locationName":"name" }, - "version":{"shape":"Version"} + "version":{ + "shape":"NumericalVersion", + "location":"uri", + "locationName":"version" + } } }, "DeleteSlotTypeRequest":{ @@ -838,8 +925,26 @@ "shape":"SlotTypeName", "location":"uri", "locationName":"name" + } + } + }, + "DeleteSlotTypeVersionRequest":{ + "type":"structure", + "required":[ + "name", + "version" + ], + "members":{ + "name":{ + "shape":"SlotTypeName", + "location":"uri", + "locationName":"name" }, - "version":{"shape":"Version"} + "version":{ + "shape":"NumericalVersion", + "location":"uri", + "locationName":"version" + } } }, "DeleteUtterancesRequest":{ @@ -1566,6 +1671,12 @@ "error":{"httpStatusCode":404}, "exception":true }, + "NumericalVersion":{ + "type":"string", + "max":64, + "min":1, + "pattern":"[0-9]+" + }, "PreconditionFailedException":{ "type":"structure", "members":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/docs-2.json index b961d8fe..171da4cb 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/lex-models/2017-04-19/docs-2.json @@ -5,32 +5,35 @@ "CreateBotVersion": "<p>Creates a new version of the bot based on the <code>$LATEST</code> version. If the <code>$LATEST</code> version of this resource hasn't changed since you created the last version, Amazon Lex doesn't create a new version. It returns the last created version.</p> <note> <p>You can update only the <code>$LATEST</code> version of the bot. You can't update the numbered versions that you create with the <code>CreateBotVersion</code> operation.</p> </note> <p> When you create the first version of a bot, Amazon Lex sets the version to 1. Subsequent versions increment by 1. For more information, see <a>versioning-intro</a>. </p> <p> This operation requires permission for the <code>lex:CreateBotVersion</code> action. </p>", "CreateIntentVersion": "<p>Creates a new version of an intent based on the <code>$LATEST</code> version of the intent. If the <code>$LATEST</code> version of this intent hasn't changed since you last updated it, Amazon Lex doesn't create a new version. It returns the last version you created.</p> <note> <p>You can update only the <code>$LATEST</code> version of the intent. You can't update the numbered versions that you create with the <code>CreateIntentVersion</code> operation.</p> </note> <p> When you create a version of an intent, Amazon Lex sets the version to 1. Subsequent versions increment by 1. For more information, see <a>versioning-intro</a>. </p> <p>This operation requires permissions to perform the <code>lex:CreateIntentVersion</code> action. </p>", "CreateSlotTypeVersion": "<p>Creates a new version of a slot type based on the <code>$LATEST</code> version of the specified slot type. If the <code>$LATEST</code> version of this resource has not changed since the last version that you created, Amazon Lex doesn't create a new version. It returns the last version that you created. </p> <note> <p>You can update only the <code>$LATEST</code> version of a slot type. You can't update the numbered versions that you create with the <code>CreateSlotTypeVersion</code> operation.</p> </note> <p>When you create a version of a slot type, Amazon Lex sets the version to 1. Subsequent versions increment by 1. For more information, see <a>versioning-intro</a>. </p> <p>This operation requires permissions for the <code>lex:CreateSlotTypeVersion</code> action.</p>", - "DeleteBot": "<p>Deletes a bot. If you specify a bot version in the request, the API deletes only the specified bot version. If you don't specify a version, the API deletes all versions of the bot, including the <code>$LATEST</code> version. </p> <p>If a bot has an alias, you can't delete it. Instead, the <code>DeleteBot</code> operation returns a <code>ResourceInUseException</code> exception that includes a reference to the alias that refers to the bot. To remove the reference to the bot, delete the alias. If you get the same exception again, delete the referring alias until the <code>DeleteBot</code> operation is successful.</p> <p>This operation requires permissions for the <code>lex:DeleteBot</code> action.</p>", + "DeleteBot": "<p>Deletes all versions of the bot, including the <code>$LATEST</code> version. To delete a specific version of the bot, use the operation.</p> <p>If a bot has an alias, you can't delete it. Instead, the <code>DeleteBot</code> operation returns a <code>ResourceInUseException</code> exception that includes a reference to the alias that refers to the bot. To remove the reference to the bot, delete the alias. If you get the same exception again, delete the referring alias until the <code>DeleteBot</code> operation is successful.</p> <p>This operation requires permissions for the <code>lex:DeleteBot</code> action.</p>", "DeleteBotAlias": "<p>Deletes an alias for the specified bot. </p> <p>You can't delete an alias that is used in the association between a bot and a messaging channel. If an alias is used in a channel association, the <code>DeleteBot</code> operation returns a <code>ResourceInUseException</code> exception that includes a reference to the channel association that refers to the bot. You can remove the reference to the alias by deleting the channel association. If you get the same exception again, delete the referring association until the <code>DeleteBotAlias</code> operation is successful.</p>", "DeleteBotChannelAssociation": "<p>Deletes the association between an Amazon Lex bot and a messaging platform.</p> <p>This operation requires permission for the <code>lex:DeleteBotChannelAssociation</code> action.</p>", - "DeleteIntent": "<p>Deletes an intent. If you specify a version in the request, the API deletes only the specified version of the intent. If you don't specify a version in the request, the API deletes all of the versions of the intent, including the <code>$LATEST</code> version. </p> <p> You can delete a version of an intent only if it is not referenced. To delete an intent that is referred to in one or more bots (see <a>how-it-works</a>), you must remove those references first. </p> <note> <p> If you get the <code>ResourceInUseException</code> exception, it provides an example reference that shows where the intent is referenced. To remove the reference to the intent, either update the bot or delete it. If you get the same exception when you attempt to delete the intent again, repeat until the intent has no references and the call to <code>DeleteIntent</code> is successful. </p> </note> <p> This operation requires permission for the <code>lex:DeleteIntent</code> action. </p>", - "DeleteSlotType": "<p>Deletes a slot type. If you specify a version in the request, the API deletes the specific version. If you don't specify a version in the request, the API deletes all versions of the slot type, including the <code>$LATEST</code> version. </p> <p> You can delete a version of a slot type only if it is not referenced. To delete a slot type that is referred to in one or more intents, you must remove those references first. </p> <note> <p> If you get the <code>SlotTypeInUse</code> exception, the exception provides an example reference that shows the intent where the slot type is referenced. To remove the reference to the slot type, either update the intent or delete it. If you get the same exception when you attempt to delete the intent again, repeat until the intent has no references and the <code>DeleteSlotType</code> call is successful. </p> </note> <p>This operation requires permission for the <code>lex:DeleteSlotType</code> action.</p>", - "DeleteUtterances": "<p>Deletes stored utterances.</p> <p>When you create or update a bot using the operation, configure your bot to store user utterances by setting <code>privacySetting</code> to <code>STORE_UTTERANCES</code>. Use <code>DeleteUtterances</code> to remove the stored utterances for a specific user .</p> <p>This operation requires permissions for the <code>lex:DeleteUtterances</code> action.</p>", + "DeleteBotVersion": "<p>Deletes a specific version of a bot. To delete all versions of a bot, use the operation. </p> <p>This operation requires permissions for the <code>lex:DeleteBotVersion</code> action.</p>", + "DeleteIntent": "<p>Deletes all versions of the intent, including the <code>$LATEST</code> version. To delete a specific version of the intent, use the operation.</p> <p> You can delete a version of an intent only if it is not referenced. To delete an intent that is referred to in one or more bots (see <a>how-it-works</a>), you must remove those references first. </p> <note> <p> If you get the <code>ResourceInUseException</code> exception, it provides an example reference that shows where the intent is referenced. To remove the reference to the intent, either update the bot or delete it. If you get the same exception when you attempt to delete the intent again, repeat until the intent has no references and the call to <code>DeleteIntent</code> is successful. </p> </note> <p> This operation requires permission for the <code>lex:DeleteIntent</code> action. </p>", + "DeleteIntentVersion": "<p>Deletes a specific version of an intent. To delete all versions of a intent, use the operation. </p> <p>This operation requires permissions for the <code>lex:DeleteIntentVersion</code> action.</p>", + "DeleteSlotType": "<p>Deletes all versions of the slot type, including the <code>$LATEST</code> version. To delete a specific version of the slot type, use the operation.</p> <p> You can delete a version of a slot type only if it is not referenced. To delete a slot type that is referred to in one or more intents, you must remove those references first. </p> <note> <p> If you get the <code>ResourceInUseException</code> exception, the exception provides an example reference that shows the intent where the slot type is referenced. To remove the reference to the slot type, either update the intent or delete it. If you get the same exception when you attempt to delete the slot type again, repeat until the slot type has no references and the <code>DeleteSlotType</code> call is successful. </p> </note> <p>This operation requires permission for the <code>lex:DeleteSlotType</code> action.</p>", + "DeleteSlotTypeVersion": "<p>Deletes a specific version of a slot type. To delete all versions of a slot type, use the operation. </p> <p>This operation requires permissions for the <code>lex:DeleteSlotTypeVersion</code> action.</p>", + "DeleteUtterances": "<p>Deletes stored utterances.</p> <p>Amazon Lex stores the utterances that users send to your bot unless the <code>childDirected</code> field in the bot is set to <code>true</code>. Utterances are stored for 15 days for use with the operation, and then stored indefinately for use in improving the ability of your bot to respond to user input.</p> <p>Use the <code>DeleteStoredUtterances</code> operation to manually delete stored utterances for a specific user.</p> <p>This operation requires permissions for the <code>lex:DeleteUtterances</code> action.</p>", "GetBot": "<p>Returns metadata information for a specific bot. You must provide the bot name and the bot version or alias. </p> <p> The GetBot operation requires permissions for the <code>lex:GetBot</code> action. </p>", - "GetBotAlias": "<p>Returns information about an Amazon Lex bot alias. For more information about aliases, see <a>versioning-aliases</a>.</p>", - "GetBotAliases": "<p>Returns a list of aliases for a specified Amazon Lex bot.</p>", - "GetBotChannelAssociation": "<p>Returns information about the association between an Amazon Lex bot and a messaging platform.</p>", - "GetBotChannelAssociations": "<p> Returns a list of all of the channels associated with the specified bot. </p>", - "GetBotVersions": "<p>Gets information about all of the versions of a bot.</p> <p>The <code>GetBotVersions</code> operation returns a <code>BotMetadata</code> object for each version of a bot. For example, if a bot has three numbered versions, the <code>GetBotVersions</code> operation returns four <code>BotMetadata</code> objects in the response, one for each numbered version and one for the <code>$LATEST</code> version. </p> <p>The <code>GetBotVersions</code> operation always returns at least one version, the <code>$LATEST</code> version.</p>", + "GetBotAlias": "<p>Returns information about an Amazon Lex bot alias. For more information about aliases, see <a>versioning-aliases</a>.</p> <p>This operation requires permissions for the <code>lex:GetBotAlias</code> action.</p>", + "GetBotAliases": "<p>Returns a list of aliases for a specified Amazon Lex bot.</p> <p>This operation requires permissions for the <code>lex:GetBotAliases</code> action.</p>", + "GetBotChannelAssociation": "<p>Returns information about the association between an Amazon Lex bot and a messaging platform.</p> <p>This operation requires permissions for the <code>lex:GetBotChannelAssociation</code> action.</p>", + "GetBotChannelAssociations": "<p> Returns a list of all of the channels associated with the specified bot. </p> <p>The <code>GetBotChannelAssociations</code> operation requires permissions for the <code>lex:GetBotChannelAssociations</code> action.</p>", + "GetBotVersions": "<p>Gets information about all of the versions of a bot.</p> <p>The <code>GetBotVersions</code> operation returns a <code>BotMetadata</code> object for each version of a bot. For example, if a bot has three numbered versions, the <code>GetBotVersions</code> operation returns four <code>BotMetadata</code> objects in the response, one for each numbered version and one for the <code>$LATEST</code> version. </p> <p>The <code>GetBotVersions</code> operation always returns at least one version, the <code>$LATEST</code> version.</p> <p>This operation requires permissions for the <code>lex:GetBotVersions</code> action.</p>", "GetBots": "<p>Returns bot information as follows: </p> <ul> <li> <p>If you provide the <code>nameContains</code> field, the response includes information for the <code>$LATEST</code> version of all bots whose name contains the specified string.</p> </li> <li> <p>If you don't specify the <code>nameContains</code> field, the operation returns information about the <code>$LATEST</code> version of all of your bots.</p> </li> </ul> <p>This operation requires permission for the <code>lex:GetBots</code> action.</p>", "GetBuiltinIntent": "<p>Returns information about a built-in intent.</p> <p>This operation requires permission for the <code>lex:GetBuiltinIntent</code> action.</p>", "GetBuiltinIntents": "<p>Gets a list of built-in intents that meet the specified criteria.</p> <p>This operation requires permission for the <code>lex:GetBuiltinIntents</code> action.</p>", "GetBuiltinSlotTypes": "<p>Gets a list of built-in slot types that meet the specified criteria.</p> <p>For a list of built-in slot types, see <a href=\"https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference\">Slot Type Reference</a> in the <i>Alexa Skills Kit</i>.</p> <p>This operation requires permission for the <code>lex:GetBuiltInSlotTypes</code> action.</p>", "GetIntent": "<p> Returns information about an intent. In addition to the intent name, you must specify the intent version. </p> <p> This operation requires permissions to perform the <code>lex:GetIntent</code> action. </p>", - "GetIntentVersions": "<p>Gets information about all of the versions of an intent.</p> <p>The <code>GetIntentVersions</code> operation returns an <code>IntentMetadata</code> object for each version of an intent. For example, if an intent has three numbered versions, the <code>GetIntentVersions</code> operation returns four <code>IntentMetadata</code> objects in the response, one for each numbered version and one for the <code>$LATEST</code> version. </p> <p>The <code>GetIntentVersions</code> operation always returns at least one version, the <code>$LATEST</code> version.</p>", + "GetIntentVersions": "<p>Gets information about all of the versions of an intent.</p> <p>The <code>GetIntentVersions</code> operation returns an <code>IntentMetadata</code> object for each version of an intent. For example, if an intent has three numbered versions, the <code>GetIntentVersions</code> operation returns four <code>IntentMetadata</code> objects in the response, one for each numbered version and one for the <code>$LATEST</code> version. </p> <p>The <code>GetIntentVersions</code> operation always returns at least one version, the <code>$LATEST</code> version.</p> <p>This operation requires permissions for the <code>lex:GetIntentVersions</code> action.</p>", "GetIntents": "<p>Returns intent information as follows: </p> <ul> <li> <p>If you specify the <code>nameContains</code> field, returns the <code>$LATEST</code> version of all intents that contain the specified string.</p> </li> <li> <p> If you don't specify the <code>nameContains</code> field, returns information about the <code>$LATEST</code> version of all intents. </p> </li> </ul> <p> The operation requires permission for the <code>lex:GetIntents</code> action. </p>", "GetSlotType": "<p>Returns information about a specific version of a slot type. In addition to specifying the slot type name, you must specify the slot type version.</p> <p>This operation requires permissions for the <code>lex:GetSlotType</code> action.</p>", - "GetSlotTypeVersions": "<p>Gets information about all versions of a slot type.</p> <p>The <code>GetSlotTypeVersions</code> operation returns a <code>SlotTypeMetadata</code> object for each version of a slot type. For example, if a slot type has three numbered versions, the <code>GetSlotTypeVersions</code> operation returns four <code>SlotTypeMetadata</code> objects in the response, one for each numbered version and one for the <code>$LATEST</code> version. </p> <p>The <code>GetSlotTypeVersions</code> operation always returns at least one version, the <code>$LATEST</code> version.</p>", + "GetSlotTypeVersions": "<p>Gets information about all versions of a slot type.</p> <p>The <code>GetSlotTypeVersions</code> operation returns a <code>SlotTypeMetadata</code> object for each version of a slot type. For example, if a slot type has three numbered versions, the <code>GetSlotTypeVersions</code> operation returns four <code>SlotTypeMetadata</code> objects in the response, one for each numbered version and one for the <code>$LATEST</code> version. </p> <p>The <code>GetSlotTypeVersions</code> operation always returns at least one version, the <code>$LATEST</code> version.</p> <p>This operation requires permissions for the <code>lex:GetSlotTypeVersions</code> action.</p>", "GetSlotTypes": "<p>Returns slot type information as follows: </p> <ul> <li> <p>If you specify the <code>nameContains</code> field, returns the <code>$LATEST</code> version of all slot types that contain the specified string.</p> </li> <li> <p> If you don't specify the <code>nameContains</code> field, returns information about the <code>$LATEST</code> version of all slot types. </p> </li> </ul> <p> The operation requires permission for the <code>lex:GetSlotTypes</code> action. </p>", - "GetUtterancesView": "<p>Use the <code>GetUtterancesView</code> operation to get information about the utterances that your users have made to your bot. You can use this list to tune the utterances that your bot responds to.</p> <p>For example, say that you have created a bot to order flowers. After your users have used your bot for a while, use the <code>GetUtterancesView</code> operation to see the requests that they have made and whether they have been successful. You might find that the utterance \"I want flowers\" is not being recognized. You could add this utterance to the <code>OrderFlowers</code> intent so that your bot recognizes that utterance.</p> <p>After you publish a new version of a bot, you can get information about the old version and the new so that you can compare the performance across the two versions. </p> <p>You can request information for up to 5 versions in each request. The response contains information about a maximum of 100 utterances for each version.</p>", - "PutBot": "<p>Creates an Amazon Lex conversational bot or replaces an existing bot. When you create or update an intent you only required to specify a name. You can use this to add intents later, or to remove intents from an existing bot. When you create a bot with a name only, the bot is created or updated but Amazon Lex returns the <code/> response <code>FAILED</code>. You can build the bot after you add one or more intents. For more information about Amazon Lex bots, see <a>how-it-works</a>. </p> <p>If you specify the name of an existing bot, the fields in the request replace the existing values in the <code>$LATEST</code> version of the bot. Amazon Lex removes any fields that you don't provide values for in the request, except for the <code>idleTTLInSeconds</code> and <code>privacySettings</code> fields, which are set to their default values. If you don't specify values for required fields, Amazon Lex throws an exception.</p> <p>This operation requires permissions for the <code>lex:PutBot</code> action. For more information, see <a>auth-and-access-control</a>.</p>", + "GetUtterancesView": "<p>Use the <code>GetUtterancesView</code> operation to get information about the utterances that your users have made to your bot. You can use this list to tune the utterances that your bot responds to.</p> <p>For example, say that you have created a bot to order flowers. After your users have used your bot for a while, use the <code>GetUtterancesView</code> operation to see the requests that they have made and whether they have been successful. You might find that the utterance \"I want flowers\" is not being recognized. You could add this utterance to the <code>OrderFlowers</code> intent so that your bot recognizes that utterance.</p> <p>After you publish a new version of a bot, you can get information about the old version and the new so that you can compare the performance across the two versions. </p> <p>Data is available for the last 15 days. You can request information for up to 5 versions in each request. The response contains information about a maximum of 100 utterances for each version.</p> <p>If the bot's <code>childDirected</code> field is set to <code>true</code>, utterances for the bot are not stored and cannot be retrieved with the <code>GetUtterancesView</code> operation. For more information, see .</p> <p>This operation requires permissions for the <code>lex:GetUtterancesView</code> action.</p>", + "PutBot": "<p>Creates an Amazon Lex conversational bot or replaces an existing bot. When you create or update a bot you only required to specify a name. You can use this to add intents later, or to remove intents from an existing bot. When you create a bot with a name only, the bot is created or updated but Amazon Lex returns the <code/> response <code>FAILED</code>. You can build the bot after you add one or more intents. For more information about Amazon Lex bots, see <a>how-it-works</a>. </p> <p>If you specify the name of an existing bot, the fields in the request replace the existing values in the <code>$LATEST</code> version of the bot. Amazon Lex removes any fields that you don't provide values for in the request, except for the <code>idleTTLInSeconds</code> and <code>privacySettings</code> fields, which are set to their default values. If you don't specify values for required fields, Amazon Lex throws an exception.</p> <p>This operation requires permissions for the <code>lex:PutBot</code> action. For more information, see <a>auth-and-access-control</a>.</p>", "PutBotAlias": "<p>Creates an alias for the specified version of the bot or replaces an alias for the specified bot. To change the version of the bot that the alias points to, replace the alias. For more information about aliases, see <a>versioning-aliases</a>.</p> <p>This operation requires permissions for the <code>lex:PutBotAlias</code> action. </p>", - "PutIntent": "<p>Creates an intent or replaces an existing intent.</p> <p>To define the interaction between the user and your bot, you use one or more intents. For a pizza ordering bot, for example, you would create an <code>OrderPizza</code> intent. </p> <p>To create an intent or replace an existing intent, you must provide the following:</p> <ul> <li> <p>Intent name. For example, <code>OrderPizza</code>.</p> </li> <li> <p>Sample utterances. For example, \"Can I order a pizza, please.\" and \"I want to order a pizza.\"</p> </li> <li> <p>Information to be gathered. You specify slot types for the information that your bot will request from the user. You can specify standard slot types, such as a date or a time, or custom slot types such as the size and crust of a pizza.</p> </li> <li> <p>How the intent will be fulfilled. You can provide a Lambda function or configure the intent to return the intent information to the client application. If you use a Lambda function, when all of the intent information is available, Amazon Lex invokes your Lambda function. If you configure your intent to return the intent information to the client application. </p> </li> </ul> <p>You can specify other optional information in the request, such as:</p> <ul> <li> <p>A confirmation prompt to ask the user to confirm an intent. For example, \"Shall I order your pizza?\"</p> </li> <li> <p>A conclusion statement to send to the user after the intent has been fulfilled. For example, \"I placed your pizza order.\"</p> </li> <li> <p>A follow-up prompt that asks the user for additional activity. For example, asking \"Do you want to order a drink with your pizza?\"</p> </li> </ul> <p>If you specify an existing intent name to update the intent, Amazon Lex replaces the values in the <code>$LATEST</code> version of the slot type with the values in the request. Amazon Lex removes fields that you don't provide in the request. If you don't specify the required fields, Amazon Lex throws an exception.</p> <p>For more information, see <a>how-it-works</a>.</p> <p>This operation requires permissions for the <code>lex:PutIntent</code> action. For more information, see <a>auth-and-access-control</a>.</p>", + "PutIntent": "<p>Creates an intent or replaces an existing intent.</p> <p>To define the interaction between the user and your bot, you use one or more intents. For a pizza ordering bot, for example, you would create an <code>OrderPizza</code> intent. </p> <p>To create an intent or replace an existing intent, you must provide the following:</p> <ul> <li> <p>Intent name. For example, <code>OrderPizza</code>.</p> </li> <li> <p>Sample utterances. For example, \"Can I order a pizza, please.\" and \"I want to order a pizza.\"</p> </li> <li> <p>Information to be gathered. You specify slot types for the information that your bot will request from the user. You can specify standard slot types, such as a date or a time, or custom slot types such as the size and crust of a pizza.</p> </li> <li> <p>How the intent will be fulfilled. You can provide a Lambda function or configure the intent to return the intent information to the client application. If you use a Lambda function, when all of the intent information is available, Amazon Lex invokes your Lambda function. If you configure your intent to return the intent information to the client application. </p> </li> </ul> <p>You can specify other optional information in the request, such as:</p> <ul> <li> <p>A confirmation prompt to ask the user to confirm an intent. For example, \"Shall I order your pizza?\"</p> </li> <li> <p>A conclusion statement to send to the user after the intent has been fulfilled. For example, \"I placed your pizza order.\"</p> </li> <li> <p>A follow-up prompt that asks the user for additional activity. For example, asking \"Do you want to order a drink with your pizza?\"</p> </li> </ul> <p>If you specify an existing intent name to update the intent, Amazon Lex replaces the values in the <code>$LATEST</code> version of the slot type with the values in the request. Amazon Lex removes fields that you don't provide in the request. If you don't specify the required fields, Amazon Lex throws an exception.</p> <p>For more information, see <a>how-it-works</a>.</p> <p>This operation requires permissions for the <code>lex:PutIntent</code> action.</p>", "PutSlotType": "<p>Creates a custom slot type or replaces an existing custom slot type.</p> <p>To create a custom slot type, specify a name for the slot type and a set of enumeration values, which are the values that a slot of this type can assume. For more information, see <a>how-it-works</a>.</p> <p>If you specify the name of an existing slot type, the fields in the request replace the existing values in the <code>$LATEST</code> version of the slot type. Amazon Lex removes the fields that you don't provide in the request. If you don't specify required fields, Amazon Lex throws an exception.</p> <p>This operation requires permissions for the <code>lex:PutSlotType</code> action.</p>" }, "shapes": { @@ -128,6 +131,7 @@ "DeleteBotAliasRequest$botName": "<p>The name of the bot that the alias points to.</p>", "DeleteBotChannelAssociationRequest$botName": "<p>The name of the Amazon Lex bot.</p>", "DeleteBotRequest$name": "<p>The name of the bot. The name is case sensitive. </p>", + "DeleteBotVersionRequest$name": "<p>The name of the bot.</p>", "DeleteUtterancesRequest$botName": "<p>The name of the bot that stored the utterances.</p>", "GetBotAliasRequest$botName": "<p>The name of the bot.</p>", "GetBotAliasResponse$botName": "<p>The name of the bot that the alias points to.</p>", @@ -306,16 +310,31 @@ "refs": { } }, + "DeleteBotVersionRequest": { + "base": null, + "refs": { + } + }, "DeleteIntentRequest": { "base": null, "refs": { } }, + "DeleteIntentVersionRequest": { + "base": null, + "refs": { + } + }, "DeleteSlotTypeRequest": { "base": null, "refs": { } }, + "DeleteSlotTypeVersionRequest": { + "base": null, + "refs": { + } + }, "DeleteUtterancesRequest": { "base": null, "refs": { @@ -591,6 +610,7 @@ "CreateIntentVersionRequest$name": "<p>The name of the intent that you want to create a new version of. The name is case sensitive. </p>", "CreateIntentVersionResponse$name": "<p>The name of the intent.</p>", "DeleteIntentRequest$name": "<p>The name of the intent. The name is case sensitive. </p>", + "DeleteIntentVersionRequest$name": "<p>The name of the intent.</p>", "GetIntentRequest$name": "<p>The name of the intent. The name is case sensitive. </p>", "GetIntentResponse$name": "<p>The name of the intent.</p>", "GetIntentVersionsRequest$name": "<p>The name of the intent for which versions should be returned.</p>", @@ -728,6 +748,14 @@ "refs": { } }, + "NumericalVersion": { + "base": null, + "refs": { + "DeleteBotVersionRequest$version": "<p>The version of the bot to delete. You cannot delete the <code>$LATEST</code> version of the bot. To delete the <code>$LATEST</code> version, use the operation.</p>", + "DeleteIntentVersionRequest$version": "<p>The version of the intent to delete. You cannot delete the <code>$LATEST</code> version of the intent. To delete the <code>$LATEST</code> version, use the operation.</p>", + "DeleteSlotTypeVersionRequest$version": "<p>The version of the slot type to delete. You cannot delete the <code>$LATEST</code> version of the slot type. To delete the <code>$LATEST</code> version, use the operation.</p>" + } + }, "PreconditionFailedException": { "base": "<p> The checksum of the resource that you are trying to change does not match the checksum in the request. Check the resource's checksum and try again.</p>", "refs": { @@ -736,7 +764,7 @@ "Priority": { "base": null, "refs": { - "Slot$priority": "<p> Specifies the order in which to elicit slot values from the user. For example, if the intent has two slots with priorities 1 and 2, AWS Amazon Lex first elicits a value for the slot with priority 1.</p> <p>If multiple slots share the same priority, the order in which Amazon Lex elicits values is arbitrary.</p>" + "Slot$priority": "<p> Directs Lex the order in which to elicit this slot value from the user. For example, if the intent has two slots with priorities 1 and 2, AWS Lex first elicits a value for the slot with priority 1.</p> <p>If multiple slots share the same priority, the order in which Lex elicits values is arbitrary.</p>" } }, "ProcessBehavior": { @@ -886,6 +914,7 @@ "CreateSlotTypeVersionRequest$name": "<p>The name of the slot type that you want to create a new version for. The name is case sensitive. </p>", "CreateSlotTypeVersionResponse$name": "<p>The name of the slot type.</p>", "DeleteSlotTypeRequest$name": "<p>The name of the slot type. The name is case sensitive. </p>", + "DeleteSlotTypeVersionRequest$name": "<p>The name of the slot type.</p>", "GetSlotTypeRequest$name": "<p>The name of the slot type. The name is case sensitive. </p>", "GetSlotTypeResponse$name": "<p>The name of the slot type.</p>", "GetSlotTypeVersionsRequest$name": "<p>The name of the slot type for which versions should be returned.</p>", @@ -946,7 +975,7 @@ "CreateBotVersionRequest$checksum": "<p>Identifies a specific revision of the <code>$LATEST</code> version of the bot. If you specify a checksum and the <code>$LATEST</code> version of the bot has a different checksum, a <code>PreconditionFailedException</code> exception is returned and Amazon Lex doesn't publish a new version. If you don't specify a checksum, Amazon Lex publishes the <code>$LATEST</code> version.</p>", "CreateBotVersionResponse$failureReason": "<p>If <code>status</code> is <code>FAILED</code>, Amazon Lex provides the reason that it failed to build the bot.</p>", "CreateBotVersionResponse$voiceId": "<p>The Amazon Parrot voice ID that Amazon Lex uses for voice interactions with the user.</p>", - "CreateBotVersionResponse$checksum": "<p>Checksum identifying the version of the boat that was created.</p>", + "CreateBotVersionResponse$checksum": "<p>Checksum identifying the version of the bot that was created.</p>", "CreateIntentVersionRequest$checksum": "<p>Checksum of the <code>$LATEST</code> version of the intent that should be used to create the new version. If you specify a checksum and the <code>$LATEST</code> version of the intent has a different checksum, Amazon Lex returns a <code>PreconditionFailedException</code> exception and doesn't publish a new version. If you don't specify a checksum, Amazon Lex publishes the <code>$LATEST</code> version.</p>", "CreateIntentVersionResponse$checksum": "<p>Checksum of the intent version created.</p>", "CreateSlotTypeVersionRequest$checksum": "<p>Checksum for the <code>$LATEST</code> version of the slot type that you want to publish. If you specify a checksum and the <code>$LATEST</code> version of the slot type has a different checksum, Amazon Lex returns a <code>PreconditionFailedException</code> exception and doesn't publish the new version. If you don't specify a checksum, Amazon Lex publishes the <code>$LATEST</code> version.</p>", @@ -1063,9 +1092,6 @@ "CreateBotVersionResponse$version": "<p>The version of the bot. </p>", "CreateIntentVersionResponse$version": "<p>The version number assigned to the new version of the intent.</p>", "CreateSlotTypeVersionResponse$version": "<p>The version assigned to the new slot type version. </p>", - "DeleteBotRequest$version": "<p>The version of the bot.</p>", - "DeleteIntentRequest$version": "<p>The version of the intent.</p>", - "DeleteSlotTypeRequest$version": "<p>The version of the slot type.</p>", "GetBotAliasResponse$botVersion": "<p>The version of the bot that the alias points to.</p>", "GetBotResponse$version": "<p>The version of the bot. For a new bot, the version is always <code>$LATEST</code>.</p>", "GetIntentRequest$version": "<p>The version of the intent.</p>", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/api-2.json index b519fb09..07d9b4a3 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/api-2.json @@ -749,6 +749,24 @@ {"shape":"UnauthenticatedException"} ] }, + "PutInstancePublicPorts":{ + "name":"PutInstancePublicPorts", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"PutInstancePublicPortsRequest"}, + "output":{"shape":"PutInstancePublicPortsResult"}, + "errors":[ + {"shape":"ServiceException"}, + {"shape":"InvalidInputException"}, + {"shape":"NotFoundException"}, + {"shape":"OperationFailureException"}, + {"shape":"AccessDeniedException"}, + {"shape":"AccountSetupInProgressException"}, + {"shape":"UnauthenticatedException"} + ] + }, "RebootInstance":{ "name":"RebootInstance", "http":{ @@ -1375,7 +1393,7 @@ "GetInstancePortStatesResult":{ "type":"structure", "members":{ - "portStates":{"shape":"PortStateList"} + "portStates":{"shape":"InstancePortStateList"} } }, "GetInstanceRequest":{ @@ -1654,6 +1672,19 @@ "type":"list", "member":{"shape":"InstancePortInfo"} }, + "InstancePortState":{ + "type":"structure", + "members":{ + "fromPort":{"shape":"Port"}, + "toPort":{"shape":"Port"}, + "protocol":{"shape":"NetworkProtocol"}, + "state":{"shape":"PortState"} + } + }, + "InstancePortStateList":{ + "type":"list", + "member":{"shape":"InstancePortState"} + }, "InstanceSnapshot":{ "type":"structure", "members":{ @@ -1898,6 +1929,7 @@ "StartInstance", "RebootInstance", "OpenInstancePublicPorts", + "PutInstancePublicPorts", "CloseInstancePublicPorts", "AllocateStaticIp", "ReleaseStaticIp", @@ -1943,6 +1975,10 @@ "protocol":{"shape":"NetworkProtocol"} } }, + "PortInfoList":{ + "type":"list", + "member":{"shape":"PortInfo"} + }, "PortState":{ "type":"string", "enum":[ @@ -1950,9 +1986,22 @@ "closed" ] }, - "PortStateList":{ - "type":"list", - "member":{"shape":"PortState"} + "PutInstancePublicPortsRequest":{ + "type":"structure", + "required":[ + "portInfos", + "instanceName" + ], + "members":{ + "portInfos":{"shape":"PortInfoList"}, + "instanceName":{"shape":"ResourceName"} + } + }, + "PutInstancePublicPortsResult":{ + "type":"structure", + "members":{ + "operation":{"shape":"Operation"} + } }, "RebootInstanceRequest":{ "type":"structure", @@ -2039,7 +2088,8 @@ "message":{"shape":"string"}, "tip":{"shape":"string"} }, - "exception":true + "exception":true, + "fault":true }, "StartInstanceRequest":{ "type":"structure", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/docs-2.json index 97e2ab6f..70b4e6be 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "<p>Amazon Lightsail is the easiest way to get started with AWS for developers who just need virtual private servers. Lightsail includes everything you need to launch your project quickly - a virtual machine, SSD-based storage, data transfer, DNS management, and a static IP - for a low, predictable price. You manage those Lightsail servers through the Lightsail console or by using the API or command-line interface (CLI).</p> <p>For more information about Lightsail concepts and tasks, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs\">Lightsail Dev Guide</a>.</p> <p>To use the Lightsail API or the CLI, you will need to use AWS Identity and Access Management (IAM) to generate access keys. For details about how to set this up, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/how-to/articles/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli\">Lightsail Dev Guide</a>.</p>", + "service": "<p>Amazon Lightsail is the easiest way to get started with AWS for developers who just need virtual private servers. Lightsail includes everything you need to launch your project quickly - a virtual machine, SSD-based storage, data transfer, DNS management, and a static IP - for a low, predictable price. You manage those Lightsail servers through the Lightsail console or by using the API or command-line interface (CLI).</p> <p>For more information about Lightsail concepts and tasks, see the <a href=\"https://lightsail.aws.amazon.com/ls/docs/all\">Lightsail Dev Guide</a>.</p> <p>To use the Lightsail API or the CLI, you will need to use AWS Identity and Access Management (IAM) to generate access keys. For details about how to set this up, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/how-to/article/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli\">Lightsail Dev Guide</a>.</p>", "operations": { "AllocateStaticIp": "<p>Allocates a static IP address.</p>", "AttachStaticIp": "<p>Attaches a static IP address to a specific Amazon Lightsail instance.</p>", @@ -36,13 +36,14 @@ "GetOperation": "<p>Returns information about a specific operation. Operations include events such as when you create an instance, allocate a static IP, attach a static IP, and so on.</p>", "GetOperations": "<p>Returns information about all operations.</p> <p>Results are returned from oldest to newest, up to a maximum of 200. Results can be paged by making each subsequent call to <code>GetOperations</code> use the maximum (last) <code>statusChangedAt</code> value from the previous request.</p>", "GetOperationsForResource": "<p>Gets operations for a specific resource (e.g., an instance or a static IP).</p>", - "GetRegions": "<p>Returns a list of all valid regions for Amazon Lightsail.</p>", + "GetRegions": "<p>Returns a list of all valid regions for Amazon Lightsail. Use the <code>include availability zones</code> parameter to also return the availability zones in a region.</p>", "GetStaticIp": "<p>Returns information about a specific static IP.</p>", "GetStaticIps": "<p>Returns information about all static IPs in the user's account.</p>", "ImportKeyPair": "<p>Imports a public SSH key from a specific key pair.</p>", "IsVpcPeered": "<p>Returns a Boolean value indicating whether your Lightsail VPC is peered.</p>", "OpenInstancePublicPorts": "<p>Adds public ports to an Amazon Lightsail instance.</p>", "PeerVpc": "<p>Tries to peer the Lightsail VPC with the user's default VPC.</p>", + "PutInstancePublicPorts": "<p>Sets the specified open ports for an Amazon Lightsail instance, and closes all ports for every protocol not included in the current request.</p>", "RebootInstance": "<p>Restarts a specific instance. When your Amazon Lightsail instance is finished rebooting, Lightsail assigns a new public IP address. To use the same IP address after restarting, create a static IP address and attach it to the instance.</p>", "ReleaseStaticIp": "<p>Deletes a specific static IP from your account.</p>", "StartInstance": "<p>Starts a specific Amazon Lightsail instance from a stopped state. To restart an instance, use the reboot instance operation.</p>", @@ -96,7 +97,7 @@ "AvailabilityZoneList": { "base": null, "refs": { - "Region$availabilityZones": "<p>The Availability Zones.</p>" + "Region$availabilityZones": "<p>The Availability Zones. Follows the format <code>us-east-1a</code> (case-sensitive).</p>" } }, "Base64": { @@ -627,6 +628,18 @@ "InstanceNetworking$ports": "<p>An array of key-value pairs containing information about the ports on the instance.</p>" } }, + "InstancePortState": { + "base": "<p>Describes the port state.</p>", + "refs": { + "InstancePortStateList$member": null + } + }, + "InstancePortStateList": { + "base": null, + "refs": { + "GetInstancePortStatesResult$portStates": "<p>Information about the port states resulting from your request.</p>" + } + }, "InstanceSnapshot": { "base": "<p>Describes the snapshot of the virtual private server, or <i>instance</i>.</p>", "refs": { @@ -654,7 +667,7 @@ } }, "InvalidInputException": { - "base": "<p>Lightsail throws this exception when user input does not conform to the validation rules of an input field.</p>", + "base": "<p>Lightsail throws this exception when user input does not conform to the validation rules of an input field.</p> <note> <p>Domain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set your Region configuration to us-east-1 to create, view, or edit these resources.</p> </note>", "refs": { } }, @@ -757,14 +770,15 @@ "NetworkProtocol": { "base": null, "refs": { - "InstancePortInfo$protocol": "<p>The protocol. </p>", + "InstancePortInfo$protocol": "<p>The protocol being used. Can be one of the following.</p> <ul> <li> <p> <code>tcp</code> - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead.</p> </li> <li> <p> <code>all</code> - All transport layer protocol types. For more general information, see <a href=\"https://en.wikipedia.org/wiki/Transport_layer\">Transport layer</a> on Wikipedia.</p> </li> <li> <p> <code>udp</code> - With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead.</p> </li> </ul>", + "InstancePortState$protocol": "<p>The protocol being used. Can be one of the following.</p> <ul> <li> <p> <code>tcp</code> - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead.</p> </li> <li> <p> <code>all</code> - All transport layer protocol types. For more general information, see <a href=\"https://en.wikipedia.org/wiki/Transport_layer\">Transport layer</a> on Wikipedia.</p> </li> <li> <p> <code>udp</code> - With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead.</p> </li> </ul>", "PortInfo$protocol": "<p>The protocol. </p>" } }, "NonEmptyString": { "base": null, "refs": { - "AvailabilityZone$zoneName": "<p>The name of the Availability Zone.</p>", + "AvailabilityZone$zoneName": "<p>The name of the Availability Zone. The format is <code>us-east-1a</code> (case-sensitive).</p>", "AvailabilityZone$state": "<p>The state of the Availability Zone.</p>", "Blueprint$blueprintId": "<p>The ID for the virtual private server image (e.g., <code>app_wordpress_4_4</code> or <code>app_lamp_7_0</code>).</p>", "Blueprint$group": "<p>The group name of the blueprint (e.g., <code>amazon-linux</code>).</p>", @@ -818,6 +832,7 @@ "OpenInstancePublicPortsResult$operation": "<p>An array of key-value pairs containing information about the request operation.</p>", "OperationList$member": null, "PeerVpcResult$operation": "<p>An array of key-value pairs containing information about the request operation.</p>", + "PutInstancePublicPortsResult$operation": "<p>Describes metadata about the operation you just executed.</p>", "UnpeerVpcResult$operation": "<p>An array of key-value pairs containing information about the request operation.</p>" } }, @@ -873,6 +888,8 @@ "refs": { "InstancePortInfo$fromPort": "<p>The first port in the range.</p>", "InstancePortInfo$toPort": "<p>The last port in the range.</p>", + "InstancePortState$fromPort": "<p>The first port in the range.</p>", + "InstancePortState$toPort": "<p>The last port in the range.</p>", "PortInfo$fromPort": "<p>The first port in the range.</p>", "PortInfo$toPort": "<p>The last port in the range.</p>" } @@ -887,19 +904,30 @@ "base": "<p>Describes information about the ports on your virtual private server (or <i>instance</i>).</p>", "refs": { "CloseInstancePublicPortsRequest$portInfo": "<p>Information about the public port you are trying to close.</p>", - "OpenInstancePublicPortsRequest$portInfo": "<p>An array of key-value pairs containing information about the port mappings.</p>" + "OpenInstancePublicPortsRequest$portInfo": "<p>An array of key-value pairs containing information about the port mappings.</p>", + "PortInfoList$member": null + } + }, + "PortInfoList": { + "base": null, + "refs": { + "PutInstancePublicPortsRequest$portInfos": "<p>Specifies information about the public port(s).</p>" } }, "PortState": { "base": null, "refs": { - "PortStateList$member": null + "InstancePortState$state": "<p>Specifies whether the instance port is <code>open</code> or <code>closed</code>.</p>" } }, - "PortStateList": { + "PutInstancePublicPortsRequest": { + "base": null, + "refs": { + } + }, + "PutInstancePublicPortsResult": { "base": null, "refs": { - "GetInstancePortStatesResult$portStates": "<p>Information about the port states resulting from your request.</p>" } }, "RebootInstanceRequest": { @@ -992,6 +1020,7 @@ "KeyPair$name": "<p>The friendly name of the SSH key pair.</p>", "OpenInstancePublicPortsRequest$instanceName": "<p>The name of the instance for which you want to open the public ports.</p>", "Operation$resourceName": "<p>The resource name.</p>", + "PutInstancePublicPortsRequest$instanceName": "<p>The Lightsail instance name of the public port(s) you are setting.</p>", "RebootInstanceRequest$instanceName": "<p>The name of the instance to reboot.</p>", "ReleaseStaticIpRequest$staticIpName": "<p>The name of the static IP to delete.</p>", "StartInstanceRequest$instanceName": "<p>The name of the instance (a virtual private server) to start.</p>", @@ -1152,9 +1181,9 @@ "Blueprint$licenseUrl": "<p>The end-user license agreement URL for the image or blueprint.</p>", "Bundle$instanceType": "<p>The Amazon EC2 instance type (e.g., <code>t2.micro</code>).</p>", "Bundle$name": "<p>A friendly name for the bundle (e.g., <code>Micro</code>).</p>", - "CreateInstancesFromSnapshotRequest$availabilityZone": "<p>The Availability Zone where you want to create your instances. Use the following formatting: <code>us-east-1a</code> (case sensitive).</p>", + "CreateInstancesFromSnapshotRequest$availabilityZone": "<p>The Availability Zone where you want to create your instances. Use the following formatting: <code>us-east-1a</code> (case sensitive). You can get a list of availability zones by using the <a href=\"http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html\">get regions</a> operation. Be sure to add the <code>include availability zones</code> parameter to your request.</p>", "CreateInstancesFromSnapshotRequest$userData": "<p>You can create a launch script that configures a server with additional user data. For example, <code>apt-get –y update</code>.</p> <note> <p>Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use <code>yum</code>, Debian and Ubuntu use <code>apt-get</code>, and FreeBSD uses <code>pkg</code>. For a complete list, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/getting-started/articles/pre-installed-apps\">Dev Guide</a>.</p> </note>", - "CreateInstancesRequest$availabilityZone": "<p>The Availability Zone in which to create your instance. Use the following format: <code>us-east-1a</code> (case sensitive).</p>", + "CreateInstancesRequest$availabilityZone": "<p>The Availability Zone in which to create your instance. Use the following format: <code>us-east-1a</code> (case sensitive). You can get a list of availability zones by using the <a href=\"http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html\">get regions</a> operation. Be sure to add the <code>include availability zones</code> parameter to your request.</p>", "CreateInstancesRequest$userData": "<p>A launch script you can create that configures a server with additional user data. For example, you might want to run <code>apt-get –y update</code>.</p> <note> <p>Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use <code>yum</code>, Debian and Ubuntu use <code>apt-get</code>, and FreeBSD uses <code>pkg</code>. For a complete list, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/getting-started/articles/pre-installed-apps\">Dev Guide</a>.</p> </note>", "Disk$supportCode": "<p>The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.</p>", "Disk$path": "<p>The disk path.</p>", @@ -1214,7 +1243,7 @@ "Region$continentCode": "<p>The continent code (e.g., <code>NA</code>, meaning North America).</p>", "Region$description": "<p>The description of the AWS Region (e.g., <code>This region is recommended to serve users in the eastern United States and eastern Canada</code>).</p>", "Region$displayName": "<p>The display name (e.g., <code>Virginia</code>).</p>", - "ResourceLocation$availabilityZone": "<p>The Availability Zone.</p>", + "ResourceLocation$availabilityZone": "<p>The Availability Zone. Follows the format <code>us-east-1a</code> (case-sensitive).</p>", "ServiceException$code": null, "ServiceException$docs": null, "ServiceException$message": null, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/paginators-1.json new file mode 100644 index 00000000..5677bd8e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/paginators-1.json @@ -0,0 +1,4 @@ +{ + "pagination": { + } +} diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/docs-2.json index 2e059518..4b5fc567 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/docs-2.json @@ -26,7 +26,7 @@ "PutLogEvents": "<p>Uploads a batch of log events to the specified log stream.</p> <p>You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using <a>DescribeLogStreams</a>.</p> <p>The batch of events must satisfy the following constraints:</p> <ul> <li> <p>The maximum batch size is 1,048,576 bytes, and this size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.</p> </li> <li> <p>None of the log events in the batch can be more than 2 hours in the future.</p> </li> <li> <p>None of the log events in the batch can be older than 14 days or the retention period of the log group.</p> </li> <li> <p>The log events in the batch must be in chronological ordered by their timestamp (the time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC).</p> </li> <li> <p>The maximum number of log events in a batch is 10,000.</p> </li> <li> <p>A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.</p> </li> </ul>", "PutMetricFilter": "<p>Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through <a>PutLogEvents</a>.</p> <p>The maximum number of metric filters that can be associated with a log group is 100.</p>", "PutRetentionPolicy": "<p>Sets the retention of the specified log group. A retention policy allows you to configure the number of days you want to retain log events in the specified log group.</p>", - "PutSubscriptionFilter": "<p>Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through <a>PutLogEvents</a> and have them delivered to a specific destination. Currently, the supported destinations are:</p> <ul> <li> <p>An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>A logical destination that belongs to a different account, for cross-account delivery.</p> </li> <li> <p>An Amazon Kinesis Firehose stream that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>An AWS Lambda function that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> </ul> <p>There can only be one subscription filter associated with a log group.</p>", + "PutSubscriptionFilter": "<p>Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through <a>PutLogEvents</a> and have them delivered to a specific destination. Currently, the supported destinations are:</p> <ul> <li> <p>An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>A logical destination that belongs to a different account, for cross-account delivery.</p> </li> <li> <p>An Amazon Kinesis Firehose stream that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>An AWS Lambda function that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> </ul> <p>There can only be one subscription filter associated with a log group. If you are updating an existing filter, you must specify the correct name in <code>filterName</code>. Otherwise, the call will fail because you cannot associate a second filter with a log group.</p>", "TagLogGroup": "<p>Adds or updates the specified tags for the specified log group.</p> <p>To list the tags for a log group, use <a>ListTagsLogGroup</a>. To remove tags, use <a>UntagLogGroup</a>.</p> <p>For more information about tags, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/log-group-tagging.html\">Tag Log Groups in Amazon CloudWatch Logs</a> in the <i>Amazon CloudWatch Logs User Guide</i>.</p>", "TestMetricFilter": "<p>Tests the filter pattern of a metric filter against a sample of log event messages. You can use this operation to validate the correctness of a metric filter pattern.</p>", "UntagLogGroup": "<p>Removes the specified tags from the specified log group.</p> <p>To list the tags for a log group, use <a>ListTagsLogGroup</a>. To add tags, use <a>UntagLogGroup</a>.</p>" @@ -361,7 +361,7 @@ "DescribeSubscriptionFiltersRequest$filterNamePrefix": "<p>The prefix to match. If you don't specify a value, no prefix filter is applied.</p>", "MetricFilter$filterName": "<p>The name of the metric filter.</p>", "PutMetricFilterRequest$filterName": "<p>A name for the metric filter.</p>", - "PutSubscriptionFilterRequest$filterName": "<p>A name for the subscription filter.</p>", + "PutSubscriptionFilterRequest$filterName": "<p>A name for the subscription filter. If you are updating an existing filter, you must specify the correct name in <code>filterName</code>. Otherwise, the call will fail because you cannot associate a second filter with a log group. To find the name of the filter currently associated with a log group, use <a>DescribeSubscriptionFilters</a>.</p>", "SubscriptionFilter$filterName": "<p>The name of the subscription filter.</p>" } }, @@ -622,7 +622,7 @@ "OrderBy": { "base": null, "refs": { - "DescribeLogStreamsRequest$orderBy": "<p>If the value is <code>LogStreamName</code>, the results are ordered by log stream name. If the value is <code>LastEventTime</code>, the results are ordered by the event time. The default value is <code>LogStreamName</code>.</p> <p>If you order the results by event time, you cannot specify the <code>logStreamNamePrefix</code> parameter.</p>" + "DescribeLogStreamsRequest$orderBy": "<p>If the value is <code>LogStreamName</code>, the results are ordered by log stream name. If the value is <code>LastEventTime</code>, the results are ordered by the event time. The default value is <code>LogStreamName</code>.</p> <p>If you order the results by event time, you cannot specify the <code>logStreamNamePrefix</code> parameter.</p> <p>lastEventTimestamp represents the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. lastEventTimeStamp updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.</p>" } }, "OutputLogEvent": { @@ -814,27 +814,27 @@ "refs": { "CreateExportTaskRequest$from": "<p>The start time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp earlier than this time are not exported.</p>", "CreateExportTaskRequest$to": "<p>The end time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not exported.</p>", - "Destination$creationTime": "<p>The creation time of the destination.</p>", + "Destination$creationTime": "<p>The creation time of the destination, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", "ExportTask$from": "<p>The start time, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp prior to this time are not exported.</p>", "ExportTask$to": "<p>The end time, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not exported.</p>", - "ExportTaskExecutionInfo$creationTime": "<p>The creation time of the export task.</p>", - "ExportTaskExecutionInfo$completionTime": "<p>The completion time of the export task.</p>", + "ExportTaskExecutionInfo$creationTime": "<p>The creation time of the export task, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", + "ExportTaskExecutionInfo$completionTime": "<p>The completion time of the export task, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", "FilterLogEventsRequest$startTime": "<p>The start of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp prior to this time are not returned.</p>", "FilterLogEventsRequest$endTime": "<p>The end of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not returned.</p>", "FilteredLogEvent$timestamp": "<p>The time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", - "FilteredLogEvent$ingestionTime": "<p>The time the event was ingested.</p>", + "FilteredLogEvent$ingestionTime": "<p>The time the event was ingested, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", "GetLogEventsRequest$startTime": "<p>The start of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp earlier than this time are not included.</p>", "GetLogEventsRequest$endTime": "<p>The end of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not included.</p>", "InputLogEvent$timestamp": "<p>The time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", - "LogGroup$creationTime": "<p>The creation time of the log group.</p>", - "LogStream$creationTime": "<p>The creation time of the stream.</p>", + "LogGroup$creationTime": "<p>The creation time of the log group, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", + "LogStream$creationTime": "<p>The creation time of the stream, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", "LogStream$firstEventTimestamp": "<p>The time of the first event, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", - "LogStream$lastEventTimestamp": "<p>The time of the last event, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", - "LogStream$lastIngestionTime": "<p>The ingestion time.</p>", - "MetricFilter$creationTime": "<p>The creation time of the metric filter.</p>", + "LogStream$lastEventTimestamp": "<p> the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. lastEventTime updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.</p>", + "LogStream$lastIngestionTime": "<p>The ingestion time, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", + "MetricFilter$creationTime": "<p>The creation time of the metric filter, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", "OutputLogEvent$timestamp": "<p>The time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", - "OutputLogEvent$ingestionTime": "<p>The time the event was ingested.</p>", - "SubscriptionFilter$creationTime": "<p>The creation time of the subscription filter.</p>" + "OutputLogEvent$ingestionTime": "<p>The time the event was ingested, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>", + "SubscriptionFilter$creationTime": "<p>The creation time of the subscription filter, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>" } }, "Token": { diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/paginators-1.json index f6893241..d7020682 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/paginators-1.json @@ -2,38 +2,38 @@ "pagination": { "DescribeDestinations": { "input_token": "nextToken", - "output_token": "nextToken", "limit_key": "limit", + "output_token": "nextToken", "result_key": "destinations" }, "DescribeLogGroups": { "input_token": "nextToken", - "output_token": "nextToken", "limit_key": "limit", + "output_token": "nextToken", "result_key": "logGroups" }, "DescribeLogStreams": { "input_token": "nextToken", - "output_token": "nextToken", "limit_key": "limit", + "output_token": "nextToken", "result_key": "logStreams" }, "DescribeMetricFilters": { "input_token": "nextToken", - "output_token": "nextToken", "limit_key": "limit", + "output_token": "nextToken", "result_key": "metricFilters" }, "DescribeSubscriptionFilters": { "input_token": "nextToken", - "output_token": "nextToken", "limit_key": "limit", + "output_token": "nextToken", "result_key": "subscriptionFilters" }, "FilterLogEvents": { "input_token": "nextToken", - "output_token": "nextToken", "limit_key": "limit", + "output_token": "nextToken", "result_key": [ "events", "searchedLogStreams" @@ -41,9 +41,9 @@ }, "GetLogEvents": { "input_token": "nextToken", - "output_token": "nextForwardToken", "limit_key": "limit", + "output_token": "nextForwardToken", "result_key": "events" } } -} +}
\ No newline at end of file diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/api-2.json index a8c72807..d5d993fa 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/api-2.json @@ -742,6 +742,7 @@ "members":{ "Id":{"shape":"AccountId"}, "Arn":{"shape":"AccountArn"}, + "Email":{"shape":"Email"}, "Name":{"shape":"AccountName"}, "Status":{"shape":"AccountStatus"}, "JoinedMethod":{"shape":"AccountJoinedMethod"}, @@ -883,7 +884,9 @@ "MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED", "ACCOUNT_CANNOT_LEAVE_ORGANIZATION", "MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED", - "ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED" + "MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED", + "ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED", + "MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE" ] }, "CreateAccountFailureReason":{ @@ -892,6 +895,7 @@ "ACCOUNT_LIMIT_EXCEEDED", "EMAIL_ALREADY_EXISTS", "INVALID_ADDRESS", + "INVALID_EMAIL", "INTERNAL_FAILURE" ] }, @@ -1175,7 +1179,7 @@ "type":"string", "max":64, "min":6, - "pattern":"[\\w+=,.-]+@[\\w.-]+\\.[\\w]+", + "pattern":"[^\\s@]+@[^\\s@]+\\.[^\\s@]+", "sensitive":true }, "EnableAllFeaturesRequest":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/docs-2.json index c48d8037..1791ca3e 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/docs-2.json @@ -5,7 +5,7 @@ "AcceptHandshake": "<p>Sends a response to the originator of a handshake agreeing to the action proposed by the handshake request. </p> <p>This operation can be called only by the following principals when they also have the relevant IAM permissions:</p> <ul> <li> <p> <b>Invitation to join</b> or <b>Approve all features request</b> handshakes: only a principal from the member account. </p> </li> <li> <p> <b>Enable all features final confirmation</b> handshake: only a principal from the master account.</p> <p>For more information about invitations, see <a href=\"http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_invites.html\">Inviting an AWS Account to Join Your Organization</a> in the <i>AWS Organizations User Guide</i>. For more information about requests to enable all features in the organization, see <a href=\"http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html\">Enabling All Features in Your Organization</a> in the <i>AWS Organizations User Guide</i>.</p> </li> </ul>", "AttachPolicy": "<p>Attaches a policy to a root, an organizational unit, or an individual account. How the policy affects accounts depends on the type of policy:</p> <ul> <li> <p> <b>Service control policy (SCP)</b> - An SCP specifies what permissions can be delegated to users in affected member accounts. The scope of influence for a policy depends on what you attach the policy to:</p> <ul> <li> <p>If you attach an SCP to a root, it affects all accounts in the organization.</p> </li> <li> <p>If you attach an SCP to an OU, it affects all accounts in that OU and in any child OUs.</p> </li> <li> <p>If you attach the policy directly to an account, then it affects only that account.</p> </li> </ul> <p>SCPs essentially are permission \"filters\". When you attach one SCP to a higher level root or OU, and you also attach a different SCP to a child OU or to an account, the child policy can further restrict only the permissions that pass through the parent filter and are available to the child. An SCP that is attached to a child cannot grant a permission that is not already granted by the parent. For example, imagine that the parent SCP allows permissions A, B, C, D, and E. The child SCP allows C, D, E, F, and G. The result is that the accounts affected by the child SCP are allowed to use only C, D, and E. They cannot use A or B because they were filtered out by the child OU. They also cannot use F and G because they were filtered out by the parent OU. They cannot be granted back by the child SCP; child SCPs can only filter the permissions they receive from the parent SCP.</p> <p>AWS Organizations attaches a default SCP named <code>\"FullAWSAccess</code> to every root, OU, and account. This default SCP allows all services and actions, enabling any new child OU or account to inherit the permissions of the parent root or OU. If you detach the default policy, you must replace it with a policy that specifies the permissions that you want to allow in that OU or account.</p> <p>For more information about how Organizations policies permissions work, see <a href=\"http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scp.html\">Using Service Control Policies</a> in the <i>AWS Organizations User Guide</i>.</p> </li> </ul> <p>This operation can be called only from the organization's master account.</p>", "CancelHandshake": "<p>Cancels a handshake. Canceling a handshake sets the handshake state to <code>CANCELED</code>. </p> <p>This operation can be called only from the account that originated the handshake. The recipient of the handshake can't cancel it, but can use <a>DeclineHandshake</a> instead. After a handshake is canceled, the recipient can no longer respond to that handshake. </p>", - "CreateAccount": "<p>Creates an AWS account that is automatically a member of the organization whose credentials made the request. This is an asynchronous request that AWS performs in the background. If you want to check the status of the request later, you need the <code>OperationId</code> response element from this operation to provide as a parameter to the <a>DescribeCreateAccountStatus</a> operation.</p> <p>AWS Organizations preconfigures the new member account with a role (named <code>OrganizationAccountAccessRole</code> by default) that grants administrator permissions to the new account. Principals in the master account can assume the role. AWS Organizations clones the company name and address information for the new account from the organization's master account.</p> <p>For more information about creating accounts, see <a href=\"http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_create.html\">Creating an AWS Account in Your Organization</a> in the <i>AWS Organizations User Guide</i>.</p> <important> <p>You cannot remove accounts that are created with this operation from an organization. That also means that you cannot delete an organization that contains an account that is created with this operation.</p> </important> <note> <p>When you create a member account with this operation, the account is created with the <b>IAM User and Role Access to Billing Information</b> switch enabled. This allows IAM users and roles that are granted appropriate permissions to view billing information. If this is disabled, then only the account root user can access billing information. For information about how to disable this for an account, see <a href=\"http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html\">Granting Access to Your Billing Information and Tools</a>.</p> </note> <p>This operation can be called only from the organization's master account.</p>", + "CreateAccount": "<p>Creates an AWS account that is automatically a member of the organization whose credentials made the request. This is an asynchronous request that AWS performs in the background. If you want to check the status of the request later, you need the <code>OperationId</code> response element from this operation to provide as a parameter to the <a>DescribeCreateAccountStatus</a> operation.</p> <p>AWS Organizations preconfigures the new member account with a role (named <code>OrganizationAccountAccessRole</code> by default) that grants administrator permissions to the new account. Principals in the master account can assume the role. AWS Organizations clones the company name and address information for the new account from the organization's master account.</p> <p>For more information about creating accounts, see <a href=\"http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_create.html\">Creating an AWS Account in Your Organization</a> in the <i>AWS Organizations User Guide</i>.</p> <important> <p>You cannot remove accounts that are created with this operation from an organization. That also means that you cannot delete an organization that contains an account that is created with this operation.</p> </important> <note> <p>When you create a member account with this operation, you can choose whether to create the account with the <b>IAM User and Role Access to Billing Information</b> switch enabled. If you enable it, IAM users and roles that have appropriate permissions can view billing information for the account. If you disable this, then only the account root user can access billing information. For information about how to disable this for an account, see <a href=\"http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html\">Granting Access to Your Billing Information and Tools</a>.</p> </note> <p>This operation can be called only from the organization's master account.</p>", "CreateOrganization": "<p>Creates an AWS organization. The account whose user is calling the CreateOrganization operation automatically becomes the <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/orgs_getting-started_concepts.html#account\">master account</a> of the new organization.</p> <p>This operation must be called using credentials from the account that is to become the new organization's master account. The principal must also have the relevant IAM permissions.</p> <p>By default (or if you set the <code>FeatureSet</code> parameter to <code>ALL</code>), the new organization is created with all features enabled and service control policies automatically enabled in the root. If you instead choose to create the organization supporting only the consolidated billing features by setting the <code>FeatureSet</code> parameter to <code>CONSOLIDATED_BILLING\"</code>, then no policy types are enabled by default and you cannot use organization policies.</p>", "CreateOrganizationalUnit": "<p>Creates an organizational unit (OU) within a root or parent OU. An OU is a container for accounts that enables you to organize your accounts to apply policies according to your business requirements. The number of levels deep that you can nest OUs is dependent upon the policy types enabled for that root. For service control policies, the limit is five. </p> <p>For more information about OUs, see <a href=\"http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_ous.html\">Managing Organizational Units</a> in the <i>AWS Organizations User Guide</i>.</p> <p>This operation can be called only from the organization's master account.</p>", "CreatePolicy": "<p>Creates a policy of a specified type that you can attach to a root, an organizational unit (OU), or an individual AWS account.</p> <p>For more information about policies and their use, see <a href=\"http://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies.html\">Managing Organization Policies</a>.</p> <p>This operation can be called only from the organization's master account.</p>", @@ -190,7 +190,7 @@ } }, "ConstraintViolationException": { - "base": "<p>Performing this operation violates a minimum or maximum value limit. For example, attempting to removing the last SCP from an OU or root, inviting or creating too many accounts to the organization, or attaching too many policies to an account, OU, or root.</p>", + "base": "<p>Performing this operation violates a minimum or maximum value limit. For example, attempting to removing the last SCP from an OU or root, inviting or creating too many accounts to the organization, or attaching too many policies to an account, OU, or root. This exception includes a reason that contains additional information about the violated limit:</p> <p/> <ul> <li> <p>ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number of accounts in an organization. <b>Note</b>: deleted and closed accounts still count toward your limit.</p> </li> <li> <p>HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of handshakes you can send in one day.</p> </li> <li> <p>OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational units you can have in an organization.</p> </li> <li> <p>OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit tree that is too many levels deep.</p> </li> <li> <p>POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of policies that you can have in an organization.</p> </li> <li> <p>MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the number of policies of a certain type that can be attached to an entity at one time.</p> </li> <li> <p>MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a policy from an entity that would cause the entity to have fewer than the minimum number of policies of a certain type required.</p> </li> <li> <p>ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account from an organization that was created from within organizations.</p> </li> <li> <p>MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization with this account, you first must associate a payment instrument, such as a credit card, with the account.</p> </li> <li> <p>MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation with this member account, you first must associate a payment instrument, such as a credit card, with the account.</p> </li> <li> <p>ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of accounts that you can create in one day.</p> </li> <li> <p>MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account in this organization, you first must migrate the organization's master account to the marketplace that corresponds to the master account's address. For example, accounts with India addresses must be associated with the AISPL marketplace. All accounts in an organization must be associated with the same marketplace.</p> </li> </ul>", "refs": { } }, @@ -203,7 +203,7 @@ "CreateAccountFailureReason": { "base": null, "refs": { - "CreateAccountStatus$FailureReason": "<p>If the request failed, a description of the reason for the failure.</p>" + "CreateAccountStatus$FailureReason": "<p>If the request failed, a description of the reason for the failure.</p> <ul> <li> <p>ACCOUNT_LIMIT_EXCEEDED: The account could not be created because you have reached the limit on the number of accounts in your organization.</p> </li> <li> <p>EMAIL_ALREADY_EXISTS: The account could not be created because another AWS account with that email address already exists.</p> </li> <li> <p>INVALID_ADDRESS: The account could not be created because the address you provided is not valid.</p> </li> <li> <p>INVALID_EMAIL: The account could not be created because the email address you provided is not valid.</p> </li> <li> <p>INTERNAL_FAILURE: The account could not be created because of an internal failure. Try again later. If the problem persists, contact Customer Support.</p> </li> </ul>" } }, "CreateAccountRequest": { @@ -408,6 +408,7 @@ "Email": { "base": null, "refs": { + "Account$Email": "<p>The email address associated with the AWS account.</p> <p>The <a href=\"http://wikipedia.org/wiki/regex\">regex pattern</a> for this parameter is a string of characters that represents a standard Internet email address.</p>", "CreateAccountRequest$Email": "<p>The email address of the owner to assign to the new member account. This email address must not already be associated with another AWS account.</p>", "Organization$MasterAccountEmail": "<p>The email address that is associated with the AWS account that is designated as the master account for the organization.</p>" } @@ -515,7 +516,7 @@ } }, "HandshakeConstraintViolationException": { - "base": "<p>The requested operation would violate the constraint identified in the reason code.</p>", + "base": "<p>The requested operation would violate the constraint identified in the reason code.</p> <ul> <li> <p>ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number of accounts in an organization. <b>Note</b>: deleted and closed accounts still count toward your limit.</p> </li> <li> <p>HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of handshakes you can send in one day.</p> </li> <li> <p>ALREADY_IN_AN_ORGANIZATION: The handshake request is invalid because the invited account is already a member of an organization.</p> </li> <li> <p>ORGANIZATION_ALREADY_HAS_ALL_FEATURES: The handshake request is invalid because the organization has already enabled all features.</p> </li> <li> <p>INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES: You cannot issue new invitations to join an organization while it is in the process of enabling all features. You can resume inviting accounts after you finalize the process when all accounts have agreed to the change.</p> </li> <li> <p>PAYMENT_INSTRUMENT_REQUIRED: You cannot complete the operation with an account that does not have a payment instrument, such as a credit card, associated with it.</p> </li> <li> <p>ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD: The request failed because the account is from a different marketplace than the accounts in the organization. For example, accounts with India addresses must be associated with the AISPL marketplace. All accounts in an organization must be from the same marketplace.</p> </li> <li> <p>ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED: You attempted to change the membership of an account too quickly after its previous change.</p> </li> </ul>", "refs": { } }, @@ -620,7 +621,7 @@ "IAMUserAccessToBilling": { "base": null, "refs": { - "CreateAccountRequest$IamUserAccessToBilling": "<p>If set to <code>ALLOW</code>, the new account enables IAM users to access account billing information <i>if</i> they have the required permissions. If set to <code>DENY</code>, then only the root user of the new account can access account billing information. For more information, see <a href=\"http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html#ControllingAccessWebsite-Activate\">Activating Access to the Billing and Cost Management Console</a> in the <i>AWS Billing and Cost Management User Guide</i>.</p>" + "CreateAccountRequest$IamUserAccessToBilling": "<p>If set to <code>ALLOW</code>, the new account enables IAM users to access account billing information <i>if</i> they have the required permissions. If set to <code>DENY</code>, then only the root user of the new account can access account billing information. For more information, see <a href=\"http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html#ControllingAccessWebsite-Activate\">Activating Access to the Billing and Cost Management Console</a> in the <i>AWS Billing and Cost Management User Guide</i>.</p> <p>If you do not specify this parameter, the value defaults to ALLOW, and IAM users and roles with the required permissions can access billing information for the new account.</p>" } }, "InvalidHandshakeTransitionException": { @@ -629,7 +630,7 @@ } }, "InvalidInputException": { - "base": "<p>You provided invalid values for one or more of the request parameters.</p>", + "base": "<p>The requested operation failed because you provided invalid values for one or more of the request parameters. This exception includes a reason that contains additional information about the violated limit:</p> <ul> <li> <p>INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, organization, or email) as a party.</p> </li> <li> <p>INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the organization.</p> </li> <li> <p>INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. </p> </li> <li> <p>INVALID_ENUM: You specified a value that is not valid for that parameter.</p> </li> <li> <p>INVALID_LIST_MEMBER: You provided a list to a parameter that contains at least one invalid value.</p> </li> <li> <p>MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer than allowed.</p> </li> <li> <p>MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger value than allowed.</p> </li> <li> <p>MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter than allowed.</p> </li> <li> <p>MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller value than allowed.</p> </li> <li> <p>IMMUTABLE_POLICY: You specified a policy that is managed by AWS and cannot be modified.</p> </li> <li> <p>INVALID_PATTERN: You provided a value that doesn't match the required pattern.</p> </li> <li> <p>INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't match the required pattern.</p> </li> <li> <p>INPUT_REQUIRED: You must include a value for all required parameters.</p> </li> <li> <p>INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter from the response to a previous call of the operation.</p> </li> <li> <p>MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter for the operation.</p> </li> <li> <p>MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only between entities in the same root.</p> </li> </ul>", "refs": { } }, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/examples-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/examples-1.json index ea09a454..8e39290e 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/examples-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/examples-1.json @@ -392,6 +392,7 @@ "output": { "Account": { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/555555555555", + "Email": "anika@example.com", "Id": "555555555555", "Name": "Beta Account" } @@ -762,6 +763,7 @@ "Accounts": [ { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111", + "Email": "bill@example.com", "Id": "111111111111", "JoinedMethod": "INVITED", "JoinedTimestamp": "20161215T193015Z", @@ -770,6 +772,7 @@ }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/222222222222", + "Email": "alice@example.com", "Id": "222222222222", "JoinedMethod": "INVITED", "JoinedTimestamp": "20161215T210221Z", @@ -778,6 +781,7 @@ }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333", + "Email": "juan@example.com", "Id": "333333333333", "JoinedMethod": "INVITED", "JoinedTimestamp": "20161215T210347Z", @@ -786,6 +790,7 @@ }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444", + "Email": "anika@example.com", "Id": "444444444444", "JoinedMethod": "INVITED", "JoinedTimestamp": "20161215T210332Z", @@ -814,15 +819,21 @@ "Accounts": [ { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333", + "Email": "juan@example.com", "Id": "333333333333", "JoinedMethod": "INVITED", - "JoinedTimestamp": "2016-12-28T14:43:03.39Z" + "JoinedTimestamp": 1481835795.536, + "Name": "Development Account", + "Status": "ACTIVE" }, { "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444", + "Email": "anika@example.com", "Id": "444444444444", "JoinedMethod": "INVITED", - "JoinedTimestamp": "2016-12-28T14:47:33.23Z" + "JoinedTimestamp": 1481835812.143, + "Name": "Test Account", + "Status": "ACTIVE" } ] }, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/paginators-1.json index 5677bd8e..ad365ba8 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/organizations/2016-11-28/paginators-1.json @@ -1,4 +1,64 @@ { "pagination": { + "ListAccounts": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListAccountsForParent": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListChildren": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListCreateAccountStatus": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListHandshakesForAccount": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListHandshakesForOrganization": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListOrganizationalUnitsForParent": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListParents": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListPolicies": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListPoliciesForTarget": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListRoots": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, + "ListTargetsForPolicy": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + } } } diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/polly/2016-06-10/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/polly/2016-06-10/api-2.json index 9cde79ae..5db81e88 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/polly/2016-06-10/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/polly/2016-06-10/api-2.json @@ -526,7 +526,8 @@ "Maxim", "Tatyana", "Astrid", - "Filiz" + "Filiz", + "Vicki" ] }, "VoiceList":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/api-2.json index 186a47e1..a00178cb 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/api-2.json @@ -2334,6 +2334,7 @@ "StorageEncrypted":{"shape":"Boolean"}, "KmsKeyId":{"shape":"String"}, "DBClusterSnapshotArn":{"shape":"String"}, + "SourceDBClusterSnapshotArn":{"shape":"String"}, "IAMDatabaseAuthenticationEnabled":{"shape":"Boolean"} }, "wrapper":true diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/docs-2.json index ce4f065e..3cb192a9 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/docs-2.json @@ -2400,6 +2400,7 @@ "DBClusterSnapshot$SnapshotType": "<p>Provides the type of the DB cluster snapshot.</p>", "DBClusterSnapshot$KmsKeyId": "<p>If <code>StorageEncrypted</code> is true, the KMS key identifier for the encrypted DB cluster snapshot.</p>", "DBClusterSnapshot$DBClusterSnapshotArn": "<p>The Amazon Resource Name (ARN) for the DB cluster snapshot.</p>", + "DBClusterSnapshot$SourceDBClusterSnapshotArn": "<p>If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot; otherwise, a null value.</p>", "DBClusterSnapshotAttribute$AttributeName": "<p>The name of the manual DB cluster snapshot attribute.</p> <p>The attribute named <code>restore</code> refers to the list of AWS accounts that have permission to copy or restore the manual DB cluster snapshot. For more information, see the <a>ModifyDBClusterSnapshotAttribute</a> API action.</p>", "DBClusterSnapshotAttributesResult$DBClusterSnapshotIdentifier": "<p>The identifier of the manual DB cluster snapshot that the attributes apply to.</p>", "DBClusterSnapshotMessage$Marker": "<p> An optional pagination token provided by a previous <a>DescribeDBClusterSnapshots</a> request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by <code>MaxRecords</code>. </p>", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/examples-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/examples-1.json index c842ee0d..e72a328e 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/examples-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/rds/2014-10-31/examples-1.json @@ -8,6 +8,8 @@ "SubscriptionName": "mymysqleventsubscription" }, "output": { + "EventSubscription": { + } }, "comments": { "input": { @@ -50,6 +52,8 @@ "ResourceIdentifier": "arn:aws:rds:us-east-1:992648334831:db:mymysqlinstance" }, "output": { + "ResourcePendingMaintenanceActions": { + } }, "comments": { "input": { @@ -69,6 +73,8 @@ "DBSecurityGroupName": "mydbsecuritygroup" }, "output": { + "DBSecurityGroup": { + } }, "comments": { "input": { @@ -89,6 +95,8 @@ "TargetDBClusterParameterGroupIdentifier": "mydbclusterparametergroup-copy" }, "output": { + "DBClusterParameterGroup": { + } }, "comments": { "input": { @@ -108,6 +116,8 @@ "TargetDBClusterSnapshotIdentifier": "cluster-snapshot-copy-1" }, "output": { + "DBClusterSnapshot": { + } }, "comments": { "input": { @@ -128,6 +138,8 @@ "TargetDBParameterGroupIdentifier": "mymysqlparametergroup-copy" }, "output": { + "DBParameterGroup": { + } }, "comments": { "input": { @@ -147,6 +159,8 @@ "TargetDBSnapshotIdentifier": "mydbsnapshot-copy" }, "output": { + "DBSnapshot": { + } }, "comments": { "input": { @@ -167,6 +181,8 @@ "TargetOptionGroupIdentifier": "mymysqloptiongroup-copy" }, "output": { + "OptionGroup": { + } }, "comments": { "input": { @@ -197,6 +213,8 @@ "StorageEncrypted": true }, "output": { + "DBCluster": { + } }, "comments": { "input": { @@ -217,6 +235,8 @@ "Description": "My DB cluster parameter group" }, "output": { + "DBClusterParameterGroup": { + } }, "comments": { "input": { @@ -236,6 +256,8 @@ "DBClusterSnapshotIdentifier": "mydbclustersnapshot" }, "output": { + "DBClusterSnapshot": { + } }, "comments": { "input": { @@ -259,6 +281,8 @@ "MasterUsername": "MyUser" }, "output": { + "DBInstance": { + } }, "comments": { "input": { @@ -289,6 +313,8 @@ ] }, "output": { + "DBInstance": { + } }, "comments": { "input": { @@ -309,6 +335,8 @@ "Description": "My MySQL parameter group" }, "output": { + "DBParameterGroup": { + } }, "comments": { "input": { @@ -328,6 +356,8 @@ "DBSecurityGroupName": "mydbsecuritygroup" }, "output": { + "DBSecurityGroup": { + } }, "comments": { "input": { @@ -347,6 +377,8 @@ "DBSnapshotIdentifier": "mydbsnapshot" }, "output": { + "DBSnapshot": { + } }, "comments": { "input": { @@ -370,6 +402,8 @@ ] }, "output": { + "DBSubnetGroup": { + } }, "comments": { "input": { @@ -397,6 +431,8 @@ "SubscriptionName": "mymysqleventsubscription" }, "output": { + "EventSubscription": { + } }, "comments": { "input": { @@ -418,6 +454,8 @@ "OptionGroupName": "mymysqloptiongroup" }, "output": { + "OptionGroup": { + } }, "comments": { "input": { @@ -437,6 +475,8 @@ "SkipFinalSnapshot": true }, "output": { + "DBCluster": { + } }, "comments": { "input": { @@ -471,6 +511,8 @@ "DBClusterSnapshotIdentifier": "mydbclustersnapshot" }, "output": { + "DBClusterSnapshot": { + } }, "comments": { "input": { @@ -490,6 +532,8 @@ "SkipFinalSnapshot": true }, "output": { + "DBInstance": { + } }, "comments": { "input": { @@ -540,6 +584,8 @@ "DBSnapshotIdentifier": "mydbsnapshot" }, "output": { + "DBSnapshot": { + } }, "comments": { "input": { @@ -574,6 +620,8 @@ "SubscriptionName": "myeventsubscription" }, "output": { + "EventSubscription": { + } }, "comments": { "input": { @@ -681,6 +729,8 @@ "DBClusterSnapshotIdentifier": "mydbclustersnapshot" }, "output": { + "DBClusterSnapshotAttributesResult": { + } }, "comments": { "input": { @@ -853,6 +903,8 @@ "DBSnapshotIdentifier": "mydbsnapshot" }, "output": { + "DBSnapshotAttributesResult": { + } }, "comments": { "input": { @@ -910,6 +962,8 @@ "DBParameterGroupFamily": "aurora5.6" }, "output": { + "EngineDefaults": { + } }, "comments": { "input": { @@ -928,6 +982,8 @@ "DBParameterGroupFamily": "mysql5.6" }, "output": { + "EngineDefaults": { + } }, "comments": { "input": { @@ -1212,6 +1268,8 @@ "TargetDBInstanceIdentifier": "myaurorareplica" }, "output": { + "DBCluster": { + } }, "comments": { "input": { @@ -1253,6 +1311,8 @@ "PreferredMaintenanceWindow": "Tue:05:00-Tue:05:30" }, "output": { + "DBCluster": { + } }, "comments": { "input": { @@ -1304,6 +1364,8 @@ ] }, "output": { + "DBClusterSnapshotAttributesResult": { + } }, "comments": { "input": { @@ -1329,6 +1391,8 @@ "PreferredMaintenanceWindow": "Tue:05:00-Tue:05:30" }, "output": { + "DBInstance": { + } }, "comments": { "input": { @@ -1376,6 +1440,8 @@ ] }, "output": { + "DBSnapshotAttributesResult": { + } }, "comments": { "input": { @@ -1398,6 +1464,8 @@ ] }, "output": { + "DBSubnetGroup": { + } }, "comments": { "input": { @@ -1422,6 +1490,8 @@ "SubscriptionName": "mymysqleventsubscription" }, "output": { + "EventSubscription": { + } }, "comments": { "input": { @@ -1449,6 +1519,8 @@ ] }, "output": { + "OptionGroup": { + } }, "comments": { "input": { @@ -1469,6 +1541,8 @@ "PreferredBackupWindow": "03:30-04:00" }, "output": { + "DBInstance": { + } }, "comments": { "input": { @@ -1488,6 +1562,8 @@ "ReservedDBInstancesOfferingId": "fb29428a-646d-4390-850e-5fe89926e727" }, "output": { + "ReservedDBInstance": { + } }, "comments": { "input": { @@ -1507,6 +1583,8 @@ "ForceFailover": false }, "output": { + "DBInstance": { + } }, "comments": { "input": { @@ -1526,6 +1604,8 @@ "SubscriptionName": "myeventsubscription" }, "output": { + "EventSubscription": { + } }, "comments": { "input": { @@ -1603,6 +1683,8 @@ "SnapshotIdentifier": "sample-cluster-snapshot1" }, "output": { + "DBCluster": { + } }, "comments": { "input": { @@ -1623,6 +1705,8 @@ "SourceDBClusterIdentifier": "sample-cluster1" }, "output": { + "DBCluster": { + } }, "comments": { "input": { @@ -1642,88 +1726,90 @@ "DBSnapshotIdentifier": "rds:mysqldb-2014-04-22-08-15" }, "output": { - "AllocatedStorage": 200, - "AutoMinorVersionUpgrade": true, - "AvailabilityZone": "us-west-2b", - "BackupRetentionPeriod": 7, - "CACertificateIdentifier": "rds-ca-2015", - "CopyTagsToSnapshot": false, - "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:mysqldb-restored", - "DBInstanceClass": "db.t2.small", - "DBInstanceIdentifier": "mysqldb-restored", - "DBInstanceStatus": "available", - "DBName": "sample", - "DBParameterGroups": [ - { - "DBParameterGroupName": "default.mysql5.6", - "ParameterApplyStatus": "in-sync" - } - ], - "DBSecurityGroups": [ - - ], - "DBSubnetGroup": { - "DBSubnetGroupDescription": "default", - "DBSubnetGroupName": "default", - "SubnetGroupStatus": "Complete", - "Subnets": [ + "DBInstance": { + "AllocatedStorage": 200, + "AutoMinorVersionUpgrade": true, + "AvailabilityZone": "us-west-2b", + "BackupRetentionPeriod": 7, + "CACertificateIdentifier": "rds-ca-2015", + "CopyTagsToSnapshot": false, + "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:mysqldb-restored", + "DBInstanceClass": "db.t2.small", + "DBInstanceIdentifier": "mysqldb-restored", + "DBInstanceStatus": "available", + "DBName": "sample", + "DBParameterGroups": [ { - "SubnetAvailabilityZone": { - "Name": "us-west-2a" + "DBParameterGroupName": "default.mysql5.6", + "ParameterApplyStatus": "in-sync" + } + ], + "DBSecurityGroups": [ + + ], + "DBSubnetGroup": { + "DBSubnetGroupDescription": "default", + "DBSubnetGroupName": "default", + "SubnetGroupStatus": "Complete", + "Subnets": [ + { + "SubnetAvailabilityZone": { + "Name": "us-west-2a" + }, + "SubnetIdentifier": "subnet-77e8db03", + "SubnetStatus": "Active" }, - "SubnetIdentifier": "subnet-77e8db03", - "SubnetStatus": "Active" - }, - { - "SubnetAvailabilityZone": { - "Name": "us-west-2b" + { + "SubnetAvailabilityZone": { + "Name": "us-west-2b" + }, + "SubnetIdentifier": "subnet-c39989a1", + "SubnetStatus": "Active" }, - "SubnetIdentifier": "subnet-c39989a1", - "SubnetStatus": "Active" - }, + { + "SubnetAvailabilityZone": { + "Name": "us-west-2c" + }, + "SubnetIdentifier": "subnet-4b267b0d", + "SubnetStatus": "Active" + } + ], + "VpcId": "vpc-c1c5b3a3" + }, + "DbInstancePort": 0, + "DbiResourceId": "db-VNZUCCBTEDC4WR7THXNJO72HVQ", + "DomainMemberships": [ + + ], + "Engine": "mysql", + "EngineVersion": "5.6.27", + "LicenseModel": "general-public-license", + "MasterUsername": "mymasteruser", + "MonitoringInterval": 0, + "MultiAZ": false, + "OptionGroupMemberships": [ { - "SubnetAvailabilityZone": { - "Name": "us-west-2c" - }, - "SubnetIdentifier": "subnet-4b267b0d", - "SubnetStatus": "Active" + "OptionGroupName": "default:mysql-5-6", + "Status": "in-sync" } ], - "VpcId": "vpc-c1c5b3a3" - }, - "DbInstancePort": 0, - "DbiResourceId": "db-VNZUCCBTEDC4WR7THXNJO72HVQ", - "DomainMemberships": [ - - ], - "Engine": "mysql", - "EngineVersion": "5.6.27", - "LicenseModel": "general-public-license", - "MasterUsername": "mymasteruser", - "MonitoringInterval": 0, - "MultiAZ": false, - "OptionGroupMemberships": [ - { - "OptionGroupName": "default:mysql-5-6", - "Status": "in-sync" - } - ], - "PendingModifiedValues": { - }, - "PreferredBackupWindow": "12:58-13:28", - "PreferredMaintenanceWindow": "tue:10:16-tue:10:46", - "PubliclyAccessible": true, - "ReadReplicaDBInstanceIdentifiers": [ + "PendingModifiedValues": { + }, + "PreferredBackupWindow": "12:58-13:28", + "PreferredMaintenanceWindow": "tue:10:16-tue:10:46", + "PubliclyAccessible": true, + "ReadReplicaDBInstanceIdentifiers": [ - ], - "StorageEncrypted": false, - "StorageType": "gp2", - "VpcSecurityGroups": [ - { - "Status": "active", - "VpcSecurityGroupId": "sg-e5e5b0d2" - } - ] + ], + "StorageEncrypted": false, + "StorageType": "gp2", + "VpcSecurityGroups": [ + { + "Status": "active", + "VpcSecurityGroupId": "sg-e5e5b0d2" + } + ] + } }, "comments": { "input": { @@ -1744,88 +1830,90 @@ "TargetDBInstanceIdentifier": "mysql-sample-restored" }, "output": { - "AllocatedStorage": 200, - "AutoMinorVersionUpgrade": true, - "AvailabilityZone": "us-west-2b", - "BackupRetentionPeriod": 7, - "CACertificateIdentifier": "rds-ca-2015", - "CopyTagsToSnapshot": false, - "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:mysql-sample-restored", - "DBInstanceClass": "db.t2.small", - "DBInstanceIdentifier": "mysql-sample-restored", - "DBInstanceStatus": "available", - "DBName": "sample", - "DBParameterGroups": [ - { - "DBParameterGroupName": "default.mysql5.6", - "ParameterApplyStatus": "in-sync" - } - ], - "DBSecurityGroups": [ - - ], - "DBSubnetGroup": { - "DBSubnetGroupDescription": "default", - "DBSubnetGroupName": "default", - "SubnetGroupStatus": "Complete", - "Subnets": [ + "DBInstance": { + "AllocatedStorage": 200, + "AutoMinorVersionUpgrade": true, + "AvailabilityZone": "us-west-2b", + "BackupRetentionPeriod": 7, + "CACertificateIdentifier": "rds-ca-2015", + "CopyTagsToSnapshot": false, + "DBInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:mysql-sample-restored", + "DBInstanceClass": "db.t2.small", + "DBInstanceIdentifier": "mysql-sample-restored", + "DBInstanceStatus": "available", + "DBName": "sample", + "DBParameterGroups": [ { - "SubnetAvailabilityZone": { - "Name": "us-west-2a" + "DBParameterGroupName": "default.mysql5.6", + "ParameterApplyStatus": "in-sync" + } + ], + "DBSecurityGroups": [ + + ], + "DBSubnetGroup": { + "DBSubnetGroupDescription": "default", + "DBSubnetGroupName": "default", + "SubnetGroupStatus": "Complete", + "Subnets": [ + { + "SubnetAvailabilityZone": { + "Name": "us-west-2a" + }, + "SubnetIdentifier": "subnet-77e8db03", + "SubnetStatus": "Active" }, - "SubnetIdentifier": "subnet-77e8db03", - "SubnetStatus": "Active" - }, - { - "SubnetAvailabilityZone": { - "Name": "us-west-2b" + { + "SubnetAvailabilityZone": { + "Name": "us-west-2b" + }, + "SubnetIdentifier": "subnet-c39989a1", + "SubnetStatus": "Active" }, - "SubnetIdentifier": "subnet-c39989a1", - "SubnetStatus": "Active" - }, + { + "SubnetAvailabilityZone": { + "Name": "us-west-2c" + }, + "SubnetIdentifier": "subnet-4b267b0d", + "SubnetStatus": "Active" + } + ], + "VpcId": "vpc-c1c5b3a3" + }, + "DbInstancePort": 0, + "DbiResourceId": "db-VNZUCCBTEDC4WR7THXNJO72HVQ", + "DomainMemberships": [ + + ], + "Engine": "mysql", + "EngineVersion": "5.6.27", + "LicenseModel": "general-public-license", + "MasterUsername": "mymasteruser", + "MonitoringInterval": 0, + "MultiAZ": false, + "OptionGroupMemberships": [ { - "SubnetAvailabilityZone": { - "Name": "us-west-2c" - }, - "SubnetIdentifier": "subnet-4b267b0d", - "SubnetStatus": "Active" + "OptionGroupName": "default:mysql-5-6", + "Status": "in-sync" } ], - "VpcId": "vpc-c1c5b3a3" - }, - "DbInstancePort": 0, - "DbiResourceId": "db-VNZUCCBTEDC4WR7THXNJO72HVQ", - "DomainMemberships": [ - - ], - "Engine": "mysql", - "EngineVersion": "5.6.27", - "LicenseModel": "general-public-license", - "MasterUsername": "mymasteruser", - "MonitoringInterval": 0, - "MultiAZ": false, - "OptionGroupMemberships": [ - { - "OptionGroupName": "default:mysql-5-6", - "Status": "in-sync" - } - ], - "PendingModifiedValues": { - }, - "PreferredBackupWindow": "12:58-13:28", - "PreferredMaintenanceWindow": "tue:10:16-tue:10:46", - "PubliclyAccessible": true, - "ReadReplicaDBInstanceIdentifiers": [ + "PendingModifiedValues": { + }, + "PreferredBackupWindow": "12:58-13:28", + "PreferredMaintenanceWindow": "tue:10:16-tue:10:46", + "PubliclyAccessible": true, + "ReadReplicaDBInstanceIdentifiers": [ - ], - "StorageEncrypted": false, - "StorageType": "gp2", - "VpcSecurityGroups": [ - { - "Status": "active", - "VpcSecurityGroupId": "sg-e5e5b0d2" - } - ] + ], + "StorageEncrypted": false, + "StorageType": "gp2", + "VpcSecurityGroups": [ + { + "Status": "active", + "VpcSecurityGroupId": "sg-e5e5b0d2" + } + ] + } }, "comments": { "input": { @@ -1845,6 +1933,8 @@ "DBSecurityGroupName": "mydbsecuritygroup" }, "output": { + "DBSecurityGroup": { + } }, "comments": { "input": { diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/rekognition/2016-06-27/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/rekognition/2016-06-27/api-2.json index 215e8180..03755103 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/rekognition/2016-06-27/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/rekognition/2016-06-27/api-2.json @@ -134,7 +134,8 @@ {"shape":"AccessDeniedException"}, {"shape":"InternalServerError"}, {"shape":"ThrottlingException"}, - {"shape":"ProvisionedThroughputExceededException"} + {"shape":"ProvisionedThroughputExceededException"}, + {"shape":"InvalidImageFormatException"} ] }, "IndexFaces":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/api-2.json index 088a0ca7..b2eb52d2 100755 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/api-2.json @@ -103,7 +103,8 @@ "input":{"shape":"DescribeAddressesRequest"}, "output":{"shape":"DescribeAddressesResult"}, "errors":[ - {"shape":"InvalidResourceException"} + {"shape":"InvalidResourceException"}, + {"shape":"InvalidNextTokenException"} ] }, "DescribeCluster":{ @@ -174,7 +175,8 @@ "input":{"shape":"ListClusterJobsRequest"}, "output":{"shape":"ListClusterJobsResult"}, "errors":[ - {"shape":"InvalidResourceException"} + {"shape":"InvalidResourceException"}, + {"shape":"InvalidNextTokenException"} ] }, "ListClusters":{ @@ -184,7 +186,10 @@ "requestUri":"/" }, "input":{"shape":"ListClustersRequest"}, - "output":{"shape":"ListClustersResult"} + "output":{"shape":"ListClustersResult"}, + "errors":[ + {"shape":"InvalidNextTokenException"} + ] }, "ListJobs":{ "name":"ListJobs", @@ -193,7 +198,10 @@ "requestUri":"/" }, "input":{"shape":"ListJobsRequest"}, - "output":{"shape":"ListJobsResult"} + "output":{"shape":"ListJobsResult"}, + "errors":[ + {"shape":"InvalidNextTokenException"} + ] }, "UpdateCluster":{ "name":"UpdateCluster", @@ -243,7 +251,8 @@ "Landmark":{"shape":"String"}, "Country":{"shape":"String"}, "PostalCode":{"shape":"String"}, - "PhoneNumber":{"shape":"String"} + "PhoneNumber":{"shape":"String"}, + "IsRestricted":{"shape":"Boolean"} } }, "AddressId":{ @@ -321,7 +330,8 @@ "Resources":{"shape":"JobResource"}, "AddressId":{"shape":"AddressId"}, "ShippingOption":{"shape":"ShippingOption"}, - "Notification":{"shape":"Notification"} + "Notification":{"shape":"Notification"}, + "ForwardingAddressId":{"shape":"AddressId"} } }, "ClusterState":{ @@ -365,7 +375,8 @@ "RoleARN":{"shape":"RoleARN"}, "SnowballType":{"shape":"SnowballType"}, "ShippingOption":{"shape":"ShippingOption"}, - "Notification":{"shape":"Notification"} + "Notification":{"shape":"Notification"}, + "ForwardingAddressId":{"shape":"AddressId"} } }, "CreateClusterResult":{ @@ -387,7 +398,8 @@ "ShippingOption":{"shape":"ShippingOption"}, "Notification":{"shape":"Notification"}, "ClusterId":{"shape":"ClusterId"}, - "SnowballType":{"shape":"SnowballType"} + "SnowballType":{"shape":"SnowballType"}, + "ForwardingAddressId":{"shape":"AddressId"} } }, "CreateJobResult":{ @@ -529,6 +541,13 @@ }, "exception":true }, + "InvalidNextTokenException":{ + "type":"structure", + "members":{ + "Message":{"shape":"String"} + }, + "exception":true + }, "InvalidResourceException":{ "type":"structure", "members":{ @@ -584,7 +603,8 @@ "Notification":{"shape":"Notification"}, "DataTransferProgress":{"shape":"DataTransfer"}, "JobLogInfo":{"shape":"JobLogs"}, - "ClusterId":{"shape":"String"} + "ClusterId":{"shape":"String"}, + "ForwardingAddressId":{"shape":"AddressId"} } }, "JobMetadataList":{ @@ -644,7 +664,7 @@ "KmsKeyARN":{ "type":"string", "max":255, - "pattern":"arn:(aws|aws-us-gov):kms:.*:[0-9]{12}:key/.*" + "pattern":"arn:aws.*:kms:.*:[0-9]{12}:key/.*" }, "LambdaResource":{ "type":"structure", @@ -722,7 +742,7 @@ "RoleARN":{ "type":"string", "max":255, - "pattern":"arn:(aws|aws-us-gov):iam::[0-9]{12}:role/.*" + "pattern":"arn:aws.*:iam::[0-9]{12}:role/.*" }, "S3Resource":{ "type":"structure", @@ -778,11 +798,10 @@ "SnsTopicARN":{ "type":"string", "max":255, - "pattern":"arn:(aws|aws-us-gov):sns:.*:[0-9]{12}:.*" + "pattern":"arn:aws.*:sns:.*:[0-9]{12}:.*" }, "String":{ "type":"string", - "max":255, "min":1 }, "Timestamp":{"type":"timestamp"}, @@ -803,7 +822,8 @@ "Resources":{"shape":"JobResource"}, "AddressId":{"shape":"AddressId"}, "ShippingOption":{"shape":"ShippingOption"}, - "Notification":{"shape":"Notification"} + "Notification":{"shape":"Notification"}, + "ForwardingAddressId":{"shape":"AddressId"} } }, "UpdateClusterResult":{ @@ -822,7 +842,8 @@ "AddressId":{"shape":"AddressId"}, "ShippingOption":{"shape":"ShippingOption"}, "Description":{"shape":"String"}, - "SnowballCapacityPreference":{"shape":"SnowballCapacity"} + "SnowballCapacityPreference":{"shape":"SnowballCapacity"}, + "ForwardingAddressId":{"shape":"AddressId"} } }, "UpdateJobResult":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/docs-2.json index ca3b33d6..194f4fe9 100755 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/docs-2.json @@ -4,13 +4,13 @@ "operations": { "CancelCluster": "<p>Cancels a cluster job. You can only cancel a cluster job while it's in the <code>AwaitingQuorum</code> status. You'll have at least an hour after creating a cluster job to cancel it.</p>", "CancelJob": "<p>Cancels the specified job. You can only cancel a job before its <code>JobState</code> value changes to <code>PreparingAppliance</code>. Requesting the <code>ListJobs</code> or <code>DescribeJob</code> action will return a job's <code>JobState</code> as part of the response element data returned.</p>", - "CreateAddress": "<p>Creates an address for a Snowball to be shipped to. </p> <p>Addresses are validated at the time of creation. The address you provide must be located within the serviceable area of your region. If the address is invalid or unsupported, then an exception is thrown.</p>", + "CreateAddress": "<p>Creates an address for a Snowball to be shipped to. In most regions, addresses are validated at the time of creation. The address you provide must be located within the serviceable area of your region. If the address is invalid or unsupported, then an exception is thrown.</p>", "CreateCluster": "<p>Creates an empty cluster. Each cluster supports five nodes. You use the <a>CreateJob</a> action separately to create the jobs for each of these nodes. The cluster does not ship until these five node jobs have been created.</p>", - "CreateJob": "<p>Creates a job to import or export data between Amazon S3 and your on-premises data center. Your AWS account must have the right trust policies and permissions in place to create a job for Snowball. If you're creating a job for a node in a cluster, you only need to provide the <code>clusterId</code> value; the other job attributes are inherited from the cluster. .</p>", + "CreateJob": "<p>Creates a job to import or export data between Amazon S3 and your on-premises data center. Your AWS account must have the right trust policies and permissions in place to create a job for Snowball. If you're creating a job for a node in a cluster, you only need to provide the <code>clusterId</code> value; the other job attributes are inherited from the cluster. </p>", "DescribeAddress": "<p>Takes an <code>AddressId</code> and returns specific details about that address in the form of an <code>Address</code> object.</p>", "DescribeAddresses": "<p>Returns a specified number of <code>ADDRESS</code> objects. Calling this API in one of the US regions will return addresses from the list of all addresses associated with this account in all US regions.</p>", "DescribeCluster": "<p>Returns information about a specific cluster including shipping information, cluster status, and other important metadata.</p>", - "DescribeJob": "<p>Returns information about a specific job including shipping information, job status, and other important metadata. .</p>", + "DescribeJob": "<p>Returns information about a specific job including shipping information, job status, and other important metadata. </p>", "GetJobManifest": "<p>Returns a link to an Amazon S3 presigned URL for the manifest file associated with the specified <code>JobId</code> value. You can access the manifest file for up to 60 minutes after this request has been made. To access the manifest file after 60 minutes have passed, you'll have to make another call to the <code>GetJobManifest</code> action.</p> <p>The manifest is an encrypted file that you can download after your job enters the <code>WithCustomer</code> status. The manifest is decrypted by using the <code>UnlockCode</code> code value, when you pass both values to the Snowball through the Snowball client when the client is started for the first time.</p> <p>As a best practice, we recommend that you don't save a copy of an <code>UnlockCode</code> value in the same location as the manifest file for that job. Saving these separately helps prevent unauthorized parties from gaining access to the Snowball associated with that job.</p> <p>The credentials of a given job, including its manifest file and unlock code, expire 90 days after the job is created.</p>", "GetJobUnlockCode": "<p>Returns the <code>UnlockCode</code> code value for the specified job. A particular <code>UnlockCode</code> value can be accessed for up to 90 days after the associated job has been created.</p> <p>The <code>UnlockCode</code> value is a 29-character code with 25 alphanumeric characters and 4 hyphens. This code is used to decrypt the manifest file when it is passed along with the manifest to the Snowball through the Snowball client when the client is started for the first time.</p> <p>As a best practice, we recommend that you don't save a copy of the <code>UnlockCode</code> in the same location as the manifest file for that job. Saving these separately helps prevent unauthorized parties from gaining access to the Snowball associated with that job.</p>", "GetSnowballUsage": "<p>Returns information about the Snowball service limit for your account, and also the number of Snowballs your account has in use.</p> <p>The default service limit for the number of Snowballs that you can have at one time is 1. If you want to increase your service limit, contact AWS Support.</p>", @@ -34,12 +34,18 @@ "refs": { "Address$AddressId": "<p>The unique ID for an address.</p>", "ClusterMetadata$AddressId": "<p>The automatically generated ID for a specific address.</p>", + "ClusterMetadata$ForwardingAddressId": "<p>The ID of the address that you want a cluster shipped to, after it will be shipped to its primary address. This field is not supported in most regions.</p>", "CreateClusterRequest$AddressId": "<p>The ID for the address that you want the cluster shipped to.></p>", + "CreateClusterRequest$ForwardingAddressId": "<p>The forwarding address ID for a cluster. This field is not supported in most regions.</p>", "CreateJobRequest$AddressId": "<p>The ID for the address that you want the Snowball shipped to.</p>", + "CreateJobRequest$ForwardingAddressId": "<p>The forwarding address ID for a job. This field is not supported in most regions.</p>", "DescribeAddressRequest$AddressId": "<p>The automatically generated ID for a specific address.</p>", "JobMetadata$AddressId": "<p>The ID for the address that you want the Snowball shipped to.</p>", + "JobMetadata$ForwardingAddressId": "<p>The ID of the address that you want a job shipped to, after it will be shipped to its primary address. This field is not supported in most regions.</p>", "UpdateClusterRequest$AddressId": "<p>The ID of the updated <a>Address</a> object.</p>", - "UpdateJobRequest$AddressId": "<p>The ID of the updated <a>Address</a> object.</p>" + "UpdateClusterRequest$ForwardingAddressId": "<p>The updated ID for the forwarding address for a cluster. This field is not supported in most regions.</p>", + "UpdateJobRequest$AddressId": "<p>The ID of the updated <a>Address</a> object.</p>", + "UpdateJobRequest$ForwardingAddressId": "<p>The updated ID for the forwarding address for a job. This field is not supported in most regions.</p>" } }, "AddressList": { @@ -51,6 +57,7 @@ "Boolean": { "base": null, "refs": { + "Address$IsRestricted": "<p>If the address you are creating is a primary address, then set this option to true. This field is not supported in most regions.</p>", "JobListEntry$IsMaster": "<p>A value that indicates that this job is a master job. A master job represents a successful request to create an export job. Master jobs aren't associated with any Snowballs. Instead, each master job will have at least one job part, and each job part is associated with a Snowball. It might take some time before the job parts associated with a particular master job are listed, because they are created after the master job is created.</p>", "Notification$NotifyAll": "<p>Any change in job state will trigger a notification for this job.</p>" } @@ -256,6 +263,11 @@ "refs": { } }, + "InvalidNextTokenException": { + "base": "<p>The <code>NextToken</code> string was altered unexpectedly, and the operation has stopped. Run the operation without changing the <code>NextToken</code> string, and try again.</p>", + "refs": { + } + }, "InvalidResourceException": { "base": "<p>The specified resource can't be found. Check the information you provided in your last request, and try again.</p>", "refs": { @@ -356,7 +368,7 @@ "ClusterMetadata$KmsKeyARN": "<p>The <code>KmsKeyARN</code> Amazon Resource Name (ARN) associated with this cluster. This ARN was created using the <a href=\"http://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html\">CreateKey</a> API action in AWS Key Management Service (AWS KMS).</p>", "CreateClusterRequest$KmsKeyARN": "<p>The <code>KmsKeyARN</code> value that you want to associate with this cluster. <code>KmsKeyARN</code> values are created by using the <a href=\"http://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html\">CreateKey</a> API action in AWS Key Management Service (AWS KMS). </p>", "CreateJobRequest$KmsKeyARN": "<p>The <code>KmsKeyARN</code> that you want to associate with this job. <code>KmsKeyARN</code>s are created using the <a href=\"http://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html\">CreateKey</a> AWS Key Management Service (KMS) API action.</p>", - "JobMetadata$KmsKeyARN": "<p>The Amazon Resource Name (ARN) for the AWS Key Management Service (AWS KMS) key associated with this job. This ARN was created using the <code>CreateKey</code> API action in AWS KMS.</p>" + "JobMetadata$KmsKeyARN": "<p>The Amazon Resource Name (ARN) for the AWS Key Management Service (AWS KMS) key associated with this job. This ARN was created using the <a href=\"http://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html\">CreateKey</a> API action in AWS KMS.</p>" } }, "LambdaResource": { @@ -444,9 +456,9 @@ "ClusterMetadata$RoleARN": "<p>The role ARN associated with this cluster. This ARN was created using the <a href=\"http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html\">CreateRole</a> API action in AWS Identity and Access Management (IAM).</p>", "CreateClusterRequest$RoleARN": "<p>The <code>RoleARN</code> that you want to associate with this cluster. <code>RoleArn</code> values are created by using the <a href=\"http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html\">CreateRole</a> API action in AWS Identity and Access Management (IAM).</p>", "CreateJobRequest$RoleARN": "<p>The <code>RoleARN</code> that you want to associate with this job. <code>RoleArn</code>s are created using the <a href=\"http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html\">CreateRole</a> AWS Identity and Access Management (IAM) API action.</p>", - "JobMetadata$RoleARN": "<p>The role ARN associated with this job. This ARN was created using the <code>CreateRole</code> API action in AWS Identity and Access Management (IAM).</p>", + "JobMetadata$RoleARN": "<p>The role ARN associated with this job. This ARN was created using the <a href=\"http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html\">CreateRole</a> API action in AWS Identity and Access Management (IAM).</p>", "UpdateClusterRequest$RoleARN": "<p>The new role Amazon Resource Name (ARN) that you want to associate with this cluster. To create a role ARN, use the <a href=\"http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html\">CreateRole</a> API action in AWS Identity and Access Management (IAM).</p>", - "UpdateJobRequest$RoleARN": "<p>The new role Amazon Resource Name (ARN) that you want to associate with this job. To create a role ARN, use the <a href=\"http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html\">CreateRole</a> AWS Identity and Access Management (IAM) API action.</p>" + "UpdateJobRequest$RoleARN": "<p>The new role Amazon Resource Name (ARN) that you want to associate with this job. To create a role ARN, use the <a href=\"http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html\">CreateRole</a>AWS Identity and Access Management (IAM) API action.</p>" } }, "S3Resource": { @@ -519,8 +531,8 @@ "Address$Street3": "<p>The third line in a street address that a Snowball is to be delivered to.</p>", "Address$City": "<p>The city in an address that a Snowball is to be delivered to.</p>", "Address$StateOrProvince": "<p>The state or province in an address that a Snowball is to be delivered to.</p>", - "Address$PrefectureOrDistrict": "<p>The prefecture or district that the appliance will be shipped to.</p>", - "Address$Landmark": "<p>The landmark identifying the address that the appliance will be shipped to.</p>", + "Address$PrefectureOrDistrict": "<p>This field is no longer used and the value is ignored.</p>", + "Address$Landmark": "<p>This field is no longer used and the value is ignored.</p>", "Address$Country": "<p>The country in an address that a Snowball is to be delivered to.</p>", "Address$PostalCode": "<p>The postal code in an address that a Snowball is to be delivered to.</p>", "Address$PhoneNumber": "<p>The phone number associated with an address that a Snowball is to be delivered to.</p>", @@ -539,6 +551,7 @@ "InvalidAddressException$Message": null, "InvalidInputCombinationException$Message": null, "InvalidJobStateException$Message": null, + "InvalidNextTokenException$Message": null, "InvalidResourceException$Message": null, "JobListEntry$JobId": "<p>The automatically generated ID for a job, for example <code>JID123e4567-e89b-12d3-a456-426655440000</code>.</p>", "JobListEntry$Description": "<p>The optional description of this specific job, for example <code>Important Photos 2016-08-11</code>.</p>", @@ -557,7 +570,7 @@ "ListClustersResult$NextToken": "<p>HTTP requests are stateless. If you use the automatically generated <code>NextToken</code> value in your next <code>ClusterListEntry</code> call, your list of returned clusters will start from this point in the array.</p>", "ListJobsRequest$NextToken": "<p>HTTP requests are stateless. To identify what object comes \"next\" in the list of <code>JobListEntry</code> objects, you have the option of specifying <code>NextToken</code> as the starting point for your returned list.</p>", "ListJobsResult$NextToken": "<p>HTTP requests are stateless. If you use this automatically generated <code>NextToken</code> value in your next <code>ListJobs</code> call, your returned <code>JobListEntry</code> objects will start from this point in the array.</p>", - "Shipment$Status": "<p>Status information for a shipment. Valid statuses include <code>NEW</code>, <code>IN_TRANSIT</code>, and <code>DELIVERED</code>.</p>", + "Shipment$Status": "<p>Status information for a shipment.</p>", "Shipment$TrackingNumber": "<p>The tracking number for this job. Using this tracking number with your region's carrier's website, you can track a Snowball as the carrier transports it.</p> <p>For India, the carrier is Amazon Logistics. For all other regions, UPS is the carrier.</p>", "UnsupportedAddressException$Message": null, "UpdateClusterRequest$Description": "<p>The updated description of this cluster.</p>", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/paginators-1.json index d03aba77..c5d937be 100755 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/snowball/2016-06-30/paginators-1.json @@ -1,16 +1,16 @@ { "pagination": { - "ListJobs": { + "DescribeAddresses": { + "input_token": "NextToken", "limit_key": "MaxResults", "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "JobListEntries" + "result_key": "Addresses" }, - "DescribeAddresses": { + "ListJobs": { + "input_token": "NextToken", "limit_key": "MaxResults", "output_token": "NextToken", - "input_token": "NextToken", - "result_key": "Addresses" + "result_key": "JobListEntries" } } }
\ No newline at end of file diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/api-2.json index e6753ed1..0531c8b2 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/api-2.json @@ -760,7 +760,9 @@ "ReceiveMessageWaitTimeSeconds", "RedrivePolicy", "FifoQueue", - "ContentBasedDeduplication" + "ContentBasedDeduplication", + "KmsMasterKeyId", + "KmsDataKeyReusePeriodSeconds" ] }, "QueueDeletedRecently":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/docs-2.json index d377eeff..9293bb80 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/docs-2.json @@ -4,20 +4,20 @@ "operations": { "AddPermission": "<p>Adds a permission to a queue for a specific <a href=\"http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P\">principal</a>. This allows sharing access to the queue.</p> <p>When you create a queue, you have full control access rights for the queue. Only you, the owner of the queue, can grant or deny permissions to the queue. For more information about these permissions, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html\">Shared Queues</a> in the <i>Amazon SQS Developer Guide</i>.</p> <note> <p> <code>AddPermission</code> writes an Amazon-SQS-generated policy. If you want to write your own policy, use <code> <a>SetQueueAttributes</a> </code> to upload your policy. For more information about writing your own policy, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AccessPolicyLanguage.html\">Using The Access Policy Language</a> in the <i>Amazon SQS Developer Guide</i>.</p> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", "ChangeMessageVisibility": "<p>Changes the visibility timeout of a specified message in a queue to a new value. The maximum allowed timeout value is 12 hours. Thus, you can't extend the timeout of a message in an existing queue to more than a total visibility timeout of 12 hours. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>.</p> <p>For example, you have a message and with the default visibility timeout of 5 minutes. After 3 minutes, you call <code>ChangeMessageVisiblity</code> with a timeout of 10 minutes. At that time, the timeout for the message is extended by 10 minutes beyond the time of the <code>ChangeMessageVisibility</code> action. This results in a total visibility timeout of 13 minutes. You can continue to call the <code>ChangeMessageVisibility</code> to extend the visibility timeout to a maximum of 12 hours. If you try to extend the visibility timeout beyond 12 hours, your request is rejected.</p> <p>A message is considered to be <i>in flight</i> after it's received from a queue by a consumer, but not yet deleted from the queue.</p> <p>For standard queues, there can be a maximum of 120,000 inflight messages per queue. If you reach this limit, Amazon SQS returns the <code>OverLimit</code> error message. To avoid reaching the limit, you should delete messages from the queue after they're processed. You can also increase the number of queues you use to process your messages.</p> <p>For FIFO queues, there can be a maximum of 20,000 inflight messages per queue. If you reach this limit, Amazon SQS returns no error messages.</p> <important> <p>If you attempt to set the <code>VisibilityTimeout</code> to a value greater than the maximum time left, Amazon SQS returns an error. Amazon SQS doesn't automatically recalculate and increase the timeout to the maximum remaining time.</p> <p>Unlike with a queue, when you change the visibility timeout for a specific message the timeout value is applied immediately but isn't saved in memory for that message. If you don't delete a message after it is received, the visibility timeout for the message reverts to the original timeout value (not to the value you set using the <code>ChangeMessageVisibility</code> action) the next time the message is received.</p> </important>", - "ChangeMessageVisibilityBatch": "<p>Changes the visibility timeout of multiple messages. This is a batch version of <code> <a>ChangeMessageVisibility</a> </code>. The result of the action on each message is reported individually in the response. You can send up to 10 <code> <a>ChangeMessageVisibility</a> </code> requests with each <code>ChangeMessageVisibilityBatch</code> action.</p> <important> <p>Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p> </important> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", - "CreateQueue": "<p>Creates a new standard or FIFO queue or returns the URL of an existing queue. You can pass one or more attributes in the request. Keep the following caveats in mind:</p> <ul> <li> <p>If you don't specify the <code>FifoQueue</code> attribute, Amazon SQS creates a standard queue.</p> <note> <p> You can't change the queue type after you create it and you can't convert an existing standard queue into a FIFO queue. You must either create a new FIFO queue for your application or delete your existing standard queue and recreate it as a FIFO queue. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving\"> Moving From a Standard Queue to a FIFO Queue</a> in the <i>Amazon SQS Developer Guide</i>. </p> </note> </li> <li> <p>If you don't provide a value for an attribute, the queue is created with the default value for the attribute.</p> </li> <li> <p>If you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.</p> </li> </ul> <p>To successfully create a new queue, you must provide a queue name that adheres to the <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html\">limits related to queues</a> and is unique within the scope of your queues.</p> <p>To get the queue URL, use the <code> <a>GetQueueUrl</a> </code> action. <code> <a>GetQueueUrl</a> </code> requires only the <code>QueueName</code> parameter. be aware of existing queue names:</p> <ul> <li> <p>If you provide the name of an existing queue along with the exact names and values of all the queue's attributes, <code>CreateQueue</code> returns the queue URL for the existing queue.</p> </li> <li> <p>If the queue name, attribute names, or attribute values don't match an existing queue, <code>CreateQueue</code> returns an error.</p> </li> </ul> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", - "DeleteMessage": "<p>Deletes the specified message from the specified queue. You specify the message by using the message's <i>receipt handle</i> and not the <i>MessageId</i> you receive when you send the message. Even if the message is locked by another reader due to the visibility timeout setting, it is still deleted from the queue. If you leave a message in the queue for longer than the queue's configured retention period, Amazon SQS automatically deletes the message. </p> <note> <p> The receipt handle is associated with a specific instance of receiving the message. If you receive a message more than once, the receipt handle you get each time you receive the message is different. If you don't provide the most recently received receipt handle for the message when you use the <code>DeleteMessage</code> action, the request succeeds, but the message might not be deleted.</p> <p>For standard queues, it is possible to receive a message even after you deleting it. This might happen on rare occasions if one of the servers storing a copy of the message is unavailable when you send the request to delete the message. The copy remains on the server and might be returned to you on a subsequent receive request. You should ensure that your application is idempotent, so that receiving a message more than once does not cause issues.</p> </note>", - "DeleteMessageBatch": "<p>Deletes up to ten messages from the specified queue. This is a batch version of <code> <a>DeleteMessage</a> </code>. The result of the action on each message is reported individually in the response.</p> <important> <p>Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p> </important> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", + "ChangeMessageVisibilityBatch": "<p>Changes the visibility timeout of multiple messages. This is a batch version of <code> <a>ChangeMessageVisibility</a>.</code> The result of the action on each message is reported individually in the response. You can send up to 10 <code> <a>ChangeMessageVisibility</a> </code> requests with each <code>ChangeMessageVisibilityBatch</code> action.</p> <important> <p>Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p> </important> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", + "CreateQueue": "<p>Creates a new standard or FIFO queue. You can pass one or more attributes in the request. Keep the following caveats in mind:</p> <ul> <li> <p>If you don't specify the <code>FifoQueue</code> attribute, Amazon SQS creates a standard queue.</p> <note> <p> You can't change the queue type after you create it and you can't convert an existing standard queue into a FIFO queue. You must either create a new FIFO queue for your application or delete your existing standard queue and recreate it as a FIFO queue. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving\"> Moving From a Standard Queue to a FIFO Queue</a> in the <i>Amazon SQS Developer Guide</i>. </p> </note> </li> <li> <p>If you don't provide a value for an attribute, the queue is created with the default value for the attribute.</p> </li> <li> <p>If you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.</p> </li> </ul> <p>To successfully create a new queue, you must provide a queue name that adheres to the <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html\">limits related to queues</a> and is unique within the scope of your queues.</p> <p>To get the queue URL, use the <code> <a>GetQueueUrl</a> </code> action. <code> <a>GetQueueUrl</a> </code> requires only the <code>QueueName</code> parameter. be aware of existing queue names:</p> <ul> <li> <p>If you provide the name of an existing queue along with the exact names and values of all the queue's attributes, <code>CreateQueue</code> returns the queue URL for the existing queue.</p> </li> <li> <p>If the queue name, attribute names, or attribute values don't match an existing queue, <code>CreateQueue</code> returns an error.</p> </li> </ul> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", + "DeleteMessage": "<p>Deletes the specified message from the specified queue. You specify the message by using the message's <i>receipt handle</i> and not the <i>MessageId</i> you receive when you send the message. Even if the message is locked by another reader due to the visibility timeout setting, it is still deleted from the queue. If you leave a message in the queue for longer than the queue's configured retention period, Amazon SQS automatically deletes the message. </p> <note> <p> The receipt handle is associated with a specific instance of receiving the message. If you receive a message more than once, the receipt handle you get each time you receive the message is different. If you don't provide the most recently received receipt handle for the message when you use the <code>DeleteMessage</code> action, the request succeeds, but the message might not be deleted.</p> <p>For standard queues, it is possible to receive a message even after you delete it. This might happen on rare occasions if one of the servers storing a copy of the message is unavailable when you send the request to delete the message. The copy remains on the server and might be returned to you on a subsequent receive request. You should ensure that your application is idempotent, so that receiving a message more than once does not cause issues.</p> </note>", + "DeleteMessageBatch": "<p>Deletes up to ten messages from the specified queue. This is a batch version of <code> <a>DeleteMessage</a>.</code> The result of the action on each message is reported individually in the response.</p> <important> <p>Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p> </important> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", "DeleteQueue": "<p>Deletes the queue specified by the <code>QueueUrl</code>, even if the queue is empty. If the specified queue doesn't exist, Amazon SQS returns a successful response.</p> <important> <p>Be careful with the <code>DeleteQueue</code> action: When you delete a queue, any messages in the queue are no longer available. </p> </important> <p>When you delete a queue, the deletion process takes up to 60 seconds. Requests you send involving that queue during the 60 seconds might succeed. For example, a <code> <a>SendMessage</a> </code> request might succeed, but after 60 seconds the queue and the message you sent no longer exist.</p> <p>When you delete a queue, you must wait at least 60 seconds before creating a queue with the same name. </p>", - "GetQueueAttributes": "<p>Gets attributes for the specified queue.</p> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", + "GetQueueAttributes": "<p>Gets attributes for the specified queue.</p> <note> <p>To determine whether a queue is <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO</a>, you can check whether <code>QueueName</code> ends with the <code>.fifo</code> suffix.</p> </note> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", "GetQueueUrl": "<p>Returns the URL of an existing queue. This action provides a simple way to retrieve the URL of an Amazon SQS queue.</p> <p>To access a queue that belongs to another AWS account, use the <code>QueueOwnerAWSAccountId</code> parameter to specify the account ID of the queue's owner. The queue's owner must grant you permission to access the queue. For more information about shared queue access, see <code> <a>AddPermission</a> </code> or see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html\">Shared Queues</a> in the <i>Amazon SQS Developer Guide</i>. </p>", "ListDeadLetterSourceQueues": "<p>Returns a list of your queues that have the <code>RedrivePolicy</code> queue attribute configured with a dead letter queue.</p> <p>For more information about using dead letter queues, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html\">Using Amazon SQS Dead Letter Queues</a> in the <i>Amazon SQS Developer Guide</i>.</p>", "ListQueues": "<p>Returns a list of your queues. The maximum number of queues that can be returned is 1,000. If you specify a value for the optional <code>QueueNamePrefix</code> parameter, only queues with a name that begins with the specified value are returned.</p>", "PurgeQueue": "<p>Deletes the messages in a queue specified by the <code>QueueURL</code> parameter.</p> <important> <p>When you use the <code>PurgeQueue</code> action, you can't retrieve a message deleted from a queue.</p> </important> <p>When you purge a queue, the message deletion process takes up to 60 seconds. All messages sent to the queue before calling the <code>PurgeQueue</code> action are deleted. Messages sent to the queue while it is being purged might be deleted. While the queue is being purged, messages sent to the queue before <code>PurgeQueue</code> is called might be received, but are deleted within the next minute.</p>", - "ReceiveMessage": "<p>Retrieves one or more messages (up to 10), from the specified queue. Using the <code>WaitTimeSeconds</code> parameter enables long-poll support. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html\">Amazon SQS Long Polling</a> in the <i>Amazon SQS Developer Guide</i>. </p> <p>Short poll is the default behavior where a weighted random set of machines is sampled on a <code>ReceiveMessage</code> call. Thus, only the messages on the sampled machines are returned. If the number of messages in the queue is small (fewer than 1,000), you most likely get fewer messages than you requested per <code>ReceiveMessage</code> call. If the number of messages in the queue is extremely small, you might not receive any messages in a particular <code>ReceiveMessage</code> response. If this happens, repeat the request. </p> <p>For each message returned, the response includes the following:</p> <ul> <li> <p>The message body.</p> </li> <li> <p>An MD5 digest of the message body. For information on MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p> </li> <li> <p>The <code>MessageId</code> you received when you sent the message to the queue.</p> </li> <li> <p>The receipt handle.</p> </li> <li> <p>The message attributes.</p> </li> <li> <p>An MD5 digest of the message attributes.</p> </li> </ul> <p>The receipt handle is the identifier you must provide when deleting the message. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html\">Queue and Message Identifiers</a> in the <i>Amazon SQS Developer Guide</i>.</p> <p>You can provide the <code>VisibilityTimeout</code> parameter in your request. The parameter is applied to the messages that Amazon SQS returns in the response. If you don't include the parameter, the overall visibility timeout for the queue is used for the returned messages. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>.</p> <p>A message that isn't deleted or a message whose visibility isn't extended before the visibility timeout expires counts as a failed receive. Depending on the configuration of the queue, the message might be sent to the dead letter queue.</p> <note> <p>In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.</p> </note>", + "ReceiveMessage": "<p>Retrieves one or more messages (up to 10), from the specified queue. Using the <code>WaitTimeSeconds</code> parameter enables long-poll support. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html\">Amazon SQS Long Polling</a> in the <i>Amazon SQS Developer Guide</i>. </p> <p>Short poll is the default behavior where a weighted random set of machines is sampled on a <code>ReceiveMessage</code> call. Thus, only the messages on the sampled machines are returned. If the number of messages in the queue is small (fewer than 1,000), you most likely get fewer messages than you requested per <code>ReceiveMessage</code> call. If the number of messages in the queue is extremely small, you might not receive any messages in a particular <code>ReceiveMessage</code> response. If this happens, repeat the request. </p> <p>For each message returned, the response includes the following:</p> <ul> <li> <p>The message body.</p> </li> <li> <p>An MD5 digest of the message body. For information about MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p> </li> <li> <p>The <code>MessageId</code> you received when you sent the message to the queue.</p> </li> <li> <p>The receipt handle.</p> </li> <li> <p>The message attributes.</p> </li> <li> <p>An MD5 digest of the message attributes.</p> </li> </ul> <p>The receipt handle is the identifier you must provide when deleting the message. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html\">Queue and Message Identifiers</a> in the <i>Amazon SQS Developer Guide</i>.</p> <p>You can provide the <code>VisibilityTimeout</code> parameter in your request. The parameter is applied to the messages that Amazon SQS returns in the response. If you don't include the parameter, the overall visibility timeout for the queue is used for the returned messages. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>.</p> <p>A message that isn't deleted or a message whose visibility isn't extended before the visibility timeout expires counts as a failed receive. Depending on the configuration of the queue, the message might be sent to the dead letter queue.</p> <note> <p>In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.</p> </note>", "RemovePermission": "<p>Revokes any permissions in the queue policy that matches the specified <code>Label</code> parameter. Only the owner of the queue can remove permissions.</p>", - "SendMessage": "<p>Delivers a message to the specified queue.</p> <important> <p>The following list shows the characters (in Unicode) that are allowed in your message, according to the W3C XML specification:</p> <ul> <li> <p> <code>#x9</code> </p> </li> <li> <p> <code>#xA</code> </p> </li> <li> <p> <code>#xD</code> </p> </li> <li> <p> <code>#x20</code> to <code>#xD7FF</code> </p> </li> <li> <p> <code>#xE000</code> to <code>#xFFFD</code> </p> </li> <li> <p> <code>#x10000</code> to <code>#x10FFFF</code> </p> </li> </ul> <p>For more information, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>. If you send any characters that aren't included in this list, your request is rejected.</p> </important>", - "SendMessageBatch": "<p>Delivers up to ten messages to the specified queue. This is a batch version of <code> <a>SendMessage</a> </code>. For a FIFO queue, multiple messages within a single batch are enqueued in the order they are sent.</p> <p>The result of sending each message is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p> <p>The maximum allowed individual message size and the maximum total payload size (the sum of the individual lengths of all of the batched messages) are both 256 KB (262,144 bytes).</p> <important> <p>The following list shows the characters (in Unicode) that are allowed in your message, according to the W3C XML specification:</p> <ul> <li> <p> <code>#x9</code> </p> </li> <li> <p> <code>#xA</code> </p> </li> <li> <p> <code>#xD</code> </p> </li> <li> <p> <code>#x20</code> to <code>#xD7FF</code> </p> </li> <li> <p> <code>#xE000</code> to <code>#xFFFD</code> </p> </li> <li> <p> <code>#x10000</code> to <code>#x10FFFF</code> </p> </li> </ul> <p>For more information, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>. If you send any characters that aren't included in this list, your request is rejected.</p> </important> <p>If you don't specify the <code>DelaySeconds</code> parameter for an entry, Amazon SQS uses the default value for the queue.</p> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", + "SendMessage": "<p>Delivers a message to the specified queue.</p> <important> <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:</p> <p> <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code> </p> <p>Any characters not included in this list will be rejected. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p> </important>", + "SendMessageBatch": "<p>Delivers up to ten messages to the specified queue. This is a batch version of <code> <a>SendMessage</a>.</code> For a FIFO queue, multiple messages within a single batch are enqueued in the order they are sent.</p> <p>The result of sending each message is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p> <p>The maximum allowed individual message size and the maximum total payload size (the sum of the individual lengths of all of the batched messages) are both 256 KB (262,144 bytes).</p> <important> <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:</p> <p> <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code> </p> <p>Any characters not included in this list will be rejected. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p> </important> <p>If you don't specify the <code>DelaySeconds</code> parameter for an entry, Amazon SQS uses the default value for the queue.</p> <note> <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p> <p> <code>&Attribute.1=this</code> </p> <p> <code>&Attribute.2=that</code> </p> </note>", "SetQueueAttributes": "<p>Sets the value of one or more queue attributes. When you change a queue's attributes, the change can take up to 60 seconds for most of the attributes to propagate throughout the Amazon SQS system. Changes made to the <code>MessageRetentionPeriod</code> attribute can take up to 15 minutes.</p> <note> <p>In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.</p> </note>" }, "shapes": { @@ -41,7 +41,7 @@ "AttributeNameList": { "base": null, "refs": { - "GetQueueAttributesRequest$AttributeNames": "<p>A list of attributes for which to retrieve information.</p> <note> <p>In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.</p> </note> <p>The following attributes are supported:</p> <ul> <li> <p> <code>All</code> - Returns all values. </p> </li> <li> <p> <code>ApproximateNumberOfMessages</code> - Returns the approximate number of visible messages in a queue. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-resources-required-process-messages.html\">Resources Required to Process Messages</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> <li> <p> <code>ApproximateNumberOfMessagesDelayed</code> - Returns the approximate number of messages that are waiting to be added to the queue. </p> </li> <li> <p> <code>ApproximateNumberOfMessagesNotVisible</code> - Returns the approximate number of messages that have not timed-out and aren't deleted. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-resources-required-process-messages.html\">Resources Required to Process Messages</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> <li> <p> <code>CreatedTimestamp</code> - Returns the time when the queue was created in seconds (<a href=\"http://en.wikipedia.org/wiki/Unix_time\">epoch time</a>).</p> </li> <li> <p> <code>DelaySeconds</code> - Returns the default delay on the queue in seconds.</p> </li> <li> <p> <code>LastModifiedTimestamp</code> - Returns the time when the queue was last changed in seconds (<a href=\"http://en.wikipedia.org/wiki/Unix_time\">epoch time</a>).</p> </li> <li> <p> <code>MaximumMessageSize</code> - Returns the limit of how many bytes a message can contain before Amazon SQS rejects it.</p> </li> <li> <p> <code>MessageRetentionPeriod</code> - Returns the number of seconds for which Amazon SQS retains a message.</p> </li> <li> <p> <code>Policy</code> - Returns the policy of the queue.</p> </li> <li> <p> <code>QueueArn</code> - Returns the Amazon resource name (ARN) of the queue.</p> </li> <li> <p> <code>ReceiveMessageWaitTimeSeconds</code> - Returns the number of seconds for which the <code>ReceiveMessage</code> action waits for a message to arrive. </p> </li> <li> <p> <code>RedrivePolicy</code> - Returns the parameters for dead letter queue functionality of the source queue. For more information about the redrive policy and dead letter queues, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html\">Using Amazon SQS Dead Letter Queues</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> <li> <p> <code>VisibilityTimeout</code> - Returns the visibility timeout for the queue. For more information about the visibility timeout, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> </ul> <p>The following attributes apply only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO (first-in-first-out) queues</a>:</p> <ul> <li> <p> <code>FifoQueue</code> - Returns whether the queue is FIFO. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic\">FIFO Queue Logic</a> in the <i>Amazon SQS Developer Guide</i>.</p> </li> <li> <p> <code>ContentBasedDeduplication</code> - Returns whether content-based deduplication is enabled for the queue. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\">Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> </ul>", + "GetQueueAttributesRequest$AttributeNames": "<p>A list of attributes for which to retrieve information.</p> <note> <p>In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.</p> </note> <p>The following attributes are supported:</p> <ul> <li> <p> <code>All</code> - Returns all values. </p> </li> <li> <p> <code>ApproximateNumberOfMessages</code> - Returns the approximate number of visible messages in a queue. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-resources-required-process-messages.html\">Resources Required to Process Messages</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> <li> <p> <code>ApproximateNumberOfMessagesDelayed</code> - Returns the approximate number of messages that are waiting to be added to the queue. </p> </li> <li> <p> <code>ApproximateNumberOfMessagesNotVisible</code> - Returns the approximate number of messages that have not timed-out and aren't deleted. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-resources-required-process-messages.html\">Resources Required to Process Messages</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> <li> <p> <code>CreatedTimestamp</code> - Returns the time when the queue was created in seconds (<a href=\"http://en.wikipedia.org/wiki/Unix_time\">epoch time</a>).</p> </li> <li> <p> <code>DelaySeconds</code> - Returns the default delay on the queue in seconds.</p> </li> <li> <p> <code>LastModifiedTimestamp</code> - Returns the time when the queue was last changed in seconds (<a href=\"http://en.wikipedia.org/wiki/Unix_time\">epoch time</a>).</p> </li> <li> <p> <code>MaximumMessageSize</code> - Returns the limit of how many bytes a message can contain before Amazon SQS rejects it.</p> </li> <li> <p> <code>MessageRetentionPeriod</code> - Returns the length of time, in seconds, for which Amazon SQS retains a message.</p> </li> <li> <p> <code>Policy</code> - Returns the policy of the queue.</p> </li> <li> <p> <code>QueueArn</code> - Returns the Amazon resource name (ARN) of the queue.</p> </li> <li> <p> <code>ReceiveMessageWaitTimeSeconds</code> - Returns the length of time, in seconds, for which the <code>ReceiveMessage</code> action waits for a message to arrive. </p> </li> <li> <p> <code>RedrivePolicy</code> - Returns the parameters for dead letter queue functionality of the source queue. For more information about the redrive policy and dead letter queues, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html\">Using Amazon SQS Dead Letter Queues</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> <li> <p> <code>VisibilityTimeout</code> - Returns the visibility timeout for the queue. For more information about the visibility timeout, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> </ul> <p>The following attributes apply only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html\">server-side-encryption</a>:</p> <ul> <li> <p> <code>KmsMasterKeyId</code> - Returns the ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms\">Key Terms</a>. </p> </li> <li> <p> <code>KmsDataKeyReusePeriodSeconds</code> - Returns the length of time, in seconds, for which Amazon SQS can reuse a data key to encrypt or decrypt messages before calling AWS KMS again. </p> </li> </ul> <p>The following attributes apply only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO (first-in-first-out) queues</a>:</p> <ul> <li> <p> <code>FifoQueue</code> - Returns whether the queue is FIFO. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic\">FIFO Queue Logic</a> in the <i>Amazon SQS Developer Guide</i>.</p> <note> <p>To determine whether a queue is <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO</a>, you can check whether <code>QueueName</code> ends with the <code>.fifo</code> suffix.</p> </note> </li> <li> <p> <code>ContentBasedDeduplication</code> - Returns whether content-based deduplication is enabled for the queue. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\">Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>. </p> </li> </ul>", "ReceiveMessageRequest$AttributeNames": "<p>A list of attributes that need to be returned along with each message. These attributes include:</p> <ul> <li> <p> <code>All</code> - Returns all values.</p> </li> <li> <p> <code>ApproximateFirstReceiveTimestamp</code> - Returns the time the message was first received from the queue (<a href=\"http://en.wikipedia.org/wiki/Unix_time\">epoch time</a> in milliseconds).</p> </li> <li> <p> <code>ApproximateReceiveCount</code> - Returns the number of times a message has been received from the queue but not deleted.</p> </li> <li> <p> <code>SenderId</code> </p> <ul> <li> <p>For an IAM user, returns the IAM user ID, for example <code>ABCDEFGHI1JKLMNOPQ23R</code>.</p> </li> <li> <p>For an IAM role, returns the IAM role ID, for example <code>ABCDE1F2GH3I4JK5LMNOP:i-a123b456</code>.</p> </li> </ul> </li> <li> <p> <code>SentTimestamp</code> - Returns the time the message was sent to the queue (<a href=\"http://en.wikipedia.org/wiki/Unix_time\">epoch time</a> in milliseconds).</p> </li> <li> <p> <code>MessageDeduplicationId</code> - Returns the value provided by the sender that calls the <code> <a>SendMessage</a> </code> action.</p> </li> <li> <p> <code>MessageGroupId</code> - Returns the value provided by the sender that calls the <code> <a>SendMessage</a> </code> action. Messages with the same <code>MessageGroupId</code> are returned in sequence.</p> </li> <li> <p> <code>SequenceNumber</code> - Returns the value provided by Amazon SQS.</p> </li> </ul> <p>Any other valid special request parameters (such as the following) are ignored:</p> <ul> <li> <p> <code>ApproximateNumberOfMessages</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesDelayed</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesNotVisible</code> </p> </li> <li> <p> <code>CreatedTimestamp</code> </p> </li> <li> <p> <code>ContentBasedDeduplication</code> </p> </li> <li> <p> <code>DelaySeconds</code> </p> </li> <li> <p> <code>FifoQueue</code> </p> </li> <li> <p> <code>LastModifiedTimestamp</code> </p> </li> <li> <p> <code>MaximumMessageSize</code> </p> </li> <li> <p> <code>MessageRetentionPeriod</code> </p> </li> <li> <p> <code>Policy</code> </p> </li> <li> <p> <code>QueueArn</code>, </p> </li> <li> <p> <code>ReceiveMessageWaitTimeSeconds</code> </p> </li> <li> <p> <code>RedrivePolicy</code> </p> </li> <li> <p> <code>VisibilityTimeout</code> </p> </li> </ul>" } }, @@ -94,7 +94,7 @@ } }, "ChangeMessageVisibilityBatchRequestEntry": { - "base": "<p>Encloses a receipt handle and an entry id for each message in <code> <a>ChangeMessageVisibilityBatch</a> </code>.</p> <important> <p>All of the following list parameters must be prefixed with <code>ChangeMessageVisibilityBatchRequestEntry.n</code>, where <code>n</code> is an integer value starting with <code>1</code>. For example, a parameter list for this action might look like this:</p> </important> <p> <code>&amp;ChangeMessageVisibilityBatchRequestEntry.1.Id=change_visibility_msg_2</code> </p> <p> <code>&amp;ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=<replaceable>Your_Receipt_Handle</replaceable></code> </p> <p> <code>&amp;ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=45</code> </p>", + "base": "<p>Encloses a receipt handle and an entry id for each message in <code> <a>ChangeMessageVisibilityBatch</a>.</code> </p> <important> <p>All of the following list parameters must be prefixed with <code>ChangeMessageVisibilityBatchRequestEntry.n</code>, where <code>n</code> is an integer value starting with <code>1</code>. For example, a parameter list for this action might look like this:</p> </important> <p> <code>&amp;ChangeMessageVisibilityBatchRequestEntry.1.Id=change_visibility_msg_2</code> </p> <p> <code>&amp;ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=<replaceable>Your_Receipt_Handle</replaceable></code> </p> <p> <code>&amp;ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=45</code> </p>", "refs": { "ChangeMessageVisibilityBatchRequestEntryList$member": null } @@ -111,7 +111,7 @@ } }, "ChangeMessageVisibilityBatchResultEntry": { - "base": "<p>Encloses the <code>Id</code> of an entry in <code> <a>ChangeMessageVisibilityBatch</a> </code>.</p>", + "base": "<p>Encloses the <code>Id</code> of an entry in <code> <a>ChangeMessageVisibilityBatch</a>.</code> </p>", "refs": { "ChangeMessageVisibilityBatchResultEntryList$member": null } @@ -160,7 +160,7 @@ } }, "DeleteMessageBatchResultEntry": { - "base": "<p>Encloses the <code>Id</code> of an entry in <code> <a>DeleteMessageBatch</a> </code>.</p>", + "base": "<p>Encloses the <code>Id</code> of an entry in <code> <a>DeleteMessageBatch</a>.</code> </p>", "refs": { "DeleteMessageBatchResultEntryList$member": null } @@ -214,8 +214,8 @@ "ReceiveMessageRequest$MaxNumberOfMessages": "<p>The maximum number of messages to return. Amazon SQS never returns more messages than this value (however, fewer messages might be returned). Valid values are 1 to 10. Default is 1.</p>", "ReceiveMessageRequest$VisibilityTimeout": "<p>The duration (in seconds) that the received messages are hidden from subsequent retrieve requests after being retrieved by a <code>ReceiveMessage</code> request.</p>", "ReceiveMessageRequest$WaitTimeSeconds": "<p>The duration (in seconds) for which the call waits for a message to arrive in the queue before returning. If a message is available, the call returns sooner than <code>WaitTimeSeconds</code>.</p>", - "SendMessageBatchRequestEntry$DelaySeconds": "<p>The number of seconds for which a specific message is delayed. Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive <code>DelaySeconds</code> value become available for processing after the delay period is finished. If you don't specify a value, the default value for the queue is applied. </p> <note> <p>When you set <code>FifoQueue</code>, you can't set <code>DelaySeconds</code> per message. You can set this parameter only on a queue level.</p> </note>", - "SendMessageRequest$DelaySeconds": "<p> The number of seconds to delay a specific message. Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive <code>DelaySeconds</code> value become available for processing after the delay period is finished. If you don't specify a value, the default value for the queue applies. </p> <note> <p>When you set <code>FifoQueue</code>, you can't set <code>DelaySeconds</code> per message. You can set this parameter only on a queue level.</p> </note>" + "SendMessageBatchRequestEntry$DelaySeconds": "<p>The length of time, in seconds, for which a specific message is delayed. Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive <code>DelaySeconds</code> value become available for processing after the delay period is finished. If you don't specify a value, the default value for the queue is applied. </p> <note> <p>When you set <code>FifoQueue</code>, you can't set <code>DelaySeconds</code> per message. You can set this parameter only on a queue level.</p> </note>", + "SendMessageRequest$DelaySeconds": "<p> The length of time, in seconds, for which to delay a specific message. Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive <code>DelaySeconds</code> value become available for processing after the delay period is finished. If you don't specify a value, the default value for the queue applies. </p> <note> <p>When you set <code>FifoQueue</code>, you can't set <code>DelaySeconds</code> per message. You can set this parameter only on a queue level.</p> </note>" } }, "InvalidAttributeName": { @@ -277,7 +277,7 @@ } }, "MessageAttributeValue": { - "base": "<p>The user-specified message attribute value. For string data types, the <code>Value</code> attribute has the same restrictions on the content as the message body. For more information, see <code> <a>SendMessage</a> </code>.</p> <p> <code>Name</code>, <code>type</code>, <code>value</code> and the message body must not be empty or null. All parts of the message attribute, including <code>Name</code>, <code>Type</code>, and <code>Value</code>, are part of the message size restriction (256 KB or 262,144 bytes).</p>", + "base": "<p>The user-specified message attribute value. For string data types, the <code>Value</code> attribute has the same restrictions on the content as the message body. For more information, see <code> <a>SendMessage</a>.</code> </p> <p> <code>Name</code>, <code>type</code>, <code>value</code> and the message body must not be empty or null. All parts of the message attribute, including <code>Name</code>, <code>Type</code>, and <code>Value</code>, are part of the message size restriction (256 KB or 262,144 bytes).</p>", "refs": { "MessageBodyAttributeMap$value": null } @@ -331,9 +331,9 @@ "QueueAttributeMap": { "base": null, "refs": { - "CreateQueueRequest$Attributes": "<p>A map of attributes with their corresponding values.</p> <p>The following lists the names, descriptions, and values of the special request parameters that the <code>CreateQueue</code> action uses:</p> <ul> <li> <p> <code>DelaySeconds</code> - The number of seconds for which the delivery of all messages in the queue is delayed. Valid values: An integer from 0 to 900 seconds (15 minutes). The default is 0 (zero). </p> </li> <li> <p> <code>MaximumMessageSize</code> - The limit of how many bytes a message can contain before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB). </p> </li> <li> <p> <code>MessageRetentionPeriod</code> - The number of seconds for which Amazon SQS retains a message. Valid values: An integer from 60 seconds (1 minute) to 1,209,600 seconds (14 days). The default is 345,600 (4 days). </p> </li> <li> <p> <code>Policy</code> - The queue's policy. A valid AWS policy. For more information about policy structure, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html\">Overview of AWS IAM Policies</a> in the <i>Amazon IAM User Guide</i>. </p> </li> <li> <p> <code>ReceiveMessageWaitTimeSeconds</code> - The number of seconds for which a <code> <a>ReceiveMessage</a> </code> action waits for a message to arrive. Valid values: An integer from 0 to 20 (seconds). The default is 0 (zero). </p> </li> <li> <p> <code>RedrivePolicy</code> - The parameters for the dead letter queue functionality of the source queue. For more information about the redrive policy and dead letter queues, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html\">Using Amazon SQS Dead Letter Queues</a> in the <i>Amazon SQS Developer Guide</i>. </p> <note> <p>The dead letter queue of a FIFO queue must also be a FIFO queue. Similarly, the dead letter queue of a standard queue must also be a standard queue.</p> </note> </li> <li> <p> <code>VisibilityTimeout</code> - The visibility timeout for the queue. Valid values: An integer from 0 to 43,200 (12 hours). The default is 30. For more information about the visibility timeout, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>.</p> </li> </ul> <p>The following attributes apply only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO (first-in-first-out) queues</a>:</p> <ul> <li> <p> <code>FifoQueue</code> - Designates a queue as FIFO. You can provide this attribute only during queue creation. You can't change it for an existing queue. When you set this attribute, you must provide a <code>MessageGroupId</code> explicitly.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic\">FIFO Queue Logic</a> in the <i>Amazon SQS Developer Guide</i>.</p> </li> <li> <p> <code>ContentBasedDeduplication</code> - Enables content-based deduplication. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\">Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>. </p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>You can also use <code>ContentBasedDeduplication</code> for messages with identical content to be treated as duplicates.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> </li> </ul> <p>Any other valid special request parameters (such as the following) are ignored:</p> <ul> <li> <p> <code>ApproximateNumberOfMessages</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesDelayed</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesNotVisible</code> </p> </li> <li> <p> <code>CreatedTimestamp</code> </p> </li> <li> <p> <code>LastModifiedTimestamp</code> </p> </li> <li> <p> <code>QueueArn</code> </p> </li> </ul>", + "CreateQueueRequest$Attributes": "<p>A map of attributes with their corresponding values.</p> <p>The following lists the names, descriptions, and values of the special request parameters that the <code>CreateQueue</code> action uses:</p> <ul> <li> <p> <code>DelaySeconds</code> - The length of time, in seconds, for which the delivery of all messages in the queue is delayed. Valid values: An integer from 0 to 900 seconds (15 minutes). The default is 0 (zero). </p> </li> <li> <p> <code>MaximumMessageSize</code> - The limit of how many bytes a message can contain before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB). </p> </li> <li> <p> <code>MessageRetentionPeriod</code> - The length of time, in seconds, for which Amazon SQS retains a message. Valid values: An integer from 60 seconds (1 minute) to 1,209,600 seconds (14 days). The default is 345,600 (4 days). </p> </li> <li> <p> <code>Policy</code> - The queue's policy. A valid AWS policy. For more information about policy structure, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html\">Overview of AWS IAM Policies</a> in the <i>Amazon IAM User Guide</i>. </p> </li> <li> <p> <code>ReceiveMessageWaitTimeSeconds</code> - The length of time, in seconds, for which a <code> <a>ReceiveMessage</a> </code> action waits for a message to arrive. Valid values: An integer from 0 to 20 (seconds). The default is 0 (zero). </p> </li> <li> <p> <code>RedrivePolicy</code> - The parameters for the dead letter queue functionality of the source queue. For more information about the redrive policy and dead letter queues, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html\">Using Amazon SQS Dead Letter Queues</a> in the <i>Amazon SQS Developer Guide</i>. </p> <note> <p>The dead letter queue of a FIFO queue must also be a FIFO queue. Similarly, the dead letter queue of a standard queue must also be a standard queue.</p> </note> </li> <li> <p> <code>VisibilityTimeout</code> - The visibility timeout for the queue. Valid values: An integer from 0 to 43,200 (12 hours). The default is 30. For more information about the visibility timeout, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>.</p> </li> </ul> <p>The following attributes apply only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html\">server-side-encryption</a>:</p> <ul> <li> <p> <code>KmsMasterKeyId</code> - The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms\">Key Terms</a>. While the alias of the AWS-managed CMK for Amazon SQS is always <code>alias/aws/sqs</code>, the alias of a custom CMK can, for example, be <code>alias/aws/sqs</code>. For more examples, see <a href=\"http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters\">KeyId</a> in the <i>AWS Key Management Service API Reference</i>. </p> </li> <li> <p> <code>KmsDataKeyReusePeriodSeconds</code> - The length of time, in seconds, for which Amazon SQS can reuse a <a href=\"http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys\">data key</a> to encrypt or decrypt messages before calling AWS KMS again. An integer representing seconds, between 60 seconds (1 minute) and 86,400 seconds (24 hours). The default is 300 (5 minutes). A shorter time period provides better security but results in more calls to KMS which incur charges after Free Tier. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work\">How Does the Data Key Reuse Period Work?</a>. </p> </li> </ul> <p>The following attributes apply only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO (first-in-first-out) queues</a>:</p> <ul> <li> <p> <code>FifoQueue</code> - Designates a queue as FIFO. Valid values: <code>true</code>, <code>false</code>. You can provide this attribute only during queue creation. You can't change it for an existing queue. When you set this attribute, you must also provide the <code>MessageGroupId</code> for your messages explicitly.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic\">FIFO Queue Logic</a> in the <i>Amazon SQS Developer Guide</i>.</p> </li> <li> <p> <code>ContentBasedDeduplication</code> - Enables content-based deduplication. Valid values: <code>true</code>, <code>false</code>. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\">Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>. </p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> </li> </ul> <p>Any other valid special request parameters (such as the following) are ignored:</p> <ul> <li> <p> <code>ApproximateNumberOfMessages</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesDelayed</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesNotVisible</code> </p> </li> <li> <p> <code>CreatedTimestamp</code> </p> </li> <li> <p> <code>LastModifiedTimestamp</code> </p> </li> <li> <p> <code>QueueArn</code> </p> </li> </ul>", "GetQueueAttributesResult$Attributes": "<p>A map of attributes to their respective values.</p>", - "SetQueueAttributesRequest$Attributes": "<p>A map of attributes to set.</p> <p>The following lists the names, descriptions, and values of the special request parameters that the <code>SetQueueAttributes</code> action uses:</p> <ul> <li> <p> <code>DelaySeconds</code> - The number of seconds for which the delivery of all messages in the queue is delayed. Valid values: An integer from 0 to 900 (15 minutes). The default is 0 (zero). </p> </li> <li> <p> <code>MaximumMessageSize</code> - The limit of how many bytes a message can contain before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB). </p> </li> <li> <p> <code>MessageRetentionPeriod</code> - The number of seconds for which Amazon SQS retains a message. Valid values: An integer representing seconds, from 60 (1 minute) to 1,209,600 (14 days). The default is 345,600 (4 days). </p> </li> <li> <p> <code>Policy</code> - The queue's policy. A valid AWS policy. For more information about policy structure, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html\">Overview of AWS IAM Policies</a> in the <i>Amazon IAM User Guide</i>. </p> </li> <li> <p> <code>ReceiveMessageWaitTimeSeconds</code> - The number of seconds for which a <code> <a>ReceiveMessage</a> </code> action waits for a message to arrive. Valid values: an integer from 0 to 20 (seconds). The default is 0. </p> </li> <li> <p> <code>RedrivePolicy</code> - The parameters for the dead letter queue functionality of the source queue. For more information about the redrive policy and dead letter queues, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html\">Using Amazon SQS Dead Letter Queues</a> in the <i>Amazon SQS Developer Guide</i>. </p> <note> <p>The dead letter queue of a FIFO queue must also be a FIFO queue. Similarly, the dead letter queue of a standard queue must also be a standard queue.</p> </note> </li> <li> <p> <code>VisibilityTimeout</code> - The visibility timeout for the queue. Valid values: an integer from 0 to 43,200 (12 hours). The default is 30. For more information about the visibility timeout, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>.</p> </li> </ul> <p>The following attribute applies only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO (first-in-first-out) queues</a>:</p> <ul> <li> <p> <code>ContentBasedDeduplication</code> - Enables content-based deduplication. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\">Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>. </p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>You can also use <code>ContentBasedDeduplication</code> for messages with identical content to be treated as duplicates.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> </li> </ul> <p>Any other valid special request parameters (such as the following) are ignored:</p> <ul> <li> <p> <code>ApproximateNumberOfMessages</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesDelayed</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesNotVisible</code> </p> </li> <li> <p> <code>CreatedTimestamp</code> </p> </li> <li> <p> <code>LastModifiedTimestamp</code> </p> </li> <li> <p> <code>QueueArn</code> </p> </li> </ul>" + "SetQueueAttributesRequest$Attributes": "<p>A map of attributes to set.</p> <p>The following lists the names, descriptions, and values of the special request parameters that the <code>SetQueueAttributes</code> action uses:</p> <ul> <li> <p> <code>DelaySeconds</code> - The length of time, in seconds, for which the delivery of all messages in the queue is delayed. Valid values: An integer from 0 to 900 (15 minutes). The default is 0 (zero). </p> </li> <li> <p> <code>MaximumMessageSize</code> - The limit of how many bytes a message can contain before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB). </p> </li> <li> <p> <code>MessageRetentionPeriod</code> - The length of time, in seconds, for which Amazon SQS retains a message. Valid values: An integer representing seconds, from 60 (1 minute) to 1,209,600 (14 days). The default is 345,600 (4 days). </p> </li> <li> <p> <code>Policy</code> - The queue's policy. A valid AWS policy. For more information about policy structure, see <a href=\"http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html\">Overview of AWS IAM Policies</a> in the <i>Amazon IAM User Guide</i>. </p> </li> <li> <p> <code>ReceiveMessageWaitTimeSeconds</code> - The length of time, in seconds, for which a <code> <a>ReceiveMessage</a> </code> action waits for a message to arrive. Valid values: an integer from 0 to 20 (seconds). The default is 0. </p> </li> <li> <p> <code>RedrivePolicy</code> - The parameters for the dead letter queue functionality of the source queue. For more information about the redrive policy and dead letter queues, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html\">Using Amazon SQS Dead Letter Queues</a> in the <i>Amazon SQS Developer Guide</i>. </p> <note> <p>The dead letter queue of a FIFO queue must also be a FIFO queue. Similarly, the dead letter queue of a standard queue must also be a standard queue.</p> </note> </li> <li> <p> <code>VisibilityTimeout</code> - The visibility timeout for the queue. Valid values: an integer from 0 to 43,200 (12 hours). The default is 30. For more information about the visibility timeout, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html\">Visibility Timeout</a> in the <i>Amazon SQS Developer Guide</i>.</p> </li> </ul> <p>The following attributes apply only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html\">server-side-encryption</a>:</p> <ul> <li> <p> <code>KmsMasterKeyId</code> - The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms\">Key Terms</a>. While the alias of the AWS-managed CMK for Amazon SQS is always <code>alias/aws/sqs</code>, the alias of a custom CMK can, for example, be <code>alias/aws/sqs</code>. For more examples, see <a href=\"http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters\">KeyId</a> in the <i>AWS Key Management Service API Reference</i>. </p> </li> <li> <p> <code>KmsDataKeyReusePeriodSeconds</code> - The length of time, in seconds, for which Amazon SQS can reuse a <a href=\"http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys\">data key</a> to encrypt or decrypt messages before calling AWS KMS again. An integer representing seconds, between 60 seconds (1 minute) and 86,400 seconds (24 hours). The default is 300 (5 minutes). A shorter time period provides better security but results in more calls to KMS which incur charges after Free Tier. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work\">How Does the Data Key Reuse Period Work?</a>. </p> </li> </ul> <p>The following attribute applies only to <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html\">FIFO (first-in-first-out) queues</a>:</p> <ul> <li> <p> <code>ContentBasedDeduplication</code> - Enables content-based deduplication. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\">Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>. </p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> </li> </ul> <p>Any other valid special request parameters (such as the following) are ignored:</p> <ul> <li> <p> <code>ApproximateNumberOfMessages</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesDelayed</code> </p> </li> <li> <p> <code>ApproximateNumberOfMessagesNotVisible</code> </p> </li> <li> <p> <code>CreatedTimestamp</code> </p> </li> <li> <p> <code>LastModifiedTimestamp</code> </p> </li> <li> <p> <code>QueueArn</code> </p> </li> </ul>" } }, "QueueAttributeName": { @@ -408,7 +408,7 @@ } }, "SendMessageBatchResultEntry": { - "base": "<p>Encloses a <code>MessageId</code> for a successfully-enqueued message in a <code> <a>SendMessageBatch</a> </code>.</p>", + "base": "<p>Encloses a <code>MessageId</code> for a successfully-enqueued message in a <code> <a>SendMessageBatch</a>.</code> </p>", "refs": { "SendMessageBatchResultEntryList$member": null } @@ -469,7 +469,7 @@ "Message$ReceiptHandle": "<p>An identifier associated with the act of receiving the message. A new receipt handle is returned every time you receive a message. When deleting a message, you provide the last received receipt handle to delete the message.</p>", "Message$MD5OfBody": "<p>An MD5 digest of the non-URL-encoded message body string.</p>", "Message$Body": "<p>The message's contents (not URL-encoded).</p>", - "Message$MD5OfMessageAttributes": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information on MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", + "Message$MD5OfMessageAttributes": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", "MessageAttributeValue$StringValue": "<p>Strings are Unicode with UTF-8 binary encoding. For a list of code values, see <a href=\"http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters\">ASCII Printable Characters</a>.</p>", "MessageAttributeValue$DataType": "<p>Amazon SQS supports the following logical data types: <code>String</code>, <code>Number</code>, and <code>Binary</code>. For the <code>Number</code> data type, you must use <code>StringValue</code>.</p> <p>You can also append custom labels. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html#message-attributes-data-types-validation\">Message Attribute Data Types and Validation</a> in the <i>Amazon SQS Developer Guide</i>.</p>", "MessageBodyAttributeMap$key": null, @@ -484,21 +484,21 @@ "SendMessageBatchRequest$QueueUrl": "<p>The URL of the Amazon SQS queue to which batched messages are sent.</p> <p>Queue URLs are case-sensitive.</p>", "SendMessageBatchRequestEntry$Id": "<p>An identifier for a message in this batch used to communicate the result.</p> <note> <p>The <code>Id</code>s of a batch request need to be unique within a request</p> </note>", "SendMessageBatchRequestEntry$MessageBody": "<p>The body of the message.</p>", - "SendMessageBatchRequestEntry$MessageDeduplicationId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The token used for deduplication of messages within a 5-minute minimum deduplication interval. If a message with a particular <code>MessageDeduplicationId</code> is sent successfully, subsequent messages with the same <code>MessageDeduplicationId</code> are accepted successfully but aren't delivered. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\"> Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>.</p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>You can also use <code>ContentBasedDeduplication</code> for messages with identical content to be treated as duplicates.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> <note> <p>The <code>MessageDeduplicationId</code> is available to the recipient of the message (this can be useful for troubleshooting delivery issues).</p> <p>If a message is sent successfully but the acknowledgement is lost and the message is resent with the same <code>MessageDeduplicationId</code> after the deduplication interval, Amazon SQS can't detect duplicate messages.</p> </note> <p>The length of <code>MessageDeduplicationId</code> is 128 characters. <code>MessageDeduplicationId</code> can contain alphanumeric characters (<code>a-z</code>, <code>A-Z</code>, <code>0-9</code>) and punctuation (<code>!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~</code>).</p> <p>For best practices of using <code>MessageDeduplicationId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagededuplicationid-property\">Using the MessageDeduplicationId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p>", - "SendMessageBatchRequestEntry$MessageGroupId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use <code>MessageGroupId</code> values (for example, session data for multiple users). In this scenario, multiple readers can process the queue, but the session data of each user is processed in a FIFO fashion.</p> <ul> <li> <p>You must associate a non-empty <code>MessageGroupId</code> with a message. If you don't provide a <code>MessageGroupId</code>, the action fails.</p> </li> <li> <p> <code>ReceiveMessage</code> might return messages with multiple <code>MessageGroupId</code> values. For each <code>MessageGroupId</code>, the messages are sorted by time sent. The caller can't specify a <code>MessageGroupId</code>.</p> </li> </ul> <p>The length of <code>MessageGroupId</code> is 128 characters. Valid values are alphanumeric characters and punctuation <code>(!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~)</code>.</p> <p>For best practices of using <code>MessageGroupId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property\">Using the MessageGroupId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p>", + "SendMessageBatchRequestEntry$MessageDeduplicationId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The token used for deduplication of messages within a 5-minute minimum deduplication interval. If a message with a particular <code>MessageDeduplicationId</code> is sent successfully, subsequent messages with the same <code>MessageDeduplicationId</code> are accepted successfully but aren't delivered. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\"> Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>.</p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> <note> <p>The <code>MessageDeduplicationId</code> is available to the recipient of the message (this can be useful for troubleshooting delivery issues).</p> <p>If a message is sent successfully but the acknowledgement is lost and the message is resent with the same <code>MessageDeduplicationId</code> after the deduplication interval, Amazon SQS can't detect duplicate messages.</p> </note> <p>The length of <code>MessageDeduplicationId</code> is 128 characters. <code>MessageDeduplicationId</code> can contain alphanumeric characters (<code>a-z</code>, <code>A-Z</code>, <code>0-9</code>) and punctuation (<code>!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~</code>).</p> <p>For best practices of using <code>MessageDeduplicationId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagededuplicationid-property\">Using the MessageDeduplicationId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p>", + "SendMessageBatchRequestEntry$MessageGroupId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use <code>MessageGroupId</code> values (for example, session data for multiple users). In this scenario, multiple readers can process the queue, but the session data of each user is processed in a FIFO fashion.</p> <ul> <li> <p>You must associate a non-empty <code>MessageGroupId</code> with a message. If you don't provide a <code>MessageGroupId</code>, the action fails.</p> </li> <li> <p> <code>ReceiveMessage</code> might return messages with multiple <code>MessageGroupId</code> values. For each <code>MessageGroupId</code>, the messages are sorted by time sent. The caller can't specify a <code>MessageGroupId</code>.</p> </li> </ul> <p>The length of <code>MessageGroupId</code> is 128 characters. Valid values are alphanumeric characters and punctuation <code>(!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~)</code>.</p> <p>For best practices of using <code>MessageGroupId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property\">Using the MessageGroupId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p> <important> <p> <code>MessageGroupId</code> is required for FIFO queues. You can't use it for Standard queues.</p> </important>", "SendMessageBatchResultEntry$Id": "<p>An identifier for the message in this batch.</p>", "SendMessageBatchResultEntry$MessageId": "<p>An identifier for the message.</p>", - "SendMessageBatchResultEntry$MD5OfMessageBody": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information on MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", - "SendMessageBatchResultEntry$MD5OfMessageAttributes": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information on MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", - "SendMessageBatchResultEntry$SequenceNumber": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>A large, non-consecutive number that Amazon SQS assigns to each message.</p> <p>The length of <code>SequenceNumber</code> is 128 bits. As <code>SequenceNumber</code> continues to increase for a particular <code>MessageGroupId</code>.</p>", + "SendMessageBatchResultEntry$MD5OfMessageBody": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", + "SendMessageBatchResultEntry$MD5OfMessageAttributes": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", + "SendMessageBatchResultEntry$SequenceNumber": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The large, non-consecutive number that Amazon SQS assigns to each message.</p> <p>The length of <code>SequenceNumber</code> is 128 bits. As <code>SequenceNumber</code> continues to increase for a particular <code>MessageGroupId</code>.</p>", "SendMessageRequest$QueueUrl": "<p>The URL of the Amazon SQS queue to which a message is sent.</p> <p>Queue URLs are case-sensitive.</p>", - "SendMessageRequest$MessageBody": "<p>The message to send. The maximum string size is 256 KB.</p> <important> <p>The following list shows the characters (in Unicode) that are allowed in your message, according to the W3C XML specification:</p> <ul> <li> <p> <code>#x9</code> </p> </li> <li> <p> <code>#xA</code> </p> </li> <li> <p> <code>#xD</code> </p> </li> <li> <p> <code>#x20</code> to <code>#xD7FF</code> </p> </li> <li> <p> <code>#xE000</code> to <code>#xFFFD</code> </p> </li> <li> <p> <code>#x10000</code> to <code>#x10FFFF</code> </p> </li> </ul> <p>For more information, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>. If you send any characters that aren't included in this list, your request is rejected.</p> </important>", - "SendMessageRequest$MessageDeduplicationId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The token used for deduplication of sent messages. If a message with a particular <code>MessageDeduplicationId</code> is sent successfully, any messages sent with the same <code>MessageDeduplicationId</code> are accepted successfully but aren't delivered during the 5-minute deduplication interval. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\"> Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>.</p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>You can also use <code>ContentBasedDeduplication</code> for messages with identical content to be treated as duplicates.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> <note> <p>The <code>MessageDeduplicationId</code> is available to the recipient of the message (this can be useful for troubleshooting delivery issues).</p> <p>If a message is sent successfully but the acknowledgement is lost and the message is resent with the same <code>MessageDeduplicationId</code> after the deduplication interval, Amazon SQS can't detect duplicate messages.</p> </note> <p>The length of <code>MessageDeduplicationId</code> is 128 characters. <code>MessageDeduplicationId</code> can contain alphanumeric characters (<code>a-z</code>, <code>A-Z</code>, <code>0-9</code>) and punctuation (<code>!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~</code>).</p> <p>For best practices of using <code>MessageDeduplicationId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagededuplicationid-property\">Using the MessageDeduplicationId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p>", - "SendMessageRequest$MessageGroupId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use <code>MessageGroupId</code> values (for example, session data for multiple users). In this scenario, multiple readers can process the queue, but the session data of each user is processed in a FIFO fashion.</p> <ul> <li> <p>You must associate a non-empty <code>MessageGroupId</code> with a message. If you don't provide a <code>MessageGroupId</code>, the action fails.</p> </li> <li> <p> <code>ReceiveMessage</code> might return messages with multiple <code>MessageGroupId</code> values. For each <code>MessageGroupId</code>, the messages are sorted by time sent. The caller can't specify a <code>MessageGroupId</code>.</p> </li> </ul> <p>The length of <code>MessageGroupId</code> is 128 characters. Valid values are alphanumeric characters and punctuation <code>(!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~)</code>.</p> <p>For best practices of using <code>MessageGroupId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property\">Using the MessageGroupId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p>", - "SendMessageResult$MD5OfMessageBody": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information on MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", - "SendMessageResult$MD5OfMessageAttributes": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information on MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", + "SendMessageRequest$MessageBody": "<p>The message to send. The maximum string size is 256 KB.</p> <important> <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:</p> <p> <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code> </p> <p>Any characters not included in this list will be rejected. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p> </important>", + "SendMessageRequest$MessageDeduplicationId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The token used for deduplication of sent messages. If a message with a particular <code>MessageDeduplicationId</code> is sent successfully, any messages sent with the same <code>MessageDeduplicationId</code> are accepted successfully but aren't delivered during the 5-minute deduplication interval. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing\"> Exactly-Once Processing</a> in the <i>Amazon SQS Developer Guide</i>.</p> <ul> <li> <p>Every message must have a unique <code>MessageDeduplicationId</code>,</p> <ul> <li> <p>You may provide a <code>MessageDeduplicationId</code> explicitly.</p> </li> <li> <p>If you aren't able to provide a <code>MessageDeduplicationId</code> and you enable <code>ContentBasedDeduplication</code> for your queue, Amazon SQS uses a SHA-256 hash to generate the <code>MessageDeduplicationId</code> using the body of the message (but not the attributes of the message). </p> </li> <li> <p>If you don't provide a <code>MessageDeduplicationId</code> and the queue doesn't have <code>ContentBasedDeduplication</code> set, the action fails with an error.</p> </li> <li> <p>If the queue has <code>ContentBasedDeduplication</code> set, your <code>MessageDeduplicationId</code> overrides the generated one.</p> </li> </ul> </li> <li> <p>When <code>ContentBasedDeduplication</code> is in effect, messages with identical content sent within the deduplication interval are treated as duplicates and only one copy of the message is delivered.</p> </li> <li> <p>If you send one message with <code>ContentBasedDeduplication</code> enabled and then another message with a <code>MessageDeduplicationId</code> that is the same as the one generated for the first <code>MessageDeduplicationId</code>, the two messages are treated as duplicates and only one copy of the message is delivered. </p> </li> </ul> <note> <p>The <code>MessageDeduplicationId</code> is available to the recipient of the message (this can be useful for troubleshooting delivery issues).</p> <p>If a message is sent successfully but the acknowledgement is lost and the message is resent with the same <code>MessageDeduplicationId</code> after the deduplication interval, Amazon SQS can't detect duplicate messages.</p> </note> <p>The length of <code>MessageDeduplicationId</code> is 128 characters. <code>MessageDeduplicationId</code> can contain alphanumeric characters (<code>a-z</code>, <code>A-Z</code>, <code>0-9</code>) and punctuation (<code>!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~</code>).</p> <p>For best practices of using <code>MessageDeduplicationId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagededuplicationid-property\">Using the MessageDeduplicationId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p>", + "SendMessageRequest$MessageGroupId": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use <code>MessageGroupId</code> values (for example, session data for multiple users). In this scenario, multiple readers can process the queue, but the session data of each user is processed in a FIFO fashion.</p> <ul> <li> <p>You must associate a non-empty <code>MessageGroupId</code> with a message. If you don't provide a <code>MessageGroupId</code>, the action fails.</p> </li> <li> <p> <code>ReceiveMessage</code> might return messages with multiple <code>MessageGroupId</code> values. For each <code>MessageGroupId</code>, the messages are sorted by time sent. The caller can't specify a <code>MessageGroupId</code>.</p> </li> </ul> <p>The length of <code>MessageGroupId</code> is 128 characters. Valid values are alphanumeric characters and punctuation <code>(!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~)</code>.</p> <p>For best practices of using <code>MessageGroupId</code>, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property\">Using the MessageGroupId Property</a> in the <i>Amazon Simple Queue Service Developer Guide</i>.</p> <important> <p> <code>MessageGroupId</code> is required for FIFO queues. You can't use it for Standard queues.</p> </important>", + "SendMessageResult$MD5OfMessageBody": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", + "SendMessageResult$MD5OfMessageAttributes": "<p>An MD5 digest of the non-URL-encoded message attribute string. You can use this attribute to verify that Amazon SQS received the message correctly. Amazon SQS URL-decodes the message before creating the MD5 digest. For information about MD5, see <a href=\"https://www.ietf.org/rfc/rfc1321.txt\">RFC1321</a>.</p>", "SendMessageResult$MessageId": "<p>An attribute containing the <code>MessageId</code> of the message sent to the queue. For more information, see <a href=\"http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html\">Queue and Message Identifiers</a> in the <i>Amazon SQS Developer Guide</i>. </p>", - "SendMessageResult$SequenceNumber": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>A large, non-consecutive number that Amazon SQS assigns to each message.</p> <p>The length of <code>SequenceNumber</code> is 128 bits. <code>SequenceNumber</code> continues to increase for a particular <code>MessageGroupId</code>.</p>", + "SendMessageResult$SequenceNumber": "<p>This parameter applies only to FIFO (first-in-first-out) queues.</p> <p>The large, non-consecutive number that Amazon SQS assigns to each message.</p> <p>The length of <code>SequenceNumber</code> is 128 bits. <code>SequenceNumber</code> continues to increase for a particular <code>MessageGroupId</code>.</p>", "SetQueueAttributesRequest$QueueUrl": "<p>The URL of the Amazon SQS queue whose attributes are set.</p> <p>Queue URLs are case-sensitive.</p>", "StringList$member": null } diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/paginators-1.json index e7ac48a9..4d5fe76b 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/sqs/2012-11-05/paginators-1.json @@ -4,4 +4,4 @@ "result_key": "QueueUrls" } } -} +}
\ No newline at end of file diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/api-2.json index 6fb2f615..61cfee11 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/api-2.json @@ -1071,7 +1071,9 @@ {"shape":"InvalidDocumentVersion"}, {"shape":"AssociationDoesNotExist"}, {"shape":"InvalidUpdate"}, - {"shape":"TooManyUpdates"} + {"shape":"TooManyUpdates"}, + {"shape":"InvalidDocument"}, + {"shape":"InvalidTarget"} ] }, "UpdateAssociationStatus":{ @@ -2744,6 +2746,14 @@ "locationName":"FailedCreateAssociationEntry" } }, + "FailureDetails":{ + "type":"structure", + "members":{ + "FailureStage":{"shape":"String"}, + "FailureType":{"shape":"String"}, + "Details":{"shape":"AutomationParameterMap"} + } + }, "Fault":{ "type":"string", "enum":[ @@ -5014,7 +5024,8 @@ "Inputs":{"shape":"NormalStringMap"}, "Outputs":{"shape":"AutomationParameterMap"}, "Response":{"shape":"String"}, - "FailureMessage":{"shape":"String"} + "FailureMessage":{"shape":"String"}, + "FailureDetails":{"shape":"FailureDetails"} } }, "StepExecutionList":{ @@ -5152,7 +5163,9 @@ "Parameters":{"shape":"Parameters"}, "DocumentVersion":{"shape":"DocumentVersion"}, "ScheduleExpression":{"shape":"ScheduleExpression"}, - "OutputLocation":{"shape":"InstanceAssociationOutputLocation"} + "OutputLocation":{"shape":"InstanceAssociationOutputLocation"}, + "Name":{"shape":"DocumentName"}, + "Targets":{"shape":"Targets"} } }, "UpdateAssociationResult":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/docs-2.json index 642bfc8a..21f81a29 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/docs-2.json @@ -2,7 +2,7 @@ "version": "2.0", "service": "<fullname>Amazon EC2 Systems Manager</fullname> <p>Amazon EC2 Systems Manager is a collection of capabilities that helps you automate management tasks such as collecting system inventory, applying operating system (OS) patches, automating the creation of Amazon Machine Images (AMIs), and configuring operating systems (OSs) and applications at scale. Systems Manager lets you remotely and securely manage the configuration of your managed instances. A <i>managed instance</i> is any Amazon EC2 instance or on-premises machine in your hybrid environment that has been configured for Systems Manager.</p> <p>This reference is intended to be used with the <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/\">Amazon EC2 Systems Manager User Guide</a>.</p> <p>To get started, verify prerequisites and configure managed instances. For more information, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-prereqs.html\">Systems Manager Prerequisites</a>.</p>", "operations": { - "AddTagsToResource": "<p>Adds or overwrites one or more tags for the specified resource. Tags are metadata that you assign to your managed instances. Tags enable you to categorize your managed instances in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. For example, you could define a set of tags for your account's managed instances that helps you track each instance's owner and stack level. For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or Test. Each resource can have a maximum of 10 tags. </p> <p>We recommend that you devise a set of tag keys that meets your needs for each resource type. Using a consistent set of tag keys makes it easier for you to manage your resources. You can search and filter the resources based on the tags you add. Tags don't have any semantic meaning to Amazon EC2 and are interpreted strictly as a string of characters. </p> <p>For more information about tags, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html\">Tagging Your Amazon EC2 Resources</a> in the <i>Amazon EC2 User Guide</i>.</p>", + "AddTagsToResource": "<p>Adds or overwrites one or more tags for the specified resource. Tags are metadata that you assign to your managed instances, Maintenance Windows, or Parameter Store parameters. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. For example, you could define a set of tags for your account's managed instances that helps you track each instance's owner and stack level. For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or Test.</p> <p>Each resource can have a maximum of 10 tags. </p> <p>We recommend that you devise a set of tag keys that meets your needs for each resource type. Using a consistent set of tag keys makes it easier for you to manage your resources. You can search and filter the resources based on the tags you add. Tags don't have any semantic meaning to Amazon EC2 and are interpreted strictly as a string of characters. </p> <p>For more information about tags, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html\">Tagging Your Amazon EC2 Resources</a> in the <i>Amazon EC2 User Guide</i>.</p>", "CancelCommand": "<p>Attempts to cancel the command specified by the Command ID. There is no guarantee that the command will be terminated and the underlying process stopped.</p>", "CreateActivation": "<p>Registers your on-premises server or virtual machine with Amazon EC2 so that you can manage these resources using Run Command. An on-premises server or virtual machine that has been registered with EC2 is called a managed instance. For more information about activations, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html\">Setting Up Systems Manager in Hybrid Environments</a>.</p>", "CreateAssociation": "<p>Associates the specified Systems Manager document with the specified instances or targets.</p> <p>When you associate a document with one or more instances using instance IDs or tags, the SSM Agent running on the instance processes the document and configures the instance as specified.</p> <p>If you associate a document with an instance that already has an associated document, the system throws the AssociationAlreadyExists exception.</p>", @@ -16,7 +16,7 @@ "DeleteMaintenanceWindow": "<p>Deletes a Maintenance Window.</p>", "DeleteParameter": "<p>Delete a parameter from the system.</p>", "DeletePatchBaseline": "<p>Deletes a patch baseline.</p>", - "DeregisterManagedInstance": "<p>Removes the server or virtual machine from the list of registered servers. You can reregister the instance again at any time. If you don’t plan to use Run Command on the server, we suggest uninstalling the SSM Agent first.</p>", + "DeregisterManagedInstance": "<p>Removes the server or virtual machine from the list of registered servers. You can reregister the instance again at any time. If you don't plan to use Run Command on the server, we suggest uninstalling the SSM Agent first.</p>", "DeregisterPatchBaselineForPatchGroup": "<p>Removes a patch group from a patch baseline.</p>", "DeregisterTargetFromMaintenanceWindow": "<p>Removes a target from a Maintenance Window.</p>", "DeregisterTaskFromMaintenanceWindow": "<p>Removes a task from a Maintenance Window.</p>", @@ -25,7 +25,7 @@ "DescribeAutomationExecutions": "<p>Provides details about all active and terminated Automation executions.</p>", "DescribeAvailablePatches": "<p>Lists all patches that could possibly be included in a patch baseline.</p>", "DescribeDocument": "<p>Describes the specified SSM document.</p>", - "DescribeDocumentPermission": "<p>Describes the permissions for a Systems Manager document. If you created the document, you are the owner. If a document is shared, it can either be shared privately (by specifying a user’s AWS account ID) or publicly (<i>All</i>). </p>", + "DescribeDocumentPermission": "<p>Describes the permissions for a Systems Manager document. If you created the document, you are the owner. If a document is shared, it can either be shared privately (by specifying a user's AWS account ID) or publicly (<i>All</i>). </p>", "DescribeEffectiveInstanceAssociations": "<p>All associations for the instance(s).</p>", "DescribeEffectivePatchesForPatchBaseline": "<p>Retrieves the current effective patches (the patch and the approval state) for the specified patch baseline.</p>", "DescribeInstanceAssociationsStatus": "<p>The status of the associations for the instance(s).</p>", @@ -114,7 +114,7 @@ "base": null, "refs": { "Activation$Description": "<p>A user defined description of the activation.</p>", - "CreateActivationRequest$Description": "<p>A user-defined description of the resource that you want to register with Amazon EC2. </p>" + "CreateActivationRequest$Description": "<p>A userdefined description of the resource that you want to register with Amazon EC2. </p>" } }, "ActivationId": { @@ -338,7 +338,7 @@ "refs": { "AutomationExecution$AutomationExecutionId": "<p>The execution ID.</p>", "AutomationExecutionMetadata$AutomationExecutionId": "<p>The execution ID.</p>", - "GetAutomationExecutionRequest$AutomationExecutionId": "<p>The unique identifier for an existing automation execution to examine. The execution ID is returned by <code>StartAutomationExecution</code> when the execution of an Automation document is initiated.</p>", + "GetAutomationExecutionRequest$AutomationExecutionId": "<p>The unique identifier for an existing automation execution to examine. The execution ID is returned by StartAutomationExecution when the execution of an Automation document is initiated.</p>", "StartAutomationExecutionResult$AutomationExecutionId": "<p>The unique ID of a newly scheduled automation execution.</p>", "StopAutomationExecutionRequest$AutomationExecutionId": "<p>The execution ID of the Automation to stop.</p>" } @@ -370,7 +370,7 @@ "refs": { "AutomationExecution$AutomationExecutionStatus": "<p>The execution status of the Automation.</p>", "AutomationExecutionMetadata$AutomationExecutionStatus": "<p>The status of the execution. Valid values include: Running, Succeeded, Failed, Timed out, or Cancelled.</p>", - "StepExecution$StepStatus": "<p>The execution status for this step. Valid values include: <code>Pending</code>, <code>InProgress</code>, <code>Success</code>, <code>Cancelled</code>, <code>Failed</code>, and <code>TimedOut</code>.</p>" + "StepExecution$StepStatus": "<p>The execution status for this step. Valid values include: Pending, InProgress, Success, Cancelled, Failed, and TimedOut.</p>" } }, "AutomationParameterKey": { @@ -382,9 +382,10 @@ "AutomationParameterMap": { "base": null, "refs": { - "AutomationExecution$Parameters": "<p>The key-value map of execution parameters, which were supplied when calling <code>StartAutomationExecution</code>.</p>", + "AutomationExecution$Parameters": "<p>The key-value map of execution parameters, which were supplied when calling StartAutomationExecution.</p>", "AutomationExecution$Outputs": "<p>The list of execution outputs as defined in the automation document.</p>", "AutomationExecutionMetadata$Outputs": "<p>The list of execution outputs as defined in the Automation document.</p>", + "FailureDetails$Details": "<p>Detailed information about the Automation step failure.</p>", "StartAutomationExecutionRequest$Parameters": "<p>A key-value map of execution parameters, which match the declared parameters in the Automation document.</p>", "StepExecution$Outputs": "<p>Returned values from the execution of the step.</p>" } @@ -476,7 +477,7 @@ "base": null, "refs": { "CreateMaintenanceWindowRequest$ClientToken": "<p>User-provided idempotency token.</p>", - "CreatePatchBaselineRequest$ClientToken": "<p>Caller-provided idempotency token.</p>", + "CreatePatchBaselineRequest$ClientToken": "<p>User-provided idempotency token.</p>", "RegisterTargetWithMaintenanceWindowRequest$ClientToken": "<p>User-provided idempotency token.</p>", "RegisterTaskWithMaintenanceWindowRequest$ClientToken": "<p>User-provided idempotency token.</p>" } @@ -541,7 +542,7 @@ "base": null, "refs": { "CommandInvocation$Status": "<p>Whether or not the invocation succeeded, failed, or is pending.</p>", - "GetCommandInvocationResult$Status": "<p>The status of the parent command for this invocation. This status can be different than <code>StatusDetails</code>.</p>" + "GetCommandInvocationResult$Status": "<p>The status of the parent command for this invocation. This status can be different than StatusDetails.</p>" } }, "CommandList": { @@ -607,7 +608,7 @@ "CompletedCount": { "base": null, "refs": { - "Command$CompletedCount": "<p>The number of targets for which the command invocation reached a terminal state. Terminal states include the following: <code>Success</code>, <code>Failed</code>, <code>Execution Timed Out</code>, <code>Delivery Timed Out</code>, <code>Canceled</code>, <code>Terminated</code>, or <code>Undeliverable</code>.</p>" + "Command$CompletedCount": "<p>The number of targets for which the command invocation reached a terminal state. Terminal states include the following: Success, Failed, Execution Timed Out, Delivery Timed Out, Canceled, Terminated, or Undeliverable.</p>" } }, "ComputerName": { @@ -638,7 +639,7 @@ } }, "CreateAssociationBatchRequestEntry": { - "base": "<p> Describes the association of a Systems Manager document and an instance.</p>", + "base": "<p>Describes the association of a Systems Manager document and an instance.</p>", "refs": { "CreateAssociationBatchRequestEntries$member": null, "FailedCreateAssociation$Entry": "<p>The association.</p>" @@ -718,7 +719,7 @@ "CommandInvocation$RequestedDateTime": "<p>The time and date the request was sent to this instance.</p>", "CommandPlugin$ResponseStartDateTime": "<p>The time the plugin started executing. </p>", "CommandPlugin$ResponseFinishDateTime": "<p>The time the plugin stopped executing. Could stop prematurely if, for example, a cancel command was sent. </p>", - "DocumentDescription$CreatedDate": "<p> The date when the document was created.</p>", + "DocumentDescription$CreatedDate": "<p>The date when the document was created.</p>", "DocumentVersionInfo$CreatedDate": "<p>The date the document was created.</p>", "GetMaintenanceWindowExecutionResult$StartTime": "<p>The time the Maintenance Window started executing.</p>", "GetMaintenanceWindowExecutionResult$EndTime": "<p>The time the Maintenance Window finished executing.</p>", @@ -743,7 +744,7 @@ "ParameterMetadata$LastModifiedDate": "<p>Date the parameter was last changed or updated.</p>", "Patch$ReleaseDate": "<p>The date the patch was released.</p>", "PatchStatus$ApprovalDate": "<p>The date the patch was approved (or will be approved if the status is PENDING_APPROVAL).</p>", - "StepExecution$ExecutionStartTime": "<p>If a step has begun execution, this contains the time the step started. If the step is in <code>Pending</code> status, this field is not populated.</p>", + "StepExecution$ExecutionStartTime": "<p>If a step has begun execution, this contains the time the step started. If the step is in Pending status, this field is not populated.</p>", "StepExecution$ExecutionEndTime": "<p>If a step has finished execution, this contains the time the execution ended. If the step has not yet concluded, this field is not populated.</p>", "UpdatePatchBaselineResult$CreatedDate": "<p>The date when the patch baseline was created.</p>", "UpdatePatchBaselineResult$ModifiedDate": "<p>The date when the patch baseline was last modified.</p>" @@ -1113,7 +1114,7 @@ "DescriptionInDocument": { "base": null, "refs": { - "DocumentDescription$Description": "<p> A description of the document. </p>" + "DocumentDescription$Description": "<p>A description of the document. </p>" } }, "DocumentARN": { @@ -1149,7 +1150,7 @@ } }, "DocumentDescription": { - "base": "<p> Describes an SSM document. </p>", + "base": "<p>Describes an SSM document. </p>", "refs": { "CreateDocumentResult$DocumentDescription": "<p>Information about the Systems Manager document.</p>", "DescribeDocumentResult$Document": "<p>Information about the SSM document.</p>", @@ -1220,7 +1221,7 @@ "AutomationExecutionMetadata$DocumentName": "<p>The name of the Automation document used during execution.</p>", "Command$DocumentName": "<p>The name of the document requested for execution.</p>", "CommandInvocation$DocumentName": "<p>The document name that was requested for execution.</p>", - "CreateAssociationBatchRequestEntry$Name": "<p> The name of the configuration document. </p>", + "CreateAssociationBatchRequestEntry$Name": "<p>The name of the configuration document. </p>", "CreateAssociationRequest$Name": "<p>The name of the Systems Manager document.</p>", "CreateDocumentRequest$Name": "<p>A name for the Systems Manager document.</p>", "DeleteAssociationRequest$Name": "<p>The name of the Systems Manager document.</p>", @@ -1233,6 +1234,7 @@ "InstanceAssociationStatusInfo$Name": "<p>The name of the association.</p>", "ListDocumentVersionsRequest$Name": "<p>The name of the document about which you want version information.</p>", "ModifyDocumentPermissionRequest$Name": "<p>The name of the document that you want to share.</p>", + "UpdateAssociationRequest$Name": "<p>The name of the association document.</p>", "UpdateAssociationStatusRequest$Name": "<p>The name of the SSM document.</p>", "UpdateDocumentDefaultVersionRequest$Name": "<p>The name of a custom document that you want to set as the default version.</p>", "UpdateDocumentRequest$Name": "<p>The name of the document that you want to update.</p>" @@ -1278,7 +1280,7 @@ "DocumentParameterType": { "base": null, "refs": { - "DocumentParameter$Type": "<p>The type of parameter. The type can be either “String” or “StringList”.</p>" + "DocumentParameter$Type": "<p>The type of parameter. The type can be either String or StringList.</p>" } }, "DocumentPermissionLimit": { @@ -1369,7 +1371,7 @@ } }, "DoesNotExistException": { - "base": "<p>Error returned when the ID specified for a resource (e.g. a Maintenance Window) doesn’t exist.</p>", + "base": "<p>Error returned when the ID specified for a resource (e.g. a Maintenance Window) doesn't exist.</p>", "refs": { } }, @@ -1404,7 +1406,7 @@ "ErrorCount": { "base": null, "refs": { - "Command$ErrorCount": "<p>The number of targets for which the status is <code>Failed</code> or <code>Execution Timed Out</code>.</p>" + "Command$ErrorCount": "<p>The number of targets for which the status is Failed or Execution Timed Out.</p>" } }, "ExpirationDate": { @@ -1426,6 +1428,12 @@ "CreateAssociationBatchResult$Failed": "<p>Information about the associations that failed.</p>" } }, + "FailureDetails": { + "base": "<p>Information about an Automation failure.</p>", + "refs": { + "StepExecution$FailureDetails": "<p>Information about the Automation failure.</p>" + } + }, "Fault": { "base": null, "refs": { @@ -1594,7 +1602,7 @@ } }, "IdempotentParameterMismatch": { - "base": "<p>Error returned when an idempotent operation is retried and the parameters don’t match the original call to the API with the same idempotency token. </p>", + "base": "<p>Error returned when an idempotent operation is retried and the parameters don't match the original call to the API with the same idempotency token. </p>", "refs": { } }, @@ -1627,8 +1635,8 @@ "refs": { "AssociationDescription$OutputLocation": "<p>An Amazon S3 bucket where you want to store the output details of the request.</p>", "CreateAssociationBatchRequestEntry$OutputLocation": "<p>An Amazon S3 bucket where you want to store the results of this request.</p>", - "CreateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the output details of the request. For example:</p> <p> <code>\"{ \\\"S3Location\\\": { \\\"OutputS3Region\\\": \\\"<region>\\\", \\\"OutputS3BucketName\\\": \\\"bucket name\\\", \\\"OutputS3KeyPrefix\\\": \\\"folder name\\\" } }\"</code> </p>", - "UpdateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the results of this request.</p> <p> <code>\"{ \\\"S3Location\\\": { \\\"OutputS3Region\\\": \\\"<region>\\\", \\\"OutputS3BucketName\\\": \\\"bucket name\\\", \\\"OutputS3KeyPrefix\\\": \\\"folder name\\\" } }\"</code> </p>" + "CreateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the output details of the request.</p>", + "UpdateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the results of this request.</p>" } }, "InstanceAssociationOutputUrl": { @@ -1668,7 +1676,7 @@ "Association$InstanceId": "<p>The ID of the instance.</p>", "AssociationDescription$InstanceId": "<p>The ID of the instance.</p>", "CommandInvocation$InstanceId": "<p>The instance ID in which this invocation was requested.</p>", - "CreateAssociationBatchRequestEntry$InstanceId": "<p> The ID of the instance. </p>", + "CreateAssociationBatchRequestEntry$InstanceId": "<p>The ID of the instance. </p>", "CreateAssociationRequest$InstanceId": "<p>The instance ID.</p>", "DeleteAssociationRequest$InstanceId": "<p>The ID of the instance.</p>", "DescribeAssociationRequest$InstanceId": "<p>The instance ID.</p>", @@ -1698,7 +1706,7 @@ "CancelCommandRequest$InstanceIds": "<p>(Optional) A list of instance IDs on which you want to cancel the command. If not provided, the command is canceled on every instance on which it was requested.</p>", "Command$InstanceIds": "<p>The instance IDs against which this command was requested.</p>", "DescribeInstancePatchStatesRequest$InstanceIds": "<p>The ID of the instance whose patch state information should be retrieved.</p>", - "SendCommandRequest$InstanceIds": "<p>Required. The instance IDs where the command should execute. You can specify a maximum of 50 IDs.</p>" + "SendCommandRequest$InstanceIds": "<p>The instance IDs where the command should execute. You can specify a maximum of 50 IDs. If you prefer not to list individual instance IDs, you can instead send commands to a fleet of instances using the Targets parameter, which accepts EC2 tags.</p>" } }, "InstanceInformation": { @@ -1753,7 +1761,7 @@ "InstanceInformationStringFilterKey": { "base": null, "refs": { - "InstanceInformationStringFilter$Key": "<p>The filter key name to describe your instances. For example:</p> <p>\"InstanceIds\"|\"AgentVersion\"|\"PingStatus\"|\"PlatformTypes\"|\"ActivationIds\"|\"IamRole\"|\"ResourceType\"|”AssociationStatus”|”Tag Key”</p>" + "InstanceInformationStringFilter$Key": "<p>The filter key name to describe your instances. For example:</p> <p>\"InstanceIds\"|\"AgentVersion\"|\"PingStatus\"|\"PlatformTypes\"|\"ActivationIds\"|\"IamRole\"|\"ResourceType\"|\"AssociationStatus\"|\"Tag Key\"</p>" } }, "InstanceInformationStringFilterList": { @@ -1784,7 +1792,7 @@ "InstancePatchStateFilterList": { "base": null, "refs": { - "DescribeInstancePatchStatesForPatchGroupRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string 1 ≤ length ≤ 200)</p> <p> Values (array containing a single string)</p> <p> Type (string “Equal”, “NotEqual”, “LessThan”, “GreaterThan”)</p>" + "DescribeInstancePatchStatesForPatchGroupRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string between 1 and 200 characters)</p> <p> Values (array containing a single string)</p> <p> Type (string \"Equal\", \"NotEqual\", \"LessThan\", \"GreaterThan\")</p>" } }, "InstancePatchStateFilterValue": { @@ -1820,7 +1828,7 @@ "InstanceTagName": { "base": null, "refs": { - "CommandInvocation$InstanceName": "<p>The name of the invocation target. For Amazon EC2 instances this is the value for the <code>aws:Name</code> tag. For on-premises instances, this is the name of the instance.</p>" + "CommandInvocation$InstanceName": "<p>The name of the invocation target. For Amazon EC2 instances this is the value for the aws:Name tag. For on-premises instances, this is the name of the instance.</p>" } }, "Integer": { @@ -1828,10 +1836,10 @@ "refs": { "DescribePatchGroupStateResult$Instances": "<p>The number of instances in the patch group.</p>", "DescribePatchGroupStateResult$InstancesWithInstalledPatches": "<p>The number of instances with installed patches.</p>", - "DescribePatchGroupStateResult$InstancesWithInstalledOtherPatches": "<p>The number of instances with patches installed that aren’t defined in the patch baseline.</p>", + "DescribePatchGroupStateResult$InstancesWithInstalledOtherPatches": "<p>The number of instances with patches installed that aren't defined in the patch baseline.</p>", "DescribePatchGroupStateResult$InstancesWithMissingPatches": "<p>The number of instances with missing patches from the patch baseline.</p>", "DescribePatchGroupStateResult$InstancesWithFailedPatches": "<p>The number of instances with patches from the patch baseline that failed to install.</p>", - "DescribePatchGroupStateResult$InstancesWithNotApplicablePatches": "<p>The number of instances with patches that aren’t applicable.</p>" + "DescribePatchGroupStateResult$InstancesWithNotApplicablePatches": "<p>The number of instances with patches that aren't applicable.</p>" } }, "InternalServerError": { @@ -2066,8 +2074,8 @@ "InventoryItemContentHash": { "base": null, "refs": { - "InventoryItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The <code>PutInventory</code> API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>", - "InventoryResultItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The <code>PutInventory</code> API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>" + "InventoryItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The PutInventory API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>", + "InventoryResultItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The PutInventory API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>" } }, "InventoryItemEntry": { @@ -2115,14 +2123,14 @@ "base": null, "refs": { "InvalidItemContentException$TypeName": null, - "InventoryItem$TypeName": "<p>The name of the inventory type. Default inventory item type names start with <code>AWS</code>. Custom inventory type names will start with <code>Custom</code>. Default inventory item types include the following: <code>AWS:AWSComponent</code>, <code>AWS:Application</code>, <code>AWS:InstanceInformation</code>, <code>AWS:Network</code>, and <code>AWS:WindowsUpdate</code>.</p>", - "InventoryItemSchema$TypeName": "<p>The name of the inventory type. Default inventory item type names start with <code>AWS</code>. Custom inventory type names will start with <code>Custom</code>. Default inventory item types include the following: <code>AWS:AWSComponent</code>, <code>AWS:Application</code>, <code>AWS:InstanceInformation</code>, <code>AWS:Network</code>, and <code>AWS:WindowsUpdate</code>.</p>", + "InventoryItem$TypeName": "<p>The name of the inventory type. Default inventory item type names start with AWS. Custom inventory type names will start with Custom. Default inventory item types include the following: AWS:AWSComponent, AWS:Application, AWS:InstanceInformation, AWS:Network, and AWS:WindowsUpdate.</p>", + "InventoryItemSchema$TypeName": "<p>The name of the inventory type. Default inventory item type names start with AWS. Custom inventory type names will start with Custom. Default inventory item types include the following: AWS:AWSComponent, AWS:Application, AWS:InstanceInformation, AWS:Network, and AWS:WindowsUpdate.</p>", "InventoryResultItem$TypeName": "<p>The name of the inventory result item type.</p>", "ItemContentMismatchException$TypeName": null, "ItemSizeLimitExceededException$TypeName": null, "ListInventoryEntriesRequest$TypeName": "<p>The type of inventory item for which you want information.</p>", "ListInventoryEntriesResult$TypeName": "<p>The type of inventory item returned by the request.</p>", - "ResultAttribute$TypeName": "<p>Name of the inventory item type. Valid value: “AWS:InstanceInformation”. Default Value: “AWS:InstanceInformation”.</p>" + "ResultAttribute$TypeName": "<p>Name of the inventory item type. Valid value: AWS:InstanceInformation. Default Value: AWS:InstanceInformation.</p>" } }, "InventoryItemTypeNameFilter": { @@ -2437,10 +2445,10 @@ "refs": { "DescribeMaintenanceWindowExecutionTaskInvocationsRequest$Filters": "<p>Optional filters used to scope down the returned task invocations. The supported filter key is STATUS with the corresponding values PENDING, IN_PROGRESS, SUCCESS, FAILED, TIMED_OUT, CANCELLING, and CANCELLED.</p>", "DescribeMaintenanceWindowExecutionTasksRequest$Filters": "<p>Optional filters used to scope down the returned tasks. The supported filter key is STATUS with the corresponding values PENDING, IN_PROGRESS, SUCCESS, FAILED, TIMED_OUT, CANCELLING, and CANCELLED. </p>", - "DescribeMaintenanceWindowExecutionsRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, 1 ≤ length ≤ 128)</p> <p>Values (array of strings 1 ≤ length ≤ 256)</p> <p>The supported Keys are <code>ExecutedBefore</code> and <code>ExecutedAfter</code> with the value being a date/time string such as 2016-11-04T05:00:00Z.</p>", - "DescribeMaintenanceWindowTargetsRequest$Filters": "<p>Optional filters that can be used to narrow down the scope of the returned window targets. The supported filter keys are <code>Type</code>, <code>WindowTargetId</code> and <code>OwnerInformation</code>.</p>", - "DescribeMaintenanceWindowTasksRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned tasks. The supported filter keys are <code>WindowTaskId</code>, <code>TaskArn</code>, <code>Priority</code>, and <code>TaskType</code>.</p>", - "DescribeMaintenanceWindowsRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned Maintenance Windows. Supported filter keys are <code>Name</code> and <code>Enabled</code>.</p>" + "DescribeMaintenanceWindowExecutionsRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, between 1 and 128 characters)</p> <p>Values (array of strings, each string is between 1 and 256 characters)</p> <p>The supported Keys are ExecutedBefore and ExecutedAfter with the value being a date/time string such as 2016-11-04T05:00:00Z.</p>", + "DescribeMaintenanceWindowTargetsRequest$Filters": "<p>Optional filters that can be used to narrow down the scope of the returned window targets. The supported filter keys are Type, WindowTargetId and OwnerInformation.</p>", + "DescribeMaintenanceWindowTasksRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned tasks. The supported filter keys are WindowTaskId, TaskArn, Priority, and TaskType.</p>", + "DescribeMaintenanceWindowsRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned Maintenance Windows. Supported filter keys are Name and Enabled.</p>" } }, "MaintenanceWindowFilterValue": { @@ -2615,7 +2623,7 @@ "MaintenanceWindowTaskParametersList": { "base": null, "refs": { - "GetMaintenanceWindowExecutionTaskResult$TaskParameters": "<p>The parameters passed to the task when it was executed. The map has the following format:</p> <p>Key: string, 1 ≤ length ≤ 255</p> <p>Value: an array of strings where each string 1 ≤ length ≤ 255</p>" + "GetMaintenanceWindowExecutionTaskResult$TaskParameters": "<p>The parameters passed to the task when it was executed. The map has the following format:</p> <p>Key: string, between 1 and 255 characters</p> <p>Value: an array of strings, each string is between 1 and 255 characters</p>" } }, "MaintenanceWindowTaskPriority": { @@ -2651,11 +2659,11 @@ "MaxConcurrency": { "base": null, "refs": { - "Command$MaxConcurrency": "<p>The maximum number of instances that are allowed to execute the command at the same time. You can specify a number of instances, such as 10, or a percentage of instances, such as 10%. The default value is 50. For more information about how to use <code>MaxConcurrency</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>", + "Command$MaxConcurrency": "<p>The maximum number of instances that are allowed to execute the command at the same time. You can specify a number of instances, such as 10, or a percentage of instances, such as 10%. The default value is 50. For more information about how to use MaxConcurrency, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>", "GetMaintenanceWindowExecutionTaskResult$MaxConcurrency": "<p>The defined maximum number of task executions that could be run in parallel.</p>", "MaintenanceWindowTask$MaxConcurrency": "<p>The maximum number of targets this task can be run for in parallel.</p>", "RegisterTaskWithMaintenanceWindowRequest$MaxConcurrency": "<p>The maximum number of targets this task can be run for in parallel.</p>", - "SendCommandRequest$MaxConcurrency": "<p>(Optional) The maximum number of instances that are allowed to execute the command at the same time. You can specify a number such as “10” or a percentage such as “10%”. The default value is 50. For more information about how to use <code>MaxConcurrency</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" + "SendCommandRequest$MaxConcurrency": "<p>(Optional) The maximum number of instances that are allowed to execute the command at the same time. You can specify a number such as 10 or a percentage such as 10%. The default value is 50. For more information about how to use MaxConcurrency, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" } }, "MaxDocumentSizeExceeded": { @@ -2666,11 +2674,11 @@ "MaxErrors": { "base": null, "refs": { - "Command$MaxErrors": "<p>The maximum number of errors allowed before the system stops sending the command to additional targets. You can specify a number of errors, such as 10, or a percentage or errors, such as 10%. The default value is 50. For more information about how to use <code>MaxErrors</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>", + "Command$MaxErrors": "<p>The maximum number of errors allowed before the system stops sending the command to additional targets. You can specify a number of errors, such as 10, or a percentage or errors, such as 10%. The default value is 50. For more information about how to use MaxErrors, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>", "GetMaintenanceWindowExecutionTaskResult$MaxErrors": "<p>The defined maximum number of task execution errors allowed before scheduling of the task execution would have been stopped.</p>", "MaintenanceWindowTask$MaxErrors": "<p>The maximum number of errors allowed before this task stops being scheduled.</p>", "RegisterTaskWithMaintenanceWindowRequest$MaxErrors": "<p>The maximum number of errors allowed before this task stops being scheduled.</p>", - "SendCommandRequest$MaxErrors": "<p>The maximum number of errors allowed without the command failing. When the command fails one more time beyond the value of <code>MaxErrors</code>, the systems stops sending the command to additional targets. You can specify a number like “10” or a percentage like “10%”. The default value is 50. For more information about how to use <code>MaxErrors</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" + "SendCommandRequest$MaxErrors": "<p>The maximum number of errors allowed without the command failing. When the command fails one more time beyond the value of MaxErrors, the systems stops sending the command to additional targets. You can specify a number like 10 or a percentage like 10%. The default value is 50. For more information about how to use MaxErrors, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" } }, "MaxResults": { @@ -3019,7 +3027,7 @@ "PatchComplianceDataList": { "base": null, "refs": { - "DescribeInstancePatchesResult$Patches": "<p>Each entry in the array is a structure containing:</p> <p>Title (string)</p> <p>KBId (string)</p> <p>Classification (string)</p> <p>Severity (string)</p> <p>State (string – “INSTALLED”, “INSTALLED_OTHER”, “MISSING”, “NOT_APPLICABLE”, “FAILED”)</p> <p>InstalledTime (DateTime)</p> <p>InstalledBy (string)</p>" + "DescribeInstancePatchesResult$Patches": "<p>Each entry in the array is a structure containing:</p> <p>Title (string)</p> <p>KBId (string)</p> <p>Classification (string)</p> <p>Severity (string)</p> <p>State (string: \"INSTALLED\", \"INSTALLED OTHER\", \"MISSING\", \"NOT APPLICABLE\", \"FAILED\")</p> <p>InstalledTime (DateTime)</p> <p>InstalledBy (string)</p>" } }, "PatchComplianceDataState": { @@ -3131,7 +3139,7 @@ "PatchGroupPatchBaselineMappingList": { "base": null, "refs": { - "DescribePatchGroupsResult$Mappings": "<p>Each entry in the array contains:</p> <p>PatchGroup: string (1 ≤ length ≤ 256, Regex: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$)</p> <p>PatchBaselineIdentity: A PatchBaselineIdentity element. </p>" + "DescribePatchGroupsResult$Mappings": "<p>Each entry in the array contains:</p> <p>PatchGroup: string (between 1 and 256 characters, Regex: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$)</p> <p>PatchBaselineIdentity: A PatchBaselineIdentity element. </p>" } }, "PatchId": { @@ -3182,7 +3190,7 @@ "PatchLanguage": { "base": null, "refs": { - "Patch$Language": "<p>The language of the patch if it’s language-specific.</p>" + "Patch$Language": "<p>The language of the patch if it's language-specific.</p>" } }, "PatchList": { @@ -3194,7 +3202,7 @@ "PatchMissingCount": { "base": null, "refs": { - "InstancePatchState$MissingCount": "<p>The number of patches from the patch baseline that are applicable for the instance but aren’t currently installed.</p>" + "InstancePatchState$MissingCount": "<p>The number of patches from the patch baseline that are applicable for the instance but aren't currently installed.</p>" } }, "PatchMsrcNumber": { @@ -3212,7 +3220,7 @@ "PatchNotApplicableCount": { "base": null, "refs": { - "InstancePatchState$NotApplicableCount": "<p>The number of patches from the patch baseline that aren’t applicable for the instance and hence aren’t installed on the instance.</p>" + "InstancePatchState$NotApplicableCount": "<p>The number of patches from the patch baseline that aren't applicable for the instance and hence aren't installed on the instance.</p>" } }, "PatchOperationEndTime": { @@ -3249,8 +3257,8 @@ "base": null, "refs": { "DescribeAvailablePatchesRequest$Filters": "<p>Filters used to scope down the returned patches.</p>", - "DescribeInstancePatchesRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, 1 ≤ length ≤ 128)</p> <p>Values (array of strings 1 ≤ length ≤ 256)</p>", - "DescribePatchBaselinesRequest$Filters": "<p>Each element in the array is a structure containing: </p> <p>Key: (string, “NAME_PREFIX” or “OWNER”)</p> <p>Value: (array of strings, exactly 1 entry, 1 ≤ length ≤ 255)</p>" + "DescribeInstancePatchesRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, between 1 and 128 characters)</p> <p>Values (array of strings, each string between 1 and 256 characters)</p>", + "DescribePatchBaselinesRequest$Filters": "<p>Each element in the array is a structure containing: </p> <p>Key: (string, \"NAME_PREFIX\" or \"OWNER\")</p> <p>Value: (array of strings, exactly 1 entry, between 1 and 255 characters)</p>" } }, "PatchOrchestratorFilterValue": { @@ -3462,7 +3470,7 @@ "base": null, "refs": { "CommandPlugin$ResponseCode": "<p>A numeric response code generated after executing the plugin. </p>", - "GetCommandInvocationResult$ResponseCode": "<p>The error level response code for the plugin script. If the response code is <code>-1</code>, then the command has not started executing on the instance, or it was not received by the instance.</p>" + "GetCommandInvocationResult$ResponseCode": "<p>The error level response code for the plugin script. If the response code is -1, then the command has not started executing on the instance, or it was not received by the instance.</p>" } }, "ResultAttribute": { @@ -3481,7 +3489,7 @@ "base": null, "refs": { "Command$OutputS3BucketName": "<p>The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command.</p>", - "CommandPlugin$OutputS3BucketName": "<p>The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> <code>test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript</code> </p> <p> <code>test_folder</code> is the name of the Amazon S3 bucket;</p> <p> <code>ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix</code> is the name of the S3 prefix;</p> <p> <code>i-1234567876543</code> is the instance ID;</p> <p> <code>awsrunShellScript</code> is the name of the plugin.</p>", + "CommandPlugin$OutputS3BucketName": "<p>The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript </p> <p>test_folder is the name of the Amazon S3 bucket;</p> <p> ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3 prefix;</p> <p>i-1234567876543 is the instance ID;</p> <p>awsrunShellScript is the name of the plugin.</p>", "LoggingInfo$S3BucketName": "<p>The name of an Amazon S3 bucket where execution logs are stored .</p>", "S3OutputLocation$OutputS3BucketName": "<p>The name of the Amazon S3 bucket.</p>", "SendCommandRequest$OutputS3BucketName": "<p>The name of the S3 bucket where command execution responses should be stored.</p>" @@ -3491,7 +3499,7 @@ "base": null, "refs": { "Command$OutputS3KeyPrefix": "<p>The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command.</p>", - "CommandPlugin$OutputS3KeyPrefix": "<p>The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> <code>test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript</code> </p> <p> <code>test_folder</code> is the name of the Amazon S3 bucket;</p> <p> <code>ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix</code> is the name of the S3 prefix;</p> <p> <code>i-1234567876543</code> is the instance ID;</p> <p> <code>awsrunShellScript</code> is the name of the plugin.</p>", + "CommandPlugin$OutputS3KeyPrefix": "<p>The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript </p> <p>test_folder is the name of the Amazon S3 bucket;</p> <p> ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3 prefix;</p> <p>i-1234567876543 is the instance ID;</p> <p>awsrunShellScript is the name of the plugin.</p>", "LoggingInfo$S3KeyPrefix": "<p>(Optional) The Amazon S3 bucket subfolder. </p>", "S3OutputLocation$OutputS3KeyPrefix": "<p>The Amazon S3 bucket subfolder.</p>", "SendCommandRequest$OutputS3KeyPrefix": "<p>The directory structure within the S3 bucket where the responses should be stored.</p>" @@ -3525,8 +3533,8 @@ "Association$ScheduleExpression": "<p>A cron expression that specifies a schedule when the association runs.</p>", "AssociationDescription$ScheduleExpression": "<p>A cron expression that specifies a schedule when the association runs.</p>", "CreateAssociationBatchRequestEntry$ScheduleExpression": "<p>A cron expression that specifies a schedule when the association runs.</p>", - "CreateAssociationRequest$ScheduleExpression": "<p>A cron expression when the association will be applied to the target(s). Supported expressions are every half, 1, 2, 4, 8 or 12 hour(s); every specified day and time of the week. For example: cron(0 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0 0/4 1/1 * ? *) to run every four hours; and cron(0 0 10 ? * SUN *) to run every Sunday at 10 a.m.</p>", - "UpdateAssociationRequest$ScheduleExpression": "<p>The cron expression used to schedule the association that you want to update. Supported expressions are every half, 1, 2, 4, 8 or 12 hour(s); every specified day and time of the week. For example: cron(0 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0 0/4 1/1 * ? *) to run every four hours; and cron(0 0 10 ? * SUN *) to run every Sunday at 10 a.m.</p>" + "CreateAssociationRequest$ScheduleExpression": "<p>A cron expression when the association will be applied to the target(s).</p>", + "UpdateAssociationRequest$ScheduleExpression": "<p>The cron expression used to schedule the association that you want to update.</p>" } }, "SendCommandRequest": { @@ -3573,7 +3581,7 @@ "StandardOutputContent": { "base": null, "refs": { - "GetCommandInvocationResult$StandardOutputContent": "<p>The first 24,000 characters written by the plugin to stdout. If the command has not finished executing, if <code>ExecutionStatus</code> is neither <code>Succeeded</code> nor <code>Failed</code>, then this string is empty.</p>" + "GetCommandInvocationResult$StandardOutputContent": "<p>The first 24,000 characters written by the plugin to stdout. If the command has not finished executing, if ExecutionStatus is neither Succeeded nor Failed, then this string is empty.</p>" } }, "StartAutomationExecutionRequest": { @@ -3595,10 +3603,10 @@ "StatusDetails": { "base": null, "refs": { - "Command$StatusDetails": "<p>A detailed status of the command execution. <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to any instances.</p> </li> <li> <p>In Progress – The command has been sent to at least one instance but has not reached a final state on all instances.</p> </li> <li> <p>Success – The command successfully executed on all invocations. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The value of <code>MaxErrors</code> or more command invocations shows a status of <code>Delivery Timed Out</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – The value of <code>MaxErrors</code> or more command invocations shows a status of <code>Execution Timed Out</code>. This is a terminal state.</p> </li> <li> <p>Failed – The value of <code>MaxErrors</code> or more command invocations shows a status of <code>Failed</code>. This is a terminal state.</p> </li> <li> <p>Incomplete – The command was attempted on all instances and one or more invocations does not have a value of <code>Success</code> but not enough invocations failed for the status to be <code>Failed</code>. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Rate Exceeded – The number of instances targeted by the command exceeded the account limit for pending invocations. The system has canceled the command before executing it on any instance. This is a terminal state.</p> </li> </ul>", - "CommandInvocation$StatusDetails": "<p>A detailed status of the command execution for each invocation (each instance targeted by the command). <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to the instance.</p> </li> <li> <p>In Progress – The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success – The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command’s <code>MaxErrors</code> limit, but they do contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed – The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable – The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command’s <code>MaxErrors</code> limit and don't contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Terminated – The parent command exceeded its <code>MaxErrors</code> limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>", - "CommandPlugin$StatusDetails": "<p>A detailed status of the plugin execution. <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to the instance.</p> </li> <li> <p>In Progress – The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success – The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command’s <code>MaxErrors</code> limit, but they do contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed – The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable – The command can't be delivered to the instance. The instance might not exist, or it might not be responding. Undeliverable invocations don't count against the parent command’s <code>MaxErrors</code> limit, and they don't contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Terminated – The parent command exceeded its <code>MaxErrors</code> limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>", - "GetCommandInvocationResult$StatusDetails": "<p>A detailed status of the command execution for an invocation. <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to the instance.</p> </li> <li> <p>In Progress – The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Delayed – The system attempted to send the command to the target, but the target was not available. The instance might not be available because of network issues, the instance was stopped, etc. The system will try to deliver the command again.</p> </li> <li> <p>Success – The command or plugin was executed successfully. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command’s <code>MaxErrors</code> limit, but they do contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – The command started to execute on the instance, but the execution was not complete before the timeout expired. Execution timeouts count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed – The command wasn't executed successfully on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable – The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command’s <code>MaxErrors</code> limit and don't contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Terminated – The parent command exceeded its <code>MaxErrors</code> limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>" + "Command$StatusDetails": "<p>A detailed status of the command execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to any instances.</p> </li> <li> <p>In Progress: The command has been sent to at least one instance but has not reached a final state on all instances.</p> </li> <li> <p>Success: The command successfully executed on all invocations. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The value of MaxErrors or more command invocations shows a status of Delivery Timed Out. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: The value of MaxErrors or more command invocations shows a status of Execution Timed Out. This is a terminal state.</p> </li> <li> <p>Failed: The value of MaxErrors or more command invocations shows a status of Failed. This is a terminal state.</p> </li> <li> <p>Incomplete: The command was attempted on all instances and one or more invocations does not have a value of Success but not enough invocations failed for the status to be Failed. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Rate Exceeded: The number of instances targeted by the command exceeded the account limit for pending invocations. The system has canceled the command before executing it on any instance. This is a terminal state.</p> </li> </ul>", + "CommandInvocation$StatusDetails": "<p>A detailed status of the command execution for each invocation (each instance targeted by the command). StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to the instance.</p> </li> <li> <p>In Progress: The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success: The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>", + "CommandPlugin$StatusDetails": "<p>A detailed status of the plugin execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to the instance.</p> </li> <li> <p>In Progress: The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success: The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable: The command can't be delivered to the instance. The instance might not exist, or it might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit, and they don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>", + "GetCommandInvocationResult$StatusDetails": "<p>A detailed status of the command execution for an invocation. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to the instance.</p> </li> <li> <p>In Progress: The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Delayed: The system attempted to send the command to the target, but the target was not available. The instance might not be available because of network issues, the instance was stopped, etc. The system will try to deliver the command again.</p> </li> <li> <p>Success: The command or plugin was executed successfully. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: The command started to execute on the instance, but the execution was not complete before the timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed: The command wasn't executed successfully on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>" } }, "StatusMessage": { @@ -3610,7 +3618,7 @@ "StatusName": { "base": null, "refs": { - "AssociationOverview$Status": "<p>The status of the association. Status can be: <code>Pending</code>, <code>Success</code>, or <code>Failed</code>.</p>", + "AssociationOverview$Status": "<p>The status of the association. Status can be: Pending, Success, or Failed.</p>", "AssociationOverview$DetailedStatus": "<p>A detailed status of the association.</p>", "AssociationStatusAggregatedCount$key": null, "InstanceAggregatedAssociationOverview$DetailedStatus": "<p>Detailed status information about the aggregated associations.</p>", @@ -3666,6 +3674,8 @@ "DocumentVersionLimitExceeded$Message": null, "DoesNotExistException$Message": null, "DuplicateDocumentContent$Message": null, + "FailureDetails$FailureStage": "<p>The stage of the Automation execution when the failure occurred. The stages include the following: InputValidation, PreVerification, Invocation, PostVerification.</p>", + "FailureDetails$FailureType": "<p>The type of Automation failure. Failure types include the following: Action, Permission, Throttling, Verification, Internal.</p>", "IdempotentParameterMismatch$Message": null, "InstanceInformation$PlatformName": "<p>The name of the operating system platform running on your instance. </p>", "InstanceInformation$PlatformVersion": "<p>The version of the OS platform running on your instance. </p>", @@ -3723,7 +3733,7 @@ "base": null, "refs": { "GetCommandInvocationResult$ExecutionStartDateTime": "<p>The date and time the plugin started executing. Date and time are written in ISO 8601 format. For example, August 28, 2016 is represented as 2016-08-28. If the plugin has not started to execute, the string is empty.</p>", - "GetCommandInvocationResult$ExecutionElapsedTime": "<p>Duration since <code>ExecutionStartDateTime</code>.</p>", + "GetCommandInvocationResult$ExecutionElapsedTime": "<p>Duration since ExecutionStartDateTime.</p>", "GetCommandInvocationResult$ExecutionEndDateTime": "<p>The date and time the plugin was finished executing. Date and time are written in ISO 8601 format. For example, August 28, 2016 is represented as 2016-08-28. If the plugin has not started to execute, the string is empty.</p>" } }, @@ -3760,7 +3770,7 @@ } }, "Target": { - "base": "<p>An array of search criteria that targets instances using a <code>Key</code>,<code>Value</code> combination that you specify. <code>Targets</code> is required if you don't provide one or more instance IDs in the call.</p>", + "base": "<p>An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call.</p>", "refs": { "Targets$member": null } @@ -3774,7 +3784,7 @@ "TargetKey": { "base": null, "refs": { - "Target$Key": "<p>User-defined criteria for sending commands that target instances that meet the criteria. <code>Key</code> can be <code>tag:<Amazon EC2 tag></code> or <code>InstanceIds</code>. For more information about how to send commands that target instances using <code>Key</code>,<code>Value</code> parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" + "Target$Key": "<p>User-defined criteria for sending commands that target instances that meet the criteria. Key can be tag:<Amazon EC2 tag> or InstanceIds. For more information about how to send commands that target instances using Key,Value parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" } }, "TargetValue": { @@ -3786,7 +3796,7 @@ "TargetValues": { "base": null, "refs": { - "Target$Values": "<p>User-defined criteria that maps to <code>Key</code>. For example, if you specified <code>tag:ServerRole</code>, you could specify <code>value:WebServer</code> to execute a command on instances that include Amazon EC2 tags of ServerRole,WebServer. For more information about how to send commands that target instances using <code>Key</code>,<code>Value</code> parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" + "Target$Values": "<p>User-defined criteria that maps to Key. For example, if you specified tag:ServerRole, you could specify value:WebServer to execute a command on instances that include Amazon EC2 tags of ServerRole,WebServer. For more information about how to send commands that target instances using Key,Value parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" } }, "Targets": { @@ -3794,14 +3804,15 @@ "refs": { "Association$Targets": "<p>The instances targeted by the request to create an association. </p>", "AssociationDescription$Targets": "<p>The instances targeted by the request. </p>", - "Command$Targets": "<p>An array of search criteria that targets instances using a <code>Key</code>,<code>Value</code> combination that you specify. <code>Targets</code> is required if you don't provide one or more instance IDs in the call.</p>", + "Command$Targets": "<p>An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call.</p>", "CreateAssociationBatchRequestEntry$Targets": "<p>The instances targeted by the request.</p>", - "CreateAssociationRequest$Targets": "<p>The targets (either instances or tags) for the association. Instances are specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags are specified using Key=<tag name>,Values=<tag value>.</p>", + "CreateAssociationRequest$Targets": "<p>The targets (either instances or tags) for the association.</p>", "MaintenanceWindowTarget$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags are specified using Key=<tag name>,Values=<tag value>.</p>", "MaintenanceWindowTask$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags are specified using Key=<tag name>,Values=<tag value>.</p>", "RegisterTargetWithMaintenanceWindowRequest$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags are specified using Key=<tag name>,Values=<tag value>.</p>", "RegisterTaskWithMaintenanceWindowRequest$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags are specified using Key=<tag name>,Values=<tag value>.</p>", - "SendCommandRequest$Targets": "<p>(Optional) An array of search criteria that targets instances using a <code>Key</code>,<code>Value</code> combination that you specify. <code>Targets</code> is required if you don't provide one or more instance IDs in the call. For more information about how to use <code>Targets</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>" + "SendCommandRequest$Targets": "<p>(Optional) An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call. For more information about how to use Targets, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>", + "UpdateAssociationRequest$Targets": "<p>The targets of the association.</p>" } }, "TimeoutSeconds": { @@ -3811,7 +3822,7 @@ } }, "TooManyTagsError": { - "base": "<p>The <code>Targets</code> parameter includes too many tags. Remove one or more tags and try the command again.</p>", + "base": "<p>The Targets parameter includes too many tags. Remove one or more tags and try the command again.</p>", "refs": { } }, @@ -3826,7 +3837,7 @@ } }, "UnsupportedInventorySchemaVersionException": { - "base": "<p>Inventory item type schema version has to match supported versions in the service. Check output of <code>GetInventorySchema</code> to see the available schema version for each type.</p>", + "base": "<p>Inventory item type schema version has to match supported versions in the service. Check output of GetInventorySchema to see the available schema version for each type.</p>", "refs": { } }, @@ -3913,8 +3924,8 @@ "Url": { "base": null, "refs": { - "CommandInvocation$StandardOutputUrl": "<p>The URL to the plugin’s StdOut file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, <code>StandardOutputUrl</code> is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>", - "CommandInvocation$StandardErrorUrl": "<p>The URL to the plugin’s StdErr file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, <code>StandardErrorUrl</code> is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>", + "CommandInvocation$StandardOutputUrl": "<p>The URL to the plugin's StdOut file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, StandardOutputUrl is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>", + "CommandInvocation$StandardErrorUrl": "<p>The URL to the plugin's StdErr file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, StandardErrorUrl is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>", "CommandPlugin$StandardOutputUrl": "<p>The URL for the complete text written by the plugin to stdout in Amazon S3. If the Amazon S3 bucket for the command was not specified, then this string is empty.</p>", "CommandPlugin$StandardErrorUrl": "<p>The URL for the complete text written by the plugin to stderr. If execution is not yet complete, then this string is empty.</p>", "GetCommandInvocationResult$StandardOutputUrl": "<p>The URL for the complete text written by the plugin to stdout in Amazon S3. If an Amazon S3 bucket was not specified, then this string is empty.</p>", diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/api-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/api-2.json index 133d9bd4..05e36001 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/api-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/api-2.json @@ -1,14 +1,14 @@ { "version":"2.0", "metadata":{ - "uid":"workspaces-2015-04-08", "apiVersion":"2015-04-08", "endpointPrefix":"workspaces", "jsonVersion":"1.1", "protocol":"json", "serviceFullName":"Amazon WorkSpaces", "signatureVersion":"v4", - "targetPrefix":"WorkspacesService" + "targetPrefix":"WorkspacesService", + "uid":"workspaces-2015-04-08" }, "operations":{ "CreateTags":{ diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/docs-2.json b/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/docs-2.json index a95c1e96..d4c90e4f 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/docs-2.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/docs-2.json @@ -10,11 +10,11 @@ "DescribeWorkspaceDirectories": "<p>Retrieves information about the AWS Directory Service directories in the region that are registered with Amazon WorkSpaces and are available to your account.</p> <p>This operation supports pagination with the use of the <code>NextToken</code> request and response parameters. If more results are available, the <code>NextToken</code> response member contains a token that you pass in the next call to this operation to retrieve the next set of items.</p>", "DescribeWorkspaces": "<p>Obtains information about the specified WorkSpaces.</p> <p>Only one of the filter parameters, such as <code>BundleId</code>, <code>DirectoryId</code>, or <code>WorkspaceIds</code>, can be specified at a time.</p> <p>This operation supports pagination with the use of the <code>NextToken</code> request and response parameters. If more results are available, the <code>NextToken</code> response member contains a token that you pass in the next call to this operation to retrieve the next set of items.</p>", "DescribeWorkspacesConnectionStatus": "<p>Describes the connection status of a specified WorkSpace.</p>", - "ModifyWorkspaceProperties": "<p>Modifies the WorkSpace properties, including the RunningMode and AutoStop time.</p>", + "ModifyWorkspaceProperties": "<p>Modifies the WorkSpace properties, including the running mode and AutoStop time.</p>", "RebootWorkspaces": "<p>Reboots the specified WorkSpaces.</p> <p>To be able to reboot a WorkSpace, the WorkSpace must have a <b>State</b> of <code>AVAILABLE</code>, <code>IMPAIRED</code>, or <code>INOPERABLE</code>.</p> <note> <p>This operation is asynchronous and returns before the WorkSpaces have rebooted.</p> </note>", "RebuildWorkspaces": "<p>Rebuilds the specified WorkSpaces.</p> <p>Rebuilding a WorkSpace is a potentially destructive action that can result in the loss of data. Rebuilding a WorkSpace causes the following to occur:</p> <ul> <li> <p>The system is restored to the image of the bundle that the WorkSpace is created from. Any applications that have been installed, or system settings that have been made since the WorkSpace was created will be lost.</p> </li> <li> <p>The data drive (D drive) is re-created from the last automatic snapshot taken of the data drive. The current contents of the data drive are overwritten. Automatic snapshots of the data drive are taken every 12 hours, so the snapshot can be as much as 12 hours old.</p> </li> </ul> <p>To be able to rebuild a WorkSpace, the WorkSpace must have a <b>State</b> of <code>AVAILABLE</code> or <code>ERROR</code>.</p> <note> <p>This operation is asynchronous and returns before the WorkSpaces have been completely rebuilt.</p> </note>", - "StartWorkspaces": "<p>Starts the specified WorkSpaces. The API only works with WorkSpaces that have RunningMode configured as AutoStop and the State set to “STOPPED.”</p>", - "StopWorkspaces": "<p> Stops the specified WorkSpaces. The API only works with WorkSpaces that have RunningMode configured as AutoStop and the State set to AVAILABLE, IMPAIRED, UNHEALTHY, or ERROR.</p>", + "StartWorkspaces": "<p>Starts the specified WorkSpaces. The WorkSpaces must have a running mode of AutoStop and a state of STOPPED.</p>", + "StopWorkspaces": "<p> Stops the specified WorkSpaces. The WorkSpaces must have a running mode of AutoStop and a state of AVAILABLE, IMPAIRED, UNHEALTHY, or ERROR.</p>", "TerminateWorkspaces": "<p>Terminates the specified WorkSpaces.</p> <p>Terminating a WorkSpace is a permanent action and cannot be undone. The user's data is not maintained and will be destroyed. If you need to archive any user data, contact Amazon Web Services before terminating the WorkSpace.</p> <p>You can terminate a WorkSpace that is in any state except <code>SUSPENDED</code>.</p> <note> <p>This operation is asynchronous and returns before the WorkSpaces have been completely terminated.</p> </note>" }, "shapes": { @@ -25,7 +25,7 @@ } }, "AccessDeniedException": { - "base": null, + "base": "<p>The user is not authorized to access a resource.</p>", "refs": { } }, @@ -313,7 +313,7 @@ } }, "InvalidResourceStateException": { - "base": "<p>The specified WorkSpace has an invalid state for this operation.</p>", + "base": "<p>The state of the WorkSpace is not valid for this operation.</p>", "refs": { } }, @@ -574,7 +574,7 @@ } }, "UnsupportedWorkspaceConfigurationException": { - "base": "<p>The WorkSpace does not have the supported configuration for this operation. For more information, see the <a href=\"http://docs.aws.amazon.com/workspaces/latest/adminguide\">Amazon WorkSpaces Administration Guide</a>. </p>", + "base": "<p>The configuration of this WorkSpace is not supported for this operation. For more information, see the <a href=\"http://docs.aws.amazon.com/workspaces/latest/adminguide/\">Amazon WorkSpaces Administration Guide</a>. </p>", "refs": { } }, diff --git a/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/paginators-1.json b/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/paginators-1.json index efa8cbad..cc7a0c68 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/paginators-1.json +++ b/vendor/github.com/aws/aws-sdk-go/models/apis/workspaces/2015-04-08/paginators-1.json @@ -11,10 +11,10 @@ "result_key": "Directories" }, "DescribeWorkspaces": { - "limit_key": "Limit", "input_token": "NextToken", + "limit_key": "Limit", "output_token": "NextToken", "result_key": "Workspaces" } } -} +}
\ No newline at end of file diff --git a/vendor/github.com/aws/aws-sdk-go/models/endpoints/endpoints.json b/vendor/github.com/aws/aws-sdk-go/models/endpoints/endpoints.json index 1fa6acd7..78d29d0a 100644 --- a/vendor/github.com/aws/aws-sdk-go/models/endpoints/endpoints.json +++ b/vendor/github.com/aws/aws-sdk-go/models/endpoints/endpoints.json @@ -320,10 +320,19 @@ "us-west-2": {} } }, + "codestar": { + "endpoints": { + "eu-west-1": {}, + "us-east-1": {}, + "us-east-2": {}, + "us-west-2": {} + } + }, "cognito-identity": { "endpoints": { "ap-northeast-1": {}, "ap-northeast-2": {}, + "ap-south-1": {}, "ap-southeast-2": {}, "eu-central-1": {}, "eu-west-1": {}, @@ -337,6 +346,7 @@ "endpoints": { "ap-northeast-1": {}, "ap-northeast-2": {}, + "ap-south-1": {}, "ap-southeast-2": {}, "eu-central-1": {}, "eu-west-1": {}, @@ -350,6 +360,7 @@ "endpoints": { "ap-northeast-1": {}, "ap-northeast-2": {}, + "ap-south-1": {}, "ap-southeast-2": {}, "eu-central-1": {}, "eu-west-1": {}, @@ -672,6 +683,16 @@ "us-west-2": {} } }, + "entitlement.marketplace": { + "defaults": { + "credentialScope": { + "service": "aws-marketplace" + } + }, + "endpoints": { + "us-east-1": {} + } + }, "es": { "endpoints": { "ap-northeast-1": {}, @@ -1340,6 +1361,7 @@ "endpoints": { "ap-northeast-1": {}, "ap-northeast-2": {}, + "ap-south-1": {}, "ap-southeast-1": {}, "ap-southeast-2": {}, "ca-central-1": {}, diff --git a/vendor/github.com/aws/aws-sdk-go/private/model/api/api.go b/vendor/github.com/aws/aws-sdk-go/private/model/api/api.go index 638436c8..6e52c033 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/model/api/api.go +++ b/vendor/github.com/aws/aws-sdk-go/private/model/api/api.go @@ -320,6 +320,98 @@ func (a *API) APIName() string { return a.name } +var tplServiceDoc = template.Must(template.New("service docs").Funcs(template.FuncMap{ + "GetCrosslinkURL": GetCrosslinkURL, +}). + Parse(` +// Package {{ .PackageName }} provides the client and types for making API +// requests to {{ .Metadata.ServiceFullName }}. +{{ if .Documentation -}} +// +{{ .Documentation }} +{{ end -}} +{{ $crosslinkURL := GetCrosslinkURL $.BaseCrosslinkURL $.APIName $.Metadata.UID -}} +{{ if $crosslinkURL -}} +// +// See {{ $crosslinkURL }} for more information on this service. +{{ end -}} +// +// See {{ .PackageName }} package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/{{ .PackageName }}/ +// +// Using the Client +// +// To use the client for {{ .Metadata.ServiceFullName }} 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 := {{ .PackageName }}.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 {{ .Metadata.ServiceFullName }} client {{ .StructName }} for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/{{ .PackageName }}/#New +// +{{ $opts := .OperationNames -}} +{{ $optName := index $opts 0 -}} +{{ $opt := index .Operations $optName -}} +{{ $optInputName := $opt.InputRef.GoTypeWithPkgName -}} +// 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.{{ $opt.ExportedName }}(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("{{ $optName }} 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.{{ $opt.ExportedName }}WithContext(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/ +`)) + // A tplService defines the template for the service generated code. var tplService = template.Must(template.New("service").Funcs(template.FuncMap{ "ServiceNameValue": func(a *API) string { @@ -328,7 +420,6 @@ var tplService = template.Must(template.New("service").Funcs(template.FuncMap{ } return "ServiceName" }, - "GetCrosslinkURL": GetCrosslinkURL, "EndpointsIDConstValue": func(a *API) string { if a.NoConstServiceNames { return fmt.Sprintf("%q", a.Metadata.EndpointPrefix) @@ -346,12 +437,12 @@ var tplService = template.Must(template.New("service").Funcs(template.FuncMap{ return "EndpointsID" }, }).Parse(` -{{ .Documentation }}// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. -{{ $crosslinkURL := GetCrosslinkURL $.BaseCrosslinkURL $.APIName $.Metadata.UID -}} -{{ if ne $crosslinkURL "" -}} -// Please also see {{ $crosslinkURL }} -{{ end -}} +// {{ .StructName }} provides the API operation methods for making requests to +// {{ .Metadata.ServiceFullName }}. See this package's package overview docs +// for details on the service. +// +// {{ .StructName }} methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type {{ .StructName }} struct { *client.Client } @@ -457,6 +548,20 @@ func (c *{{ .StructName }}) newRequest(op *request.Operation, params, data inter } `)) +// ServicePackageDoc generates the contents of the doc file for the service. +// +// Will also read in the custom doc templates for the service if found. +func (a *API) ServicePackageDoc() string { + a.imports = map[string]bool{} + + var buf bytes.Buffer + if err := tplServiceDoc.Execute(&buf, a); err != nil { + panic(err) + } + + return buf.String() +} + // ServiceGoCode renders service go code. Returning it as a string. func (a *API) ServiceGoCode() string { a.resetImports() diff --git a/vendor/github.com/aws/aws-sdk-go/private/model/api/customization_passes.go b/vendor/github.com/aws/aws-sdk-go/private/model/api/customization_passes.go index 273e7b17..0a69fbcc 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/model/api/customization_passes.go +++ b/vendor/github.com/aws/aws-sdk-go/private/model/api/customization_passes.go @@ -3,7 +3,6 @@ package api import ( - "fmt" "io/ioutil" "path/filepath" "strings" @@ -48,34 +47,6 @@ func (a *API) customizationPasses() { if fn := svcCustomizations[a.PackageName()]; fn != nil { fn(a) } - - blobDocStringCustomizations(a) -} - -const base64MarshalDocStr = "// %s is automatically base64 encoded/decoded by the SDK.\n" - -func blobDocStringCustomizations(a *API) { - for _, s := range a.Shapes { - payloadMemberName := s.Payload - - for refName, ref := range s.MemberRefs { - if refName == payloadMemberName { - // Payload members have their own encoding and may - // be raw bytes or io.Reader - continue - } - if ref.Shape.Type == "blob" { - docStr := fmt.Sprintf(base64MarshalDocStr, refName) - if len(strings.TrimSpace(ref.Shape.Documentation)) != 0 { - ref.Shape.Documentation += "//\n" + docStr - } else if len(strings.TrimSpace(ref.Documentation)) != 0 { - ref.Documentation += "//\n" + docStr - } else { - ref.Documentation = docStr - } - } - } - } } // s3Customizations customizes the API generation to replace values specific to S3. diff --git a/vendor/github.com/aws/aws-sdk-go/private/model/api/docstring.go b/vendor/github.com/aws/aws-sdk-go/private/model/api/docstring.go index ebdd741d..22f8f469 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/model/api/docstring.go +++ b/vendor/github.com/aws/aws-sdk-go/private/model/api/docstring.go @@ -46,13 +46,9 @@ func (a *API) AttachDocs(filename string) { func (d *apiDocumentation) setup() { d.API.Documentation = docstring(d.Service) - if d.Service == "" { - d.API.Documentation = - fmt.Sprintf("// %s is a client for %s.\n", d.API.StructName(), d.API.NiceName()) - } for op, doc := range d.Operations { - d.API.Operations[op].Documentation = strings.TrimSpace(docstring(doc)) + d.API.Operations[op].Documentation = docstring(doc) } for shape, info := range d.Shapes { @@ -78,24 +74,41 @@ func (d *apiDocumentation) setup() { var reNewline = regexp.MustCompile(`\r?\n`) var reMultiSpace = regexp.MustCompile(`\s+`) var reComments = regexp.MustCompile(`<!--.*?-->`) -var reFullname = regexp.MustCompile(`\s*<fullname?>.+?<\/fullname?>\s*`) +var reFullnameBlock = regexp.MustCompile(`<fullname>(.+?)<\/fullname>`) +var reFullname = regexp.MustCompile(`<fullname>(.*?)</fullname>`) var reExamples = regexp.MustCompile(`<examples?>.+?<\/examples?>`) var reEndNL = regexp.MustCompile(`\n+$`) // docstring rewrites a string to insert godocs formatting. func docstring(doc string) string { + doc = strings.TrimSpace(doc) + if doc == "" { + return "" + } + doc = reNewline.ReplaceAllString(doc, "") doc = reMultiSpace.ReplaceAllString(doc, " ") doc = reComments.ReplaceAllString(doc, "") + + var fullname string + parts := reFullnameBlock.FindStringSubmatch(doc) + if len(parts) > 1 { + fullname = parts[1] + } + // Remove full name block from doc string doc = reFullname.ReplaceAllString(doc, "") + doc = reExamples.ReplaceAllString(doc, "") doc = generateDoc(doc) doc = reEndNL.ReplaceAllString(doc, "") - if doc == "" { - return "\n" + doc = html.UnescapeString(doc) + + // Replace doc with full name if doc is empty. + doc = strings.TrimSpace(doc) + if len(doc) == 0 { + doc = fullname } - doc = html.UnescapeString(doc) return commentify(doc) } @@ -116,16 +129,26 @@ var style = map[string]string{ // commentify converts a string to a Go comment func commentify(doc string) string { + if len(doc) == 0 { + return "" + } + lines := strings.Split(doc, "\n") - out := []string{} - for i, line := range lines { + out := make([]string, 0, len(lines)) + for i := 0; i < len(lines); i++ { + line := lines[i] + if i > 0 && line == "" && lines[i-1] == "" { continue } - out = append(out, "// "+line) + out = append(out, line) } - return strings.Join(out, "\n") + "\n" + if len(out) > 0 { + out[0] = "// " + out[0] + return strings.Join(out, "\n// ") + } + return "" } // wrap returns a rewritten version of text to have line breaks diff --git a/vendor/github.com/aws/aws-sdk-go/private/model/api/shape.go b/vendor/github.com/aws/aws-sdk-go/private/model/api/shape.go index f42521c2..60d867c0 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/model/api/shape.go +++ b/vendor/github.com/aws/aws-sdk-go/private/model/api/shape.go @@ -521,14 +521,23 @@ type {{ .ShapeName }} struct { {{ range $_, $name := $context.MemberNames -}} {{ $elem := index $context.MemberRefs $name -}} + {{ $isBlob := $context.WillRefBeBase64Encoded $name -}} {{ $isRequired := $context.IsRequired $name -}} {{ $doc := $elem.Docstring -}} - {{ $doc }} - {{ if $isRequired -}} + {{ if $doc -}} + {{ $doc }} + {{ end -}} + {{ if $isBlob -}} {{ if $doc -}} // {{ end -}} + // {{ $name }} is automatically base64 encoded/decoded by the SDK. + {{ end -}} + {{ if $isRequired -}} + {{ if or $doc $isBlob -}} + // + {{ end -}} // {{ $name }} is a required field {{ end -}} {{ $name }} {{ $context.GoStructType $name $elem }} {{ $elem.GoTags false $isRequired }} @@ -634,3 +643,17 @@ func (s *Shape) removeRef(ref *ShapeRef) { } } } + +func (s *Shape) WillRefBeBase64Encoded(refName string) bool { + payloadRefName := s.Payload + if payloadRefName == refName { + return false + } + + ref, ok := s.MemberRefs[refName] + if !ok { + panic(fmt.Sprintf("shape %s does not contain %q refName", s.ShapeName, refName)) + } + + return ref.Shape.Type == "blob" +} diff --git a/vendor/github.com/aws/aws-sdk-go/private/model/cli/gen-api/main.go b/vendor/github.com/aws/aws-sdk-go/private/model/cli/gen-api/main.go index a0d549ff..48dc6beb 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/model/cli/gen-api/main.go +++ b/vendor/github.com/aws/aws-sdk-go/private/model/cli/gen-api/main.go @@ -62,6 +62,13 @@ func newGenerateInfo(modelFile, svcPath, svcImportPath string) *generateInfo { fmt.Println("waiters-2.json error:", err) } + // pkgDocAddonsFile := strings.Replace(modelFile, "api-2.json", "go-pkg-doc.gotmpl", -1) + // if _, err := os.Stat(pkgDocAddonsFile); err == nil { + // g.API.AttachPackageDocAddons(pkgDocAddonsFile) + // } else if !os.IsNotExist(err) { + // fmt.Println("go-pkg-doc.gotmpl error:", err) + // } + g.API.Setup() if svc := os.Getenv("SERVICES"); svc != "" { @@ -175,7 +182,8 @@ func writeServiceFiles(g *generateInfo, filename string) { fmt.Printf("Generating %s (%s)...\n", g.API.PackageName(), g.API.Metadata.APIVersion) - // write api.go and service.go files + // write files for service client and API + Must(writeServiceDocFile(g)) Must(writeAPIFile(g)) Must(writeExamplesFile(g)) Must(writeServiceFile(g)) @@ -192,6 +200,7 @@ func Must(err error) { } const codeLayout = `// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + %s package %s @@ -202,6 +211,16 @@ func writeGoFile(file string, layout string, args ...interface{}) error { return ioutil.WriteFile(file, []byte(util.GoFmt(fmt.Sprintf(layout, args...))), 0664) } +// writeServiceDocFile generates the documentation for service package. +func writeServiceDocFile(g *generateInfo) error { + return writeGoFile(filepath.Join(g.PackageDir, "doc.go"), + codeLayout, + strings.TrimSpace(g.API.ServicePackageDoc()), + g.API.PackageName(), + "", + ) +} + // writeExamplesFile writes out the service example file. func writeExamplesFile(g *generateInfo) error { return writeGoFile(filepath.Join(g.PackageDir, "examples_test.go"), @@ -252,18 +271,17 @@ func writeWaitersFile(g *generateInfo) error { ) } -// writeAPIFile writes out the service api file. +// writeAPIFile writes out the service API file. func writeAPIFile(g *generateInfo) error { return writeGoFile(filepath.Join(g.PackageDir, "api.go"), codeLayout, - fmt.Sprintf("\n// Package %s provides a client for %s.", - g.API.PackageName(), g.API.Metadata.ServiceFullName), + "", g.API.PackageName(), g.API.APIGoCode(), ) } -// writeAPIErrorsFile writes out the service api errors file. +// writeAPIErrorsFile writes out the service API errors file. func writeAPIErrorsFile(g *generateInfo) error { return writeGoFile(filepath.Join(g.PackageDir, "errors.go"), codeLayout, diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/build_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/build_test.go index 8954bafb..b22899e5 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/build_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/build_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService1ProtocolTest struct { *client.Client } @@ -195,8 +199,12 @@ type InputService1TestShapeInputService1TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService2ProtocolTest struct { *client.Client } @@ -353,8 +361,12 @@ type InputService2TestShapeInputService2TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService3ProtocolTest struct { *client.Client } @@ -507,8 +519,12 @@ func (s *InputService3TestShapeStructType) SetScalarArg(v string) *InputService3 return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService4ProtocolTest struct { *client.Client } @@ -649,8 +665,12 @@ type InputService4TestShapeInputService4TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService5ProtocolTest struct { *client.Client } @@ -791,8 +811,12 @@ type InputService5TestShapeInputService5TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService6ProtocolTest struct { *client.Client } @@ -933,8 +957,12 @@ type InputService6TestShapeInputService6TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService7ProtocolTest struct { *client.Client } @@ -1076,8 +1104,12 @@ type InputService7TestShapeInputService7TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService8ProtocolTest struct { *client.Client } @@ -1218,8 +1250,12 @@ type InputService8TestShapeInputService8TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService9ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/unmarshal_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/unmarshal_test.go index 3e4e02d2..b58fda61 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/unmarshal_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/ec2query/unmarshal_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService1ProtocolTest struct { *client.Client } @@ -241,8 +245,12 @@ func (s *OutputService1TestShapeOutputService1TestCaseOperation1Output) SetTrueB return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService2ProtocolTest struct { *client.Client } @@ -382,8 +390,12 @@ func (s *OutputService2TestShapeOutputService2TestCaseOperation1Output) SetBlob( return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService3ProtocolTest struct { *client.Client } @@ -522,8 +534,12 @@ func (s *OutputService3TestShapeOutputService3TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService4ProtocolTest struct { *client.Client } @@ -662,8 +678,12 @@ func (s *OutputService4TestShapeOutputService4TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService5ProtocolTest struct { *client.Client } @@ -802,8 +822,12 @@ func (s *OutputService5TestShapeOutputService5TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService6ProtocolTest struct { *client.Client } @@ -954,8 +978,12 @@ func (s *OutputService6TestShapeStructureType) SetFoo(v string) *OutputService6T return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService7ProtocolTest struct { *client.Client } @@ -1094,8 +1122,12 @@ func (s *OutputService7TestShapeOutputService7TestCaseOperation1Output) SetMap(v return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService8ProtocolTest struct { *client.Client } @@ -1234,8 +1266,12 @@ func (s *OutputService8TestShapeOutputService8TestCaseOperation1Output) SetMap(v return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService9ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/build_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/build_test.go index dec77921..1164fab1 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/build_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/build_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService1ProtocolTest struct { *client.Client } @@ -190,8 +194,12 @@ type InputService1TestShapeInputService1TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService2ProtocolTest struct { *client.Client } @@ -334,8 +342,12 @@ type InputService2TestShapeInputService2TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService3ProtocolTest struct { *client.Client } @@ -562,8 +574,12 @@ type InputService3TestShapeInputService3TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService4ProtocolTest struct { *client.Client } @@ -707,8 +723,12 @@ type InputService4TestShapeInputService4TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService5ProtocolTest struct { *client.Client } @@ -1262,8 +1282,12 @@ func (s *InputService5TestShapeRecursiveStructType) SetRecursiveStruct(v *InputS return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService6ProtocolTest struct { *client.Client } @@ -1407,8 +1431,12 @@ type InputService6TestShapeInputService6TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService7ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/unmarshal_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/unmarshal_test.go index 7540f028..b1024e07 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/unmarshal_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/jsonrpc/unmarshal_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService1ProtocolTest struct { *client.Client } @@ -241,8 +245,12 @@ func (s *OutputService1TestShapeOutputService1TestCaseOperation1Output) SetTrueB return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService2ProtocolTest struct { *client.Client } @@ -403,8 +411,12 @@ func (s *OutputService2TestShapeOutputService2TestCaseOperation1Output) SetStruc return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService3ProtocolTest struct { *client.Client } @@ -563,8 +575,12 @@ func (s *OutputService3TestShapeTimeContainer) SetFoo(v time.Time) *OutputServic return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService4ProtocolTest struct { *client.Client } @@ -796,8 +812,12 @@ type OutputService4TestShapeStructType struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService5ProtocolTest struct { *client.Client } @@ -936,8 +956,12 @@ func (s *OutputService5TestShapeOutputService5TestCaseOperation1Output) SetMapMe return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService6ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/query/build_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/query/build_test.go index dd5ffeae..9b1ad92c 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/query/build_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/query/build_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService1ProtocolTest struct { *client.Client } @@ -353,8 +357,12 @@ type InputService1TestShapeInputService1TestCaseOperation3Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService2ProtocolTest struct { *client.Client } @@ -507,8 +515,12 @@ func (s *InputService2TestShapeStructType) SetScalarArg(v string) *InputService2 return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService3ProtocolTest struct { *client.Client } @@ -724,8 +736,12 @@ type InputService3TestShapeInputService3TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService4ProtocolTest struct { *client.Client } @@ -957,8 +973,12 @@ type InputService4TestShapeInputService4TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService5ProtocolTest struct { *client.Client } @@ -1099,8 +1119,12 @@ type InputService5TestShapeInputService5TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService6ProtocolTest struct { *client.Client } @@ -1241,8 +1265,12 @@ type InputService6TestShapeInputService6TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService7ProtocolTest struct { *client.Client } @@ -1391,8 +1419,12 @@ type InputService7TestShapeInputService7TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService8ProtocolTest struct { *client.Client } @@ -1533,8 +1565,12 @@ type InputService8TestShapeInputService8TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService9ProtocolTest struct { *client.Client } @@ -1675,8 +1711,12 @@ type InputService9TestShapeInputService9TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService10ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService10ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService10ProtocolTest struct { *client.Client } @@ -1818,8 +1858,12 @@ type InputService10TestShapeInputService10TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService11ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService11ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService11ProtocolTest struct { *client.Client } @@ -1960,8 +2004,12 @@ type InputService11TestShapeInputService11TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService12ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService12ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService12ProtocolTest struct { *client.Client } @@ -2513,8 +2561,12 @@ func (s *InputService12TestShapeRecursiveStructType) SetRecursiveStruct(v *Input return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService13ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService13ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService13ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/query/unmarshal_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/query/unmarshal_test.go index 2908b617..76b23094 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/query/unmarshal_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/query/unmarshal_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService1ProtocolTest struct { *client.Client } @@ -249,8 +253,12 @@ func (s *OutputService1TestShapeOutputService1TestCaseOperation1Output) SetTrueB return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService2ProtocolTest struct { *client.Client } @@ -397,8 +405,12 @@ func (s *OutputService2TestShapeOutputService2TestCaseOperation1Output) SetStr(v return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService3ProtocolTest struct { *client.Client } @@ -538,8 +550,12 @@ func (s *OutputService3TestShapeOutputService3TestCaseOperation1Output) SetBlob( return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService4ProtocolTest struct { *client.Client } @@ -678,8 +694,12 @@ func (s *OutputService4TestShapeOutputService4TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService5ProtocolTest struct { *client.Client } @@ -818,8 +838,12 @@ func (s *OutputService5TestShapeOutputService5TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService6ProtocolTest struct { *client.Client } @@ -958,8 +982,12 @@ func (s *OutputService6TestShapeOutputService6TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService7ProtocolTest struct { *client.Client } @@ -1098,8 +1126,12 @@ func (s *OutputService7TestShapeOutputService7TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService8ProtocolTest struct { *client.Client } @@ -1266,8 +1298,12 @@ func (s *OutputService8TestShapeStructureShape) SetFoo(v string) *OutputService8 return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService9ProtocolTest struct { *client.Client } @@ -1434,8 +1470,12 @@ func (s *OutputService9TestShapeStructureShape) SetFoo(v string) *OutputService9 return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService10ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService10ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService10ProtocolTest struct { *client.Client } @@ -1574,8 +1614,12 @@ func (s *OutputService10TestShapeOutputService10TestCaseOperation1Output) SetLis return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService11ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService11ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService11ProtocolTest struct { *client.Client } @@ -1726,8 +1770,12 @@ func (s *OutputService11TestShapeStructType) SetFoo(v string) *OutputService11Te return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService12ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService12ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService12ProtocolTest struct { *client.Client } @@ -1866,8 +1914,12 @@ func (s *OutputService12TestShapeOutputService12TestCaseOperation1Output) SetMap return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService13ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService13ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService13ProtocolTest struct { *client.Client } @@ -2006,8 +2058,12 @@ func (s *OutputService13TestShapeOutputService13TestCaseOperation1Output) SetMap return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService14ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService14ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService14ProtocolTest struct { *client.Client } @@ -2146,8 +2202,12 @@ func (s *OutputService14TestShapeOutputService14TestCaseOperation1Output) SetMap return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService15ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService15ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService15ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/build_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/build_test.go index 7034db25..71e6d875 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/build_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/build_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService1ProtocolTest struct { *client.Client } @@ -180,8 +184,12 @@ type InputService1TestShapeInputService1TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService2ProtocolTest struct { *client.Client } @@ -323,8 +331,12 @@ type InputService2TestShapeInputService2TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService3ProtocolTest struct { *client.Client } @@ -466,8 +478,12 @@ type InputService3TestShapeInputService3TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService4ProtocolTest struct { *client.Client } @@ -609,8 +625,12 @@ type InputService4TestShapeInputService4TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService5ProtocolTest struct { *client.Client } @@ -760,8 +780,12 @@ type InputService5TestShapeInputService5TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService6ProtocolTest struct { *client.Client } @@ -911,8 +935,12 @@ type InputService6TestShapeInputService6TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService7ProtocolTest struct { *client.Client } @@ -1130,8 +1158,12 @@ type InputService7TestShapeInputService7TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService8ProtocolTest struct { *client.Client } @@ -1289,8 +1321,12 @@ type InputService8TestShapeInputService8TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService9ProtocolTest struct { *client.Client } @@ -1476,8 +1512,12 @@ func (s *InputService9TestShapeStructType) SetB(v string) *InputService9TestShap return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService10ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService10ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService10ProtocolTest struct { *client.Client } @@ -1671,8 +1711,12 @@ func (s *InputService10TestShapeStructType) SetB(v string) *InputService10TestSh return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService11ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService11ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService11ProtocolTest struct { *client.Client } @@ -1844,8 +1888,12 @@ type InputService11TestShapeInputService11TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService12ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService12ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService12ProtocolTest struct { *client.Client } @@ -2010,8 +2058,12 @@ type InputService12TestShapeInputService12TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService13ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService13ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService13ProtocolTest struct { *client.Client } @@ -2229,8 +2281,12 @@ type InputService13TestShapeInputService13TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService14ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService14ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService14ProtocolTest struct { *client.Client } @@ -2460,8 +2516,12 @@ type InputService14TestShapeInputService14TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService15ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService15ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService15ProtocolTest struct { *client.Client } @@ -2679,8 +2739,12 @@ type InputService15TestShapeInputService15TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService16ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService16ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService16ProtocolTest struct { *client.Client } @@ -3238,8 +3302,12 @@ func (s *InputService16TestShapeRecursiveStructType) SetRecursiveStruct(v *Input return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService17ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService17ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService17ProtocolTest struct { *client.Client } @@ -3465,8 +3533,12 @@ type InputService17TestShapeInputService17TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService18ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService18ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService18ProtocolTest struct { *client.Client } @@ -3608,8 +3680,12 @@ type InputService18TestShapeInputService18TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService19ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService19ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService19ProtocolTest struct { *client.Client } @@ -3751,8 +3827,12 @@ type InputService19TestShapeInputService19TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService20ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService20ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService20ProtocolTest struct { *client.Client } @@ -3970,8 +4050,12 @@ type InputService20TestShapeInputService20TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService21ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService21ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService21ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/unmarshal_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/unmarshal_test.go index ae9e9eee..8233fe0f 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/unmarshal_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/restjson/unmarshal_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService1ProtocolTest struct { *client.Client } @@ -265,8 +269,12 @@ func (s *OutputService1TestShapeOutputService1TestCaseOperation1Output) SetTrueB return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService2ProtocolTest struct { *client.Client } @@ -427,8 +435,12 @@ func (s *OutputService2TestShapeOutputService2TestCaseOperation1Output) SetStruc return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService3ProtocolTest struct { *client.Client } @@ -587,8 +599,12 @@ func (s *OutputService3TestShapeTimeContainer) SetFoo(v time.Time) *OutputServic return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService4ProtocolTest struct { *client.Client } @@ -727,8 +743,12 @@ func (s *OutputService4TestShapeOutputService4TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService5ProtocolTest struct { *client.Client } @@ -879,8 +899,12 @@ func (s *OutputService5TestShapeSingleStruct) SetFoo(v string) *OutputService5Te return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService6ProtocolTest struct { *client.Client } @@ -1019,8 +1043,12 @@ func (s *OutputService6TestShapeOutputService6TestCaseOperation1Output) SetMapMe return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService7ProtocolTest struct { *client.Client } @@ -1159,8 +1187,12 @@ func (s *OutputService7TestShapeOutputService7TestCaseOperation1Output) SetMapMe return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService8ProtocolTest struct { *client.Client } @@ -1299,8 +1331,12 @@ func (s *OutputService8TestShapeOutputService8TestCaseOperation1Output) SetStrTy return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService9ProtocolTest struct { *client.Client } @@ -1447,8 +1483,12 @@ func (s *OutputService9TestShapeOutputService9TestCaseOperation1Output) SetPrefi return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService10ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService10ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService10ProtocolTest struct { *client.Client } @@ -1607,8 +1647,12 @@ func (s *OutputService10TestShapeOutputService10TestCaseOperation1Output) SetHea return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService11ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService11ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService11ProtocolTest struct { *client.Client } @@ -1747,8 +1791,12 @@ func (s *OutputService11TestShapeOutputService11TestCaseOperation1Output) SetStr return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService12ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService12ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService12ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/build_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/build_test.go index 9b13461e..60cb96f3 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/build_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/build_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService1ProtocolTest struct { *client.Client } @@ -352,8 +356,12 @@ type InputService1TestShapeInputService1TestCaseOperation3Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService2ProtocolTest struct { *client.Client } @@ -519,8 +527,12 @@ type InputService2TestShapeInputService2TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService3ProtocolTest struct { *client.Client } @@ -766,8 +778,12 @@ func (s *InputService3TestShapeSubStructure) SetFoo(v string) *InputService3Test return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService4ProtocolTest struct { *client.Client } @@ -937,8 +953,12 @@ func (s *InputService4TestShapeSubStructure) SetFoo(v string) *InputService4Test return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService5ProtocolTest struct { *client.Client } @@ -1080,8 +1100,12 @@ type InputService5TestShapeInputService5TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService6ProtocolTest struct { *client.Client } @@ -1223,8 +1247,12 @@ type InputService6TestShapeInputService6TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService7ProtocolTest struct { *client.Client } @@ -1366,8 +1394,12 @@ type InputService7TestShapeInputService7TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService8ProtocolTest struct { *client.Client } @@ -1509,8 +1541,12 @@ type InputService8TestShapeInputService8TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService9ProtocolTest struct { *client.Client } @@ -1664,8 +1700,12 @@ func (s *InputService9TestShapeSingleFieldStruct) SetElement(v string) *InputSer return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService10ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService10ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService10ProtocolTest struct { *client.Client } @@ -1828,8 +1868,12 @@ func (s *InputService10TestShapeStructureShape) SetT(v time.Time) *InputService1 return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService11ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService11ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService11ProtocolTest struct { *client.Client } @@ -1971,8 +2015,12 @@ type InputService11TestShapeInputService11TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService12ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService12ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService12ProtocolTest struct { *client.Client } @@ -2114,8 +2162,12 @@ type InputService12TestShapeInputService12TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService13ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService13ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService13ProtocolTest struct { *client.Client } @@ -2265,8 +2317,12 @@ type InputService13TestShapeInputService13TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService14ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService14ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService14ProtocolTest struct { *client.Client } @@ -2416,8 +2472,12 @@ type InputService14TestShapeInputService14TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService15ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService15ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService15ProtocolTest struct { *client.Client } @@ -2635,8 +2695,12 @@ type InputService15TestShapeInputService15TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService16ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService16ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService16ProtocolTest struct { *client.Client } @@ -2778,8 +2842,12 @@ type InputService16TestShapeInputService16TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService17ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService17ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService17ProtocolTest struct { *client.Client } @@ -2997,8 +3065,12 @@ type InputService17TestShapeInputService17TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService18ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService18ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService18ProtocolTest struct { *client.Client } @@ -3380,8 +3452,12 @@ type InputService18TestShapeInputService18TestCaseOperation4Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService19ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService19ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService19ProtocolTest struct { *client.Client } @@ -3555,8 +3631,12 @@ type InputService19TestShapeInputService19TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService20ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService20ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService20ProtocolTest struct { *client.Client } @@ -3706,8 +3786,12 @@ type InputService20TestShapeInputService20TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService21ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService21ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService21ProtocolTest struct { *client.Client } @@ -3925,8 +4009,12 @@ type InputService21TestShapeInputService21TestCaseOperation2Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService22ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService22ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService22ProtocolTest struct { *client.Client } @@ -4484,8 +4572,12 @@ func (s *InputService22TestShapeRecursiveStructType) SetRecursiveStruct(v *Input return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService23ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService23ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService23ProtocolTest struct { *client.Client } @@ -4627,8 +4719,12 @@ type InputService23TestShapeInputService23TestCaseOperation1Output struct { _ struct{} `type:"structure"` } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// InputService24ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// InputService24ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type InputService24ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/unmarshal_test.go b/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/unmarshal_test.go index 9404bb7f..9fc8c541 100644 --- a/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/unmarshal_test.go +++ b/vendor/github.com/aws/aws-sdk-go/private/protocol/restxml/unmarshal_test.go @@ -45,8 +45,12 @@ func init() { protocol.RandReader = &awstesting.ZeroReader{} } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService1ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService1ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService1ProtocolTest struct { *client.Client } @@ -338,8 +342,12 @@ func (s *OutputService1TestShapeOutputService1TestCaseOperation2Output) SetTrueB return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService2ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService2ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService2ProtocolTest struct { *client.Client } @@ -479,8 +487,12 @@ func (s *OutputService2TestShapeOutputService2TestCaseOperation1Output) SetBlob( return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService3ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService3ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService3ProtocolTest struct { *client.Client } @@ -619,8 +631,12 @@ func (s *OutputService3TestShapeOutputService3TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService4ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService4ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService4ProtocolTest struct { *client.Client } @@ -759,8 +775,12 @@ func (s *OutputService4TestShapeOutputService4TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService5ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService5ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService5ProtocolTest struct { *client.Client } @@ -899,8 +919,12 @@ func (s *OutputService5TestShapeOutputService5TestCaseOperation1Output) SetListM return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService6ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService6ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService6ProtocolTest struct { *client.Client } @@ -1051,8 +1075,12 @@ func (s *OutputService6TestShapeSingleStructure) SetFoo(v string) *OutputService return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService7ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService7ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService7ProtocolTest struct { *client.Client } @@ -1191,8 +1219,12 @@ func (s *OutputService7TestShapeOutputService7TestCaseOperation1Output) SetMap(v return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService8ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService8ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService8ProtocolTest struct { *client.Client } @@ -1331,8 +1363,12 @@ func (s *OutputService8TestShapeOutputService8TestCaseOperation1Output) SetMap(v return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService9ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService9ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService9ProtocolTest struct { *client.Client } @@ -1491,8 +1527,12 @@ func (s *OutputService9TestShapeSingleStructure) SetFoo(v string) *OutputService return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService10ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService10ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService10ProtocolTest struct { *client.Client } @@ -1631,8 +1671,12 @@ func (s *OutputService10TestShapeOutputService10TestCaseOperation1Output) SetStr return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService11ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService11ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService11ProtocolTest struct { *client.Client } @@ -1835,8 +1879,12 @@ func (s *OutputService11TestShapeOutputService11TestCaseOperation1Output) SetTru return s } -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// OutputService12ProtocolTest provides the API operation methods for making requests to +// . See this package's package overview docs +// for details on the service. +// +// OutputService12ProtocolTest methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OutputService12ProtocolTest struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/sdk.go b/vendor/github.com/aws/aws-sdk-go/sdk.go deleted file mode 100644 index afa465a2..00000000 --- a/vendor/github.com/aws/aws-sdk-go/sdk.go +++ /dev/null @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/acm/api.go b/vendor/github.com/aws/aws-sdk-go/service/acm/api.go index c1dfaf9e..daaab150 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/acm/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/acm/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/acm/doc.go b/vendor/github.com/aws/aws-sdk-go/service/acm/doc.go new file mode 100644 index 00000000..4cf6ffba --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/acm/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/acm/service.go b/vendor/github.com/aws/aws-sdk-go/service/acm/service.go index 299438ea..b083c37d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/acm/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/acm/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/apigateway/api.go b/vendor/github.com/aws/aws-sdk-go/service/apigateway/api.go index f4e0c2ed..e12ed705 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/apigateway/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/apigateway/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/apigateway/doc.go b/vendor/github.com/aws/aws-sdk-go/service/apigateway/doc.go new file mode 100644 index 00000000..c05d3cdc --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/apigateway/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/apigateway/service.go b/vendor/github.com/aws/aws-sdk-go/service/apigateway/service.go index c544015c..690b6b2f 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/apigateway/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/apigateway/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/api.go b/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/api.go index 24e9f5be..a40f52ca 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/doc.go b/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/doc.go new file mode 100644 index 00000000..12a3ae3a --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/service.go b/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/service.go index 4ce02860..56103ee2 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/applicationautoscaling/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/api.go index 85a0acdb..0901bd61 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package applicationdiscoveryservice provides a client for AWS Application Discovery Service. package applicationdiscoveryservice import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/doc.go new file mode 100644 index 00000000..cb4f4019 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/doc.go @@ -0,0 +1,139 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package applicationdiscoveryservice provides the client and types for making API +// requests to AWS Application Discovery Service. +// +// AWS Application Discovery Service helps you plan application migration projects +// by automatically identifying servers, virtual machines (VMs), software, and +// software dependencies running in your on-premises data centers. Application +// Discovery Service also collects application performance data, which can help +// you assess the outcome of your migration. The data collected by Application +// Discovery Service is securely retained in an Amazon-hosted and managed database +// in the cloud. You can export the data as a CSV or XML file into your preferred +// visualization tool or cloud-migration solution to plan your migration. For +// more information, see the Application Discovery Service FAQ (http://aws.amazon.com/application-discovery/faqs/). +// +// Application Discovery Service offers two modes of operation. +// +// * Agentless discovery mode is recommended for environments that use VMware +// vCenter Server. This mode doesn't require you to install an agent on each +// host. Agentless discovery gathers server information regardless of the +// operating systems, which minimizes the time required for initial on-premises +// infrastructure assessment. Agentless discovery doesn't collect information +// about software and software dependencies. It also doesn't work in non-VMware +// environments. We recommend that you use agent-based discovery for non-VMware +// environments and if you want to collect information about software and +// software dependencies. You can also run agent-based and agentless discovery +// simultaneously. Use agentless discovery to quickly complete the initial +// infrastructure assessment and then install agents on select hosts to gather +// information about software and software dependencies. +// +// * Agent-based discovery mode collects a richer set of data than agentless +// discovery by using Amazon software, the AWS Application Discovery Agent, +// which you install on one or more hosts in your data center. The agent +// captures infrastructure and application information, including an inventory +// of installed software applications, system and process performance, resource +// utilization, and network dependencies between workloads. The information +// collected by agents is secured at rest and in transit to the Application +// Discovery Service database in the cloud. +// +// Application Discovery Service integrates with application discovery solutions +// from AWS Partner Network (APN) partners. Third-party application discovery +// tools can query Application Discovery Service and write to the Application +// Discovery Service database using a public API. You can then import the data +// into either a visualization tool or cloud-migration solution. +// +// Application Discovery Service doesn't gather sensitive information. All data +// is handled according to the AWS Privacy Policy (http://aws.amazon.com/privacy/). +// You can operate Application Discovery Service using offline mode to inspect +// collected data before it is shared with the service. +// +// Your AWS account must be granted access to Application Discovery Service, +// a process called whitelisting. This is true for AWS partners and customers +// alike. To request access, sign up for AWS Application Discovery Service here +// (http://aws.amazon.com/application-discovery/preview/). We send you information +// about how to get started. +// +// This API reference provides descriptions, syntax, and usage examples for +// each of the actions and data types for Application Discovery Service. The +// topic for each action shows the API request parameters and the response. +// Alternatively, you can use one of the AWS SDKs to access an API that is tailored +// to the programming language or platform that you're using. For more information, +// see AWS SDKs (http://aws.amazon.com/tools/#SDKs). +// +// This guide is intended for use with the AWS Application Discovery Service +// User Guide (http://docs.aws.amazon.com/application-discovery/latest/userguide/). +// +// See https://docs.aws.amazon.com/goto/WebAPI/discovery-2015-11-01 for more information on this service. +// +// See applicationdiscoveryservice package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/applicationdiscoveryservice/ +// +// Using the Client +// +// To use the client for AWS Application Discovery 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 := applicationdiscoveryservice.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 Application Discovery Service client ApplicationDiscoveryService for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/applicationdiscoveryservice/#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.AssociateConfigurationItemsToApplication(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("AssociateConfigurationItemsToApplication 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.AssociateConfigurationItemsToApplicationWithContext(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 applicationdiscoveryservice diff --git a/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/service.go index 42efa534..00f66dd7 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/applicationdiscoveryservice/service.go @@ -11,69 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Application Discovery Service helps you plan application migration projects -// by automatically identifying servers, virtual machines (VMs), software, and -// software dependencies running in your on-premises data centers. Application -// Discovery Service also collects application performance data, which can help -// you assess the outcome of your migration. The data collected by Application -// Discovery Service is securely retained in an Amazon-hosted and managed database -// in the cloud. You can export the data as a CSV or XML file into your preferred -// visualization tool or cloud-migration solution to plan your migration. For -// more information, see the Application Discovery Service FAQ (http://aws.amazon.com/application-discovery/faqs/). +// ApplicationDiscoveryService provides the API operation methods for making requests to +// AWS Application Discovery Service. See this package's package overview docs +// for details on the service. // -// Application Discovery Service offers two modes of operation. -// -// * Agentless discovery mode is recommended for environments that use VMware -// vCenter Server. This mode doesn't require you to install an agent on each -// host. Agentless discovery gathers server information regardless of the -// operating systems, which minimizes the time required for initial on-premises -// infrastructure assessment. Agentless discovery doesn't collect information -// about software and software dependencies. It also doesn't work in non-VMware -// environments. We recommend that you use agent-based discovery for non-VMware -// environments and if you want to collect information about software and -// software dependencies. You can also run agent-based and agentless discovery -// simultaneously. Use agentless discovery to quickly complete the initial -// infrastructure assessment and then install agents on select hosts to gather -// information about software and software dependencies. -// -// * Agent-based discovery mode collects a richer set of data than agentless -// discovery by using Amazon software, the AWS Application Discovery Agent, -// which you install on one or more hosts in your data center. The agent -// captures infrastructure and application information, including an inventory -// of installed software applications, system and process performance, resource -// utilization, and network dependencies between workloads. The information -// collected by agents is secured at rest and in transit to the Application -// Discovery Service database in the cloud. -// -// Application Discovery Service integrates with application discovery solutions -// from AWS Partner Network (APN) partners. Third-party application discovery -// tools can query Application Discovery Service and write to the Application -// Discovery Service database using a public API. You can then import the data -// into either a visualization tool or cloud-migration solution. -// -// Application Discovery Service doesn't gather sensitive information. All data -// is handled according to the AWS Privacy Policy (http://aws.amazon.com/privacy/). -// You can operate Application Discovery Service using offline mode to inspect -// collected data before it is shared with the service. -// -// Your AWS account must be granted access to Application Discovery Service, -// a process called whitelisting. This is true for AWS partners and customers -// alike. To request access, sign up for AWS Application Discovery Service here -// (http://aws.amazon.com/application-discovery/preview/). We send you information -// about how to get started. -// -// This API reference provides descriptions, syntax, and usage examples for -// each of the actions and data types for Application Discovery Service. The -// topic for each action shows the API request parameters and the response. -// Alternatively, you can use one of the AWS SDKs to access an API that is tailored -// to the programming language or platform that you're using. For more information, -// see AWS SDKs (http://aws.amazon.com/tools/#SDKs). -// -// This guide is intended for use with the AWS Application Discovery Service -// User Guide (http://docs.aws.amazon.com/application-discovery/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/discovery-2015-11-01 +// ApplicationDiscoveryService methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type ApplicationDiscoveryService struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/appstream/api.go b/vendor/github.com/aws/aws-sdk-go/service/appstream/api.go index 16f93935..8b9c3714 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/appstream/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/appstream/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package appstream provides a client for Amazon AppStream. package appstream import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/appstream/doc.go b/vendor/github.com/aws/aws-sdk-go/service/appstream/doc.go new file mode 100644 index 00000000..8b2792d7 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/appstream/doc.go @@ -0,0 +1,80 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package appstream provides the client and types for making API +// requests to Amazon AppStream. +// +// API documentation for Amazon AppStream 2.0. +// +// See https://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01 for more information on this service. +// +// See appstream package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/appstream/ +// +// Using the Client +// +// To use the client for Amazon AppStream 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 := appstream.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 AppStream client AppStream for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/appstream/#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.AssociateFleet(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("AssociateFleet 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.AssociateFleetWithContext(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 appstream diff --git a/vendor/github.com/aws/aws-sdk-go/service/appstream/service.go b/vendor/github.com/aws/aws-sdk-go/service/appstream/service.go index 33cc0c75..28ece277 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/appstream/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/appstream/service.go @@ -11,10 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// API documentation for Amazon AppStream 2.0. -// 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/appstream-2016-12-01 +// AppStream provides the API operation methods for making requests to +// Amazon AppStream. See this package's package overview docs +// for details on the service. +// +// AppStream methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type AppStream struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/athena/api.go b/vendor/github.com/aws/aws-sdk-go/service/athena/api.go new file mode 100644 index 00000000..33141fc7 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/athena/api.go @@ -0,0 +1,2749 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package athena + +import ( + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awsutil" + "github.com/aws/aws-sdk-go/aws/request" +) + +const opBatchGetNamedQuery = "BatchGetNamedQuery" + +// BatchGetNamedQueryRequest generates a "aws/request.Request" representing the +// client's request for the BatchGetNamedQuery operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See BatchGetNamedQuery for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the BatchGetNamedQuery method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the BatchGetNamedQueryRequest method. +// req, resp := client.BatchGetNamedQueryRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetNamedQuery +func (c *Athena) BatchGetNamedQueryRequest(input *BatchGetNamedQueryInput) (req *request.Request, output *BatchGetNamedQueryOutput) { + op := &request.Operation{ + Name: opBatchGetNamedQuery, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &BatchGetNamedQueryInput{} + } + + output = &BatchGetNamedQueryOutput{} + req = c.newRequest(op, input, output) + return +} + +// BatchGetNamedQuery API operation for Amazon Athena. +// +// Returns the details of a single named query or a list of up to 50 queries, +// which you provide as an array of query ID strings. Use ListNamedQueries to +// get the list of named query IDs. If information could not be retrieved for +// a submitted query ID, information about the query ID submitted is listed +// under UnprocessedNamedQueryId. Named queries are different from executed +// queries. Use BatchGetQueryExecution to get details about each unique query +// execution, and ListQueryExecutions to get a list of query execution IDs. +// +// 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. +// +// See the AWS API reference guide for Amazon Athena's +// API operation BatchGetNamedQuery for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetNamedQuery +func (c *Athena) BatchGetNamedQuery(input *BatchGetNamedQueryInput) (*BatchGetNamedQueryOutput, error) { + req, out := c.BatchGetNamedQueryRequest(input) + return out, req.Send() +} + +// BatchGetNamedQueryWithContext is the same as BatchGetNamedQuery with the addition of +// the ability to pass a context and additional request options. +// +// See BatchGetNamedQuery for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) BatchGetNamedQueryWithContext(ctx aws.Context, input *BatchGetNamedQueryInput, opts ...request.Option) (*BatchGetNamedQueryOutput, error) { + req, out := c.BatchGetNamedQueryRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opBatchGetQueryExecution = "BatchGetQueryExecution" + +// BatchGetQueryExecutionRequest generates a "aws/request.Request" representing the +// client's request for the BatchGetQueryExecution operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See BatchGetQueryExecution for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the BatchGetQueryExecution method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the BatchGetQueryExecutionRequest method. +// req, resp := client.BatchGetQueryExecutionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetQueryExecution +func (c *Athena) BatchGetQueryExecutionRequest(input *BatchGetQueryExecutionInput) (req *request.Request, output *BatchGetQueryExecutionOutput) { + op := &request.Operation{ + Name: opBatchGetQueryExecution, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &BatchGetQueryExecutionInput{} + } + + output = &BatchGetQueryExecutionOutput{} + req = c.newRequest(op, input, output) + return +} + +// BatchGetQueryExecution API operation for Amazon Athena. +// +// Returns the details of a single query execution or a list of up to 50 query +// executions, which you provide as an array of query execution ID strings. +// To get a list of query execution IDs, use ListQueryExecutions. Query executions +// are different from named (saved) queries. Use BatchGetNamedQuery to get details +// about named queries. +// +// 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. +// +// See the AWS API reference guide for Amazon Athena's +// API operation BatchGetQueryExecution for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetQueryExecution +func (c *Athena) BatchGetQueryExecution(input *BatchGetQueryExecutionInput) (*BatchGetQueryExecutionOutput, error) { + req, out := c.BatchGetQueryExecutionRequest(input) + return out, req.Send() +} + +// BatchGetQueryExecutionWithContext is the same as BatchGetQueryExecution with the addition of +// the ability to pass a context and additional request options. +// +// See BatchGetQueryExecution for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) BatchGetQueryExecutionWithContext(ctx aws.Context, input *BatchGetQueryExecutionInput, opts ...request.Option) (*BatchGetQueryExecutionOutput, error) { + req, out := c.BatchGetQueryExecutionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opCreateNamedQuery = "CreateNamedQuery" + +// CreateNamedQueryRequest generates a "aws/request.Request" representing the +// client's request for the CreateNamedQuery operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See CreateNamedQuery for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the CreateNamedQuery method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the CreateNamedQueryRequest method. +// req, resp := client.CreateNamedQueryRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateNamedQuery +func (c *Athena) CreateNamedQueryRequest(input *CreateNamedQueryInput) (req *request.Request, output *CreateNamedQueryOutput) { + op := &request.Operation{ + Name: opCreateNamedQuery, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateNamedQueryInput{} + } + + output = &CreateNamedQueryOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateNamedQuery API operation for Amazon Athena. +// +// Creates a named query. +// +// For code samples using the AWS SDK for Java, see Examples and Code Samples +// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon +// Athena User 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 +// the error. +// +// See the AWS API reference guide for Amazon Athena's +// API operation CreateNamedQuery for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateNamedQuery +func (c *Athena) CreateNamedQuery(input *CreateNamedQueryInput) (*CreateNamedQueryOutput, error) { + req, out := c.CreateNamedQueryRequest(input) + return out, req.Send() +} + +// CreateNamedQueryWithContext is the same as CreateNamedQuery with the addition of +// the ability to pass a context and additional request options. +// +// See CreateNamedQuery for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) CreateNamedQueryWithContext(ctx aws.Context, input *CreateNamedQueryInput, opts ...request.Option) (*CreateNamedQueryOutput, error) { + req, out := c.CreateNamedQueryRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opDeleteNamedQuery = "DeleteNamedQuery" + +// DeleteNamedQueryRequest generates a "aws/request.Request" representing the +// client's request for the DeleteNamedQuery operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See DeleteNamedQuery for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the DeleteNamedQuery method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the DeleteNamedQueryRequest method. +// req, resp := client.DeleteNamedQueryRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteNamedQuery +func (c *Athena) DeleteNamedQueryRequest(input *DeleteNamedQueryInput) (req *request.Request, output *DeleteNamedQueryOutput) { + op := &request.Operation{ + Name: opDeleteNamedQuery, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteNamedQueryInput{} + } + + output = &DeleteNamedQueryOutput{} + req = c.newRequest(op, input, output) + return +} + +// DeleteNamedQuery API operation for Amazon Athena. +// +// Deletes a named query. +// +// For code samples using the AWS SDK for Java, see Examples and Code Samples +// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon +// Athena User 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 +// the error. +// +// See the AWS API reference guide for Amazon Athena's +// API operation DeleteNamedQuery for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteNamedQuery +func (c *Athena) DeleteNamedQuery(input *DeleteNamedQueryInput) (*DeleteNamedQueryOutput, error) { + req, out := c.DeleteNamedQueryRequest(input) + return out, req.Send() +} + +// DeleteNamedQueryWithContext is the same as DeleteNamedQuery with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteNamedQuery for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) DeleteNamedQueryWithContext(ctx aws.Context, input *DeleteNamedQueryInput, opts ...request.Option) (*DeleteNamedQueryOutput, error) { + req, out := c.DeleteNamedQueryRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opGetNamedQuery = "GetNamedQuery" + +// GetNamedQueryRequest generates a "aws/request.Request" representing the +// client's request for the GetNamedQuery operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See GetNamedQuery for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the GetNamedQuery method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the GetNamedQueryRequest method. +// req, resp := client.GetNamedQueryRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetNamedQuery +func (c *Athena) GetNamedQueryRequest(input *GetNamedQueryInput) (req *request.Request, output *GetNamedQueryOutput) { + op := &request.Operation{ + Name: opGetNamedQuery, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &GetNamedQueryInput{} + } + + output = &GetNamedQueryOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetNamedQuery API operation for Amazon Athena. +// +// Returns information about a single query. +// +// 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. +// +// See the AWS API reference guide for Amazon Athena's +// API operation GetNamedQuery for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetNamedQuery +func (c *Athena) GetNamedQuery(input *GetNamedQueryInput) (*GetNamedQueryOutput, error) { + req, out := c.GetNamedQueryRequest(input) + return out, req.Send() +} + +// GetNamedQueryWithContext is the same as GetNamedQuery with the addition of +// the ability to pass a context and additional request options. +// +// See GetNamedQuery for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) GetNamedQueryWithContext(ctx aws.Context, input *GetNamedQueryInput, opts ...request.Option) (*GetNamedQueryOutput, error) { + req, out := c.GetNamedQueryRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opGetQueryExecution = "GetQueryExecution" + +// GetQueryExecutionRequest generates a "aws/request.Request" representing the +// client's request for the GetQueryExecution operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See GetQueryExecution for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the GetQueryExecution method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the GetQueryExecutionRequest method. +// req, resp := client.GetQueryExecutionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution +func (c *Athena) GetQueryExecutionRequest(input *GetQueryExecutionInput) (req *request.Request, output *GetQueryExecutionOutput) { + op := &request.Operation{ + Name: opGetQueryExecution, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &GetQueryExecutionInput{} + } + + output = &GetQueryExecutionOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetQueryExecution API operation for Amazon Athena. +// +// Returns information about a single execution of a query. Each time a query +// executes, information about the query execution is saved with a unique ID. +// +// 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. +// +// See the AWS API reference guide for Amazon Athena's +// API operation GetQueryExecution for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution +func (c *Athena) GetQueryExecution(input *GetQueryExecutionInput) (*GetQueryExecutionOutput, error) { + req, out := c.GetQueryExecutionRequest(input) + return out, req.Send() +} + +// GetQueryExecutionWithContext is the same as GetQueryExecution with the addition of +// the ability to pass a context and additional request options. +// +// See GetQueryExecution for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) GetQueryExecutionWithContext(ctx aws.Context, input *GetQueryExecutionInput, opts ...request.Option) (*GetQueryExecutionOutput, error) { + req, out := c.GetQueryExecutionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opGetQueryResults = "GetQueryResults" + +// GetQueryResultsRequest generates a "aws/request.Request" representing the +// client's request for the GetQueryResults operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See GetQueryResults for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the GetQueryResults method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the GetQueryResultsRequest method. +// req, resp := client.GetQueryResultsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryResults +func (c *Athena) GetQueryResultsRequest(input *GetQueryResultsInput) (req *request.Request, output *GetQueryResultsOutput) { + op := &request.Operation{ + Name: opGetQueryResults, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, + } + + if input == nil { + input = &GetQueryResultsInput{} + } + + output = &GetQueryResultsOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetQueryResults API operation for Amazon Athena. +// +// Returns the results of a single query execution specified by QueryExecutionId. +// This request does not execute the query but returns results. Use StartQueryExecution +// to run a query. +// +// 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. +// +// See the AWS API reference guide for Amazon Athena's +// API operation GetQueryResults for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryResults +func (c *Athena) GetQueryResults(input *GetQueryResultsInput) (*GetQueryResultsOutput, error) { + req, out := c.GetQueryResultsRequest(input) + return out, req.Send() +} + +// GetQueryResultsWithContext is the same as GetQueryResults with the addition of +// the ability to pass a context and additional request options. +// +// See GetQueryResults for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) GetQueryResultsWithContext(ctx aws.Context, input *GetQueryResultsInput, opts ...request.Option) (*GetQueryResultsOutput, error) { + req, out := c.GetQueryResultsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// GetQueryResultsPages iterates over the pages of a GetQueryResults operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See GetQueryResults method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a GetQueryResults operation. +// pageNum := 0 +// err := client.GetQueryResultsPages(params, +// func(page *GetQueryResultsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Athena) GetQueryResultsPages(input *GetQueryResultsInput, fn func(*GetQueryResultsOutput, bool) bool) error { + return c.GetQueryResultsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// GetQueryResultsPagesWithContext same as GetQueryResultsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) GetQueryResultsPagesWithContext(ctx aws.Context, input *GetQueryResultsInput, fn func(*GetQueryResultsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *GetQueryResultsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.GetQueryResultsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*GetQueryResultsOutput), !p.HasNextPage()) + } + return p.Err() +} + +const opListNamedQueries = "ListNamedQueries" + +// ListNamedQueriesRequest generates a "aws/request.Request" representing the +// client's request for the ListNamedQueries operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See ListNamedQueries for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the ListNamedQueries method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the ListNamedQueriesRequest method. +// req, resp := client.ListNamedQueriesRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListNamedQueries +func (c *Athena) ListNamedQueriesRequest(input *ListNamedQueriesInput) (req *request.Request, output *ListNamedQueriesOutput) { + op := &request.Operation{ + Name: opListNamedQueries, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, + } + + if input == nil { + input = &ListNamedQueriesInput{} + } + + output = &ListNamedQueriesOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListNamedQueries API operation for Amazon Athena. +// +// Provides a list of all available query IDs. +// +// For code samples using the AWS SDK for Java, see Examples and Code Samples +// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon +// Athena User 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 +// the error. +// +// See the AWS API reference guide for Amazon Athena's +// API operation ListNamedQueries for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListNamedQueries +func (c *Athena) ListNamedQueries(input *ListNamedQueriesInput) (*ListNamedQueriesOutput, error) { + req, out := c.ListNamedQueriesRequest(input) + return out, req.Send() +} + +// ListNamedQueriesWithContext is the same as ListNamedQueries with the addition of +// the ability to pass a context and additional request options. +// +// See ListNamedQueries for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) ListNamedQueriesWithContext(ctx aws.Context, input *ListNamedQueriesInput, opts ...request.Option) (*ListNamedQueriesOutput, error) { + req, out := c.ListNamedQueriesRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListNamedQueriesPages iterates over the pages of a ListNamedQueries operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListNamedQueries method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListNamedQueries operation. +// pageNum := 0 +// err := client.ListNamedQueriesPages(params, +// func(page *ListNamedQueriesOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Athena) ListNamedQueriesPages(input *ListNamedQueriesInput, fn func(*ListNamedQueriesOutput, bool) bool) error { + return c.ListNamedQueriesPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListNamedQueriesPagesWithContext same as ListNamedQueriesPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) ListNamedQueriesPagesWithContext(ctx aws.Context, input *ListNamedQueriesInput, fn func(*ListNamedQueriesOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListNamedQueriesInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListNamedQueriesRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListNamedQueriesOutput), !p.HasNextPage()) + } + return p.Err() +} + +const opListQueryExecutions = "ListQueryExecutions" + +// ListQueryExecutionsRequest generates a "aws/request.Request" representing the +// client's request for the ListQueryExecutions operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See ListQueryExecutions for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the ListQueryExecutions method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the ListQueryExecutionsRequest method. +// req, resp := client.ListQueryExecutionsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListQueryExecutions +func (c *Athena) ListQueryExecutionsRequest(input *ListQueryExecutionsInput) (req *request.Request, output *ListQueryExecutionsOutput) { + op := &request.Operation{ + Name: opListQueryExecutions, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, + } + + if input == nil { + input = &ListQueryExecutionsInput{} + } + + output = &ListQueryExecutionsOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListQueryExecutions API operation for Amazon Athena. +// +// Provides a list of all available query execution IDs. +// +// For code samples using the AWS SDK for Java, see Examples and Code Samples +// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon +// Athena User 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 +// the error. +// +// See the AWS API reference guide for Amazon Athena's +// API operation ListQueryExecutions for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListQueryExecutions +func (c *Athena) ListQueryExecutions(input *ListQueryExecutionsInput) (*ListQueryExecutionsOutput, error) { + req, out := c.ListQueryExecutionsRequest(input) + return out, req.Send() +} + +// ListQueryExecutionsWithContext is the same as ListQueryExecutions with the addition of +// the ability to pass a context and additional request options. +// +// See ListQueryExecutions for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) ListQueryExecutionsWithContext(ctx aws.Context, input *ListQueryExecutionsInput, opts ...request.Option) (*ListQueryExecutionsOutput, error) { + req, out := c.ListQueryExecutionsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListQueryExecutionsPages iterates over the pages of a ListQueryExecutions operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListQueryExecutions method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListQueryExecutions operation. +// pageNum := 0 +// err := client.ListQueryExecutionsPages(params, +// func(page *ListQueryExecutionsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Athena) ListQueryExecutionsPages(input *ListQueryExecutionsInput, fn func(*ListQueryExecutionsOutput, bool) bool) error { + return c.ListQueryExecutionsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListQueryExecutionsPagesWithContext same as ListQueryExecutionsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) ListQueryExecutionsPagesWithContext(ctx aws.Context, input *ListQueryExecutionsInput, fn func(*ListQueryExecutionsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListQueryExecutionsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListQueryExecutionsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListQueryExecutionsOutput), !p.HasNextPage()) + } + return p.Err() +} + +const opStartQueryExecution = "StartQueryExecution" + +// StartQueryExecutionRequest generates a "aws/request.Request" representing the +// client's request for the StartQueryExecution operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See StartQueryExecution for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the StartQueryExecution method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the StartQueryExecutionRequest method. +// req, resp := client.StartQueryExecutionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecution +func (c *Athena) StartQueryExecutionRequest(input *StartQueryExecutionInput) (req *request.Request, output *StartQueryExecutionOutput) { + op := &request.Operation{ + Name: opStartQueryExecution, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &StartQueryExecutionInput{} + } + + output = &StartQueryExecutionOutput{} + req = c.newRequest(op, input, output) + return +} + +// StartQueryExecution API operation for Amazon Athena. +// +// Runs (executes) the SQL query statements contained in the Query string. +// +// For code samples using the AWS SDK for Java, see Examples and Code Samples +// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon +// Athena User 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 +// the error. +// +// See the AWS API reference guide for Amazon Athena's +// API operation StartQueryExecution for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Indicates that the request was throttled. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecution +func (c *Athena) StartQueryExecution(input *StartQueryExecutionInput) (*StartQueryExecutionOutput, error) { + req, out := c.StartQueryExecutionRequest(input) + return out, req.Send() +} + +// StartQueryExecutionWithContext is the same as StartQueryExecution with the addition of +// the ability to pass a context and additional request options. +// +// See StartQueryExecution for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) StartQueryExecutionWithContext(ctx aws.Context, input *StartQueryExecutionInput, opts ...request.Option) (*StartQueryExecutionOutput, error) { + req, out := c.StartQueryExecutionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opStopQueryExecution = "StopQueryExecution" + +// StopQueryExecutionRequest generates a "aws/request.Request" representing the +// client's request for the StopQueryExecution operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See StopQueryExecution for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the StopQueryExecution method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the StopQueryExecutionRequest method. +// req, resp := client.StopQueryExecutionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StopQueryExecution +func (c *Athena) StopQueryExecutionRequest(input *StopQueryExecutionInput) (req *request.Request, output *StopQueryExecutionOutput) { + op := &request.Operation{ + Name: opStopQueryExecution, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &StopQueryExecutionInput{} + } + + output = &StopQueryExecutionOutput{} + req = c.newRequest(op, input, output) + return +} + +// StopQueryExecution API operation for Amazon Athena. +// +// Stops a query execution. +// +// For code samples using the AWS SDK for Java, see Examples and Code Samples +// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon +// Athena User 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 +// the error. +// +// See the AWS API reference guide for Amazon Athena's +// API operation StopQueryExecution for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalServerException "InternalServerException" +// Indicates a platform issue, which may be due to a transient condition or +// outage. +// +// * ErrCodeInvalidRequestException "InvalidRequestException" +// Indicates that something is wrong with the input to the request. For example, +// a required parameter may be missing or out of range. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StopQueryExecution +func (c *Athena) StopQueryExecution(input *StopQueryExecutionInput) (*StopQueryExecutionOutput, error) { + req, out := c.StopQueryExecutionRequest(input) + return out, req.Send() +} + +// StopQueryExecutionWithContext is the same as StopQueryExecution with the addition of +// the ability to pass a context and additional request options. +// +// See StopQueryExecution for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Athena) StopQueryExecutionWithContext(ctx aws.Context, input *StopQueryExecutionInput, opts ...request.Option) (*StopQueryExecutionOutput, error) { + req, out := c.StopQueryExecutionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetNamedQueryInput +type BatchGetNamedQueryInput struct { + _ struct{} `type:"structure"` + + // An array of query IDs. + // + // NamedQueryIds is a required field + NamedQueryIds []*string `min:"1" type:"list" required:"true"` +} + +// String returns the string representation +func (s BatchGetNamedQueryInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s BatchGetNamedQueryInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *BatchGetNamedQueryInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "BatchGetNamedQueryInput"} + if s.NamedQueryIds == nil { + invalidParams.Add(request.NewErrParamRequired("NamedQueryIds")) + } + if s.NamedQueryIds != nil && len(s.NamedQueryIds) < 1 { + invalidParams.Add(request.NewErrParamMinLen("NamedQueryIds", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetNamedQueryIds sets the NamedQueryIds field's value. +func (s *BatchGetNamedQueryInput) SetNamedQueryIds(v []*string) *BatchGetNamedQueryInput { + s.NamedQueryIds = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetNamedQueryOutput +type BatchGetNamedQueryOutput struct { + _ struct{} `type:"structure"` + + // Information about the named query IDs submitted. + NamedQueries []*NamedQuery `type:"list"` + + // Information about provided query IDs. + UnprocessedNamedQueryIds []*UnprocessedNamedQueryId `type:"list"` +} + +// String returns the string representation +func (s BatchGetNamedQueryOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s BatchGetNamedQueryOutput) GoString() string { + return s.String() +} + +// SetNamedQueries sets the NamedQueries field's value. +func (s *BatchGetNamedQueryOutput) SetNamedQueries(v []*NamedQuery) *BatchGetNamedQueryOutput { + s.NamedQueries = v + return s +} + +// SetUnprocessedNamedQueryIds sets the UnprocessedNamedQueryIds field's value. +func (s *BatchGetNamedQueryOutput) SetUnprocessedNamedQueryIds(v []*UnprocessedNamedQueryId) *BatchGetNamedQueryOutput { + s.UnprocessedNamedQueryIds = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetQueryExecutionInput +type BatchGetQueryExecutionInput struct { + _ struct{} `type:"structure"` + + // An array of query execution IDs. + // + // QueryExecutionIds is a required field + QueryExecutionIds []*string `min:"1" type:"list" required:"true"` +} + +// String returns the string representation +func (s BatchGetQueryExecutionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s BatchGetQueryExecutionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *BatchGetQueryExecutionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "BatchGetQueryExecutionInput"} + if s.QueryExecutionIds == nil { + invalidParams.Add(request.NewErrParamRequired("QueryExecutionIds")) + } + if s.QueryExecutionIds != nil && len(s.QueryExecutionIds) < 1 { + invalidParams.Add(request.NewErrParamMinLen("QueryExecutionIds", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetQueryExecutionIds sets the QueryExecutionIds field's value. +func (s *BatchGetQueryExecutionInput) SetQueryExecutionIds(v []*string) *BatchGetQueryExecutionInput { + s.QueryExecutionIds = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetQueryExecutionOutput +type BatchGetQueryExecutionOutput struct { + _ struct{} `type:"structure"` + + // Information about a query execution. + QueryExecutions []*QueryExecution `type:"list"` + + // Information about the query executions that failed to run. + UnprocessedQueryExecutionIds []*UnprocessedQueryExecutionId `type:"list"` +} + +// String returns the string representation +func (s BatchGetQueryExecutionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s BatchGetQueryExecutionOutput) GoString() string { + return s.String() +} + +// SetQueryExecutions sets the QueryExecutions field's value. +func (s *BatchGetQueryExecutionOutput) SetQueryExecutions(v []*QueryExecution) *BatchGetQueryExecutionOutput { + s.QueryExecutions = v + return s +} + +// SetUnprocessedQueryExecutionIds sets the UnprocessedQueryExecutionIds field's value. +func (s *BatchGetQueryExecutionOutput) SetUnprocessedQueryExecutionIds(v []*UnprocessedQueryExecutionId) *BatchGetQueryExecutionOutput { + s.UnprocessedQueryExecutionIds = v + return s +} + +// Information about the columns in a query execution result. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ColumnInfo +type ColumnInfo struct { + _ struct{} `type:"structure"` + + // Indicates whether values in the column are case-sensitive. + CaseSensitive *bool `type:"boolean"` + + // The catalog to which the query results belong. + CatalogName *string `type:"string"` + + // A column label. + Label *string `type:"string"` + + // The name of the column. + // + // Name is a required field + Name *string `type:"string" required:"true"` + + // Indicates the column's nullable status. + Nullable *string `type:"string" enum:"ColumnNullable"` + + // For DECIMAL data types, specifies the total number of digits, up to 38. For + // performance reasons, we recommend up to 18 digits. + Precision *int64 `type:"integer"` + + // For DECIMAL data types, specifies the total number of digits in the fractional + // part of the value. Defaults to 0. + Scale *int64 `type:"integer"` + + // The schema name (database name) to which the query results belong. + SchemaName *string `type:"string"` + + // The table name for the query results. + TableName *string `type:"string"` + + // The data type of the column. + // + // Type is a required field + Type *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s ColumnInfo) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ColumnInfo) GoString() string { + return s.String() +} + +// SetCaseSensitive sets the CaseSensitive field's value. +func (s *ColumnInfo) SetCaseSensitive(v bool) *ColumnInfo { + s.CaseSensitive = &v + return s +} + +// SetCatalogName sets the CatalogName field's value. +func (s *ColumnInfo) SetCatalogName(v string) *ColumnInfo { + s.CatalogName = &v + return s +} + +// SetLabel sets the Label field's value. +func (s *ColumnInfo) SetLabel(v string) *ColumnInfo { + s.Label = &v + return s +} + +// SetName sets the Name field's value. +func (s *ColumnInfo) SetName(v string) *ColumnInfo { + s.Name = &v + return s +} + +// SetNullable sets the Nullable field's value. +func (s *ColumnInfo) SetNullable(v string) *ColumnInfo { + s.Nullable = &v + return s +} + +// SetPrecision sets the Precision field's value. +func (s *ColumnInfo) SetPrecision(v int64) *ColumnInfo { + s.Precision = &v + return s +} + +// SetScale sets the Scale field's value. +func (s *ColumnInfo) SetScale(v int64) *ColumnInfo { + s.Scale = &v + return s +} + +// SetSchemaName sets the SchemaName field's value. +func (s *ColumnInfo) SetSchemaName(v string) *ColumnInfo { + s.SchemaName = &v + return s +} + +// SetTableName sets the TableName field's value. +func (s *ColumnInfo) SetTableName(v string) *ColumnInfo { + s.TableName = &v + return s +} + +// SetType sets the Type field's value. +func (s *ColumnInfo) SetType(v string) *ColumnInfo { + s.Type = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateNamedQueryInput +type CreateNamedQueryInput struct { + _ struct{} `type:"structure"` + + // A unique case-sensitive string used to ensure the request to create the query + // is idempotent (executes only once). If another CreateNamedQuery request is + // received, the same response is returned and another query is not created. + // If a parameter has changed, for example, the QueryString, an error is returned. + // + // This token is listed as not required because AWS SDKs (for example the AWS + // SDK for Java) auto-generate the token for users. If you are not using the + // AWS SDK or the AWS CLI, you must provide this token or the action will fail. + ClientRequestToken *string `min:"32" type:"string" idempotencyToken:"true"` + + // The database to which the query belongs. + // + // Database is a required field + Database *string `min:"1" type:"string" required:"true"` + + // A brief explanation of the query. + Description *string `min:"1" type:"string"` + + // The plain language name for the query. + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` + + // The text of the query itself. In other words, all query statements. + // + // QueryString is a required field + QueryString *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s CreateNamedQueryInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateNamedQueryInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateNamedQueryInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateNamedQueryInput"} + if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 32 { + invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 32)) + } + if s.Database == nil { + invalidParams.Add(request.NewErrParamRequired("Database")) + } + if s.Database != nil && len(*s.Database) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Database", 1)) + } + if s.Description != nil && len(*s.Description) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Description", 1)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + if s.QueryString == nil { + invalidParams.Add(request.NewErrParamRequired("QueryString")) + } + if s.QueryString != nil && len(*s.QueryString) < 1 { + invalidParams.Add(request.NewErrParamMinLen("QueryString", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetClientRequestToken sets the ClientRequestToken field's value. +func (s *CreateNamedQueryInput) SetClientRequestToken(v string) *CreateNamedQueryInput { + s.ClientRequestToken = &v + return s +} + +// SetDatabase sets the Database field's value. +func (s *CreateNamedQueryInput) SetDatabase(v string) *CreateNamedQueryInput { + s.Database = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *CreateNamedQueryInput) SetDescription(v string) *CreateNamedQueryInput { + s.Description = &v + return s +} + +// SetName sets the Name field's value. +func (s *CreateNamedQueryInput) SetName(v string) *CreateNamedQueryInput { + s.Name = &v + return s +} + +// SetQueryString sets the QueryString field's value. +func (s *CreateNamedQueryInput) SetQueryString(v string) *CreateNamedQueryInput { + s.QueryString = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateNamedQueryOutput +type CreateNamedQueryOutput struct { + _ struct{} `type:"structure"` + + // The unique ID of the query. + NamedQueryId *string `type:"string"` +} + +// String returns the string representation +func (s CreateNamedQueryOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateNamedQueryOutput) GoString() string { + return s.String() +} + +// SetNamedQueryId sets the NamedQueryId field's value. +func (s *CreateNamedQueryOutput) SetNamedQueryId(v string) *CreateNamedQueryOutput { + s.NamedQueryId = &v + return s +} + +// A piece of data (a field in the table). +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/Datum +type Datum struct { + _ struct{} `type:"structure"` + + // The value of the datum. + VarCharValue *string `type:"string"` +} + +// String returns the string representation +func (s Datum) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s Datum) GoString() string { + return s.String() +} + +// SetVarCharValue sets the VarCharValue field's value. +func (s *Datum) SetVarCharValue(v string) *Datum { + s.VarCharValue = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteNamedQueryInput +type DeleteNamedQueryInput struct { + _ struct{} `type:"structure"` + + // The unique ID of the query to delete. + // + // NamedQueryId is a required field + NamedQueryId *string `type:"string" required:"true" idempotencyToken:"true"` +} + +// String returns the string representation +func (s DeleteNamedQueryInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteNamedQueryInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteNamedQueryInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteNamedQueryInput"} + if s.NamedQueryId == nil { + invalidParams.Add(request.NewErrParamRequired("NamedQueryId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetNamedQueryId sets the NamedQueryId field's value. +func (s *DeleteNamedQueryInput) SetNamedQueryId(v string) *DeleteNamedQueryInput { + s.NamedQueryId = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteNamedQueryOutput +type DeleteNamedQueryOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DeleteNamedQueryOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteNamedQueryOutput) GoString() string { + return s.String() +} + +// If query results are encrypted in Amazon S3, indicates the Amazon S3 encryption +// option used. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/EncryptionConfiguration +type EncryptionConfiguration struct { + _ struct{} `type:"structure"` + + // Indicates whether Amazon S3 server-side encryption with Amazon S3-managed + // keys (SSE-S3), server-side encryption with KMS-managed keys (SSE-KMS), or + // client-side encryption with KMS-managed keys (CSE-KMS) is used. + // + // EncryptionOption is a required field + EncryptionOption *string `type:"string" required:"true" enum:"EncryptionOption"` + + // For SSE-KMS and CSE-KMS, this is the KMS key ARN or ID. + KmsKey *string `type:"string"` +} + +// String returns the string representation +func (s EncryptionConfiguration) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s EncryptionConfiguration) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *EncryptionConfiguration) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "EncryptionConfiguration"} + if s.EncryptionOption == nil { + invalidParams.Add(request.NewErrParamRequired("EncryptionOption")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetEncryptionOption sets the EncryptionOption field's value. +func (s *EncryptionConfiguration) SetEncryptionOption(v string) *EncryptionConfiguration { + s.EncryptionOption = &v + return s +} + +// SetKmsKey sets the KmsKey field's value. +func (s *EncryptionConfiguration) SetKmsKey(v string) *EncryptionConfiguration { + s.KmsKey = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetNamedQueryInput +type GetNamedQueryInput struct { + _ struct{} `type:"structure"` + + // The unique ID of the query. Use ListNamedQueries to get query IDs. + // + // NamedQueryId is a required field + NamedQueryId *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s GetNamedQueryInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetNamedQueryInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetNamedQueryInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetNamedQueryInput"} + if s.NamedQueryId == nil { + invalidParams.Add(request.NewErrParamRequired("NamedQueryId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetNamedQueryId sets the NamedQueryId field's value. +func (s *GetNamedQueryInput) SetNamedQueryId(v string) *GetNamedQueryInput { + s.NamedQueryId = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetNamedQueryOutput +type GetNamedQueryOutput struct { + _ struct{} `type:"structure"` + + // Information about the query. + NamedQuery *NamedQuery `type:"structure"` +} + +// String returns the string representation +func (s GetNamedQueryOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetNamedQueryOutput) GoString() string { + return s.String() +} + +// SetNamedQuery sets the NamedQuery field's value. +func (s *GetNamedQueryOutput) SetNamedQuery(v *NamedQuery) *GetNamedQueryOutput { + s.NamedQuery = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecutionInput +type GetQueryExecutionInput struct { + _ struct{} `type:"structure"` + + // The unique ID of the query execution. + // + // QueryExecutionId is a required field + QueryExecutionId *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s GetQueryExecutionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetQueryExecutionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetQueryExecutionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetQueryExecutionInput"} + if s.QueryExecutionId == nil { + invalidParams.Add(request.NewErrParamRequired("QueryExecutionId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetQueryExecutionId sets the QueryExecutionId field's value. +func (s *GetQueryExecutionInput) SetQueryExecutionId(v string) *GetQueryExecutionInput { + s.QueryExecutionId = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecutionOutput +type GetQueryExecutionOutput struct { + _ struct{} `type:"structure"` + + // Information about the query execution. + QueryExecution *QueryExecution `type:"structure"` +} + +// String returns the string representation +func (s GetQueryExecutionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetQueryExecutionOutput) GoString() string { + return s.String() +} + +// SetQueryExecution sets the QueryExecution field's value. +func (s *GetQueryExecutionOutput) SetQueryExecution(v *QueryExecution) *GetQueryExecutionOutput { + s.QueryExecution = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryResultsInput +type GetQueryResultsInput struct { + _ struct{} `type:"structure"` + + // The maximum number of results (rows) to return in this request. + MaxResults *int64 `type:"integer"` + + // The token that specifies where to start pagination if a previous request + // was truncated. + NextToken *string `type:"string"` + + // The unique ID of the query execution. + // + // QueryExecutionId is a required field + QueryExecutionId *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s GetQueryResultsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetQueryResultsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetQueryResultsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetQueryResultsInput"} + if s.QueryExecutionId == nil { + invalidParams.Add(request.NewErrParamRequired("QueryExecutionId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMaxResults sets the MaxResults field's value. +func (s *GetQueryResultsInput) SetMaxResults(v int64) *GetQueryResultsInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *GetQueryResultsInput) SetNextToken(v string) *GetQueryResultsInput { + s.NextToken = &v + return s +} + +// SetQueryExecutionId sets the QueryExecutionId field's value. +func (s *GetQueryResultsInput) SetQueryExecutionId(v string) *GetQueryResultsInput { + s.QueryExecutionId = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryResultsOutput +type GetQueryResultsOutput struct { + _ struct{} `type:"structure"` + + // A token to be used by the next request if this request is truncated. + NextToken *string `type:"string"` + + // The results of the query execution. + ResultSet *ResultSet `type:"structure"` +} + +// String returns the string representation +func (s GetQueryResultsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetQueryResultsOutput) GoString() string { + return s.String() +} + +// SetNextToken sets the NextToken field's value. +func (s *GetQueryResultsOutput) SetNextToken(v string) *GetQueryResultsOutput { + s.NextToken = &v + return s +} + +// SetResultSet sets the ResultSet field's value. +func (s *GetQueryResultsOutput) SetResultSet(v *ResultSet) *GetQueryResultsOutput { + s.ResultSet = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListNamedQueriesInput +type ListNamedQueriesInput struct { + _ struct{} `type:"structure"` + + // The maximum number of queries to return in this request. + MaxResults *int64 `type:"integer"` + + // The token that specifies where to start pagination if a previous request + // was truncated. + NextToken *string `type:"string"` +} + +// String returns the string representation +func (s ListNamedQueriesInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListNamedQueriesInput) GoString() string { + return s.String() +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListNamedQueriesInput) SetMaxResults(v int64) *ListNamedQueriesInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListNamedQueriesInput) SetNextToken(v string) *ListNamedQueriesInput { + s.NextToken = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListNamedQueriesOutput +type ListNamedQueriesOutput struct { + _ struct{} `type:"structure"` + + // The list of unique query IDs. + NamedQueryIds []*string `min:"1" type:"list"` + + // A token to be used by the next request if this request is truncated. + NextToken *string `type:"string"` +} + +// String returns the string representation +func (s ListNamedQueriesOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListNamedQueriesOutput) GoString() string { + return s.String() +} + +// SetNamedQueryIds sets the NamedQueryIds field's value. +func (s *ListNamedQueriesOutput) SetNamedQueryIds(v []*string) *ListNamedQueriesOutput { + s.NamedQueryIds = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListNamedQueriesOutput) SetNextToken(v string) *ListNamedQueriesOutput { + s.NextToken = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListQueryExecutionsInput +type ListQueryExecutionsInput struct { + _ struct{} `type:"structure"` + + // The maximum number of query executions to return in this request. + MaxResults *int64 `type:"integer"` + + // The token that specifies where to start pagination if a previous request + // was truncated. + NextToken *string `type:"string"` +} + +// String returns the string representation +func (s ListQueryExecutionsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListQueryExecutionsInput) GoString() string { + return s.String() +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListQueryExecutionsInput) SetMaxResults(v int64) *ListQueryExecutionsInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListQueryExecutionsInput) SetNextToken(v string) *ListQueryExecutionsInput { + s.NextToken = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListQueryExecutionsOutput +type ListQueryExecutionsOutput struct { + _ struct{} `type:"structure"` + + // A token to be used by the next request if this request is truncated. + NextToken *string `type:"string"` + + // The unique IDs of each query execution as an array of strings. + QueryExecutionIds []*string `min:"1" type:"list"` +} + +// String returns the string representation +func (s ListQueryExecutionsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListQueryExecutionsOutput) GoString() string { + return s.String() +} + +// SetNextToken sets the NextToken field's value. +func (s *ListQueryExecutionsOutput) SetNextToken(v string) *ListQueryExecutionsOutput { + s.NextToken = &v + return s +} + +// SetQueryExecutionIds sets the QueryExecutionIds field's value. +func (s *ListQueryExecutionsOutput) SetQueryExecutionIds(v []*string) *ListQueryExecutionsOutput { + s.QueryExecutionIds = v + return s +} + +// A query, where QueryString is the SQL query statements that comprise the +// query. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/NamedQuery +type NamedQuery struct { + _ struct{} `type:"structure"` + + // The database to which the query belongs. + // + // Database is a required field + Database *string `min:"1" type:"string" required:"true"` + + // A brief description of the query. + Description *string `min:"1" type:"string"` + + // The plain-language name of the query. + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` + + // The unique identifier of the query. + NamedQueryId *string `type:"string"` + + // The SQL query statements that comprise the query. + // + // QueryString is a required field + QueryString *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s NamedQuery) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s NamedQuery) GoString() string { + return s.String() +} + +// SetDatabase sets the Database field's value. +func (s *NamedQuery) SetDatabase(v string) *NamedQuery { + s.Database = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *NamedQuery) SetDescription(v string) *NamedQuery { + s.Description = &v + return s +} + +// SetName sets the Name field's value. +func (s *NamedQuery) SetName(v string) *NamedQuery { + s.Name = &v + return s +} + +// SetNamedQueryId sets the NamedQueryId field's value. +func (s *NamedQuery) SetNamedQueryId(v string) *NamedQuery { + s.NamedQueryId = &v + return s +} + +// SetQueryString sets the QueryString field's value. +func (s *NamedQuery) SetQueryString(v string) *NamedQuery { + s.QueryString = &v + return s +} + +// Information about a single instance of a query execution. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecution +type QueryExecution struct { + _ struct{} `type:"structure"` + + // The SQL query statements which the query execution ran. + Query *string `min:"1" type:"string"` + + // The database in which the query execution occurred. + QueryExecutionContext *QueryExecutionContext `type:"structure"` + + // The unique identifier for each query execution. + QueryExecutionId *string `type:"string"` + + // The location in Amazon S3 where query results were stored and the encryption + // option, if any, used for query results. + ResultConfiguration *ResultConfiguration `type:"structure"` + + // The amount of data scanned during the query execution and the amount of time + // that it took to execute. + Statistics *QueryExecutionStatistics `type:"structure"` + + // The completion date, current state, submission time, and state change reason + // (if applicable) for the query execution. + Status *QueryExecutionStatus `type:"structure"` +} + +// String returns the string representation +func (s QueryExecution) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s QueryExecution) GoString() string { + return s.String() +} + +// SetQuery sets the Query field's value. +func (s *QueryExecution) SetQuery(v string) *QueryExecution { + s.Query = &v + return s +} + +// SetQueryExecutionContext sets the QueryExecutionContext field's value. +func (s *QueryExecution) SetQueryExecutionContext(v *QueryExecutionContext) *QueryExecution { + s.QueryExecutionContext = v + return s +} + +// SetQueryExecutionId sets the QueryExecutionId field's value. +func (s *QueryExecution) SetQueryExecutionId(v string) *QueryExecution { + s.QueryExecutionId = &v + return s +} + +// SetResultConfiguration sets the ResultConfiguration field's value. +func (s *QueryExecution) SetResultConfiguration(v *ResultConfiguration) *QueryExecution { + s.ResultConfiguration = v + return s +} + +// SetStatistics sets the Statistics field's value. +func (s *QueryExecution) SetStatistics(v *QueryExecutionStatistics) *QueryExecution { + s.Statistics = v + return s +} + +// SetStatus sets the Status field's value. +func (s *QueryExecution) SetStatus(v *QueryExecutionStatus) *QueryExecution { + s.Status = v + return s +} + +// The database in which the query execution occurs. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecutionContext +type QueryExecutionContext struct { + _ struct{} `type:"structure"` + + // The name of the database. + Database *string `min:"1" type:"string"` +} + +// String returns the string representation +func (s QueryExecutionContext) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s QueryExecutionContext) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *QueryExecutionContext) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "QueryExecutionContext"} + if s.Database != nil && len(*s.Database) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Database", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDatabase sets the Database field's value. +func (s *QueryExecutionContext) SetDatabase(v string) *QueryExecutionContext { + s.Database = &v + return s +} + +// The amount of data scanned during the query execution and the amount of time +// that it took to execute. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecutionStatistics +type QueryExecutionStatistics struct { + _ struct{} `type:"structure"` + + // The number of bytes in the data that was queried. + DataScannedInBytes *int64 `type:"long"` + + // The number of milliseconds that the query took to execute. + EngineExecutionTimeInMillis *int64 `type:"long"` +} + +// String returns the string representation +func (s QueryExecutionStatistics) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s QueryExecutionStatistics) GoString() string { + return s.String() +} + +// SetDataScannedInBytes sets the DataScannedInBytes field's value. +func (s *QueryExecutionStatistics) SetDataScannedInBytes(v int64) *QueryExecutionStatistics { + s.DataScannedInBytes = &v + return s +} + +// SetEngineExecutionTimeInMillis sets the EngineExecutionTimeInMillis field's value. +func (s *QueryExecutionStatistics) SetEngineExecutionTimeInMillis(v int64) *QueryExecutionStatistics { + s.EngineExecutionTimeInMillis = &v + return s +} + +// The completion date, current state, submission time, and state change reason +// (if applicable) for the query execution. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecutionStatus +type QueryExecutionStatus struct { + _ struct{} `type:"structure"` + + // The date and time that the query completed. + CompletionDateTime *time.Time `type:"timestamp" timestampFormat:"unix"` + + // The state of query execution. SUBMITTED indicates that the query is queued + // for execution. RUNNING indicates that the query is scanning data and returning + // results. SUCCEEDED indicates that the query completed without error. FAILED + // indicates that the query experienced an error and did not complete processing. + // CANCELLED indicates that user input interrupted query execution. + State *string `type:"string" enum:"QueryExecutionState"` + + // Further detail about the status of the query. + StateChangeReason *string `type:"string"` + + // The date and time that the query was submitted. + SubmissionDateTime *time.Time `type:"timestamp" timestampFormat:"unix"` +} + +// String returns the string representation +func (s QueryExecutionStatus) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s QueryExecutionStatus) GoString() string { + return s.String() +} + +// SetCompletionDateTime sets the CompletionDateTime field's value. +func (s *QueryExecutionStatus) SetCompletionDateTime(v time.Time) *QueryExecutionStatus { + s.CompletionDateTime = &v + return s +} + +// SetState sets the State field's value. +func (s *QueryExecutionStatus) SetState(v string) *QueryExecutionStatus { + s.State = &v + return s +} + +// SetStateChangeReason sets the StateChangeReason field's value. +func (s *QueryExecutionStatus) SetStateChangeReason(v string) *QueryExecutionStatus { + s.StateChangeReason = &v + return s +} + +// SetSubmissionDateTime sets the SubmissionDateTime field's value. +func (s *QueryExecutionStatus) SetSubmissionDateTime(v time.Time) *QueryExecutionStatus { + s.SubmissionDateTime = &v + return s +} + +// The location in Amazon S3 where query results are stored and the encryption +// option, if any, used for query results. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultConfiguration +type ResultConfiguration struct { + _ struct{} `type:"structure"` + + // If query results are encrypted in S3, indicates the S3 encryption option + // used (for example, SSE-KMS or CSE-KMS and key information. + EncryptionConfiguration *EncryptionConfiguration `type:"structure"` + + // The location in S3 where query results are stored. + // + // OutputLocation is a required field + OutputLocation *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s ResultConfiguration) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ResultConfiguration) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ResultConfiguration) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ResultConfiguration"} + if s.OutputLocation == nil { + invalidParams.Add(request.NewErrParamRequired("OutputLocation")) + } + if s.EncryptionConfiguration != nil { + if err := s.EncryptionConfiguration.Validate(); err != nil { + invalidParams.AddNested("EncryptionConfiguration", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetEncryptionConfiguration sets the EncryptionConfiguration field's value. +func (s *ResultConfiguration) SetEncryptionConfiguration(v *EncryptionConfiguration) *ResultConfiguration { + s.EncryptionConfiguration = v + return s +} + +// SetOutputLocation sets the OutputLocation field's value. +func (s *ResultConfiguration) SetOutputLocation(v string) *ResultConfiguration { + s.OutputLocation = &v + return s +} + +// The metadata and rows that comprise a query result set. The metadata describes +// the column structure and data types. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultSet +type ResultSet struct { + _ struct{} `type:"structure"` + + // The metadata that describes the column structure and data types of a table + // of query results. + ResultSetMetadata *ResultSetMetadata `type:"structure"` + + // The rows in the table. + Rows []*Row `type:"list"` +} + +// String returns the string representation +func (s ResultSet) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ResultSet) GoString() string { + return s.String() +} + +// SetResultSetMetadata sets the ResultSetMetadata field's value. +func (s *ResultSet) SetResultSetMetadata(v *ResultSetMetadata) *ResultSet { + s.ResultSetMetadata = v + return s +} + +// SetRows sets the Rows field's value. +func (s *ResultSet) SetRows(v []*Row) *ResultSet { + s.Rows = v + return s +} + +// The metadata that describes the column structure and data types of a table +// of query results. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultSetMetadata +type ResultSetMetadata struct { + _ struct{} `type:"structure"` + + // Information about the columns in a query execution result. + ColumnInfo []*ColumnInfo `type:"list"` +} + +// String returns the string representation +func (s ResultSetMetadata) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ResultSetMetadata) GoString() string { + return s.String() +} + +// SetColumnInfo sets the ColumnInfo field's value. +func (s *ResultSetMetadata) SetColumnInfo(v []*ColumnInfo) *ResultSetMetadata { + s.ColumnInfo = v + return s +} + +// The rows that comprise a query result table. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/Row +type Row struct { + _ struct{} `type:"structure"` + + // The data that populates a row in a query result table. + Data []*Datum `type:"list"` +} + +// String returns the string representation +func (s Row) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s Row) GoString() string { + return s.String() +} + +// SetData sets the Data field's value. +func (s *Row) SetData(v []*Datum) *Row { + s.Data = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecutionInput +type StartQueryExecutionInput struct { + _ struct{} `type:"structure"` + + // A unique case-sensitive string used to ensure the request to create the query + // is idempotent (executes only once). If another StartQueryExecution request + // is received, the same response is returned and another query is not created. + // If a parameter has changed, for example, the QueryString, an error is returned. + // + // This token is listed as not required because AWS SDKs (for example the AWS + // SDK for Java) auto-generate the token for users. If you are not using the + // AWS SDK or the AWS CLI, you must provide this token or the action will fail. + ClientRequestToken *string `min:"32" type:"string" idempotencyToken:"true"` + + // The database within which the query executes. + QueryExecutionContext *QueryExecutionContext `type:"structure"` + + // The SQL query statements to be executed. + // + // QueryString is a required field + QueryString *string `min:"1" type:"string" required:"true"` + + // Specifies information about where and how to save the results of the query + // execution. + // + // ResultConfiguration is a required field + ResultConfiguration *ResultConfiguration `type:"structure" required:"true"` +} + +// String returns the string representation +func (s StartQueryExecutionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StartQueryExecutionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *StartQueryExecutionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "StartQueryExecutionInput"} + if s.ClientRequestToken != nil && len(*s.ClientRequestToken) < 32 { + invalidParams.Add(request.NewErrParamMinLen("ClientRequestToken", 32)) + } + if s.QueryString == nil { + invalidParams.Add(request.NewErrParamRequired("QueryString")) + } + if s.QueryString != nil && len(*s.QueryString) < 1 { + invalidParams.Add(request.NewErrParamMinLen("QueryString", 1)) + } + if s.ResultConfiguration == nil { + invalidParams.Add(request.NewErrParamRequired("ResultConfiguration")) + } + if s.QueryExecutionContext != nil { + if err := s.QueryExecutionContext.Validate(); err != nil { + invalidParams.AddNested("QueryExecutionContext", err.(request.ErrInvalidParams)) + } + } + if s.ResultConfiguration != nil { + if err := s.ResultConfiguration.Validate(); err != nil { + invalidParams.AddNested("ResultConfiguration", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetClientRequestToken sets the ClientRequestToken field's value. +func (s *StartQueryExecutionInput) SetClientRequestToken(v string) *StartQueryExecutionInput { + s.ClientRequestToken = &v + return s +} + +// SetQueryExecutionContext sets the QueryExecutionContext field's value. +func (s *StartQueryExecutionInput) SetQueryExecutionContext(v *QueryExecutionContext) *StartQueryExecutionInput { + s.QueryExecutionContext = v + return s +} + +// SetQueryString sets the QueryString field's value. +func (s *StartQueryExecutionInput) SetQueryString(v string) *StartQueryExecutionInput { + s.QueryString = &v + return s +} + +// SetResultConfiguration sets the ResultConfiguration field's value. +func (s *StartQueryExecutionInput) SetResultConfiguration(v *ResultConfiguration) *StartQueryExecutionInput { + s.ResultConfiguration = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecutionOutput +type StartQueryExecutionOutput struct { + _ struct{} `type:"structure"` + + // The unique ID of the query that ran as a result of this request. + QueryExecutionId *string `type:"string"` +} + +// String returns the string representation +func (s StartQueryExecutionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StartQueryExecutionOutput) GoString() string { + return s.String() +} + +// SetQueryExecutionId sets the QueryExecutionId field's value. +func (s *StartQueryExecutionOutput) SetQueryExecutionId(v string) *StartQueryExecutionOutput { + s.QueryExecutionId = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StopQueryExecutionInput +type StopQueryExecutionInput struct { + _ struct{} `type:"structure"` + + // The unique ID of the query execution to stop. + // + // QueryExecutionId is a required field + QueryExecutionId *string `type:"string" required:"true" idempotencyToken:"true"` +} + +// String returns the string representation +func (s StopQueryExecutionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StopQueryExecutionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *StopQueryExecutionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "StopQueryExecutionInput"} + if s.QueryExecutionId == nil { + invalidParams.Add(request.NewErrParamRequired("QueryExecutionId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetQueryExecutionId sets the QueryExecutionId field's value. +func (s *StopQueryExecutionInput) SetQueryExecutionId(v string) *StopQueryExecutionInput { + s.QueryExecutionId = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StopQueryExecutionOutput +type StopQueryExecutionOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s StopQueryExecutionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StopQueryExecutionOutput) GoString() string { + return s.String() +} + +// Information about a named query ID that could not be processed. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UnprocessedNamedQueryId +type UnprocessedNamedQueryId struct { + _ struct{} `type:"structure"` + + // The error code returned when the processing request for the named query failed, + // if applicable. + ErrorCode *string `min:"1" type:"string"` + + // The error message returned when the processing request for the named query + // failed, if applicable. + ErrorMessage *string `type:"string"` + + // The unique identifier of the named query. + NamedQueryId *string `type:"string"` +} + +// String returns the string representation +func (s UnprocessedNamedQueryId) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UnprocessedNamedQueryId) GoString() string { + return s.String() +} + +// SetErrorCode sets the ErrorCode field's value. +func (s *UnprocessedNamedQueryId) SetErrorCode(v string) *UnprocessedNamedQueryId { + s.ErrorCode = &v + return s +} + +// SetErrorMessage sets the ErrorMessage field's value. +func (s *UnprocessedNamedQueryId) SetErrorMessage(v string) *UnprocessedNamedQueryId { + s.ErrorMessage = &v + return s +} + +// SetNamedQueryId sets the NamedQueryId field's value. +func (s *UnprocessedNamedQueryId) SetNamedQueryId(v string) *UnprocessedNamedQueryId { + s.NamedQueryId = &v + return s +} + +// Describes a query execution that failed to process. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UnprocessedQueryExecutionId +type UnprocessedQueryExecutionId struct { + _ struct{} `type:"structure"` + + // The error code returned when the query execution failed to process, if applicable. + ErrorCode *string `min:"1" type:"string"` + + // The error message returned when the query execution failed to process, if + // applicable. + ErrorMessage *string `type:"string"` + + // The unique identifier of the query execution. + QueryExecutionId *string `type:"string"` +} + +// String returns the string representation +func (s UnprocessedQueryExecutionId) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UnprocessedQueryExecutionId) GoString() string { + return s.String() +} + +// SetErrorCode sets the ErrorCode field's value. +func (s *UnprocessedQueryExecutionId) SetErrorCode(v string) *UnprocessedQueryExecutionId { + s.ErrorCode = &v + return s +} + +// SetErrorMessage sets the ErrorMessage field's value. +func (s *UnprocessedQueryExecutionId) SetErrorMessage(v string) *UnprocessedQueryExecutionId { + s.ErrorMessage = &v + return s +} + +// SetQueryExecutionId sets the QueryExecutionId field's value. +func (s *UnprocessedQueryExecutionId) SetQueryExecutionId(v string) *UnprocessedQueryExecutionId { + s.QueryExecutionId = &v + return s +} + +const ( + // ColumnNullableNotNull is a ColumnNullable enum value + ColumnNullableNotNull = "NOT_NULL" + + // ColumnNullableNullable is a ColumnNullable enum value + ColumnNullableNullable = "NULLABLE" + + // ColumnNullableUnknown is a ColumnNullable enum value + ColumnNullableUnknown = "UNKNOWN" +) + +const ( + // EncryptionOptionSseS3 is a EncryptionOption enum value + EncryptionOptionSseS3 = "SSE_S3" + + // EncryptionOptionSseKms is a EncryptionOption enum value + EncryptionOptionSseKms = "SSE_KMS" + + // EncryptionOptionCseKms is a EncryptionOption enum value + EncryptionOptionCseKms = "CSE_KMS" +) + +const ( + // QueryExecutionStateQueued is a QueryExecutionState enum value + QueryExecutionStateQueued = "QUEUED" + + // QueryExecutionStateRunning is a QueryExecutionState enum value + QueryExecutionStateRunning = "RUNNING" + + // QueryExecutionStateSucceeded is a QueryExecutionState enum value + QueryExecutionStateSucceeded = "SUCCEEDED" + + // QueryExecutionStateFailed is a QueryExecutionState enum value + QueryExecutionStateFailed = "FAILED" + + // QueryExecutionStateCancelled is a QueryExecutionState enum value + QueryExecutionStateCancelled = "CANCELLED" +) + +const ( + // ThrottleReasonConcurrentQueryLimitExceeded is a ThrottleReason enum value + ThrottleReasonConcurrentQueryLimitExceeded = "CONCURRENT_QUERY_LIMIT_EXCEEDED" +) diff --git a/vendor/github.com/aws/aws-sdk-go/service/athena/athenaiface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/athena/athenaiface/interface.go new file mode 100644 index 00000000..fbf45987 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/athena/athenaiface/interface.go @@ -0,0 +1,117 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package athenaiface provides an interface to enable mocking the Amazon Athena service client +// for testing your code. +// +// It is important to note that this interface will have breaking changes +// when the service model is updated and adds new API operations, paginators, +// and waiters. +package athenaiface + +import ( + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/service/athena" +) + +// AthenaAPI provides an interface to enable mocking the +// athena.Athena service client's API operation, +// paginators, and waiters. This make unit testing your code that calls out +// to the SDK's service client's calls easier. +// +// The best way to use this interface is so the SDK's service client's calls +// can be stubbed out for unit testing your code with the SDK without needing +// to inject custom request handlers into the the SDK's request pipeline. +// +// // myFunc uses an SDK service client to make a request to +// // Amazon Athena. +// func myFunc(svc athenaiface.AthenaAPI) bool { +// // Make svc.BatchGetNamedQuery request +// } +// +// func main() { +// sess := session.New() +// svc := athena.New(sess) +// +// myFunc(svc) +// } +// +// In your _test.go file: +// +// // Define a mock struct to be used in your unit tests of myFunc. +// type mockAthenaClient struct { +// athenaiface.AthenaAPI +// } +// func (m *mockAthenaClient) BatchGetNamedQuery(input *athena.BatchGetNamedQueryInput) (*athena.BatchGetNamedQueryOutput, error) { +// // mock response/functionality +// } +// +// func TestMyFunc(t *testing.T) { +// // Setup Test +// mockSvc := &mockAthenaClient{} +// +// myfunc(mockSvc) +// +// // Verify myFunc's functionality +// } +// +// It is important to note that this interface will have breaking changes +// when the service model is updated and adds new API operations, paginators, +// and waiters. Its suggested to use the pattern above for testing, or using +// tooling to generate mocks to satisfy the interfaces. +type AthenaAPI interface { + BatchGetNamedQuery(*athena.BatchGetNamedQueryInput) (*athena.BatchGetNamedQueryOutput, error) + BatchGetNamedQueryWithContext(aws.Context, *athena.BatchGetNamedQueryInput, ...request.Option) (*athena.BatchGetNamedQueryOutput, error) + BatchGetNamedQueryRequest(*athena.BatchGetNamedQueryInput) (*request.Request, *athena.BatchGetNamedQueryOutput) + + BatchGetQueryExecution(*athena.BatchGetQueryExecutionInput) (*athena.BatchGetQueryExecutionOutput, error) + BatchGetQueryExecutionWithContext(aws.Context, *athena.BatchGetQueryExecutionInput, ...request.Option) (*athena.BatchGetQueryExecutionOutput, error) + BatchGetQueryExecutionRequest(*athena.BatchGetQueryExecutionInput) (*request.Request, *athena.BatchGetQueryExecutionOutput) + + CreateNamedQuery(*athena.CreateNamedQueryInput) (*athena.CreateNamedQueryOutput, error) + CreateNamedQueryWithContext(aws.Context, *athena.CreateNamedQueryInput, ...request.Option) (*athena.CreateNamedQueryOutput, error) + CreateNamedQueryRequest(*athena.CreateNamedQueryInput) (*request.Request, *athena.CreateNamedQueryOutput) + + DeleteNamedQuery(*athena.DeleteNamedQueryInput) (*athena.DeleteNamedQueryOutput, error) + DeleteNamedQueryWithContext(aws.Context, *athena.DeleteNamedQueryInput, ...request.Option) (*athena.DeleteNamedQueryOutput, error) + DeleteNamedQueryRequest(*athena.DeleteNamedQueryInput) (*request.Request, *athena.DeleteNamedQueryOutput) + + GetNamedQuery(*athena.GetNamedQueryInput) (*athena.GetNamedQueryOutput, error) + GetNamedQueryWithContext(aws.Context, *athena.GetNamedQueryInput, ...request.Option) (*athena.GetNamedQueryOutput, error) + GetNamedQueryRequest(*athena.GetNamedQueryInput) (*request.Request, *athena.GetNamedQueryOutput) + + GetQueryExecution(*athena.GetQueryExecutionInput) (*athena.GetQueryExecutionOutput, error) + GetQueryExecutionWithContext(aws.Context, *athena.GetQueryExecutionInput, ...request.Option) (*athena.GetQueryExecutionOutput, error) + GetQueryExecutionRequest(*athena.GetQueryExecutionInput) (*request.Request, *athena.GetQueryExecutionOutput) + + GetQueryResults(*athena.GetQueryResultsInput) (*athena.GetQueryResultsOutput, error) + GetQueryResultsWithContext(aws.Context, *athena.GetQueryResultsInput, ...request.Option) (*athena.GetQueryResultsOutput, error) + GetQueryResultsRequest(*athena.GetQueryResultsInput) (*request.Request, *athena.GetQueryResultsOutput) + + GetQueryResultsPages(*athena.GetQueryResultsInput, func(*athena.GetQueryResultsOutput, bool) bool) error + GetQueryResultsPagesWithContext(aws.Context, *athena.GetQueryResultsInput, func(*athena.GetQueryResultsOutput, bool) bool, ...request.Option) error + + ListNamedQueries(*athena.ListNamedQueriesInput) (*athena.ListNamedQueriesOutput, error) + ListNamedQueriesWithContext(aws.Context, *athena.ListNamedQueriesInput, ...request.Option) (*athena.ListNamedQueriesOutput, error) + ListNamedQueriesRequest(*athena.ListNamedQueriesInput) (*request.Request, *athena.ListNamedQueriesOutput) + + ListNamedQueriesPages(*athena.ListNamedQueriesInput, func(*athena.ListNamedQueriesOutput, bool) bool) error + ListNamedQueriesPagesWithContext(aws.Context, *athena.ListNamedQueriesInput, func(*athena.ListNamedQueriesOutput, bool) bool, ...request.Option) error + + ListQueryExecutions(*athena.ListQueryExecutionsInput) (*athena.ListQueryExecutionsOutput, error) + ListQueryExecutionsWithContext(aws.Context, *athena.ListQueryExecutionsInput, ...request.Option) (*athena.ListQueryExecutionsOutput, error) + ListQueryExecutionsRequest(*athena.ListQueryExecutionsInput) (*request.Request, *athena.ListQueryExecutionsOutput) + + ListQueryExecutionsPages(*athena.ListQueryExecutionsInput, func(*athena.ListQueryExecutionsOutput, bool) bool) error + ListQueryExecutionsPagesWithContext(aws.Context, *athena.ListQueryExecutionsInput, func(*athena.ListQueryExecutionsOutput, bool) bool, ...request.Option) error + + StartQueryExecution(*athena.StartQueryExecutionInput) (*athena.StartQueryExecutionOutput, error) + StartQueryExecutionWithContext(aws.Context, *athena.StartQueryExecutionInput, ...request.Option) (*athena.StartQueryExecutionOutput, error) + StartQueryExecutionRequest(*athena.StartQueryExecutionInput) (*request.Request, *athena.StartQueryExecutionOutput) + + StopQueryExecution(*athena.StopQueryExecutionInput) (*athena.StopQueryExecutionOutput, error) + StopQueryExecutionWithContext(aws.Context, *athena.StopQueryExecutionInput, ...request.Option) (*athena.StopQueryExecutionOutput, error) + StopQueryExecutionRequest(*athena.StopQueryExecutionInput) (*request.Request, *athena.StopQueryExecutionOutput) +} + +var _ AthenaAPI = (*athena.Athena)(nil) diff --git a/vendor/github.com/aws/aws-sdk-go/service/athena/doc.go b/vendor/github.com/aws/aws-sdk-go/service/athena/doc.go new file mode 100644 index 00000000..d4a51b74 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/athena/doc.go @@ -0,0 +1,91 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package athena provides the client and types for making API +// requests to Amazon Athena. +// +// Amazon Athena is an interactive query service that lets you use standard +// SQL to analyze data directly in Amazon S3. You can point Athena at your data +// in Amazon S3 and run ad-hoc queries and get results in seconds. Athena is +// serverless, so there is no infrastructure to set up or manage. You pay only +// for the queries you run. Athena scales automatically—executing queries in +// parallel—so results are fast, even with large datasets and complex queries. +// For more information, see What is Amazon Athena (http://docs.aws.amazon.com/athena/latest/ug/what-is.html) +// in the Amazon Athena User Guide. +// +// For code samples using the AWS SDK for Java, see Examples and Code Samples +// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon +// Athena User Guide. +// +// See https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18 for more information on this service. +// +// See athena package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/athena/ +// +// Using the Client +// +// To use the client for Amazon Athena 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 := athena.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 Athena client Athena for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/athena/#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.BatchGetNamedQuery(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("BatchGetNamedQuery 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.BatchGetNamedQueryWithContext(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 athena diff --git a/vendor/github.com/aws/aws-sdk-go/service/athena/errors.go b/vendor/github.com/aws/aws-sdk-go/service/athena/errors.go new file mode 100644 index 00000000..4060e744 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/athena/errors.go @@ -0,0 +1,26 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package athena + +const ( + + // ErrCodeInternalServerException for service response error code + // "InternalServerException". + // + // Indicates a platform issue, which may be due to a transient condition or + // outage. + ErrCodeInternalServerException = "InternalServerException" + + // ErrCodeInvalidRequestException for service response error code + // "InvalidRequestException". + // + // Indicates that something is wrong with the input to the request. For example, + // a required parameter may be missing or out of range. + ErrCodeInvalidRequestException = "InvalidRequestException" + + // ErrCodeTooManyRequestsException for service response error code + // "TooManyRequestsException". + // + // Indicates that the request was throttled. + ErrCodeTooManyRequestsException = "TooManyRequestsException" +) diff --git a/vendor/github.com/aws/aws-sdk-go/service/athena/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/athena/examples_test.go new file mode 100644 index 00000000..8ec43cdc --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/athena/examples_test.go @@ -0,0 +1,272 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package athena_test + +import ( + "bytes" + "fmt" + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/session" + "github.com/aws/aws-sdk-go/service/athena" +) + +var _ time.Duration +var _ bytes.Buffer + +func ExampleAthena_BatchGetNamedQuery() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.BatchGetNamedQueryInput{ + NamedQueryIds: []*string{ // Required + aws.String("NamedQueryId"), // Required + // More values... + }, + } + resp, err := svc.BatchGetNamedQuery(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_BatchGetQueryExecution() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.BatchGetQueryExecutionInput{ + QueryExecutionIds: []*string{ // Required + aws.String("QueryExecutionId"), // Required + // More values... + }, + } + resp, err := svc.BatchGetQueryExecution(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_CreateNamedQuery() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.CreateNamedQueryInput{ + Database: aws.String("DatabaseString"), // Required + Name: aws.String("NameString"), // Required + QueryString: aws.String("QueryString"), // Required + ClientRequestToken: aws.String("IdempotencyToken"), + Description: aws.String("DescriptionString"), + } + resp, err := svc.CreateNamedQuery(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_DeleteNamedQuery() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.DeleteNamedQueryInput{ + NamedQueryId: aws.String("NamedQueryId"), // Required + } + resp, err := svc.DeleteNamedQuery(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_GetNamedQuery() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.GetNamedQueryInput{ + NamedQueryId: aws.String("NamedQueryId"), // Required + } + resp, err := svc.GetNamedQuery(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_GetQueryExecution() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.GetQueryExecutionInput{ + QueryExecutionId: aws.String("QueryExecutionId"), // Required + } + resp, err := svc.GetQueryExecution(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_GetQueryResults() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.GetQueryResultsInput{ + QueryExecutionId: aws.String("QueryExecutionId"), // Required + MaxResults: aws.Int64(1), + NextToken: aws.String("Token"), + } + resp, err := svc.GetQueryResults(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_ListNamedQueries() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.ListNamedQueriesInput{ + MaxResults: aws.Int64(1), + NextToken: aws.String("Token"), + } + resp, err := svc.ListNamedQueries(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_ListQueryExecutions() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.ListQueryExecutionsInput{ + MaxResults: aws.Int64(1), + NextToken: aws.String("Token"), + } + resp, err := svc.ListQueryExecutions(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_StartQueryExecution() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.StartQueryExecutionInput{ + QueryString: aws.String("QueryString"), // Required + ResultConfiguration: &athena.ResultConfiguration{ // Required + OutputLocation: aws.String("String"), // Required + EncryptionConfiguration: &athena.EncryptionConfiguration{ + EncryptionOption: aws.String("EncryptionOption"), // Required + KmsKey: aws.String("String"), + }, + }, + ClientRequestToken: aws.String("IdempotencyToken"), + QueryExecutionContext: &athena.QueryExecutionContext{ + Database: aws.String("DatabaseString"), + }, + } + resp, err := svc.StartQueryExecution(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + +func ExampleAthena_StopQueryExecution() { + sess := session.Must(session.NewSession()) + + svc := athena.New(sess) + + params := &athena.StopQueryExecutionInput{ + QueryExecutionId: aws.String("QueryExecutionId"), // Required + } + resp, err := svc.StopQueryExecution(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} diff --git a/vendor/github.com/aws/aws-sdk-go/service/athena/service.go b/vendor/github.com/aws/aws-sdk-go/service/athena/service.go new file mode 100644 index 00000000..c1fd29b0 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/athena/service.go @@ -0,0 +1,95 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package athena + +import ( + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/client" + "github.com/aws/aws-sdk-go/aws/client/metadata" + "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/aws/signer/v4" + "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" +) + +// Athena provides the API operation methods for making requests to +// Amazon Athena. See this package's package overview docs +// for details on the service. +// +// Athena methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. +type Athena struct { + *client.Client +} + +// Used for custom client initialization logic +var initClient func(*client.Client) + +// Used for custom request initialization logic +var initRequest func(*request.Request) + +// Service information constants +const ( + ServiceName = "athena" // Service endpoint prefix API calls made to. + EndpointsID = ServiceName // Service ID for Regions and Endpoints metadata. +) + +// New creates a new instance of the Athena client with a session. +// If additional configuration is needed for the client instance use the optional +// aws.Config parameter to add your extra config. +// +// Example: +// // Create a Athena client from just a session. +// svc := athena.New(mySession) +// +// // Create a Athena client with additional configuration +// svc := athena.New(mySession, aws.NewConfig().WithRegion("us-west-2")) +func New(p client.ConfigProvider, cfgs ...*aws.Config) *Athena { + c := p.ClientConfig(EndpointsID, cfgs...) + return newClient(*c.Config, c.Handlers, c.Endpoint, c.SigningRegion, c.SigningName) +} + +// newClient creates, initializes and returns a new service client instance. +func newClient(cfg aws.Config, handlers request.Handlers, endpoint, signingRegion, signingName string) *Athena { + svc := &Athena{ + Client: client.New( + cfg, + metadata.ClientInfo{ + ServiceName: ServiceName, + SigningName: signingName, + SigningRegion: signingRegion, + Endpoint: endpoint, + APIVersion: "2017-05-18", + JSONVersion: "1.1", + TargetPrefix: "AmazonAthena", + }, + handlers, + ), + } + + // Handlers + svc.Handlers.Sign.PushBackNamed(v4.SignRequestHandler) + svc.Handlers.Build.PushBackNamed(jsonrpc.BuildHandler) + svc.Handlers.Unmarshal.PushBackNamed(jsonrpc.UnmarshalHandler) + svc.Handlers.UnmarshalMeta.PushBackNamed(jsonrpc.UnmarshalMetaHandler) + svc.Handlers.UnmarshalError.PushBackNamed(jsonrpc.UnmarshalErrorHandler) + + // Run custom client initialization if present + if initClient != nil { + initClient(svc.Client) + } + + return svc +} + +// newRequest creates a new request for a Athena operation and runs any +// custom request initialization. +func (c *Athena) newRequest(op *request.Operation, params, data interface{}) *request.Request { + req := c.NewRequest(op, params, data) + + // Run custom request initialization if present + if initRequest != nil { + initRequest(req) + } + + return req +} diff --git a/vendor/github.com/aws/aws-sdk-go/service/autoscaling/api.go b/vendor/github.com/aws/aws-sdk-go/service/autoscaling/api.go index a4512f98..d20cf3c0 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/autoscaling/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/autoscaling/api.go @@ -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 ( @@ -68,7 +67,7 @@ func (c *AutoScaling) AttachInstancesRequest(input *AttachInstancesInput) (req * // being attached plus the desired capacity of the group exceeds the maximum // size of the group, the operation fails. // -// If there is a Classic load balancer attached to your Auto Scaling group, +// If there is a Classic Load Balancer attached to your Auto Scaling group, // the instances are also registered with the load balancer. If there are target // groups attached to your Auto Scaling group, the instances are also registered // with the target groups. @@ -244,10 +243,10 @@ func (c *AutoScaling) AttachLoadBalancersRequest(input *AttachLoadBalancersInput // AttachLoadBalancers API operation for Auto Scaling. // -// Attaches one or more Classic load balancers to the specified Auto Scaling +// Attaches one or more Classic Load Balancers to the specified Auto Scaling // group. // -// To attach an Application load balancer instead, see AttachLoadBalancerTargetGroups. +// To attach an Application Load Balancer instead, see AttachLoadBalancerTargetGroups. // // To describe the load balancers for an Auto Scaling group, use DescribeLoadBalancers. // To detach the load balancer from the Auto Scaling group, use DetachLoadBalancers. @@ -2259,8 +2258,8 @@ func (c *AutoScaling) DescribeLoadBalancersRequest(input *DescribeLoadBalancersI // // Describes the load balancers for the specified Auto Scaling group. // -// Note that this operation describes only Classic load balancers. If you have -// Application load balancers, use DescribeLoadBalancerTargetGroups instead. +// Note that this operation describes only Classic Load Balancers. If you have +// Application Load Balancers, use DescribeLoadBalancerTargetGroups instead. // // 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 @@ -3300,13 +3299,13 @@ func (c *AutoScaling) DetachInstancesRequest(input *DetachInstancesInput) (req * // // Removes one or more instances from the specified Auto Scaling group. // -// After the instances are detached, you can manage them independently from -// the rest of the Auto Scaling group. +// After the instances are detached, you can manage them independent of the +// Auto Scaling group. // // If you do not specify the option to decrement the desired capacity, Auto // Scaling launches instances to replace the ones that are detached. // -// If there is a Classic load balancer attached to the Auto Scaling group, the +// If there is a Classic Load Balancer attached to the Auto Scaling group, the // instances are deregistered from the load balancer. If there are target groups // attached to the Auto Scaling group, the instances are deregistered from the // target groups. @@ -3475,11 +3474,11 @@ func (c *AutoScaling) DetachLoadBalancersRequest(input *DetachLoadBalancersInput // DetachLoadBalancers API operation for Auto Scaling. // -// Detaches one or more Classic load balancers from the specified Auto Scaling +// Detaches one or more Classic Load Balancers from the specified Auto Scaling // group. // -// Note that this operation detaches only Classic load balancers. If you have -// Application load balancers, use DetachLoadBalancerTargetGroups instead. +// Note that this operation detaches only Classic Load Balancers. If you have +// Application Load Balancers, use DetachLoadBalancerTargetGroups instead. // // When you detach a load balancer, it enters the Removing state while deregistering // the instances in the group. When all instances are deregistered, then you @@ -3733,9 +3732,10 @@ func (c *AutoScaling) EnterStandbyRequest(input *EnterStandbyInput) (req *reques // EnterStandby API operation for Auto Scaling. // -// Moves the specified instances into Standby mode. +// Moves the specified instances into the standby state. // -// For more information, see Auto Scaling Lifecycle (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html) +// For more information, see Temporarily Removing Instances from Your Auto Scaling +// Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html) // in the Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -3904,9 +3904,10 @@ func (c *AutoScaling) ExitStandbyRequest(input *ExitStandbyInput) (req *request. // ExitStandby API operation for Auto Scaling. // -// Moves the specified instances out of Standby mode. +// Moves the specified instances out of the standby state. // -// For more information, see Auto Scaling Lifecycle (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html) +// For more information, see Temporarily Removing Instances from Your Auto Scaling +// Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html) // in the Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -5040,15 +5041,14 @@ func (c *AutoScaling) UpdateAutoScalingGroupRequest(input *UpdateAutoScalingGrou // // Updates the configuration for the specified Auto Scaling group. // +// The new settings take effect on any scaling activities after this call returns. +// Scaling activities that are currently in progress aren't affected. +// // To update an Auto Scaling group with a launch configuration with InstanceMonitoring -// set to False, you must first disable the collection of group metrics. Otherwise, +// set to false, you must first disable the collection of group metrics. Otherwise, // you will get an error. If you have previously enabled the collection of group // metrics, you can disable it using DisableMetricsCollection. // -// The new settings are registered upon the completion of this call. Any launch -// configuration settings take effect on any triggers after this call returns. -// Scaling activities that are currently in progress aren't affected. -// // Note the following: // // * If you specify a new value for MinSize without specifying a value for @@ -5282,7 +5282,6 @@ func (s *Alarm) SetAlarmName(v string) *Alarm { return s } -// Contains the parameters for AttachInstances. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachInstancesQuery type AttachInstancesInput struct { _ struct{} `type:"structure"` @@ -5349,7 +5348,6 @@ func (s AttachInstancesOutput) GoString() string { return s.String() } -// Contains the parameters for AttachLoadBalancerTargetGroups. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancerTargetGroupsType type AttachLoadBalancerTargetGroupsInput struct { _ struct{} `type:"structure"` @@ -5421,7 +5419,6 @@ func (s AttachLoadBalancerTargetGroupsOutput) GoString() string { return s.String() } -// Contains the parameters for AttachLoadBalancers. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancersType type AttachLoadBalancersInput struct { _ struct{} `type:"structure"` @@ -5478,7 +5475,6 @@ func (s *AttachLoadBalancersInput) SetLoadBalancerNames(v []*string) *AttachLoad return s } -// Contains the output of AttachLoadBalancers. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancersResultType type AttachLoadBalancersOutput struct { _ struct{} `type:"structure"` @@ -5576,7 +5572,6 @@ func (s *BlockDeviceMapping) SetVirtualName(v string) *BlockDeviceMapping { return s } -// Contains the parameters for CompleteLifecycleAction. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CompleteLifecycleActionType type CompleteLifecycleActionInput struct { _ struct{} `type:"structure"` @@ -5677,7 +5672,6 @@ func (s *CompleteLifecycleActionInput) SetLifecycleHookName(v string) *CompleteL return s } -// Contains the output of CompleteLifecycleAction. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CompleteLifecycleActionAnswer type CompleteLifecycleActionOutput struct { _ struct{} `type:"structure"` @@ -5693,7 +5687,6 @@ func (s CompleteLifecycleActionOutput) GoString() string { return s.String() } -// Contains the parameters for CreateAutoScalingGroup. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroupType type CreateAutoScalingGroupInput struct { _ struct{} `type:"structure"` @@ -5717,7 +5710,8 @@ type CreateAutoScalingGroupInput struct { // The number of EC2 instances that should be running in the group. This number // must be greater than or equal to the minimum size of the group and less than - // or equal to the maximum size of the group. + // or equal to the maximum size of the group. If you do not specify a desired + // capacity, the default is the minimum size of the group. DesiredCapacity *int64 `type:"integer"` // The amount of time, in seconds, that Auto Scaling waits before checking the @@ -5755,7 +5749,7 @@ type CreateAutoScalingGroupInput struct { // instead of a launch configuration. LaunchConfigurationName *string `min:"1" type:"string"` - // One or more Classic load balancers. To specify an Application load balancer, + // One or more Classic Load Balancers. To specify an Application Load Balancer, // use TargetGroupARNs instead. // // For more information, see Using a Load Balancer With an Auto Scaling Group @@ -5987,7 +5981,6 @@ func (s CreateAutoScalingGroupOutput) GoString() string { return s.String() } -// Contains the parameters for CreateLaunchConfiguration. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateLaunchConfigurationType type CreateLaunchConfigurationInput struct { _ struct{} `type:"structure"` @@ -6044,14 +6037,18 @@ type CreateLaunchConfigurationInput struct { IamInstanceProfile *string `min:"1" type:"string"` // The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances. + // + // If you do not specify InstanceId, you must specify ImageId. + // // For more information, see Finding an AMI (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html) // in the Amazon Elastic Compute Cloud User Guide. ImageId *string `min:"1" type:"string"` - // The ID of the instance to use to create the launch configuration. + // The ID of the instance to use to create the launch configuration. The new + // launch configuration derives attributes from the instance, with the exception + // of the block device mapping. // - // The new launch configuration derives attributes from the instance, with the - // exception of the block device mapping. + // If you do not specify InstanceId, you must specify both ImageId and InstanceType. // // To create a launch configuration with a block device mapping or override // any other instance attributes, specify them as part of the same request. @@ -6062,11 +6059,15 @@ type CreateLaunchConfigurationInput struct { InstanceId *string `min:"1" type:"string"` // Enables detailed monitoring (true) or basic monitoring (false) for the Auto - // Scaling instances. + // Scaling instances. The default is true. InstanceMonitoring *InstanceMonitoring `type:"structure"` - // The instance type of the EC2 instance. For information about available instance - // types, see Available Instance Types (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) + // The instance type of the EC2 instance. + // + // If you do not specify InstanceId, you must specify InstanceType. + // + // For information about available instance types, see Available Instance Types + // (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) // in the Amazon Elastic Compute Cloud User Guide. InstanceType *string `min:"1" type:"string"` @@ -6317,7 +6318,6 @@ func (s CreateLaunchConfigurationOutput) GoString() string { return s.String() } -// Contains the parameters for CreateOrUpdateTags. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateOrUpdateTagsType type CreateOrUpdateTagsInput struct { _ struct{} `type:"structure"` @@ -6382,7 +6382,6 @@ func (s CreateOrUpdateTagsOutput) GoString() string { return s.String() } -// Contains the parameters for DeleteAutoScalingGroup. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteAutoScalingGroupType type DeleteAutoScalingGroupInput struct { _ struct{} `type:"structure"` @@ -6451,7 +6450,6 @@ func (s DeleteAutoScalingGroupOutput) GoString() string { return s.String() } -// Contains the parameters for DeleteLaunchConfiguration. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfigurationNameType type DeleteLaunchConfigurationInput struct { _ struct{} `type:"structure"` @@ -6509,7 +6507,6 @@ func (s DeleteLaunchConfigurationOutput) GoString() string { return s.String() } -// Contains the parameters for DeleteLifecycleHook. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLifecycleHookType type DeleteLifecycleHookInput struct { _ struct{} `type:"structure"` @@ -6569,7 +6566,6 @@ func (s *DeleteLifecycleHookInput) SetLifecycleHookName(v string) *DeleteLifecyc return s } -// Contains the output of DeleteLifecycleHook. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLifecycleHookAnswer type DeleteLifecycleHookOutput struct { _ struct{} `type:"structure"` @@ -6585,7 +6581,6 @@ func (s DeleteLifecycleHookOutput) GoString() string { return s.String() } -// Contains the parameters for DeleteNotificationConfiguration. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteNotificationConfigurationType type DeleteNotificationConfigurationInput struct { _ struct{} `type:"structure"` @@ -6661,7 +6656,6 @@ func (s DeleteNotificationConfigurationOutput) GoString() string { return s.String() } -// Contains the parameters for DeletePolicy. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeletePolicyType type DeletePolicyInput struct { _ struct{} `type:"structure"` @@ -6731,7 +6725,6 @@ func (s DeletePolicyOutput) GoString() string { return s.String() } -// Contains the parameters for DeleteScheduledAction. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteScheduledActionType type DeleteScheduledActionInput struct { _ struct{} `type:"structure"` @@ -6806,7 +6799,6 @@ func (s DeleteScheduledActionOutput) GoString() string { return s.String() } -// Contains the parameters for DeleteTags. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteTagsType type DeleteTagsInput struct { _ struct{} `type:"structure"` @@ -6886,7 +6878,6 @@ func (s DescribeAccountLimitsInput) GoString() string { return s.String() } -// Contains the parameters for DescribeAccountLimits. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAccountLimitsAnswer type DescribeAccountLimitsOutput struct { _ struct{} `type:"structure"` @@ -6955,7 +6946,6 @@ func (s DescribeAdjustmentTypesInput) GoString() string { return s.String() } -// Contains the parameters for DescribeAdjustmentTypes. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAdjustmentTypesAnswer type DescribeAdjustmentTypesOutput struct { _ struct{} `type:"structure"` @@ -6980,7 +6970,6 @@ func (s *DescribeAdjustmentTypesOutput) SetAdjustmentTypes(v []*AdjustmentType) return s } -// Contains the parameters for DescribeAutoScalingGroups. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/GroupNamesType type DescribeAutoScalingGroupsInput struct { _ struct{} `type:"structure"` @@ -6989,7 +6978,8 @@ type DescribeAutoScalingGroupsInput struct { // described. AutoScalingGroupNames []*string `type:"list"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7025,7 +7015,6 @@ func (s *DescribeAutoScalingGroupsInput) SetNextToken(v string) *DescribeAutoSca return s } -// Contains the output for DescribeAutoScalingGroups. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/GroupsType type DescribeAutoScalingGroupsOutput struct { _ struct{} `type:"structure"` @@ -7062,7 +7051,6 @@ func (s *DescribeAutoScalingGroupsOutput) SetNextToken(v string) *DescribeAutoSc return s } -// Contains the parameters for DescribeAutoScalingInstances. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingInstancesType type DescribeAutoScalingInstancesInput struct { _ struct{} `type:"structure"` @@ -7072,7 +7060,8 @@ type DescribeAutoScalingInstancesInput struct { // not exist, it is ignored with no error. InstanceIds []*string `type:"list"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7108,7 +7097,6 @@ func (s *DescribeAutoScalingInstancesInput) SetNextToken(v string) *DescribeAuto return s } -// Contains the output of DescribeAutoScalingInstances. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstancesType type DescribeAutoScalingInstancesOutput struct { _ struct{} `type:"structure"` @@ -7158,7 +7146,6 @@ func (s DescribeAutoScalingNotificationTypesInput) GoString() string { return s.String() } -// Contains the output of DescribeAutoScalingNotificationTypes. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingNotificationTypesAnswer type DescribeAutoScalingNotificationTypesOutput struct { _ struct{} `type:"structure"` @@ -7183,7 +7170,6 @@ func (s *DescribeAutoScalingNotificationTypesOutput) SetAutoScalingNotificationT return s } -// Contains the parameters for DescribeLaunchConfigurations. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfigurationNamesType type DescribeLaunchConfigurationsInput struct { _ struct{} `type:"structure"` @@ -7192,7 +7178,8 @@ type DescribeLaunchConfigurationsInput struct { // are described. LaunchConfigurationNames []*string `type:"list"` - // The maximum number of items to return with this call. The default is 100. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7228,7 +7215,6 @@ func (s *DescribeLaunchConfigurationsInput) SetNextToken(v string) *DescribeLaun return s } -// Contains the output of DescribeLaunchConfigurations. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfigurationsType type DescribeLaunchConfigurationsOutput struct { _ struct{} `type:"structure"` @@ -7280,7 +7266,6 @@ func (s DescribeLifecycleHookTypesInput) GoString() string { return s.String() } -// Contains the output of DescribeLifecycleHookTypes. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHookTypesAnswer type DescribeLifecycleHookTypesOutput struct { _ struct{} `type:"structure"` @@ -7305,7 +7290,6 @@ func (s *DescribeLifecycleHookTypesOutput) SetLifecycleHookTypes(v []*string) *D return s } -// Contains the parameters for DescribeLifecycleHooks. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHooksType type DescribeLifecycleHooksInput struct { _ struct{} `type:"structure"` @@ -7358,7 +7342,6 @@ func (s *DescribeLifecycleHooksInput) SetLifecycleHookNames(v []*string) *Descri return s } -// Contains the output of DescribeLifecycleHooks. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHooksAnswer type DescribeLifecycleHooksOutput struct { _ struct{} `type:"structure"` @@ -7383,7 +7366,6 @@ func (s *DescribeLifecycleHooksOutput) SetLifecycleHooks(v []*LifecycleHook) *De return s } -// Contains the parameters for DescribeLoadBalancerTargetGroups. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancerTargetGroupsRequest type DescribeLoadBalancerTargetGroupsInput struct { _ struct{} `type:"structure"` @@ -7393,7 +7375,8 @@ type DescribeLoadBalancerTargetGroupsInput struct { // AutoScalingGroupName is a required field AutoScalingGroupName *string `min:"1" type:"string" required:"true"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7445,7 +7428,6 @@ func (s *DescribeLoadBalancerTargetGroupsInput) SetNextToken(v string) *Describe return s } -// Contains the output of DescribeLoadBalancerTargetGroups. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancerTargetGroupsResponse type DescribeLoadBalancerTargetGroupsOutput struct { _ struct{} `type:"structure"` @@ -7480,7 +7462,6 @@ func (s *DescribeLoadBalancerTargetGroupsOutput) SetNextToken(v string) *Describ return s } -// Contains the parameters for DescribeLoadBalancers. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancersRequest type DescribeLoadBalancersInput struct { _ struct{} `type:"structure"` @@ -7490,7 +7471,8 @@ type DescribeLoadBalancersInput struct { // AutoScalingGroupName is a required field AutoScalingGroupName *string `min:"1" type:"string" required:"true"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7542,7 +7524,6 @@ func (s *DescribeLoadBalancersInput) SetNextToken(v string) *DescribeLoadBalance return s } -// Contains the output of DescribeLoadBalancers. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancersResponse type DescribeLoadBalancersOutput struct { _ struct{} `type:"structure"` @@ -7592,7 +7573,6 @@ func (s DescribeMetricCollectionTypesInput) GoString() string { return s.String() } -// Contains the output of DescribeMetricsCollectionTypes. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeMetricCollectionTypesAnswer type DescribeMetricCollectionTypesOutput struct { _ struct{} `type:"structure"` @@ -7626,7 +7606,6 @@ func (s *DescribeMetricCollectionTypesOutput) SetMetrics(v []*MetricCollectionTy return s } -// Contains the parameters for DescribeNotificationConfigurations. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeNotificationConfigurationsType type DescribeNotificationConfigurationsInput struct { _ struct{} `type:"structure"` @@ -7634,7 +7613,8 @@ type DescribeNotificationConfigurationsInput struct { // The name of the group. AutoScalingGroupNames []*string `type:"list"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7670,7 +7650,6 @@ func (s *DescribeNotificationConfigurationsInput) SetNextToken(v string) *Descri return s } -// Contains the output from DescribeNotificationConfigurations. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeNotificationConfigurationsAnswer type DescribeNotificationConfigurationsOutput struct { _ struct{} `type:"structure"` @@ -7707,7 +7686,6 @@ func (s *DescribeNotificationConfigurationsOutput) SetNotificationConfigurations return s } -// Contains the parameters for DescribePolicies. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribePoliciesType type DescribePoliciesInput struct { _ struct{} `type:"structure"` @@ -7715,7 +7693,8 @@ type DescribePoliciesInput struct { // The name of the group. AutoScalingGroupName *string `min:"1" type:"string"` - // The maximum number of items to be returned with each call. + // The maximum number of items to be returned with each call. The default value + // is 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7785,7 +7764,6 @@ func (s *DescribePoliciesInput) SetPolicyTypes(v []*string) *DescribePoliciesInp return s } -// Contains the output of DescribePolicies. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PoliciesType type DescribePoliciesOutput struct { _ struct{} `type:"structure"` @@ -7820,7 +7798,6 @@ func (s *DescribePoliciesOutput) SetScalingPolicies(v []*ScalingPolicy) *Describ return s } -// Contains the parameters for DescribeScalingActivities. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScalingActivitiesType type DescribeScalingActivitiesInput struct { _ struct{} `type:"structure"` @@ -7835,7 +7812,8 @@ type DescribeScalingActivitiesInput struct { // The name of the group. AutoScalingGroupName *string `min:"1" type:"string"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -7890,7 +7868,6 @@ func (s *DescribeScalingActivitiesInput) SetNextToken(v string) *DescribeScaling return s } -// Contains the output of DescribeScalingActivities. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ActivitiesType type DescribeScalingActivitiesOutput struct { _ struct{} `type:"structure"` @@ -7943,7 +7920,6 @@ func (s DescribeScalingProcessTypesInput) GoString() string { return s.String() } -// Contains the output of DescribeScalingProcessTypes. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ProcessesType type DescribeScalingProcessTypesOutput struct { _ struct{} `type:"structure"` @@ -7968,7 +7944,6 @@ func (s *DescribeScalingProcessTypesOutput) SetProcesses(v []*ProcessType) *Desc return s } -// Contains the parameters for DescribeScheduledActions. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScheduledActionsType type DescribeScheduledActionsInput struct { _ struct{} `type:"structure"` @@ -7980,7 +7955,8 @@ type DescribeScheduledActionsInput struct { // provided, this parameter is ignored. EndTime *time.Time `type:"timestamp" timestampFormat:"iso8601"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -8060,7 +8036,6 @@ func (s *DescribeScheduledActionsInput) SetStartTime(v time.Time) *DescribeSched return s } -// Contains the output of DescribeScheduledActions. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ScheduledActionsType type DescribeScheduledActionsOutput struct { _ struct{} `type:"structure"` @@ -8095,7 +8070,6 @@ func (s *DescribeScheduledActionsOutput) SetScheduledUpdateGroupActions(v []*Sch return s } -// Contains the parameters for DescribeTags. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTagsType type DescribeTagsInput struct { _ struct{} `type:"structure"` @@ -8103,7 +8077,8 @@ type DescribeTagsInput struct { // A filter used to scope the tags to return. Filters []*Filter `type:"list"` - // The maximum number of items to return with this call. + // The maximum number of items to return with this call. The default value is + // 50 and the maximum value is 100. MaxRecords *int64 `type:"integer"` // The token for the next set of items to return. (You received this token from @@ -8139,7 +8114,6 @@ func (s *DescribeTagsInput) SetNextToken(v string) *DescribeTagsInput { return s } -// Contains the output of DescribeTags. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/TagsType type DescribeTagsOutput struct { _ struct{} `type:"structure"` @@ -8189,7 +8163,6 @@ func (s DescribeTerminationPolicyTypesInput) GoString() string { return s.String() } -// Contains the output of DescribeTerminationPolicyTypes. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTerminationPolicyTypesAnswer type DescribeTerminationPolicyTypesOutput struct { _ struct{} `type:"structure"` @@ -8215,7 +8188,6 @@ func (s *DescribeTerminationPolicyTypesOutput) SetTerminationPolicyTypes(v []*st return s } -// Contains the parameters for DetachInstances. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachInstancesQuery type DetachInstancesInput struct { _ struct{} `type:"structure"` @@ -8282,7 +8254,6 @@ func (s *DetachInstancesInput) SetShouldDecrementDesiredCapacity(v bool) *Detach return s } -// Contains the output of DetachInstances. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachInstancesAnswer type DetachInstancesOutput struct { _ struct{} `type:"structure"` @@ -8378,7 +8349,6 @@ func (s DetachLoadBalancerTargetGroupsOutput) GoString() string { return s.String() } -// Contains the parameters for DetachLoadBalancers. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancersType type DetachLoadBalancersInput struct { _ struct{} `type:"structure"` @@ -8435,7 +8405,6 @@ func (s *DetachLoadBalancersInput) SetLoadBalancerNames(v []*string) *DetachLoad return s } -// Contains the output for DetachLoadBalancers. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancersResultType type DetachLoadBalancersOutput struct { _ struct{} `type:"structure"` @@ -8451,7 +8420,6 @@ func (s DetachLoadBalancersOutput) GoString() string { return s.String() } -// Contains the parameters for DisableMetricsCollection. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DisableMetricsCollectionQuery type DisableMetricsCollectionInput struct { _ struct{} `type:"structure"` @@ -8648,7 +8616,6 @@ func (s *Ebs) SetVolumeType(v string) *Ebs { return s } -// Contains the parameters for EnableMetricsCollection. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnableMetricsCollectionQuery type EnableMetricsCollectionInput struct { _ struct{} `type:"structure"` @@ -8800,7 +8767,6 @@ func (s *EnabledMetric) SetMetric(v string) *EnabledMetric { return s } -// Contains the parameters for EnteStandby. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnterStandbyQuery type EnterStandbyInput struct { _ struct{} `type:"structure"` @@ -8870,7 +8836,6 @@ func (s *EnterStandbyInput) SetShouldDecrementDesiredCapacity(v bool) *EnterStan return s } -// Contains the output of EnterStandby. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnterStandbyAnswer type EnterStandbyOutput struct { _ struct{} `type:"structure"` @@ -8895,7 +8860,6 @@ func (s *EnterStandbyOutput) SetActivities(v []*Activity) *EnterStandbyOutput { return s } -// Contains the parameters for ExecutePolicy. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExecutePolicyType type ExecutePolicyInput struct { _ struct{} `type:"structure"` @@ -9012,7 +8976,6 @@ func (s ExecutePolicyOutput) GoString() string { return s.String() } -// Contains the parameters for ExitStandby. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExitStandbyQuery type ExitStandbyInput struct { _ struct{} `type:"structure"` @@ -9064,7 +9027,6 @@ func (s *ExitStandbyInput) SetInstanceIds(v []*string) *ExitStandbyInput { return s } -// Contains the parameters for ExitStandby. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExitStandbyAnswer type ExitStandbyOutput struct { _ struct{} `type:"structure"` @@ -9475,7 +9437,8 @@ type InstanceDetails struct { // InstanceId is a required field InstanceId *string `min:"1" type:"string" required:"true"` - // The launch configuration associated with the instance. + // The launch configuration used to launch the instance. This value is not available + // if you attached the instance to the Auto Scaling group. // // LaunchConfigurationName is a required field LaunchConfigurationName *string `min:"1" type:"string" required:"true"` @@ -9546,12 +9509,12 @@ func (s *InstanceDetails) SetProtectedFromScaleIn(v bool) *InstanceDetails { return s } -// Describes whether instance monitoring is enabled. +// Describes whether detailed monitoring is enabled for the Auto Scaling instances. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstanceMonitoring type InstanceMonitoring struct { _ struct{} `type:"structure"` - // If True, instance monitoring is enabled. + // If true, detailed monitoring is enabled. Otherwise, basic monitoring is enabled. Enabled *bool `type:"boolean"` } @@ -9909,7 +9872,7 @@ func (s *LifecycleHook) SetRoleARN(v string) *LifecycleHook { return s } -// Describes the state of a Classic load balancer. +// Describes the state of a Classic Load Balancer. // // If you specify a load balancer when creating the Auto Scaling group, the // state of the load balancer is InService. @@ -10190,7 +10153,6 @@ func (s *ProcessType) SetProcessName(v string) *ProcessType { return s } -// Contains the parameters for PutLifecycleHook. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutLifecycleHookType type PutLifecycleHookInput struct { _ struct{} `type:"structure"` @@ -10336,7 +10298,6 @@ func (s *PutLifecycleHookInput) SetRoleARN(v string) *PutLifecycleHookInput { return s } -// Contains the output of PutLifecycleHook. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutLifecycleHookAnswer type PutLifecycleHookOutput struct { _ struct{} `type:"structure"` @@ -10352,7 +10313,6 @@ func (s PutLifecycleHookOutput) GoString() string { return s.String() } -// Contains the parameters for PutNotificationConfiguration. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutNotificationConfigurationType type PutNotificationConfigurationInput struct { _ struct{} `type:"structure"` @@ -10443,7 +10403,6 @@ func (s PutNotificationConfigurationOutput) GoString() string { return s.String() } -// Contains the parameters for PutScalingPolicy. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScalingPolicyType type PutScalingPolicyInput struct { _ struct{} `type:"structure"` @@ -10640,7 +10599,6 @@ func (s *PutScalingPolicyInput) SetStepAdjustments(v []*StepAdjustment) *PutScal return s } -// Contains the output of PutScalingPolicy. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PolicyARNType type PutScalingPolicyOutput struct { _ struct{} `type:"structure"` @@ -10665,7 +10623,6 @@ func (s *PutScalingPolicyOutput) SetPolicyARN(v string) *PutScalingPolicyOutput return s } -// Contains the parameters for PutScheduledUpdateGroupAction. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScheduledUpdateGroupActionType type PutScheduledUpdateGroupActionInput struct { _ struct{} `type:"structure"` @@ -10815,7 +10772,6 @@ func (s PutScheduledUpdateGroupActionOutput) GoString() string { return s.String() } -// Contains the parameters for RecordLifecycleActionHeartbeat. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RecordLifecycleActionHeartbeatType type RecordLifecycleActionHeartbeatInput struct { _ struct{} `type:"structure"` @@ -10901,7 +10857,6 @@ func (s *RecordLifecycleActionHeartbeatInput) SetLifecycleHookName(v string) *Re return s } -// Contains the output of RecordLifecycleActionHeartBeat. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RecordLifecycleActionHeartbeatAnswer type RecordLifecycleActionHeartbeatOutput struct { _ struct{} `type:"structure"` @@ -10948,7 +10903,7 @@ type ScalingPolicy struct { AutoScalingGroupName *string `min:"1" type:"string"` // The amount of time, in seconds, after a scaling activity completes before - // any further trigger-related scaling activities can start. + // any further dynamic scaling activities can start. Cooldown *int64 `type:"integer"` // The estimated time, in seconds, until a newly launched instance can contribute @@ -11075,7 +11030,6 @@ func (s *ScalingPolicy) SetStepAdjustments(v []*StepAdjustment) *ScalingPolicy { return s } -// Contains the parameters for SuspendProcesses and ResumeProcesses. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ScalingProcessQuery type ScalingProcessQuery struct { _ struct{} `type:"structure"` @@ -11255,7 +11209,6 @@ func (s *ScheduledUpdateGroupAction) SetTime(v time.Time) *ScheduledUpdateGroupA return s } -// Contains the parameters for SetDesiredCapacity. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetDesiredCapacityType type SetDesiredCapacityInput struct { _ struct{} `type:"structure"` @@ -11339,7 +11292,6 @@ func (s SetDesiredCapacityOutput) GoString() string { return s.String() } -// Contains the parameters for SetInstanceHealth. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceHealthQuery type SetInstanceHealthInput struct { _ struct{} `type:"structure"` @@ -11431,7 +11383,6 @@ func (s SetInstanceHealthOutput) GoString() string { return s.String() } -// Contains the parameters for SetInstanceProtection. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceProtectionQuery type SetInstanceProtectionInput struct { _ struct{} `type:"structure"` @@ -11503,7 +11454,6 @@ func (s *SetInstanceProtectionInput) SetProtectedFromScaleIn(v bool) *SetInstanc return s } -// Contains the output of SetInstanceProtection. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceProtectionAnswer type SetInstanceProtectionOutput struct { _ struct{} `type:"structure"` @@ -11809,7 +11759,6 @@ func (s *TagDescription) SetValue(v string) *TagDescription { return s } -// Contains the parameters for TerminateInstanceInAutoScalingGroup. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/TerminateInstanceInAutoScalingGroupType type TerminateInstanceInAutoScalingGroupInput struct { _ struct{} `type:"structure"` @@ -11867,7 +11816,6 @@ func (s *TerminateInstanceInAutoScalingGroupInput) SetShouldDecrementDesiredCapa return s } -// Contains the output of TerminateInstancesInAutoScalingGroup. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ActivityType type TerminateInstanceInAutoScalingGroupOutput struct { _ struct{} `type:"structure"` @@ -11892,7 +11840,6 @@ func (s *TerminateInstanceInAutoScalingGroupOutput) SetActivity(v *Activity) *Te return s } -// Contains the parameters for UpdateAutoScalingGroup. // Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroupType type UpdateAutoScalingGroupInput struct { _ struct{} `type:"structure"` diff --git a/vendor/github.com/aws/aws-sdk-go/service/autoscaling/doc.go b/vendor/github.com/aws/aws-sdk-go/service/autoscaling/doc.go new file mode 100644 index 00000000..a5c51a51 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/autoscaling/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/autoscaling/service.go b/vendor/github.com/aws/aws-sdk-go/service/autoscaling/service.go index 752375f1..5e63d1c0 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/autoscaling/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/autoscaling/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/batch/api.go b/vendor/github.com/aws/aws-sdk-go/service/batch/api.go index 8d96230a..91bed65c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/batch/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/batch/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package batch provides a client for AWS Batch. package batch import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/batch/doc.go b/vendor/github.com/aws/aws-sdk-go/service/batch/doc.go new file mode 100644 index 00000000..0144a838 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/batch/doc.go @@ -0,0 +1,96 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package batch provides the client and types for making API +// requests to AWS Batch. +// +// AWS Batch enables you to run batch computing workloads on the AWS Cloud. +// Batch computing is a common way for developers, scientists, and engineers +// to access large amounts of compute resources, and AWS Batch removes the undifferentiated +// heavy lifting of configuring and managing the required infrastructure. AWS +// Batch will be familiar to users of traditional batch computing software. +// This service can efficiently provision resources in response to jobs submitted +// in order to eliminate capacity constraints, reduce compute costs, and deliver +// results quickly. +// +// As a fully managed service, AWS Batch enables developers, scientists, and +// engineers to run batch computing workloads of any scale. AWS Batch automatically +// provisions compute resources and optimizes the workload distribution based +// on the quantity and scale of the workloads. With AWS Batch, there is no need +// to install or manage batch computing software, which allows you to focus +// on analyzing results and solving problems. AWS Batch reduces operational +// complexities, saves time, and reduces costs, which makes it easy for developers, +// scientists, and engineers to run their batch jobs in the AWS Cloud. +// +// See https://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10 for more information on this service. +// +// See batch package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/batch/ +// +// Using the Client +// +// To use the client for AWS Batch 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 := batch.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 Batch client Batch for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/batch/#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 batch diff --git a/vendor/github.com/aws/aws-sdk-go/service/batch/service.go b/vendor/github.com/aws/aws-sdk-go/service/batch/service.go index e50d232b..11539325 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/batch/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/batch/service.go @@ -11,26 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// AWS Batch enables you to run batch computing workloads on the AWS Cloud. -// Batch computing is a common way for developers, scientists, and engineers -// to access large amounts of compute resources, and AWS Batch removes the undifferentiated -// heavy lifting of configuring and managing the required infrastructure. AWS -// Batch will be familiar to users of traditional batch computing software. -// This service can efficiently provision resources in response to jobs submitted -// in order to eliminate capacity constraints, reduce compute costs, and deliver -// results quickly. +// Batch provides the API operation methods for making requests to +// AWS Batch. See this package's package overview docs +// for details on the service. // -// As a fully managed service, AWS Batch enables developers, scientists, and -// engineers to run batch computing workloads of any scale. AWS Batch automatically -// provisions compute resources and optimizes the workload distribution based -// on the quantity and scale of the workloads. With AWS Batch, there is no need -// to install or manage batch computing software, which allows you to focus -// on analyzing results and solving problems. AWS Batch reduces operational -// complexities, saves time, and reduces costs, which makes it easy for developers, -// scientists, and engineers to run their batch jobs in the AWS Cloud. -// 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/batch-2016-08-10 +// Batch methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Batch struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/budgets/api.go b/vendor/github.com/aws/aws-sdk-go/service/budgets/api.go index 99bef984..d5ba02fd 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/budgets/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/budgets/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package budgets provides a client for AWS Budgets. package budgets import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/budgets/doc.go b/vendor/github.com/aws/aws-sdk-go/service/budgets/doc.go new file mode 100644 index 00000000..87f1e95b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/budgets/doc.go @@ -0,0 +1,78 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package budgets provides the client and types for making API +// requests to AWS Budgets. +// +// All public APIs for AWS Budgets +// +// See budgets package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/budgets/ +// +// Using the Client +// +// To use the client for AWS Budgets 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 := budgets.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 Budgets client Budgets for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/budgets/#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.CreateBudget(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("CreateBudget 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.CreateBudgetWithContext(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 budgets diff --git a/vendor/github.com/aws/aws-sdk-go/service/budgets/service.go b/vendor/github.com/aws/aws-sdk-go/service/budgets/service.go index c012485c..d74d9c96 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/budgets/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/budgets/service.go @@ -11,9 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// All public APIs for AWS Budgets -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// Budgets provides the API operation methods for making requests to +// AWS Budgets. See this package's package overview docs +// for details on the service. +// +// Budgets methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Budgets struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/api.go b/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/api.go index 5856188b..96d006b8 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package clouddirectory provides a client for Amazon CloudDirectory. package clouddirectory import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/doc.go b/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/doc.go new file mode 100644 index 00000000..f5791e5c --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/doc.go @@ -0,0 +1,85 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package clouddirectory provides the client and types for making API +// requests to Amazon CloudDirectory. +// +// Amazon Cloud Directory is a component of the AWS Directory Service that simplifies +// the development and management of cloud-scale web, mobile and IoT applications. +// This guide describes the Cloud Directory operations that you can call programatically +// and includes detailed information on data types 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). +// +// See https://docs.aws.amazon.com/goto/WebAPI/clouddirectory-2016-05-10 for more information on this service. +// +// See clouddirectory package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/clouddirectory/ +// +// Using the Client +// +// To use the client for Amazon CloudDirectory 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 := clouddirectory.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 CloudDirectory client CloudDirectory for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/clouddirectory/#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.AddFacetToObject(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("AddFacetToObject 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.AddFacetToObjectWithContext(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 clouddirectory diff --git a/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/service.go b/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/service.go index 12db5bbe..d82d82d3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/clouddirectory/service.go @@ -11,15 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Amazon Cloud Directory is a component of the AWS Directory Service that simplifies -// the development and management of cloud-scale web, mobile and IoT applications. -// This guide describes the Cloud Directory operations that you can call programatically -// and includes detailed information on data types 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). -// 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/clouddirectory-2016-05-10 +// CloudDirectory provides the API operation methods for making requests to +// Amazon CloudDirectory. See this package's package overview docs +// for details on the service. +// +// CloudDirectory methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CloudDirectory struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/api.go index 37b1eabb..8b347077 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/api.go @@ -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. -// -// 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 +// 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. +// +// 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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/doc.go new file mode 100644 index 00000000..83600619 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/errors.go b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/errors.go index b49437e3..8bcf9482 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/errors.go @@ -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" ) diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/examples_test.go index d837e815..8c4b221a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/examples_test.go @@ -21,7 +21,8 @@ func ExampleCloudFormation_CancelUpdateStack() { svc := cloudformation.New(sess) params := &cloudformation.CancelUpdateStackInput{ - StackName: aws.String("StackName"), // Required + StackName: aws.String("StackName"), // Required + ClientRequestToken: aws.String("ClientRequestToken"), } resp, err := svc.CancelUpdateStack(params) @@ -42,7 +43,8 @@ func ExampleCloudFormation_ContinueUpdateRollback() { svc := cloudformation.New(sess) params := &cloudformation.ContinueUpdateRollbackInput{ - StackName: aws.String("StackNameOrId"), // Required + StackName: aws.String("StackNameOrId"), // Required + ClientRequestToken: aws.String("ClientRequestToken"), ResourcesToSkip: []*string{ aws.String("ResourceToSkip"), // Required // More values... @@ -129,7 +131,8 @@ func ExampleCloudFormation_CreateStack() { aws.String("Capability"), // Required // More values... }, - DisableRollback: aws.Bool(true), + ClientRequestToken: aws.String("ClientRequestToken"), + DisableRollback: aws.Bool(true), NotificationARNs: []*string{ aws.String("NotificationARN"), // Required // More values... @@ -202,7 +205,8 @@ func ExampleCloudFormation_DeleteStack() { svc := cloudformation.New(sess) params := &cloudformation.DeleteStackInput{ - StackName: aws.String("StackName"), // Required + StackName: aws.String("StackName"), // Required + ClientRequestToken: aws.String("ClientRequestToken"), RetainResources: []*string{ aws.String("LogicalResourceId"), // Required // More values... @@ -391,8 +395,9 @@ func ExampleCloudFormation_ExecuteChangeSet() { svc := cloudformation.New(sess) params := &cloudformation.ExecuteChangeSetInput{ - ChangeSetName: aws.String("ChangeSetNameOrId"), // Required - StackName: aws.String("StackNameOrId"), + ChangeSetName: aws.String("ChangeSetNameOrId"), // Required + ClientRequestToken: aws.String("ClientRequestToken"), + StackName: aws.String("StackNameOrId"), } resp, err := svc.ExecuteChangeSet(params) @@ -644,6 +649,7 @@ func ExampleCloudFormation_UpdateStack() { aws.String("Capability"), // Required // More values... }, + ClientRequestToken: aws.String("ClientRequestToken"), NotificationARNs: []*string{ aws.String("NotificationARN"), // Required // More values... diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/service.go index 12883f60..0115c5bb 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudformation/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudformation/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudfront/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/api.go index f0168c0c..465240b0 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudfront/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudfront/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/doc.go new file mode 100644 index 00000000..0865a909 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudfront/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/service.go index 35b82c44..75dcf86e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudfront/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudfront/sign/sign_cookie.go b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/sign/sign_cookie.go index 7852fb6f..17750719 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudfront/sign/sign_cookie.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudfront/sign/sign_cookie.go @@ -81,7 +81,7 @@ func NewCookieSigner(keyID string, privKey *rsa.PrivateKey, opts ...func(*Cookie // server's response. // // Example: -// s := NewCookieSigner(keyID, privKey) +// s := sign.NewCookieSigner(keyID, privKey) // // // Get Signed cookies for a resource that will expire in 1 hour // cookies, err := s.Sign("*", time.Now().Add(1 * time.Hour)) @@ -150,14 +150,14 @@ func cookieURLScheme(u string) (string, error) { // server's response. // // Example: -// s := NewCookieSigner(keyID, privKey) +// s := sign.NewCookieSigner(keyID, privKey) // // policy := &sign.Policy{ // Statements: []sign.Statement{ // { // // Read the provided documentation on how to set this // // correctly, you'll probably want to use wildcards. -// Resource: RawCloudFrontURL, +// Resource: rawCloudFrontURL, // Condition: sign.Condition{ // // Optional IP source address range // IPAddress: &sign.IPAddress{SourceIP: "192.0.2.0/24"}, diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/api.go index 2678fb8b..c0cf33d3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package cloudhsm provides a client for Amazon CloudHSM. package cloudhsm import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/doc.go new file mode 100644 index 00000000..64bf3a3e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/doc.go @@ -0,0 +1,80 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package cloudhsm provides the client and types for making API +// requests to Amazon CloudHSM. +// +// AWS CloudHSM Service +// +// See https://docs.aws.amazon.com/goto/WebAPI/cloudhsm-2014-05-30 for more information on this service. +// +// See cloudhsm package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudhsm/ +// +// Using the Client +// +// To use the client for Amazon CloudHSM 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 := cloudhsm.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 CloudHSM client CloudHSM for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudhsm/#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 cloudhsm diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/service.go index e372c106..6e499a56 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudhsm/service.go @@ -11,9 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// 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/cloudhsm-2014-05-30 +// CloudHSM provides the API operation methods for making requests to +// Amazon CloudHSM. See this package's package overview docs +// for details on the service. +// +// CloudHSM methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CloudHSM struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/api.go index 11788ca1..6374fba6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package cloudsearch provides a client for Amazon CloudSearch. package cloudsearch import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/doc.go new file mode 100644 index 00000000..fdaf584b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/doc.go @@ -0,0 +1,85 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package cloudsearch provides the client and types for making API +// requests to Amazon CloudSearch. +// +// You use the Amazon CloudSearch configuration service to create, configure, +// and manage search domains. Configuration service requests are submitted using +// the AWS Query protocol. AWS Query requests are HTTP or HTTPS requests submitted +// via HTTP GET or POST with a query parameter named Action. +// +// The endpoint for configuration service requests is region-specific: cloudsearch.region.amazonaws.com. +// For example, cloudsearch.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#cloudsearch_region). +// +// See cloudsearch package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudsearch/ +// +// Using the Client +// +// To use the client for Amazon CloudSearch 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 := cloudsearch.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 CloudSearch client CloudSearch for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudsearch/#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.BuildSuggesters(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("BuildSuggesters 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.BuildSuggestersWithContext(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 cloudsearch diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/service.go index b1d08cf7..6ef7a62d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudsearch/service.go @@ -11,16 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// You use the Amazon CloudSearch configuration service to create, configure, -// and manage search domains. Configuration service requests are submitted using -// the AWS Query protocol. AWS Query requests are HTTP or HTTPS requests submitted -// via HTTP GET or POST with a query parameter named Action. +// CloudSearch provides the API operation methods for making requests to +// Amazon CloudSearch. See this package's package overview docs +// for details on the service. // -// The endpoint for configuration service requests is region-specific: cloudsearch.region.amazonaws.com. -// For example, cloudsearch.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#cloudsearch_region). -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// CloudSearch methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CloudSearch struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/api.go index 74536ebb..4a28ac0c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package cloudsearchdomain provides a client for Amazon CloudSearch Domain. package cloudsearchdomain import ( @@ -856,7 +855,6 @@ type SearchInput struct { // * dismax: search using the simplified subset of the Apache Lucene query // parser syntax defined by the DisMax query parser. For more information, // see DisMax Query Parser Syntax (http://wiki.apache.org/solr/DisMaxQParserPlugin#Query_Syntax). - // QueryParser *string `location:"querystring" locationName:"q.parser" type:"string" enum:"QueryParser"` // Specifies the field and expression values to include in the response. Multiple diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/doc.go new file mode 100644 index 00000000..186f33b0 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/doc.go @@ -0,0 +1,87 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package cloudsearchdomain provides the client and types for making API +// requests to Amazon CloudSearch Domain. +// +// You use the AmazonCloudSearch2013 API to upload documents to a search domain +// and search those documents. +// +// The endpoints for submitting UploadDocuments, Search, and Suggest requests +// are domain-specific. To get the endpoints for your domain, use the Amazon +// CloudSearch configuration service DescribeDomains action. The domain endpoints +// are also displayed on the domain dashboard in the Amazon CloudSearch console. +// You submit suggest requests to the search endpoint. +// +// For more information, see the Amazon CloudSearch Developer Guide (http://docs.aws.amazon.com/cloudsearch/latest/developerguide). +// +// See cloudsearchdomain package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudsearchdomain/ +// +// Using the Client +// +// To use the client for Amazon CloudSearch Domain 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 := cloudsearchdomain.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 CloudSearch Domain client CloudSearchDomain for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cloudsearchdomain/#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.Search(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("Search 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.SearchWithContext(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 cloudsearchdomain diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/service.go index c07a3266..a537e445 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudsearchdomain/service.go @@ -11,18 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// You use the AmazonCloudSearch2013 API to upload documents to a search domain -// and search those documents. +// CloudSearchDomain provides the API operation methods for making requests to +// Amazon CloudSearch Domain. See this package's package overview docs +// for details on the service. // -// The endpoints for submitting UploadDocuments, Search, and Suggest requests -// are domain-specific. To get the endpoints for your domain, use the Amazon -// CloudSearch configuration service DescribeDomains action. The domain endpoints -// are also displayed on the domain dashboard in the Amazon CloudSearch console. -// You submit suggest requests to the search endpoint. -// -// For more information, see the Amazon CloudSearch Developer Guide (http://docs.aws.amazon.com/cloudsearch/latest/developerguide). -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// CloudSearchDomain methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CloudSearchDomain struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/api.go index f48b86cb..cbc83bae 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/doc.go new file mode 100644 index 00000000..0f25c8b7 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/service.go index 05bcdbde..49198fc6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudtrail/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/api.go index 917da5aa..41b8696e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/doc.go new file mode 100644 index 00000000..f6cbf2ad --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/service.go index 8bffc874..4b0aa76e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatch/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/api.go index c8627baa..1ee81874 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/api.go @@ -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 ( @@ -890,10 +889,18 @@ func (c *CloudWatchEvents) PutTargetsRequest(input *PutTargetsInput) (req *reque // are extracted from the event and used as values in a template that you // specify as the input to the target. // +// When you specify Input, InputPath, or InputTransformer, you must use JSON +// dot notation, not bracket notation. +// // When you add targets to a rule and the associated rule triggers soon after, // new or updated targets might not be immediately invoked. Please allow a short // period of time for changes to take effect. // +// This action can partially fail if too many requests are made at the same +// time. If that happens, FailedEntryCount is non-zero in the response and each +// entry in FailedEntries provides the ID of the failed target and the error +// code. +// // 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. @@ -988,6 +995,11 @@ func (c *CloudWatchEvents) RemoveTargetsRequest(input *RemoveTargetsInput) (req // might continue to be invoked. Please allow a short period of time for changes // to take effect. // +// This action can partially fail if too many requests are made at the same +// time. If that happens, FailedEntryCount is non-zero in the response and each +// entry in FailedEntries provides the ID of the failed target and the error +// code. +// // 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. @@ -1224,7 +1236,8 @@ type DescribeRuleOutput struct { // The description of the rule. Description *string `type:"string"` - // The event pattern. + // The event pattern. For more information, see Events and Event Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) + // in the Amazon CloudWatch Events User Guide. EventPattern *string `type:"string"` // The name of the rule. @@ -1470,7 +1483,8 @@ type InputTransformer struct { _ struct{} `type:"structure"` // Map of JSON paths to be extracted from the event. These are key-value pairs, - // where each value is a JSON path. + // where each value is a JSON path. You must use JSON dot notation, not bracket + // notation. InputPathsMap map[string]*string `type:"map"` // Input template where you can use the values of the keys from InputPathsMap @@ -2051,7 +2065,8 @@ type PutRuleInput struct { // A description of the rule. Description *string `type:"string"` - // The event pattern. + // The event pattern. For more information, see Events and Event Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) + // in the Amazon CloudWatch Events User Guide. EventPattern *string `type:"string"` // The name of the rule that you are creating or updating. @@ -2265,7 +2280,9 @@ func (s *PutTargetsOutput) SetFailedEntryCount(v int64) *PutTargetsOutput { type PutTargetsResultEntry struct { _ struct{} `type:"structure"` - // The error code that indicates why the target addition failed. + // The error code that indicates why the target addition failed. If the value + // is ConcurrentModificationException, too many requests were made at the same + // time. ErrorCode *string `type:"string"` // The error message that explains why the target addition failed. @@ -2400,7 +2417,9 @@ func (s *RemoveTargetsOutput) SetFailedEntryCount(v int64) *RemoveTargetsOutput type RemoveTargetsResultEntry struct { _ struct{} `type:"structure"` - // The error code that indicates why the target removal failed. + // The error code that indicates why the target removal failed. If the value + // is ConcurrentModificationException, too many requests were made at the same + // time. ErrorCode *string `type:"string"` // The error message that explains why the target removal failed. @@ -2449,7 +2468,9 @@ type Rule struct { // The description of the rule. Description *string `type:"string"` - // The event pattern of the rule. + // The event pattern of the rule. For more information, see Events and Event + // Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) + // in the Amazon CloudWatch Events User Guide. EventPattern *string `type:"string"` // The name of the rule. @@ -2660,13 +2681,14 @@ type Target struct { Id *string `min:"1" type:"string" required:"true"` // Valid JSON text passed to the target. In this case, nothing from the event - // itself is passed to the target. For more information, see The JavaScript - // Object Notation (JSON) Data Interchange Format (http://www.rfc-editor.org/rfc/rfc7159.txt). + // itself is passed to the target. You must use JSON dot notation, not bracket + // notation. For more information, see The JavaScript Object Notation (JSON) + // Data Interchange Format (http://www.rfc-editor.org/rfc/rfc7159.txt). Input *string `type:"string"` // The value of the JSONPath that is used for extracting part of the matched - // event when passing it to the target. For more information about JSON paths, - // see JSONPath (http://goessner.net/articles/JsonPath/). + // event when passing it to the target. You must use JSON dot notation, not + // bracket notation. For more information about JSON paths, see JSONPath (http://goessner.net/articles/JsonPath/). InputPath *string `type:"string"` // Settings to enable you to provide custom input to a target based on certain @@ -2806,7 +2828,8 @@ type TestEventPatternInput struct { // Event is a required field Event *string `type:"string" required:"true"` - // The event pattern. + // The event pattern. For more information, see Events and Event Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) + // in the Amazon CloudWatch Events User Guide. // // EventPattern is a required field EventPattern *string `type:"string" required:"true"` diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/doc.go new file mode 100644 index 00000000..a56cf09d --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/service.go index 88c8421d..1fb24f16 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go index 444b2fd7..1c0b9734 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go @@ -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 ( @@ -2714,7 +2713,10 @@ func (c *CloudWatchLogs) PutSubscriptionFilterRequest(input *PutSubscriptionFilt // * An AWS Lambda function that belongs to the same account as the subscription // filter, for same-account delivery. // -// There can only be one subscription filter associated with a log group. +// There can only be one subscription filter associated with a log group. If +// you are updating an existing filter, you must specify the correct name in +// filterName. Otherwise, the call will fail because you cannot associate a +// second filter with a log group. // // 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 @@ -4102,6 +4104,12 @@ type DescribeLogStreamsInput struct { // // If you order the results by event time, you cannot specify the logStreamNamePrefix // parameter. + // + // lastEventTimestamp represents the time of the most recent log event in the + // log stream in CloudWatch Logs. This number is expressed as the number of + // milliseconds since Jan 1, 1970 00:00:00 UTC. lastEventTimeStamp updates on + // an eventual consistency basis. It typically updates in less than an hour + // from ingestion, but may take longer in some rare situations. OrderBy *string `locationName:"orderBy" type:"string" enum:"OrderBy"` } @@ -4463,7 +4471,8 @@ type Destination struct { // The ARN of this destination. Arn *string `locationName:"arn" type:"string"` - // The creation time of the destination. + // The creation time of the destination, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` // The name of the destination. @@ -4627,10 +4636,12 @@ func (s *ExportTask) SetTo(v int64) *ExportTask { type ExportTaskExecutionInfo struct { _ struct{} `type:"structure"` - // The completion time of the export task. + // The completion time of the export task, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. CompletionTime *int64 `locationName:"completionTime" type:"long"` - // The creation time of the export task. + // The creation time of the export task, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` } @@ -4865,7 +4876,8 @@ type FilteredLogEvent struct { // The ID of the event. EventId *string `locationName:"eventId" type:"string"` - // The time the event was ingested. + // The time the event was ingested, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. IngestionTime *int64 `locationName:"ingestionTime" type:"long"` // The name of the log stream this event belongs to. @@ -5215,7 +5227,8 @@ type LogGroup struct { // The Amazon Resource Name (ARN) of the log group. Arn *string `locationName:"arn" type:"string"` - // The creation time of the log group. + // The creation time of the log group, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` // The name of the log group. @@ -5288,18 +5301,23 @@ type LogStream struct { // The Amazon Resource Name (ARN) of the log stream. Arn *string `locationName:"arn" type:"string"` - // The creation time of the stream. + // The creation time of the stream, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` // The time of the first event, expressed as the number of milliseconds since // Jan 1, 1970 00:00:00 UTC. FirstEventTimestamp *int64 `locationName:"firstEventTimestamp" type:"long"` - // The time of the last event, expressed as the number of milliseconds since - // Jan 1, 1970 00:00:00 UTC. + // the time of the most recent log event in the log stream in CloudWatch Logs. + // This number is expressed as the number of milliseconds since Jan 1, 1970 + // 00:00:00 UTC. lastEventTime updates on an eventual consistency basis. It + // typically updates in less than an hour from ingestion, but may take longer + // in some rare situations. LastEventTimestamp *int64 `locationName:"lastEventTimestamp" type:"long"` - // The ingestion time. + // The ingestion time, expressed as the number of milliseconds since Jan 1, + // 1970 00:00:00 UTC. LastIngestionTime *int64 `locationName:"lastIngestionTime" type:"long"` // The name of the log stream. @@ -5377,7 +5395,8 @@ func (s *LogStream) SetUploadSequenceToken(v string) *LogStream { type MetricFilter struct { _ struct{} `type:"structure"` - // The creation time of the metric filter. + // The creation time of the metric filter, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` // The name of the metric filter. @@ -5564,7 +5583,8 @@ func (s *MetricTransformation) SetMetricValue(v string) *MetricTransformation { type OutputLogEvent struct { _ struct{} `type:"structure"` - // The time the event was ingested. + // The time the event was ingested, expressed as the number of milliseconds + // since Jan 1, 1970 00:00:00 UTC. IngestionTime *int64 `locationName:"ingestionTime" type:"long"` // The data contained in the log event. @@ -6125,7 +6145,10 @@ type PutSubscriptionFilterInput struct { // For a more even distribution, you can group log data randomly. Distribution *string `locationName:"distribution" type:"string" enum:"Distribution"` - // A name for the subscription filter. + // A name for the subscription filter. If you are updating an existing filter, + // you must specify the correct name in filterName. Otherwise, the call will + // fail because you cannot associate a second filter with a log group. To find + // the name of the filter currently associated with a log group, use DescribeSubscriptionFilters. // // FilterName is a required field FilterName *string `locationName:"filterName" min:"1" type:"string" required:"true"` @@ -6324,7 +6347,8 @@ func (s *SearchedLogStream) SetSearchedCompletely(v bool) *SearchedLogStream { type SubscriptionFilter struct { _ struct{} `type:"structure"` - // The creation time of the subscription filter. + // The creation time of the subscription filter, expressed as the number of + // milliseconds since Jan 1, 1970 00:00:00 UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` // The Amazon Resource Name (ARN) of the destination. diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/doc.go new file mode 100644 index 00000000..b8c40691 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go index d4b0cb55..8e6094d5 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/codebuild/api.go b/vendor/github.com/aws/aws-sdk-go/service/codebuild/api.go index 8ffd9033..79c19102 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codebuild/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codebuild/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/codebuild/doc.go b/vendor/github.com/aws/aws-sdk-go/service/codebuild/doc.go new file mode 100644 index 00000000..078a56f3 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/codebuild/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/codebuild/service.go b/vendor/github.com/aws/aws-sdk-go/service/codebuild/service.go index 22fc184d..d45aed63 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codebuild/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codebuild/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/codecommit/api.go b/vendor/github.com/aws/aws-sdk-go/service/codecommit/api.go index 28e7837e..9e71917a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codecommit/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codecommit/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/codecommit/doc.go b/vendor/github.com/aws/aws-sdk-go/service/codecommit/doc.go new file mode 100644 index 00000000..fafa08c1 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/codecommit/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/codecommit/service.go b/vendor/github.com/aws/aws-sdk-go/service/codecommit/service.go index b1e292ce..cb25eaba 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codecommit/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codecommit/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/api.go b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/api.go index 96e1b208..673707b3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/api.go @@ -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 ( @@ -705,11 +704,12 @@ func (c *CodeDeploy) ContinueDeploymentRequest(input *ContinueDeploymentInput) ( // ContinueDeployment API operation for AWS CodeDeploy. // -// Starts the process of rerouting traffic from instances in the original environment -// to instances in thereplacement environment without waiting for a specified -// wait time to elapse. (Traffic rerouting, which is achieved by registering -// instances in the replacement environment with the load balancer, can start -// as soon as all instances have a status of Ready.) +// For a blue/green deployment, starts the process of rerouting traffic from +// instances in the original environment to instances in the replacement environment +// without waiting for a specified wait time to elapse. (Traffic rerouting, +// which is achieved by registering instances in the replacement environment +// with the load balancer, can start as soon as all instances have a status +// of Ready.) // // 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 @@ -965,6 +965,12 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req // * ErrCodeInvalidLoadBalancerInfoException "InvalidLoadBalancerInfoException" // An invalid load balancer name, or no load balancer name, was specified. // +// * ErrCodeInvalidFileExistsBehaviorException "InvalidFileExistsBehaviorException" +// An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy +// handles files or directories that already exist in a deployment target location +// but weren't part of the previous successful deployment. Valid values include +// "DISALLOW", "OVERWRITE", and "RETAIN". +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/CreateDeployment func (c *CodeDeploy) CreateDeployment(input *CreateDeploymentInput) (*CreateDeploymentOutput, error) { req, out := c.CreateDeploymentRequest(input) @@ -1216,8 +1222,8 @@ func (c *CodeDeploy) CreateDeploymentGroupRequest(input *CreateDeploymentGroupIn // // * ErrCodeInvalidDeploymentStyleException "InvalidDeploymentStyleException" // An invalid deployment style was specified. Valid deployment types include -// "IN_PLACE" and "BLUE_GREEN". Valid deployment options for blue/green deployments -// include "WITH_TRAFFIC_CONTROL" and "WITHOUT_TRAFFIC_CONTROL". +// "IN_PLACE" and "BLUE_GREEN". Valid deployment options include "WITH_TRAFFIC_CONTROL" +// and "WITHOUT_TRAFFIC_CONTROL". // // * ErrCodeInvalidBlueGreenDeploymentConfigurationException "InvalidBlueGreenDeploymentConfigurationException" // The configuration for the blue/green deployment group was provided in an @@ -2902,6 +2908,10 @@ func (c *CodeDeploy) ListDeploymentInstancesRequest(input *ListDeploymentInstanc // Valid values include "Blue" for an original environment and "Green" for a // replacement environment. // +// * ErrCodeInvalidDeploymentInstanceTypeException "InvalidDeploymentInstanceTypeException" +// An instance type was specified for an in-place deployment. Instance types +// are supported for blue/green deployments only. +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/ListDeploymentInstances func (c *CodeDeploy) ListDeploymentInstances(input *ListDeploymentInstancesInput) (*ListDeploymentInstancesOutput, error) { req, out := c.ListDeploymentInstancesRequest(input) @@ -3949,8 +3959,8 @@ func (c *CodeDeploy) UpdateDeploymentGroupRequest(input *UpdateDeploymentGroupIn // // * ErrCodeInvalidDeploymentStyleException "InvalidDeploymentStyleException" // An invalid deployment style was specified. Valid deployment types include -// "IN_PLACE" and "BLUE_GREEN". Valid deployment options for blue/green deployments -// include "WITH_TRAFFIC_CONTROL" and "WITHOUT_TRAFFIC_CONTROL". +// "IN_PLACE" and "BLUE_GREEN". Valid deployment options include "WITH_TRAFFIC_CONTROL" +// and "WITHOUT_TRAFFIC_CONTROL". // // * ErrCodeInvalidBlueGreenDeploymentConfigurationException "InvalidBlueGreenDeploymentConfigurationException" // The configuration for the blue/green deployment group was provided in an @@ -5009,7 +5019,7 @@ type CreateDeploymentGroupInput struct { // group. // // For more information about the predefined deployment configurations in AWS - // CodeDeploy, see see Working with Deployment Groups in AWS CodeDeploy (http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html) + // CodeDeploy, see Working with Deployment Groups in AWS CodeDeploy (http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html) // in the AWS CodeDeploy User Guide. DeploymentConfigName *string `locationName:"deploymentConfigName" min:"1" type:"string"` @@ -5018,17 +5028,19 @@ type CreateDeploymentGroupInput struct { // DeploymentGroupName is a required field DeploymentGroupName *string `locationName:"deploymentGroupName" min:"1" type:"string" required:"true"` - // Information about the type of deployment, standard or blue/green, that you + // Information about the type of deployment, in-place or blue/green, that you // want to run and whether to route deployment traffic behind a load balancer. DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"` - // The Amazon EC2 tags on which to filter. + // The Amazon EC2 tags on which to filter. The deployment group will include + // EC2 instances with any of the specified tags. Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"` - // Information about the load balancer used in a blue/green deployment. + // Information about the load balancer used in a deployment. LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"` - // The on-premises instance tags on which to filter. + // The on-premises instance tags on which to filter. The deployment group will + // include on-premises instances with any of the specified tags. OnPremisesInstanceTagFilters []*TagFilter `locationName:"onPremisesInstanceTagFilters" type:"list"` // A service role ARN that allows AWS CodeDeploy to act on the user's behalf @@ -5213,6 +5225,22 @@ type CreateDeploymentInput struct { // A comment about the deployment. Description *string `locationName:"description" type:"string"` + // Information about how AWS CodeDeploy handles files that already exist in + // a deployment target location but weren't part of the previous successful + // deployment. + // + // The fileExistsBehavior parameter takes any of the following values: + // + // * DISALLOW: The deployment fails. This is also the default behavior if + // no option is specified. + // + // * OVERWRITE: The version of the file from the application revision currently + // being deployed replaces the version already on the instance. + // + // * RETAIN: The version of the file already on the instance is kept and + // used as part of the new deployment. + FileExistsBehavior *string `locationName:"fileExistsBehavior" type:"string" enum:"FileExistsBehavior"` + // If set to true, then if the deployment causes the ApplicationStop deployment // lifecycle event to an instance to fail, the deployment to that instance will // not be considered to have failed at that point and will continue on to the @@ -5298,6 +5326,12 @@ func (s *CreateDeploymentInput) SetDescription(v string) *CreateDeploymentInput return s } +// SetFileExistsBehavior sets the FileExistsBehavior field's value. +func (s *CreateDeploymentInput) SetFileExistsBehavior(v string) *CreateDeploymentInput { + s.FileExistsBehavior = &v + return s +} + // SetIgnoreApplicationStopFailures sets the IgnoreApplicationStopFailures field's value. func (s *CreateDeploymentInput) SetIgnoreApplicationStopFailures(v bool) *CreateDeploymentInput { s.IgnoreApplicationStopFailures = &v @@ -5638,14 +5672,14 @@ type DeploymentGroupInfo struct { // The deployment group name. DeploymentGroupName *string `locationName:"deploymentGroupName" min:"1" type:"string"` - // Information about the type of deployment, either standard or blue/green, + // Information about the type of deployment, either in-place or blue/green, // you want to run and whether to route deployment traffic behind a load balancer. DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"` // The Amazon EC2 tags on which to filter. Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"` - // Information about the load balancer to use in a blue/green deployment. + // Information about the load balancer to use in a deployment. LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"` // The on-premises instance tags on which to filter. @@ -5808,7 +5842,7 @@ type DeploymentInfo struct { // A summary of the deployment status of the instances in the deployment. DeploymentOverview *DeploymentOverview `locationName:"deploymentOverview" type:"structure"` - // Information about the type of deployment, either standard or blue/green, + // Information about the type of deployment, either in-place or blue/green, // you want to run and whether to route deployment traffic behind a load balancer. DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"` @@ -5818,6 +5852,20 @@ type DeploymentInfo struct { // Information about any error associated with this deployment. ErrorInformation *ErrorInformation `locationName:"errorInformation" type:"structure"` + // Information about how AWS CodeDeploy handles files that already exist in + // a deployment target location but weren't part of the previous successful + // deployment. + // + // * DISALLOW: The deployment fails. This is also the default behavior if + // no option is specified. + // + // * OVERWRITE: The version of the file from the application revision currently + // being deployed replaces the version already on the instance. + // + // * RETAIN: The version of the file already on the instance is kept and + // used as part of the new deployment. + FileExistsBehavior *string `locationName:"fileExistsBehavior" type:"string" enum:"FileExistsBehavior"` + // If true, then if the deployment causes the ApplicationStop deployment lifecycle // event to an instance to fail, the deployment to that instance will not be // considered to have failed at that point and will continue on to the BeforeInstall @@ -5835,9 +5883,13 @@ type DeploymentInfo struct { // starts. InstanceTerminationWaitTimeStarted *bool `locationName:"instanceTerminationWaitTimeStarted" type:"boolean"` - // Information about the load balancer used in this blue/green deployment. + // Information about the load balancer used in the deployment. LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"` + // Information about the application revision that was deployed to the deployment + // group before the most recent successful deployment. + PreviousRevision *RevisionLocation `locationName:"previousRevision" type:"structure"` + // Information about the location of stored application artifacts and the service // from which to retrieve them. Revision *RevisionLocation `locationName:"revision" type:"structure"` @@ -5959,6 +6011,12 @@ func (s *DeploymentInfo) SetErrorInformation(v *ErrorInformation) *DeploymentInf return s } +// SetFileExistsBehavior sets the FileExistsBehavior field's value. +func (s *DeploymentInfo) SetFileExistsBehavior(v string) *DeploymentInfo { + s.FileExistsBehavior = &v + return s +} + // SetIgnoreApplicationStopFailures sets the IgnoreApplicationStopFailures field's value. func (s *DeploymentInfo) SetIgnoreApplicationStopFailures(v bool) *DeploymentInfo { s.IgnoreApplicationStopFailures = &v @@ -5977,6 +6035,12 @@ func (s *DeploymentInfo) SetLoadBalancerInfo(v *LoadBalancerInfo) *DeploymentInf return s } +// SetPreviousRevision sets the PreviousRevision field's value. +func (s *DeploymentInfo) SetPreviousRevision(v *RevisionLocation) *DeploymentInfo { + s.PreviousRevision = v + return s +} + // SetRevision sets the Revision field's value. func (s *DeploymentInfo) SetRevision(v *RevisionLocation) *DeploymentInfo { s.Revision = v @@ -6132,7 +6196,7 @@ func (s *DeploymentReadyOption) SetWaitTimeInMinutes(v int64) *DeploymentReadyOp return s } -// Information about the type of deployment, either standard or blue/green, +// Information about the type of deployment, either in-place or blue/green, // you want to run and whether to route deployment traffic behind a load balancer. // Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/DeploymentStyle type DeploymentStyle struct { @@ -6141,7 +6205,7 @@ type DeploymentStyle struct { // Indicates whether to route deployment traffic behind a load balancer. DeploymentOption *string `locationName:"deploymentOption" type:"string" enum:"DeploymentOption"` - // Indicates whether to run a standard deployment or a blue/green deployment. + // Indicates whether to run an in-place deployment or a blue/green deployment. DeploymentType *string `locationName:"deploymentType" type:"string" enum:"DeploymentType"` } @@ -6291,7 +6355,7 @@ func (s *Diagnostics) SetScriptName(v string) *Diagnostics { return s } -// Information about a tag filter. +// Information about an EC2 tag filter. // Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/EC2TagFilter type EC2TagFilter struct { _ struct{} `type:"structure"` @@ -6340,14 +6404,16 @@ func (s *EC2TagFilter) SetValue(v string) *EC2TagFilter { return s } -// Information about a load balancer in Elastic Load Balancing to use in a blue/green -// deployment. +// Information about a load balancer in Elastic Load Balancing to use in a deployment. // Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/ELBInfo type ELBInfo struct { _ struct{} `type:"structure"` - // The name of the load balancer that will be used to route traffic from original - // instances to replacement instances in a blue/green deployment. + // For blue/green deployments, the name of the load balancer that will be used + // to route traffic from original instances to replacement instances in a blue/green + // deployment. For in-place deployments, the name of the load balancer that + // instances are deregistered from so they are not serving traffic during a + // deployment, and then re-registered with after the deployment completes. Name *string `locationName:"name" type:"string"` } @@ -8066,13 +8132,13 @@ func (s *ListOnPremisesInstancesOutput) SetNextToken(v string) *ListOnPremisesIn return s } -// Information about the load balancer used in a blue/green deployment. +// Information about the load balancer used in a deployment. // Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/LoadBalancerInfo type LoadBalancerInfo struct { _ struct{} `type:"structure"` // An array containing information about the load balancer in Elastic Load Balancing - // to use in a blue/green deployment. + // to use in a deployment. ElbInfoList []*ELBInfo `locationName:"elbInfoList" type:"list"` } @@ -8120,6 +8186,9 @@ type MinimumHealthyHosts struct { // Although this allows one instance at a time to be taken offline for a new // deployment, it also means that if the deployment to the last instance fails, // the overall deployment still succeeds. + // + // For more information, see AWS CodeDeploy Instance Health (http://docs.aws.amazon.com/codedeploy/latest/userguide/instances-health.html) + // in the AWS CodeDeploy User Guide. Type *string `locationName:"type" type:"string" enum:"MinimumHealthyHostsType"` // The minimum healthy instance value. @@ -9010,7 +9079,7 @@ type UpdateDeploymentGroupInput struct { // it. DeploymentConfigName *string `locationName:"deploymentConfigName" min:"1" type:"string"` - // Information about the type of deployment, either standard or blue/green, + // Information about the type of deployment, either in-place or blue/green, // you want to run and whether to route deployment traffic behind a load balancer. DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"` @@ -9019,7 +9088,7 @@ type UpdateDeploymentGroupInput struct { // do not enter any tag names. Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"` - // Information about the load balancer used in a blue/green deployment. + // Information about the load balancer used in a deployment. LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"` // The new name of the deployment group, if you want to change it. @@ -9349,6 +9418,17 @@ const ( ) const ( + // FileExistsBehaviorDisallow is a FileExistsBehavior enum value + FileExistsBehaviorDisallow = "DISALLOW" + + // FileExistsBehaviorOverwrite is a FileExistsBehavior enum value + FileExistsBehaviorOverwrite = "OVERWRITE" + + // FileExistsBehaviorRetain is a FileExistsBehavior enum value + FileExistsBehaviorRetain = "RETAIN" +) + +const ( // GreenFleetProvisioningActionDiscoverExisting is a GreenFleetProvisioningAction enum value GreenFleetProvisioningActionDiscoverExisting = "DISCOVER_EXISTING" diff --git a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/doc.go b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/doc.go new file mode 100644 index 00000000..f9a43b80 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/doc.go @@ -0,0 +1,133 @@ +// 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. +// +// AWS CodeDeploy is a deployment service that automates application deployments +// to Amazon EC2 instances or on-premises instances running in your own facility. +// +// You can deploy a nearly unlimited variety of application content, such as +// code, web and configuration files, executables, packages, scripts, multimedia +// files, and so on. AWS CodeDeploy can deploy application content stored in +// Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do +// not need to make changes to your existing code before you can use AWS CodeDeploy. +// +// AWS CodeDeploy makes it easier for you to rapidly release new features, helps +// you avoid downtime during application deployment, and handles the complexity +// of updating your applications, without many of the risks associated with +// error-prone manual deployments. +// +// AWS CodeDeploy Components +// +// Use the information in this guide to help you work with the following AWS +// CodeDeploy components: +// +// * Application: A name that uniquely identifies the application you want +// to deploy. AWS CodeDeploy uses this name, which functions as a container, +// to ensure the correct combination of revision, deployment configuration, +// and deployment group are referenced during a deployment. +// +// * Deployment group: A set of individual instances. A deployment group +// contains individually tagged instances, Amazon EC2 instances in Auto Scaling +// groups, or both. +// +// * Deployment configuration: A set of deployment rules and deployment success +// and failure conditions used by AWS CodeDeploy during a deployment. +// +// * Deployment: The process, and the components involved in the process, +// of installing content on one or more instances. +// +// * Application revisions: An archive file containing source content—source +// code, web pages, executable files, and deployment scripts—along with an +// application specification file (AppSpec file). Revisions are stored in +// Amazon S3 buckets or GitHub repositories. For Amazon S3, a revision is +// uniquely identified by its Amazon S3 object key and its ETag, version, +// or both. For GitHub, a revision is uniquely identified by its commit ID. +// +// This guide also contains information to help you get details about the instances +// in your deployments and to make on-premises instances available for AWS CodeDeploy +// deployments. +// +// AWS CodeDeploy Information Resources +// +// * AWS CodeDeploy User Guide (http://docs.aws.amazon.com/codedeploy/latest/userguide) +// +// * AWS CodeDeploy API Reference Guide (http://docs.aws.amazon.com/codedeploy/latest/APIReference/) +// +// * AWS CLI Reference for AWS CodeDeploy (http://docs.aws.amazon.com/cli/latest/reference/deploy/index.html) +// +// * AWS CodeDeploy Developer Forum (https://forums.aws.amazon.com/forum.jspa?forumID=179) +// +// 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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/errors.go b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/errors.go index 1f8c6a96..1e1e41c6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/errors.go @@ -284,6 +284,13 @@ const ( // At least one of the deployment IDs was specified in an invalid format. ErrCodeInvalidDeploymentIdException = "InvalidDeploymentIdException" + // ErrCodeInvalidDeploymentInstanceTypeException for service response error code + // "InvalidDeploymentInstanceTypeException". + // + // An instance type was specified for an in-place deployment. Instance types + // are supported for blue/green deployments only. + ErrCodeInvalidDeploymentInstanceTypeException = "InvalidDeploymentInstanceTypeException" + // ErrCodeInvalidDeploymentStatusException for service response error code // "InvalidDeploymentStatusException". // @@ -294,8 +301,8 @@ const ( // "InvalidDeploymentStyleException". // // An invalid deployment style was specified. Valid deployment types include - // "IN_PLACE" and "BLUE_GREEN". Valid deployment options for blue/green deployments - // include "WITH_TRAFFIC_CONTROL" and "WITHOUT_TRAFFIC_CONTROL". + // "IN_PLACE" and "BLUE_GREEN". Valid deployment options include "WITH_TRAFFIC_CONTROL" + // and "WITHOUT_TRAFFIC_CONTROL". ErrCodeInvalidDeploymentStyleException = "InvalidDeploymentStyleException" // ErrCodeInvalidEC2TagException for service response error code @@ -304,6 +311,15 @@ const ( // The tag was specified in an invalid format. ErrCodeInvalidEC2TagException = "InvalidEC2TagException" + // ErrCodeInvalidFileExistsBehaviorException for service response error code + // "InvalidFileExistsBehaviorException". + // + // An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy + // handles files or directories that already exist in a deployment target location + // but weren't part of the previous successful deployment. Valid values include + // "DISALLOW", "OVERWRITE", and "RETAIN". + ErrCodeInvalidFileExistsBehaviorException = "InvalidFileExistsBehaviorException" + // ErrCodeInvalidIamSessionArnException for service response error code // "InvalidIamSessionArnException". // diff --git a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/examples_test.go index d341d14b..8c5fcdbe 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/examples_test.go @@ -265,6 +265,7 @@ func ExampleCodeDeploy_CreateDeployment() { DeploymentConfigName: aws.String("DeploymentConfigName"), DeploymentGroupName: aws.String("DeploymentGroupName"), Description: aws.String("Description"), + FileExistsBehavior: aws.String("FileExistsBehavior"), IgnoreApplicationStopFailures: aws.Bool(true), Revision: &codedeploy.RevisionLocation{ GitHubLocation: &codedeploy.GitHubLocation{ diff --git a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/service.go b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/service.go index 87e02645..e6524d04 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codedeploy/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codedeploy/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/codepipeline/api.go b/vendor/github.com/aws/aws-sdk-go/service/codepipeline/api.go index 1e4ce3cc..0a7360de 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codepipeline/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codepipeline/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/codepipeline/doc.go b/vendor/github.com/aws/aws-sdk-go/service/codepipeline/doc.go new file mode 100644 index 00000000..0746cc4c --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/codepipeline/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/codepipeline/service.go b/vendor/github.com/aws/aws-sdk-go/service/codepipeline/service.go index 9f18b1d3..8b7737ab 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codepipeline/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codepipeline/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/codestar/api.go b/vendor/github.com/aws/aws-sdk-go/service/codestar/api.go index a02072ac..c6dfea9c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codestar/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codestar/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package codestar provides a client for AWS CodeStar. package codestar import ( @@ -155,7 +154,7 @@ func (c *CodeStar) CreateProjectRequest(input *CreateProjectInput) (req *request // CreateProject API operation for AWS CodeStar. // -// Creates a project in AWS CodeStar with minimal structure and no resources. +// Reserved for future use. To create a project, use the AWS CodeStar console. // // 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 @@ -1478,28 +1477,18 @@ func (s *AssociateTeamMemberOutput) SetClientRequestToken(v string) *AssociateTe type CreateProjectInput struct { _ struct{} `type:"structure"` - // A user- or system-generated token that identifies the entity that requested - // project creation. This token can be used to repeat the request. It can also - // be used to identify which user or system made the request in DescribeProject - // and ListProjects. + // Reserved for future use. ClientRequestToken *string `locationName:"clientRequestToken" min:"1" type:"string"` - // Optional. The description for the project. + // Reserved for future use. Description *string `locationName:"description" type:"string"` - // The ID for the AWS CodeStar project. Project IDs must be unique within an - // AWS account. Project IDs cannot exceed 15 characters and cannot contain capital - // letters and other restricted symbols. For more information, see Limits (http://docs.aws.amazon.com/codestar/latest/userguide/limits.html) - // in the AWS CodeStar User Guide. + // Reserved for future use. // // Id is a required field Id *string `locationName:"id" min:"2" type:"string" required:"true"` - // The friendly name for the project. This friendly name serves as the basis - // for the names for resources associated with the project, such as a repository - // name in AWS CodeCommit. The name is limited to 100 characters and cannot - // contain certain restricted symbols. For more information, see Limits (http://docs.aws.amazon.com/codestar/latest/userguide/limits.html) - // in the AWS CodeStar User Guide. + // Reserved for future use. // // Name is a required field Name *string `locationName:"name" min:"1" type:"string" required:"true"` @@ -1568,22 +1557,20 @@ func (s *CreateProjectInput) SetName(v string) *CreateProjectInput { type CreateProjectOutput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) for the project. + // Reserved for future use. // // Arn is a required field Arn *string `locationName:"arn" type:"string" required:"true"` - // The user- or system-generated token from the initial request that can be - // used to repeat the request. It can also be used to identify which user or - // system made the request in DescribeProject and ListProjects. + // Reserved for future use. ClientRequestToken *string `locationName:"clientRequestToken" min:"1" type:"string"` - // The ID for the project. + // Reserved for future use. // // Id is a required field Id *string `locationName:"id" min:"2" type:"string" required:"true"` - // The ID for the AWS CodeStar project template used to create the project. + // Reserved for future use. ProjectTemplateId *string `locationName:"projectTemplateId" min:"1" type:"string"` } diff --git a/vendor/github.com/aws/aws-sdk-go/service/codestar/doc.go b/vendor/github.com/aws/aws-sdk-go/service/codestar/doc.go new file mode 100644 index 00000000..75934ec0 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/codestar/doc.go @@ -0,0 +1,123 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package codestar provides the client and types for making API +// requests to AWS CodeStar. +// +// This is the API reference for AWS CodeStar. This reference provides descriptions +// of the operations and data types for the AWS CodeStar API along with usage +// examples. +// +// You can use the AWS CodeStar API to work with: +// +// Projects and their resources, by calling the following: +// +// * DeleteProject, which deletes a project in AWS CodeStar. +// +// * DescribeProject, which lists the attributes of a project. +// +// * ListProjects, which lists all AWS CodeStar projects associated with +// your AWS account. +// +// * ListResources, which lists the resources associated with an AWS CodeStar +// project. +// +// * UpdateProject, which updates the attributes of an AWS CodeStar project. +// +// Teams and team members, by calling the following: +// +// * AssociateTeamMember, which adds an IAM user to the team for an AWS CodeStar +// project. +// +// * DisassociateTeamMember, which removes an IAM user from the team for +// an AWS CodeStar project. +// +// * ListTeamMembers, which lists all the IAM users in the team for an AWS +// CodeStar project, including their roles and attributes. +// +// Users, by calling the following: +// +// * CreateUserProfile, which creates a user profile that contains data associated +// with the user across all AWS CodeStar projects. +// +// * DeleteUserProfile, which deletes all user profile information across +// all AWS CodeStar projects. +// +// * DescribeUserProfile, which describes the profile of a user. +// +// * ListUserProfiles, which lists all AWS CodeStar user profiles. +// +// * UpdateUserProfile, which updates the profile for an AWS CodeStar user. +// +// See https://docs.aws.amazon.com/goto/WebAPI/codestar-2017-04-19 for more information on this service. +// +// See codestar package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/codestar/ +// +// Using the Client +// +// To use the client for AWS CodeStar 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 := codestar.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 CodeStar client CodeStar for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/codestar/#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.AssociateTeamMember(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("AssociateTeamMember 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.AssociateTeamMemberWithContext(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 codestar diff --git a/vendor/github.com/aws/aws-sdk-go/service/codestar/service.go b/vendor/github.com/aws/aws-sdk-go/service/codestar/service.go index 8c80c5fb..e2a7bc76 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/codestar/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/codestar/service.go @@ -11,57 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This is the API reference for AWS CodeStar. This reference provides descriptions -// of the operations and data types for the AWS CodeStar API along with usage -// examples. +// CodeStar provides the API operation methods for making requests to +// AWS CodeStar. See this package's package overview docs +// for details on the service. // -// You can use the AWS CodeStar API to work with: -// -// Projects and their resources, by calling the following: -// -// * CreateProject, which creates an empty project in AWS CodeStar with no -// resources. -// -// * DeleteProject, which deletes a project in AWS CodeStar. -// -// * DescribeProject, which lists the attributes of a project. -// -// * ListProjects, which lists all AWS CodeStar projects associated with -// your AWS account. -// -// * ListResources, which lists the resources associated with an AWS CodeStar -// project. -// -// * UpdateProject, which updates the attributes of an AWS CodeStar project. -// -// Teams and team members, by calling the following: -// -// * AssociateTeamMember, which adds an IAM user to the team for an AWS CodeStar -// project. -// -// * DisassociateTeamMember, which removes an IAM user from the team for -// an AWS CodeStar project. -// -// * ListTeamMembers, which lists all the IAM users in the team for an AWS -// CodeStar project, including their roles and attributes. -// -// Users, by calling the following: -// -// * CreateUserProfile, which creates a user profile that contains data associated -// with the user across all AWS CodeStar projects. -// -// * DeleteUserProfile, which deletes all user profile information across -// all AWS CodeStar projects. -// -// * DescribeUserProfile, which describes the profile of a user. -// -// * ListUserProfiles, which lists all AWS CodeStar user profiles. -// -// * UpdateUserProfile, which updates the profile for an AWS CodeStar user. -// -// 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/codestar-2017-04-19 +// CodeStar methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CodeStar struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/api.go b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/api.go index cd246514..6e01c3c2 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/doc.go new file mode 100644 index 00000000..138b4503 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/service.go b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/service.go index 8461c6bf..ee82b18c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentity/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/api.go b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/api.go index 6698ef0b..4349f0b3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package cognitoidentityprovider provides a client for Amazon Cognito Identity Provider. package cognitoidentityprovider import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/doc.go new file mode 100644 index 00000000..cac793ba --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/doc.go @@ -0,0 +1,87 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package cognitoidentityprovider provides the client and types for making API +// requests to Amazon Cognito Identity Provider. +// +// Using the Amazon Cognito Your User Pools API, you can create a user pool +// to manage directories and users. You can authenticate a user to obtain tokens +// related to user identity and access policies. +// +// This API reference provides information about user pools in Amazon Cognito +// Your User Pools. +// +// For more information, see the Amazon Cognito Documentation. +// +// See https://docs.aws.amazon.com/goto/WebAPI/cognito-idp-2016-04-18 for more information on this service. +// +// See cognitoidentityprovider package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cognitoidentityprovider/ +// +// Using the Client +// +// To use the client for Amazon Cognito Identity Provider 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 := cognitoidentityprovider.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 Provider client CognitoIdentityProvider for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cognitoidentityprovider/#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.AddCustomAttributes(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("AddCustomAttributes 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.AddCustomAttributesWithContext(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 cognitoidentityprovider diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/service.go b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/service.go index 299ce981..190d2071 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitoidentityprovider/service.go @@ -11,17 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Using the Amazon Cognito Your User Pools API, you can create a user pool -// to manage directories and users. You can authenticate a user to obtain tokens -// related to user identity and access policies. +// CognitoIdentityProvider provides the API operation methods for making requests to +// Amazon Cognito Identity Provider. See this package's package overview docs +// for details on the service. // -// This API reference provides information about user pools in Amazon Cognito -// Your User Pools. -// -// For more information, see the Amazon Cognito Documentation. -// 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-idp-2016-04-18 +// CognitoIdentityProvider methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CognitoIdentityProvider struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitosync/api.go b/vendor/github.com/aws/aws-sdk-go/service/cognitosync/api.go index 53e3f7ce..72c81cc4 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cognitosync/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitosync/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package cognitosync provides a client for Amazon Cognito Sync. package cognitosync import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitosync/doc.go b/vendor/github.com/aws/aws-sdk-go/service/cognitosync/doc.go new file mode 100644 index 00000000..98955372 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitosync/doc.go @@ -0,0 +1,97 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package cognitosync provides the client and types for making API +// requests to Amazon Cognito Sync. +// +// Amazon Cognito Sync provides an AWS service and client library that enable +// cross-device syncing of application-related user data. High-level client +// libraries are available for both iOS and Android. You can use these libraries +// to persist data locally so that it's available even if the device is offline. +// Developer credentials don't need to be stored on the mobile device to access +// the service. You can use Amazon Cognito to obtain a normalized user ID and +// credentials. User data is persisted in a dataset that can store up to 1 MB +// of key-value pairs, and you can have up to 20 datasets per user identity. +// +// With Amazon Cognito Sync, the data stored for each identity is accessible +// only to credentials assigned to that identity. In order to use the Cognito +// Sync service, you need to make API calls using credentials retrieved with +// Amazon Cognito Identity service (http://docs.aws.amazon.com/cognitoidentity/latest/APIReference/Welcome.html). +// +// If you want to use Cognito Sync in an Android or iOS application, you will +// probably want to make API calls via the AWS Mobile SDK. To learn more, see +// the Developer Guide for Android (http://docs.aws.amazon.com/mobile/sdkforandroid/developerguide/cognito-sync.html) +// and the Developer Guide for iOS (http://docs.aws.amazon.com/mobile/sdkforios/developerguide/cognito-sync.html). +// +// See https://docs.aws.amazon.com/goto/WebAPI/cognito-sync-2014-06-30 for more information on this service. +// +// See cognitosync package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cognitosync/ +// +// Using the Client +// +// To use the client for Amazon Cognito Sync 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 := cognitosync.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 Sync client CognitoSync for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/cognitosync/#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.BulkPublish(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("BulkPublish 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.BulkPublishWithContext(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 cognitosync diff --git a/vendor/github.com/aws/aws-sdk-go/service/cognitosync/service.go b/vendor/github.com/aws/aws-sdk-go/service/cognitosync/service.go index c835a903..1094e541 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/cognitosync/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/cognitosync/service.go @@ -11,27 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Amazon Cognito Sync provides an AWS service and client library that enable -// cross-device syncing of application-related user data. High-level client -// libraries are available for both iOS and Android. You can use these libraries -// to persist data locally so that it's available even if the device is offline. -// Developer credentials don't need to be stored on the mobile device to access -// the service. You can use Amazon Cognito to obtain a normalized user ID and -// credentials. User data is persisted in a dataset that can store up to 1 MB -// of key-value pairs, and you can have up to 20 datasets per user identity. +// CognitoSync provides the API operation methods for making requests to +// Amazon Cognito Sync. See this package's package overview docs +// for details on the service. // -// With Amazon Cognito Sync, the data stored for each identity is accessible -// only to credentials assigned to that identity. In order to use the Cognito -// Sync service, you need to make API calls using credentials retrieved with -// Amazon Cognito Identity service (http://docs.aws.amazon.com/cognitoidentity/latest/APIReference/Welcome.html). -// -// If you want to use Cognito Sync in an Android or iOS application, you will -// probably want to make API calls via the AWS Mobile SDK. To learn more, see -// the Developer Guide for Android (http://docs.aws.amazon.com/mobile/sdkforandroid/developerguide/cognito-sync.html) -// and the Developer Guide for iOS (http://docs.aws.amazon.com/mobile/sdkforios/developerguide/cognito-sync.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-sync-2014-06-30 +// CognitoSync methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CognitoSync struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/configservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/configservice/api.go index 02498a86..76a18e5e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/configservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/configservice/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/configservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/configservice/doc.go new file mode 100644 index 00000000..3b010512 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/configservice/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/configservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/configservice/service.go index 4eefd346..3593126a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/configservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/configservice/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/api.go index 7f11b19b..0eebbc0c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package costandusagereportservice provides a client for AWS Cost and Usage Report Service. package costandusagereportservice import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/doc.go new file mode 100644 index 00000000..53a2626a --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/doc.go @@ -0,0 +1,80 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package costandusagereportservice provides the client and types for making API +// requests to AWS Cost and Usage Report Service. +// +// All public APIs for AWS Cost and Usage Report service +// +// See https://docs.aws.amazon.com/goto/WebAPI/cur-2017-01-06 for more information on this service. +// +// See costandusagereportservice package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/costandusagereportservice/ +// +// Using the Client +// +// To use the client for AWS Cost and Usage Report 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 := costandusagereportservice.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 Cost and Usage Report Service client CostandUsageReportService for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/costandusagereportservice/#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.DeleteReportDefinition(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("DeleteReportDefinition 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.DeleteReportDefinitionWithContext(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 costandusagereportservice diff --git a/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/service.go index 78a43fc2..73fbf3e6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/costandusagereportservice/service.go @@ -11,10 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// All public APIs for AWS Cost and Usage Report service -// 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/cur-2017-01-06 +// CostandUsageReportService provides the API operation methods for making requests to +// AWS Cost and Usage Report Service. See this package's package overview docs +// for details on the service. +// +// CostandUsageReportService methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type CostandUsageReportService struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/api.go index 7dc62e75..a79d2915 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/doc.go new file mode 100644 index 00000000..c0dafec8 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/service.go index 212f2fc4..bf5b4761 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/databasemigrationservice/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/datapipeline/api.go b/vendor/github.com/aws/aws-sdk-go/service/datapipeline/api.go index 7cb18de1..c0fb7351 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/datapipeline/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/datapipeline/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package datapipeline provides a client for AWS Data Pipeline. package datapipeline import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/datapipeline/doc.go b/vendor/github.com/aws/aws-sdk-go/service/datapipeline/doc.go new file mode 100644 index 00000000..a178a650 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/datapipeline/doc.go @@ -0,0 +1,101 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package datapipeline provides the client and types for making API +// requests to AWS Data Pipeline. +// +// AWS Data Pipeline configures and manages a data-driven workflow called a +// pipeline. AWS Data Pipeline handles the details of scheduling and ensuring +// that data dependencies are met so that your application can focus on processing +// the data. +// +// AWS Data Pipeline provides a JAR implementation of a task runner called AWS +// Data Pipeline Task Runner. AWS Data Pipeline Task Runner provides logic for +// common data management scenarios, such as performing database queries and +// running data analysis using Amazon Elastic MapReduce (Amazon EMR). You can +// use AWS Data Pipeline Task Runner as your task runner, or you can write your +// own task runner to provide custom data management. +// +// AWS Data Pipeline implements two main sets of functionality. Use the first +// set to create a pipeline and define data sources, schedules, dependencies, +// and the transforms to be performed on the data. Use the second set in your +// task runner application to receive the next task ready for processing. The +// logic for performing the task, such as querying the data, running data analysis, +// or converting the data from one format to another, is contained within the +// task runner. The task runner performs the task assigned to it by the web +// service, reporting progress to the web service as it does so. When the task +// is done, the task runner reports the final success or failure of the task +// to the web service. +// +// See https://docs.aws.amazon.com/goto/WebAPI/datapipeline-2012-10-29 for more information on this service. +// +// See datapipeline package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/datapipeline/ +// +// Using the Client +// +// To use the client for AWS Data Pipeline 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 := datapipeline.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 Data Pipeline client DataPipeline for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/datapipeline/#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.ActivatePipeline(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("ActivatePipeline 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.ActivatePipelineWithContext(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 datapipeline diff --git a/vendor/github.com/aws/aws-sdk-go/service/datapipeline/service.go b/vendor/github.com/aws/aws-sdk-go/service/datapipeline/service.go index 92bac6fc..1c712288 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/datapipeline/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/datapipeline/service.go @@ -11,31 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Data Pipeline configures and manages a data-driven workflow called a -// pipeline. AWS Data Pipeline handles the details of scheduling and ensuring -// that data dependencies are met so that your application can focus on processing -// the data. +// DataPipeline provides the API operation methods for making requests to +// AWS Data Pipeline. See this package's package overview docs +// for details on the service. // -// AWS Data Pipeline provides a JAR implementation of a task runner called AWS -// Data Pipeline Task Runner. AWS Data Pipeline Task Runner provides logic for -// common data management scenarios, such as performing database queries and -// running data analysis using Amazon Elastic MapReduce (Amazon EMR). You can -// use AWS Data Pipeline Task Runner as your task runner, or you can write your -// own task runner to provide custom data management. -// -// AWS Data Pipeline implements two main sets of functionality. Use the first -// set to create a pipeline and define data sources, schedules, dependencies, -// and the transforms to be performed on the data. Use the second set in your -// task runner application to receive the next task ready for processing. The -// logic for performing the task, such as querying the data, running data analysis, -// or converting the data from one format to another, is contained within the -// task runner. The task runner performs the task assigned to it by the web -// service, reporting progress to the web service as it does so. When the task -// is done, the task runner reports the final success or failure of the task -// to the web service. -// 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/datapipeline-2012-10-29 +// DataPipeline methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type DataPipeline struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/devicefarm/api.go b/vendor/github.com/aws/aws-sdk-go/service/devicefarm/api.go index f9bb0c43..7f4e61d9 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/devicefarm/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/devicefarm/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package devicefarm provides a client for AWS Device Farm. package devicefarm import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/devicefarm/doc.go b/vendor/github.com/aws/aws-sdk-go/service/devicefarm/doc.go new file mode 100644 index 00000000..2a1ad1e6 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/devicefarm/doc.go @@ -0,0 +1,82 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package devicefarm provides the client and types for making API +// requests to AWS Device Farm. +// +// AWS Device Farm is a service that enables mobile app developers to test Android, +// iOS, and Fire OS apps on physical phones, tablets, and other devices in the +// cloud. +// +// See https://docs.aws.amazon.com/goto/WebAPI/devicefarm-2015-06-23 for more information on this service. +// +// See devicefarm package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/devicefarm/ +// +// Using the Client +// +// To use the client for AWS Device Farm 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 := devicefarm.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 Device Farm client DeviceFarm for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/devicefarm/#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.CreateDevicePool(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("CreateDevicePool 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.CreateDevicePoolWithContext(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 devicefarm diff --git a/vendor/github.com/aws/aws-sdk-go/service/devicefarm/service.go b/vendor/github.com/aws/aws-sdk-go/service/devicefarm/service.go index 7b5f1929..76cf7ca6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/devicefarm/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/devicefarm/service.go @@ -11,12 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Device Farm is a service that enables mobile app developers to test Android, -// iOS, and Fire OS apps on physical phones, tablets, and other devices in the -// cloud. -// 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/devicefarm-2015-06-23 +// DeviceFarm provides the API operation methods for making requests to +// AWS Device Farm. See this package's package overview docs +// for details on the service. +// +// DeviceFarm methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type DeviceFarm struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/directconnect/api.go b/vendor/github.com/aws/aws-sdk-go/service/directconnect/api.go index 376b6da3..69155fa8 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/directconnect/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/directconnect/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package directconnect provides a client for AWS Direct Connect. package directconnect import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/directconnect/doc.go b/vendor/github.com/aws/aws-sdk-go/service/directconnect/doc.go new file mode 100644 index 00000000..1ad9b401 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/directconnect/doc.go @@ -0,0 +1,91 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package directconnect provides the client and types for making API +// requests to AWS Direct Connect. +// +// AWS Direct Connect links your internal network to an AWS Direct Connect location +// over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end +// of the cable is connected to your router, the other to an AWS Direct Connect +// router. With this connection in place, you can create virtual interfaces +// directly to the AWS cloud (for example, to Amazon Elastic Compute Cloud (Amazon +// EC2) and Amazon Simple Storage Service (Amazon S3)) and to Amazon Virtual +// Private Cloud (Amazon VPC), bypassing Internet service providers in your +// network path. An AWS Direct Connect location provides access to AWS in the +// region it is associated with, as well as access to other US regions. For +// example, you can provision a single connection to any AWS Direct Connect +// location in the US and use it to access public AWS services in all US Regions +// and AWS GovCloud (US). +// +// See https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25 for more information on this service. +// +// See directconnect package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/directconnect/ +// +// Using the Client +// +// To use the client for AWS Direct Connect 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 := directconnect.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 Direct Connect client DirectConnect for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/directconnect/#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.AllocateConnectionOnInterconnect(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("AllocateConnectionOnInterconnect 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.AllocateConnectionOnInterconnectWithContext(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 directconnect diff --git a/vendor/github.com/aws/aws-sdk-go/service/directconnect/service.go b/vendor/github.com/aws/aws-sdk-go/service/directconnect/service.go index 6d3aca0f..1798ae11 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/directconnect/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/directconnect/service.go @@ -11,21 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Direct Connect links your internal network to an AWS Direct Connect location -// over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end -// of the cable is connected to your router, the other to an AWS Direct Connect -// router. With this connection in place, you can create virtual interfaces -// directly to the AWS cloud (for example, to Amazon Elastic Compute Cloud (Amazon -// EC2) and Amazon Simple Storage Service (Amazon S3)) and to Amazon Virtual -// Private Cloud (Amazon VPC), bypassing Internet service providers in your -// network path. An AWS Direct Connect location provides access to AWS in the -// region it is associated with, as well as access to other US regions. For -// example, you can provision a single connection to any AWS Direct Connect -// location in the US and use it to access public AWS services in all US Regions -// and AWS GovCloud (US). -// 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/directconnect-2012-10-25 +// DirectConnect provides the API operation methods for making requests to +// AWS Direct Connect. See this package's package overview docs +// for details on the service. +// +// DirectConnect methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type DirectConnect struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/directoryservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/directoryservice/api.go index 3367557d..cfc8bb05 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/directoryservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/directoryservice/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/directoryservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/directoryservice/doc.go new file mode 100644 index 00000000..35aa7b36 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/directoryservice/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/directoryservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/directoryservice/service.go index ba14d2cf..59299ae5 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/directoryservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/directoryservice/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/api.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/api.go index 95b35ba4..47c637bb 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/api.go @@ -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"` } diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/doc.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/doc.go new file mode 100644 index 00000000..256ef93e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/doc_custom.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/doc_custom.go new file mode 100644 index 00000000..53639be5 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/doc_custom.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/doc.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/doc.go index 03fd9126..7c2d05e6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/doc.go +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/doc.go @@ -1,50 +1,82 @@ -// Package dynamodbattribute provides marshaling utilities for marshaling to -// dynamodb.AttributeValue types and unmarshaling to Go value types. These -// utilities allow you to marshal slices, maps, structs, and scalar values +// Package dynamodbattribute provides marshaling and unmarshaling utilities to +// convert between Go types and dynamodb.AttributeValues. +// +// These utilities allow you to marshal slices, maps, structs, and scalar values // to and from dynamodb.AttributeValue. These are useful when marshaling // Go value tyes to dynamodb.AttributeValue for DynamoDB requests, or // unmarshaling the dynamodb.AttributeValue back into a Go value type. // -// Marshal Go value types to dynamodb.AttributeValue: See (ExampleMarshal) +// AttributeValue Marshaling +// +// To marshal a Go type to a dynamodbAttributeValue 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 { -// MyField string -// Letters []string -// A2Num map[string]int +// ID string +// URLs []string // } // -// ... +// //... // // r := Record{ -// MyField: "dynamodbattribute.Marshal example", -// Letters: []string{"a", "b", "c", "d"}, -// A2Num: map[string]int{"a": 1, "b": 2, "c": 3}, +// 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)) // } -// av, err := dynamodbattribute.Marshal(r) -// fmt.Println(av, err) // -// Unmarshal dynamodb.AttributeValue to Go value type: See (ExampleUnmarshal) +// _, err := r.svc.PutItem(&dynamodb.PutItemInput{ +// TableName: aws.String(myTableName), +// Item: av, +// }) +// if err != nil { +// panic(fmt.Sprintf("failed to put Record to DynamoDB, %v", err)) +// } // -// r2 := Record{} -// err = dynamodbattribute.Unmarshal(av, &r2) -// fmt.Println(err, reflect.DeepEqual(r, r2)) +// AttributeValue Unmarshaling // -// Marshal Go value type for DynamoDB.PutItem: +// 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. // -// sess := session.Must(session.NewSession()) +// 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. // -// svc := dynamodb.New(sess) -// item, err := dynamodbattribute.MarshalMap(r) -// if err != nil { -// fmt.Println("Failed to convert", err) -// return +// type Record struct { +// ID string +// URLs []string // } -// result, err := svc.PutItem(&dynamodb.PutItemInput{ -// Item: item, -// TableName: aws.String("exampleTable"), -// }) // +// //... +// +// 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 +// }) // // The ConvertTo, ConvertToList, ConvertToMap, ConvertFrom, ConvertFromMap // and ConvertFromList methods have been deprecated. The Marshal and Unmarshal diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/encode.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/encode.go index 51adf2f3..76680868 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/encode.go +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/encode.go @@ -14,7 +14,7 @@ import ( // and unmarshaled with DynamoDB AttributeValues it will be done so as number // instead of string in seconds since January 1, 1970 UTC. // -// This type is useful as an alterntitive to the struct tag `unixtime` when you +// This type is useful as an alternative to the struct tag `unixtime` when you // want to have your time value marshaled as Unix time in seconds intead of // the default time.RFC3339. // @@ -57,10 +57,9 @@ func (e *UnixTime) UnmarshalDynamoDBAttributeValue(av *dynamodb.AttributeValue) // type ExampleMarshaler struct { // Value int // } -// type (m *ExampleMarshaler) MarshalDynamoDBAttributeValue(av *dynamodb.AttributeValue) error { +// func (m *ExampleMarshaler) MarshalDynamoDBAttributeValue(av *dynamodb.AttributeValue) error { // n := fmt.Sprintf("%v", m.Value) // av.N = &n -// // return nil // } // @@ -159,6 +158,8 @@ func Marshal(in interface{}) (*dynamodb.AttributeValue, error) { // MarshalMap is an alias for Marshal func which marshals Go value // type to a map of AttributeValues. +// +// This is useful for DynamoDB APIs such as PutItem. func MarshalMap(in interface{}) (map[string]*dynamodb.AttributeValue, error) { av, err := NewEncoder().Encode(in) if err != nil || av == nil || av.M == nil { diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/service.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/service.go index 77827696..80dcd19f 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/dynamodb/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodb/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/api.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/api.go index 97074f42..0c514a8e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package dynamodbstreams provides a client for Amazon DynamoDB Streams. package dynamodbstreams import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/doc.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/doc.go new file mode 100644 index 00000000..f61c0b96 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/doc.go @@ -0,0 +1,83 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package dynamodbstreams provides the client and types for making API +// requests to Amazon DynamoDB Streams. +// +// Amazon DynamoDB Streams provides API actions for accessing streams and processing +// stream records. To learn more about application development with Streams, +// see Capturing Table Activity with DynamoDB Streams (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) +// in the Amazon DynamoDB Developer Guide. +// +// See https://docs.aws.amazon.com/goto/WebAPI/streams-dynamodb-2012-08-10 for more information on this service. +// +// See dynamodbstreams package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodbstreams/ +// +// Using the Client +// +// To use the client for Amazon DynamoDB Streams 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 := dynamodbstreams.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 Streams client DynamoDBStreams for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodbstreams/#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.DescribeStream(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("DescribeStream 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.DescribeStreamWithContext(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 dynamodbstreams diff --git a/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/service.go b/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/service.go index 4385a37a..038517df 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/dynamodbstreams/service.go @@ -11,13 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon DynamoDB Streams provides API actions for accessing streams and processing -// stream records. To learn more about application development with Streams, -// see Capturing Table Activity with DynamoDB Streams (http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Streams.html) -// in the Amazon DynamoDB 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/streams-dynamodb-2012-08-10 +// DynamoDBStreams provides the API operation methods for making requests to +// Amazon DynamoDB Streams. See this package's package overview docs +// for details on the service. +// +// DynamoDBStreams methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type DynamoDBStreams struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/ec2/api.go b/vendor/github.com/aws/aws-sdk-go/service/ec2/api.go index a18d9f9a..54338f0c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ec2/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ec2/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/ec2/doc.go b/vendor/github.com/aws/aws-sdk-go/service/ec2/doc.go new file mode 100644 index 00000000..4aa6618b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/ec2/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/ec2/service.go b/vendor/github.com/aws/aws-sdk-go/service/ec2/service.go index e0422054..ba4433d3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ec2/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ec2/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/ecr/api.go b/vendor/github.com/aws/aws-sdk-go/service/ecr/api.go index d0e62e3a..c06242da 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ecr/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ecr/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/ecr/doc.go b/vendor/github.com/aws/aws-sdk-go/service/ecr/doc.go new file mode 100644 index 00000000..004e50f0 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/ecr/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/ecr/service.go b/vendor/github.com/aws/aws-sdk-go/service/ecr/service.go index 76c8fa45..95de12e2 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ecr/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ecr/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/ecs/api.go b/vendor/github.com/aws/aws-sdk-go/service/ecs/api.go index 12eb794f..5ad7c367 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ecs/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ecs/api.go @@ -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"` } diff --git a/vendor/github.com/aws/aws-sdk-go/service/ecs/doc.go b/vendor/github.com/aws/aws-sdk-go/service/ecs/doc.go new file mode 100644 index 00000000..590b62e4 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/ecs/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/ecs/service.go b/vendor/github.com/aws/aws-sdk-go/service/ecs/service.go index 67ef4953..6082b928 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ecs/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ecs/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/efs/api.go b/vendor/github.com/aws/aws-sdk-go/service/efs/api.go index e137e30d..11bf91f5 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/efs/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/efs/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/efs/doc.go b/vendor/github.com/aws/aws-sdk-go/service/efs/doc.go new file mode 100644 index 00000000..c5e03b28 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/efs/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/efs/service.go b/vendor/github.com/aws/aws-sdk-go/service/efs/service.go index ae189c19..4d6bb2cd 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/efs/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/efs/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticache/api.go b/vendor/github.com/aws/aws-sdk-go/service/elasticache/api.go index f72386b3..3006029c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elasticache/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticache/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticache/doc.go b/vendor/github.com/aws/aws-sdk-go/service/elasticache/doc.go new file mode 100644 index 00000000..3abbaa26 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticache/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticache/service.go b/vendor/github.com/aws/aws-sdk-go/service/elasticache/service.go index 1ae97a03..40bed298 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elasticache/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticache/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/api.go b/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/api.go index b8db05a3..cd2d0fb7 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/doc.go b/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/doc.go new file mode 100644 index 00000000..257afe09 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/service.go b/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/service.go index 91c3b4df..e5650961 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticbeanstalk/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/api.go index b7d3ca20..4a07953d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/doc.go new file mode 100644 index 00000000..543a11af --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/service.go index ee2acc49..c4388e79 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elasticsearchservice/service.go @@ -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 } diff --git a/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/api.go b/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/api.go index a4c0d3f3..dc719ef0 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/api.go @@ -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 ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/doc.go b/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/doc.go new file mode 100644 index 00000000..cfaacdf4 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/doc.go @@ -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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/service.go b/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/service.go index 7060799d..29d15e2e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elastictranscoder/service.go @@ -11,9 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// The AWS Elastic Transcoder Service. -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// ElasticTranscoder provides the API operation methods for making requests to +// Amazon Elastic Transcoder. See this package's package overview docs +// for details on the service. +// +// ElasticTranscoder methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type ElasticTranscoder struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/elb/api.go b/vendor/github.com/aws/aws-sdk-go/service/elb/api.go index ed376a51..00129c5a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elb/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elb/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package elb provides a client for Elastic Load Balancing. package elb import ( @@ -64,7 +63,7 @@ func (c *ELB) AddTagsRequest(input *AddTagsInput) (req *request.Request, output // key is already associated with the load balancer, AddTags updates its value. // // For more information, see Tag Your Classic Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/add-remove-tags.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -156,7 +155,7 @@ func (c *ELB) ApplySecurityGroupsToLoadBalancerRequest(input *ApplySecurityGroup // associated security groups. // // For more information, see Security Groups for Load Balancers in a VPC (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html#elb-vpc-security-groups) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -248,7 +247,7 @@ func (c *ELB) AttachLoadBalancerToSubnetsRequest(input *AttachLoadBalancerToSubn // The load balancer evenly distributes requests across all registered subnets. // For more information, see Add or Remove Subnets for Your Load Balancer in // a VPC (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-manage-subnets.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -342,7 +341,7 @@ func (c *ELB) ConfigureHealthCheckRequest(input *ConfigureHealthCheckInput) (req // // For more information, see Configure Health Checks for Your Load Balancer // (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-healthchecks.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -436,7 +435,7 @@ func (c *ELB) CreateAppCookieStickinessPolicyRequest(input *CreateAppCookieStick // being sticky until a new application cookie is issued. // // For more information, see Application-Controlled Session Stickiness (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-application) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -541,7 +540,7 @@ func (c *ELB) CreateLBCookieStickinessPolicyRequest(input *CreateLBCookieStickin // cookie expiration time, which is specified in the policy configuration. // // For more information, see Duration-Based Session Stickiness (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-duration) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -630,7 +629,7 @@ func (c *ELB) CreateLoadBalancerRequest(input *CreateLoadBalancerInput) (req *re // CreateLoadBalancer API operation for Elastic Load Balancing. // -// Creates a Classic load balancer. +// Creates a Classic Load Balancer. // // You can add listeners, security groups, subnets, and tags when you create // your load balancer, or you can add them later using CreateLoadBalancerListeners, @@ -642,7 +641,7 @@ func (c *ELB) CreateLoadBalancerRequest(input *CreateLoadBalancerInput) (req *re // You can create up to 20 load balancers per region per account. You can request // an increase for the number of load balancers for your account. For more information, // see Limits for Your Classic Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-limits.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -688,6 +687,7 @@ func (c *ELB) CreateLoadBalancerRequest(input *CreateLoadBalancerInput) (req *re // A tag key was specified more than once. // // * ErrCodeUnsupportedProtocolException "UnsupportedProtocol" +// The specified protocol or signature version is not supported. // // Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/CreateLoadBalancer func (c *ELB) CreateLoadBalancer(input *CreateLoadBalancerInput) (*CreateLoadBalancerOutput, error) { @@ -762,7 +762,7 @@ func (c *ELB) CreateLoadBalancerListenersRequest(input *CreateLoadBalancerListen // listener. // // For more information, see Listeners for Your Classic Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -789,6 +789,7 @@ func (c *ELB) CreateLoadBalancerListenersRequest(input *CreateLoadBalancerListen // The requested configuration change is not valid. // // * ErrCodeUnsupportedProtocolException "UnsupportedProtocol" +// The specified protocol or signature version is not supported. // // Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/CreateLoadBalancerListeners func (c *ELB) CreateLoadBalancerListeners(input *CreateLoadBalancerListenersInput) (*CreateLoadBalancerListenersOutput, error) { @@ -1209,7 +1210,7 @@ func (c *ELB) DeregisterInstancesFromLoadBalancerRequest(input *DeregisterInstan // from the load balancer. // // For more information, see Register or De-Register EC2 Instances (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-deregister-register-instances.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -1247,6 +1248,85 @@ func (c *ELB) DeregisterInstancesFromLoadBalancerWithContext(ctx aws.Context, in return out, req.Send() } +const opDescribeAccountLimits = "DescribeAccountLimits" + +// DescribeAccountLimitsRequest generates a "aws/request.Request" representing the +// client's request for the DescribeAccountLimits operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See DescribeAccountLimits for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the DescribeAccountLimits method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the DescribeAccountLimitsRequest method. +// req, resp := client.DescribeAccountLimitsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/DescribeAccountLimits +func (c *ELB) DescribeAccountLimitsRequest(input *DescribeAccountLimitsInput) (req *request.Request, output *DescribeAccountLimitsOutput) { + op := &request.Operation{ + Name: opDescribeAccountLimits, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeAccountLimitsInput{} + } + + output = &DescribeAccountLimitsOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeAccountLimits API operation for Elastic Load Balancing. +// +// Describes the current Elastic Load Balancing resource limits for your AWS +// account. +// +// For more information, see Limits for Your Classic Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-limits.html) +// in the Classic Load Balancer 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 +// the error. +// +// See the AWS API reference guide for Elastic Load Balancing's +// API operation DescribeAccountLimits for usage and error information. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/DescribeAccountLimits +func (c *ELB) DescribeAccountLimits(input *DescribeAccountLimitsInput) (*DescribeAccountLimitsOutput, error) { + req, out := c.DescribeAccountLimitsRequest(input) + return out, req.Send() +} + +// DescribeAccountLimitsWithContext is the same as DescribeAccountLimits with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeAccountLimits for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *ELB) DescribeAccountLimitsWithContext(ctx aws.Context, input *DescribeAccountLimitsInput, opts ...request.Option) (*DescribeAccountLimitsOutput, error) { + req, out := c.DescribeAccountLimitsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeInstanceHealth = "DescribeInstanceHealth" // DescribeInstanceHealthRequest generates a "aws/request.Request" representing the @@ -1961,7 +2041,7 @@ func (c *ELB) DisableAvailabilityZonesForLoadBalancerRequest(input *DisableAvail // the traffic among its remaining Availability Zones. // // For more information, see Add or Remove Availability Zones (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -2051,7 +2131,7 @@ func (c *ELB) EnableAvailabilityZonesForLoadBalancerRequest(input *EnableAvailab // Zones that contain instances. // // For more information, see Add or Remove Availability Zones (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -2138,7 +2218,7 @@ func (c *ELB) ModifyLoadBalancerAttributesRequest(input *ModifyLoadBalancerAttri // can modify the load balancer attribute ConnectionSettings by specifying an // idle connection timeout value for your load balancer. // -// For more information, see the following in the Classic Load Balancers Guide: +// For more information, see the following in the Classic Load Balancer Guide: // // * Cross-Zone Load Balancing (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html) // @@ -2254,7 +2334,7 @@ func (c *ELB) RegisterInstancesWithLoadBalancerRequest(input *RegisterInstancesW // To deregister instances from a load balancer, use DeregisterInstancesFromLoadBalancer. // // For more information, see Register or De-Register EC2 Instances (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-deregister-register-instances.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -2423,7 +2503,7 @@ func (c *ELB) SetLoadBalancerListenerSSLCertificateRequest(input *SetLoadBalance // // For more information about updating your SSL certificate, see Replace the // SSL Certificate for Your Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-update-ssl-cert.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -2449,6 +2529,7 @@ func (c *ELB) SetLoadBalancerListenerSSLCertificateRequest(input *SetLoadBalance // The requested configuration change is not valid. // // * ErrCodeUnsupportedProtocolException "UnsupportedProtocol" +// The specified protocol or signature version is not supported. // // Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/SetLoadBalancerListenerSSLCertificate func (c *ELB) SetLoadBalancerListenerSSLCertificate(input *SetLoadBalancerListenerSSLCertificateInput) (*SetLoadBalancerListenerSSLCertificateOutput, error) { @@ -2530,9 +2611,9 @@ func (c *ELB) SetLoadBalancerPoliciesForBackendServerRequest(input *SetLoadBalan // // For more information about enabling back-end instance authentication, see // Configure Back-end Instance Authentication (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-create-https-ssl-load-balancer.html#configure_backendauth_clt) -// in the Classic Load Balancers Guide. For more information about Proxy Protocol, +// in the Classic Load Balancer Guide. For more information about Proxy Protocol, // see Configure Proxy Protocol Support (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-proxy-protocol.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -2627,7 +2708,7 @@ func (c *ELB) SetLoadBalancerPoliciesOfListenerRequest(input *SetLoadBalancerPol // Configuration (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/ssl-config-update.html), // Duration-Based Session Stickiness (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-duration), // and Application-Controlled Session Stickiness (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-sticky-sessions.html#enable-sticky-sessions-application) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer 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 @@ -3453,7 +3534,7 @@ type CreateLoadBalancerInput struct { // The listeners. // // For more information, see Listeners for Your Classic Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html) - // in the Classic Load Balancers Guide. + // in the Classic Load Balancer Guide. // // Listeners is a required field Listeners []*Listener `type:"list" required:"true"` @@ -3490,7 +3571,7 @@ type CreateLoadBalancerInput struct { // // For more information about tagging your load balancer, see Tag Your Classic // Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/add-remove-tags.html) - // in the Classic Load Balancers Guide. + // in the Classic Load Balancer Guide. Tags []*Tag `min:"1" type:"list"` } @@ -4099,6 +4180,87 @@ func (s *DeregisterInstancesFromLoadBalancerOutput) SetInstances(v []*Instance) return s } +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/DescribeAccountLimitsInput +type DescribeAccountLimitsInput struct { + _ struct{} `type:"structure"` + + // The marker for the next set of results. (You received this marker from a + // previous call.) + Marker *string `type:"string"` + + // The maximum number of results to return with this call. + PageSize *int64 `min:"1" type:"integer"` +} + +// String returns the string representation +func (s DescribeAccountLimitsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeAccountLimitsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DescribeAccountLimitsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DescribeAccountLimitsInput"} + if s.PageSize != nil && *s.PageSize < 1 { + invalidParams.Add(request.NewErrParamMinValue("PageSize", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMarker sets the Marker field's value. +func (s *DescribeAccountLimitsInput) SetMarker(v string) *DescribeAccountLimitsInput { + s.Marker = &v + return s +} + +// SetPageSize sets the PageSize field's value. +func (s *DescribeAccountLimitsInput) SetPageSize(v int64) *DescribeAccountLimitsInput { + s.PageSize = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/DescribeAccountLimitsOutput +type DescribeAccountLimitsOutput struct { + _ struct{} `type:"structure"` + + // Information about the limits. + Limits []*Limit `type:"list"` + + // The marker to use when requesting the next set of results. If there are no + // additional results, the string is empty. + NextMarker *string `type:"string"` +} + +// String returns the string representation +func (s DescribeAccountLimitsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeAccountLimitsOutput) GoString() string { + return s.String() +} + +// SetLimits sets the Limits field's value. +func (s *DescribeAccountLimitsOutput) SetLimits(v []*Limit) *DescribeAccountLimitsOutput { + s.Limits = v + return s +} + +// SetNextMarker sets the NextMarker field's value. +func (s *DescribeAccountLimitsOutput) SetNextMarker(v string) *DescribeAccountLimitsOutput { + s.NextMarker = &v + return s +} + // Contains the parameters for DescribeInstanceHealth. // Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/DescribeEndPointStateInput type DescribeInstanceHealthInput struct { @@ -5024,11 +5186,49 @@ func (s *LBCookieStickinessPolicy) SetPolicyName(v string) *LBCookieStickinessPo return s } +// Information about an Elastic Load Balancing resource limit for your AWS account. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/Limit +type Limit struct { + _ struct{} `type:"structure"` + + // The maximum value of the limit. + Max *string `type:"string"` + + // The name of the limit. The possible values are: + // + // * classic-listeners + // + // * classic-load-balancers + Name *string `type:"string"` +} + +// String returns the string representation +func (s Limit) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s Limit) GoString() string { + return s.String() +} + +// SetMax sets the Max field's value. +func (s *Limit) SetMax(v string) *Limit { + s.Max = &v + return s +} + +// SetName sets the Name field's value. +func (s *Limit) SetName(v string) *Limit { + s.Name = &v + return s +} + // Information about a listener. // // For information about the protocols and the ports supported by Elastic Load // Balancing, see Listeners for Your Classic Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html) -// in the Classic Load Balancers Guide. +// in the Classic Load Balancer Guide. // Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01/Listener type Listener struct { _ struct{} `type:"structure"` @@ -5135,11 +5335,7 @@ func (s *Listener) SetSSLCertificateId(v string) *Listener { type ListenerDescription struct { _ struct{} `type:"structure"` - // Information about a listener. - // - // For information about the protocols and the ports supported by Elastic Load - // Balancing, see Listeners for Your Classic Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-listener-config.html) - // in the Classic Load Balancers Guide. + // The listener. Listener *Listener `type:"structure"` // The policies. If there are no policies enabled, the list is empty. @@ -5177,7 +5373,7 @@ type LoadBalancerAttributes struct { // and delivers the information to the Amazon S3 bucket that you specify. // // For more information, see Enable Access Logs (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-access-logs.html) - // in the Classic Load Balancers Guide. + // in the Classic Load Balancer Guide. AccessLog *AccessLog `type:"structure"` // This parameter is reserved. @@ -5187,7 +5383,7 @@ type LoadBalancerAttributes struct { // the load balancer shifts traffic away from a deregistered or unhealthy instance. // // For more information, see Configure Connection Draining (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html) - // in the Classic Load Balancers Guide. + // in the Classic Load Balancer Guide. ConnectionDraining *ConnectionDraining `type:"structure"` // If enabled, the load balancer allows the connections to remain idle (no data @@ -5196,14 +5392,14 @@ type LoadBalancerAttributes struct { // By default, Elastic Load Balancing maintains a 60-second idle connection // timeout for both front-end and back-end connections of your load balancer. // For more information, see Configure Idle Connection Timeout (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html) - // in the Classic Load Balancers Guide. + // in the Classic Load Balancer Guide. ConnectionSettings *ConnectionSettings `type:"structure"` // If enabled, the load balancer routes the request traffic evenly across all // instances regardless of the Availability Zones. // // For more information, see Configure Cross-Zone Load Balancing (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html) - // in the Classic Load Balancers Guide. + // in the Classic Load Balancer Guide. CrossZoneLoadBalancing *CrossZoneLoadBalancing `type:"structure"` } @@ -5291,7 +5487,7 @@ type LoadBalancerDescription struct { // The DNS name of the load balancer. // // For more information, see Configure a Custom Domain Name (http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/using-domain-names-with-elb.html) - // in the Classic Load Balancers Guide. + // in the Classic Load Balancer Guide. CanonicalHostedZoneName *string `type:"string"` // The ID of the Amazon Route 53 hosted zone for the load balancer. @@ -5455,7 +5651,7 @@ func (s *LoadBalancerDescription) SetVPCId(v string) *LoadBalancerDescription { type ModifyLoadBalancerAttributesInput struct { _ struct{} `type:"structure"` - // The attributes of the load balancer. + // The attributes for the load balancer. // // LoadBalancerAttributes is a required field LoadBalancerAttributes *LoadBalancerAttributes `type:"structure" required:"true"` @@ -5514,7 +5710,7 @@ func (s *ModifyLoadBalancerAttributesInput) SetLoadBalancerName(v string) *Modif type ModifyLoadBalancerAttributesOutput struct { _ struct{} `type:"structure"` - // The attributes for a load balancer. + // Information about the load balancer attributes. LoadBalancerAttributes *LoadBalancerAttributes `type:"structure"` // The name of the load balancer. diff --git a/vendor/github.com/aws/aws-sdk-go/service/elb/doc.go b/vendor/github.com/aws/aws-sdk-go/service/elb/doc.go new file mode 100644 index 00000000..60b4f119 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/elb/doc.go @@ -0,0 +1,107 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package elb provides the client and types for making API +// requests to Elastic Load Balancing. +// +// A load balancer distributes incoming traffic across your EC2 instances. This +// enables you to increase the availability of your application. The load balancer +// also monitors the health of its registered instances and ensures that it +// routes traffic only to healthy instances. You configure your load balancer +// to accept incoming traffic by specifying one or more listeners, which are +// configured with a protocol and port number for connections from clients to +// the load balancer and a protocol and port number for connections from the +// load balancer to the instances. +// +// Elastic Load Balancing supports two types of load balancers: Classic Load +// Balancers and Application Load Balancers (new). A Classic Load Balancer makes +// routing and load balancing decisions either at the transport layer (TCP/SSL) +// or the application layer (HTTP/HTTPS), and supports either EC2-Classic or +// a VPC. An Application Load Balancer makes routing and load balancing decisions +// at the application layer (HTTP/HTTPS), supports path-based routing, and can +// route requests to one or more ports on each EC2 instance or container instance +// in your virtual private cloud (VPC). For more information, see the Elastic +// Load Balancing User Guide (http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/what-is-load-balancing.html). +// +// This reference covers the 2012-06-01 API, which supports Classic Load Balancers. +// The 2015-12-01 API supports Application Load Balancers. +// +// To get started, create a load balancer with one or more listeners using CreateLoadBalancer. +// Register your instances with the load balancer using RegisterInstancesWithLoadBalancer. +// +// All Elastic Load Balancing operations are idempotent, which means that they +// complete at most one time. If you repeat an operation, it succeeds with a +// 200 OK response code. +// +// See https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancing-2012-06-01 for more information on this service. +// +// See elb package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/elb/ +// +// Using the Client +// +// To use the client for Elastic Load Balancing 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 := elb.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 Elastic Load Balancing client ELB for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/elb/#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 elb diff --git a/vendor/github.com/aws/aws-sdk-go/service/elb/elbiface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/elb/elbiface/interface.go index 241a3f0d..33efa994 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elb/elbiface/interface.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elb/elbiface/interface.go @@ -112,6 +112,10 @@ type ELBAPI interface { DeregisterInstancesFromLoadBalancerWithContext(aws.Context, *elb.DeregisterInstancesFromLoadBalancerInput, ...request.Option) (*elb.DeregisterInstancesFromLoadBalancerOutput, error) DeregisterInstancesFromLoadBalancerRequest(*elb.DeregisterInstancesFromLoadBalancerInput) (*request.Request, *elb.DeregisterInstancesFromLoadBalancerOutput) + DescribeAccountLimits(*elb.DescribeAccountLimitsInput) (*elb.DescribeAccountLimitsOutput, error) + DescribeAccountLimitsWithContext(aws.Context, *elb.DescribeAccountLimitsInput, ...request.Option) (*elb.DescribeAccountLimitsOutput, error) + DescribeAccountLimitsRequest(*elb.DescribeAccountLimitsInput) (*request.Request, *elb.DescribeAccountLimitsOutput) + DescribeInstanceHealth(*elb.DescribeInstanceHealthInput) (*elb.DescribeInstanceHealthOutput, error) DescribeInstanceHealthWithContext(aws.Context, *elb.DescribeInstanceHealthInput, ...request.Option) (*elb.DescribeInstanceHealthOutput, error) DescribeInstanceHealthRequest(*elb.DescribeInstanceHealthInput) (*request.Request, *elb.DescribeInstanceHealthOutput) diff --git a/vendor/github.com/aws/aws-sdk-go/service/elb/errors.go b/vendor/github.com/aws/aws-sdk-go/service/elb/errors.go index 97042c05..77ffb20e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elb/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elb/errors.go @@ -130,5 +130,7 @@ const ( // ErrCodeUnsupportedProtocolException for service response error code // "UnsupportedProtocol". + // + // The specified protocol or signature version is not supported. ErrCodeUnsupportedProtocolException = "UnsupportedProtocol" ) diff --git a/vendor/github.com/aws/aws-sdk-go/service/elb/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/elb/examples_test.go index ddf56b03..7a08f805 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elb/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elb/examples_test.go @@ -377,6 +377,28 @@ func ExampleELB_DeregisterInstancesFromLoadBalancer() { fmt.Println(resp) } +func ExampleELB_DescribeAccountLimits() { + sess := session.Must(session.NewSession()) + + svc := elb.New(sess) + + params := &elb.DescribeAccountLimitsInput{ + Marker: aws.String("Marker"), + PageSize: aws.Int64(1), + } + resp, err := svc.DescribeAccountLimits(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + func ExampleELB_DescribeInstanceHealth() { sess := session.Must(session.NewSession()) diff --git a/vendor/github.com/aws/aws-sdk-go/service/elb/service.go b/vendor/github.com/aws/aws-sdk-go/service/elb/service.go index 1c83ec5e..057530f6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elb/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elb/service.go @@ -11,36 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// A load balancer distributes incoming traffic across your EC2 instances. This -// enables you to increase the availability of your application. The load balancer -// also monitors the health of its registered instances and ensures that it -// routes traffic only to healthy instances. You configure your load balancer -// to accept incoming traffic by specifying one or more listeners, which are -// configured with a protocol and port number for connections from clients to -// the load balancer and a protocol and port number for connections from the -// load balancer to the instances. +// ELB provides the API operation methods for making requests to +// Elastic Load Balancing. See this package's package overview docs +// for details on the service. // -// Elastic Load Balancing supports two types of load balancers: Classic load -// balancers and Application load balancers (new). A Classic load balancer makes -// routing and load balancing decisions either at the transport layer (TCP/SSL) -// or the application layer (HTTP/HTTPS), and supports either EC2-Classic or -// a VPC. An Application load balancer makes routing and load balancing decisions -// at the application layer (HTTP/HTTPS), supports path-based routing, and can -// route requests to one or more ports on each EC2 instance or container instance -// in your virtual private cloud (VPC). For more information, see the . -// -// This reference covers the 2012-06-01 API, which supports Classic load balancers. -// The 2015-12-01 API supports Application load balancers. -// -// To get started, create a load balancer with one or more listeners using CreateLoadBalancer. -// Register your instances with the load balancer using RegisterInstancesWithLoadBalancer. -// -// All Elastic Load Balancing operations are idempotent, which means that they -// complete at most one time. If you repeat an operation, it succeeds with a -// 200 OK response code. -// 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/elasticloadbalancing-2012-06-01 +// ELB methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type ELB struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/elbv2/api.go b/vendor/github.com/aws/aws-sdk-go/service/elbv2/api.go index 5a83828b..d5fadd72 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elbv2/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elbv2/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package elbv2 provides a client for Elastic Load Balancing. package elbv2 import ( @@ -986,6 +985,85 @@ func (c *ELBV2) DeregisterTargetsWithContext(ctx aws.Context, input *DeregisterT return out, req.Send() } +const opDescribeAccountLimits = "DescribeAccountLimits" + +// DescribeAccountLimitsRequest generates a "aws/request.Request" representing the +// client's request for the DescribeAccountLimits operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See DescribeAccountLimits for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the DescribeAccountLimits method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the DescribeAccountLimitsRequest method. +// req, resp := client.DescribeAccountLimitsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits +func (c *ELBV2) DescribeAccountLimitsRequest(input *DescribeAccountLimitsInput) (req *request.Request, output *DescribeAccountLimitsOutput) { + op := &request.Operation{ + Name: opDescribeAccountLimits, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeAccountLimitsInput{} + } + + output = &DescribeAccountLimitsOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeAccountLimits API operation for Elastic Load Balancing. +// +// Describes the current Elastic Load Balancing resource limits for your AWS +// account. +// +// For more information, see Limits for Your Application Load Balancer (http://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-limits.html) +// in the Application Load Balancer 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 +// the error. +// +// See the AWS API reference guide for Elastic Load Balancing's +// API operation DescribeAccountLimits for usage and error information. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/DescribeAccountLimits +func (c *ELBV2) DescribeAccountLimits(input *DescribeAccountLimitsInput) (*DescribeAccountLimitsOutput, error) { + req, out := c.DescribeAccountLimitsRequest(input) + return out, req.Send() +} + +// DescribeAccountLimitsWithContext is the same as DescribeAccountLimits with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeAccountLimits for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *ELBV2) DescribeAccountLimitsWithContext(ctx aws.Context, input *DescribeAccountLimitsInput, opts ...request.Option) (*DescribeAccountLimitsOutput, error) { + req, out := c.DescribeAccountLimitsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeListeners = "DescribeListeners" // DescribeListenersRequest generates a "aws/request.Request" representing the @@ -4095,6 +4173,87 @@ func (s DeregisterTargetsOutput) GoString() string { return s.String() } +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/DescribeAccountLimitsInput +type DescribeAccountLimitsInput struct { + _ struct{} `type:"structure"` + + // The marker for the next set of results. (You received this marker from a + // previous call.) + Marker *string `type:"string"` + + // The maximum number of results to return with this call. + PageSize *int64 `min:"1" type:"integer"` +} + +// String returns the string representation +func (s DescribeAccountLimitsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeAccountLimitsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DescribeAccountLimitsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DescribeAccountLimitsInput"} + if s.PageSize != nil && *s.PageSize < 1 { + invalidParams.Add(request.NewErrParamMinValue("PageSize", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMarker sets the Marker field's value. +func (s *DescribeAccountLimitsInput) SetMarker(v string) *DescribeAccountLimitsInput { + s.Marker = &v + return s +} + +// SetPageSize sets the PageSize field's value. +func (s *DescribeAccountLimitsInput) SetPageSize(v int64) *DescribeAccountLimitsInput { + s.PageSize = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/DescribeAccountLimitsOutput +type DescribeAccountLimitsOutput struct { + _ struct{} `type:"structure"` + + // Information about the limits. + Limits []*Limit `type:"list"` + + // The marker to use when requesting the next set of results. If there are no + // additional results, the string is empty. + NextMarker *string `type:"string"` +} + +// String returns the string representation +func (s DescribeAccountLimitsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeAccountLimitsOutput) GoString() string { + return s.String() +} + +// SetLimits sets the Limits field's value. +func (s *DescribeAccountLimitsOutput) SetLimits(v []*Limit) *DescribeAccountLimitsOutput { + s.Limits = v + return s +} + +// SetNextMarker sets the NextMarker field's value. +func (s *DescribeAccountLimitsOutput) SetNextMarker(v string) *DescribeAccountLimitsOutput { + s.NextMarker = &v + return s +} + // Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/DescribeListenersInput type DescribeListenersInput struct { _ struct{} `type:"structure"` @@ -4820,6 +4979,50 @@ func (s *DescribeTargetHealthOutput) SetTargetHealthDescriptions(v []*TargetHeal return s } +// Information about an Elastic Load Balancing resource limit for your AWS account. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/Limit +type Limit struct { + _ struct{} `type:"structure"` + + // The maximum value of the limit. + Max *string `type:"string"` + + // The name of the limit. The possible values are: + // + // * application-load-balancers + // + // * listeners-per-application-load-balancer + // + // * rules-per-application-load-balancer + // + // * target-groups + // + // * targets-per-application-load-balancer + Name *string `type:"string"` +} + +// String returns the string representation +func (s Limit) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s Limit) GoString() string { + return s.String() +} + +// SetMax sets the Max field's value. +func (s *Limit) SetMax(v string) *Limit { + s.Max = &v + return s +} + +// SetName sets the Name field's value. +func (s *Limit) SetName(v string) *Limit { + s.Name = &v + return s +} + // Information about a listener. // Please also see https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01/Listener type Listener struct { diff --git a/vendor/github.com/aws/aws-sdk-go/service/elbv2/doc.go b/vendor/github.com/aws/aws-sdk-go/service/elbv2/doc.go new file mode 100644 index 00000000..4c8224cc --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/elbv2/doc.go @@ -0,0 +1,125 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package elbv2 provides the client and types for making API +// requests to Elastic Load Balancing. +// +// A load balancer distributes incoming traffic across targets, such as your +// EC2 instances. This enables you to increase the availability of your application. +// The load balancer also monitors the health of its registered targets and +// ensures that it routes traffic only to healthy targets. You configure your +// load balancer to accept incoming traffic by specifying one or more listeners, +// which are configured with a protocol and port number for connections from +// clients to the load balancer. You configure a target group with a protocol +// and port number for connections from the load balancer to the targets, and +// with health check settings to be used when checking the health status of +// the targets. +// +// Elastic Load Balancing supports two types of load balancers: Classic Load +// Balancers and Application Load Balancers. A Classic Load Balancer makes routing +// and load balancing decisions either at the transport layer (TCP/SSL) or the +// application layer (HTTP/HTTPS), and supports either EC2-Classic or a VPC. +// An Application Load Balancer makes routing and load balancing decisions at +// the application layer (HTTP/HTTPS), supports path-based routing, and can +// route requests to one or more ports on each EC2 instance or container instance +// in your virtual private cloud (VPC). For more information, see the Elastic +// Load Balancing User Guide (http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/). +// +// This reference covers the 2015-12-01 API, which supports Application Load +// Balancers. The 2012-06-01 API supports Classic Load Balancers. +// +// To get started, complete the following tasks: +// +// Create an Application Load Balancer using CreateLoadBalancer. +// +// Create a target group using CreateTargetGroup. +// +// Register targets for the target group using RegisterTargets. +// +// Create one or more listeners for your load balancer using CreateListener. +// +// (Optional) Create one or more rules for content routing based on URL using +// CreateRule. +// +// To delete an Application Load Balancer and its related resources, complete +// the following tasks: +// +// Delete the load balancer using DeleteLoadBalancer. +// +// Delete the target group using DeleteTargetGroup. +// +// All Elastic Load Balancing operations are idempotent, which means that they +// complete at most one time. If you repeat an operation, it succeeds. +// +// See https://docs.aws.amazon.com/goto/WebAPI/elasticloadbalancingv2-2015-12-01 for more information on this service. +// +// See elbv2 package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/elbv2/ +// +// Using the Client +// +// To use the client for Elastic Load Balancing 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 := elbv2.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 Elastic Load Balancing client ELBV2 for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/elbv2/#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 elbv2 diff --git a/vendor/github.com/aws/aws-sdk-go/service/elbv2/elbv2iface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/elbv2/elbv2iface/interface.go index 1d99a35e..f4a5014d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elbv2/elbv2iface/interface.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elbv2/elbv2iface/interface.go @@ -100,6 +100,10 @@ type ELBV2API interface { DeregisterTargetsWithContext(aws.Context, *elbv2.DeregisterTargetsInput, ...request.Option) (*elbv2.DeregisterTargetsOutput, error) DeregisterTargetsRequest(*elbv2.DeregisterTargetsInput) (*request.Request, *elbv2.DeregisterTargetsOutput) + DescribeAccountLimits(*elbv2.DescribeAccountLimitsInput) (*elbv2.DescribeAccountLimitsOutput, error) + DescribeAccountLimitsWithContext(aws.Context, *elbv2.DescribeAccountLimitsInput, ...request.Option) (*elbv2.DescribeAccountLimitsOutput, error) + DescribeAccountLimitsRequest(*elbv2.DescribeAccountLimitsInput) (*request.Request, *elbv2.DescribeAccountLimitsOutput) + DescribeListeners(*elbv2.DescribeListenersInput) (*elbv2.DescribeListenersOutput, error) DescribeListenersWithContext(aws.Context, *elbv2.DescribeListenersInput, ...request.Option) (*elbv2.DescribeListenersOutput, error) DescribeListenersRequest(*elbv2.DescribeListenersInput) (*request.Request, *elbv2.DescribeListenersOutput) diff --git a/vendor/github.com/aws/aws-sdk-go/service/elbv2/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/elbv2/examples_test.go index 2d4f66cc..b8e16c8d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elbv2/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elbv2/examples_test.go @@ -306,6 +306,28 @@ func ExampleELBV2_DeregisterTargets() { fmt.Println(resp) } +func ExampleELBV2_DescribeAccountLimits() { + sess := session.Must(session.NewSession()) + + svc := elbv2.New(sess) + + params := &elbv2.DescribeAccountLimitsInput{ + Marker: aws.String("Marker"), + PageSize: aws.Int64(1), + } + resp, err := svc.DescribeAccountLimits(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + func ExampleELBV2_DescribeListeners() { sess := session.Must(session.NewSession()) diff --git a/vendor/github.com/aws/aws-sdk-go/service/elbv2/service.go b/vendor/github.com/aws/aws-sdk-go/service/elbv2/service.go index 57e07924..c3733846 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/elbv2/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/elbv2/service.go @@ -11,55 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// A load balancer distributes incoming traffic across targets, such as your -// EC2 instances. This enables you to increase the availability of your application. -// The load balancer also monitors the health of its registered targets and -// ensures that it routes traffic only to healthy targets. You configure your -// load balancer to accept incoming traffic by specifying one or more listeners, -// which are configured with a protocol and port number for connections from -// clients to the load balancer. You configure a target group with a protocol -// and port number for connections from the load balancer to the targets, and -// with health check settings to be used when checking the health status of -// the targets. +// ELBV2 provides the API operation methods for making requests to +// Elastic Load Balancing. See this package's package overview docs +// for details on the service. // -// Elastic Load Balancing supports two types of load balancers: Classic Load -// Balancers and Application Load Balancers. A Classic Load Balancer makes routing -// and load balancing decisions either at the transport layer (TCP/SSL) or the -// application layer (HTTP/HTTPS), and supports either EC2-Classic or a VPC. -// An Application Load Balancer makes routing and load balancing decisions at -// the application layer (HTTP/HTTPS), supports path-based routing, and can -// route requests to one or more ports on each EC2 instance or container instance -// in your virtual private cloud (VPC). For more information, see the Elastic -// Load Balancing User Guide (http://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/). -// -// This reference covers the 2015-12-01 API, which supports Application Load -// Balancers. The 2012-06-01 API supports Classic Load Balancers. -// -// To get started, complete the following tasks: -// -// Create an Application Load Balancer using CreateLoadBalancer. -// -// Create a target group using CreateTargetGroup. -// -// Register targets for the target group using RegisterTargets. -// -// Create one or more listeners for your load balancer using CreateListener. -// -// (Optional) Create one or more rules for content routing based on URL using -// CreateRule. -// -// To delete an Application Load Balancer and its related resources, complete -// the following tasks: -// -// Delete the load balancer using DeleteLoadBalancer. -// -// Delete the target group using DeleteTargetGroup. -// -// All Elastic Load Balancing operations are idempotent, which means that they -// complete at most one time. If you repeat an operation, it succeeds. -// 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/elasticloadbalancingv2-2015-12-01 +// ELBV2 methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type ELBV2 struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/emr/api.go b/vendor/github.com/aws/aws-sdk-go/service/emr/api.go index 5fa88f56..d7eb0abe 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/emr/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/emr/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package emr provides a client for Amazon Elastic MapReduce. package emr import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/emr/doc.go b/vendor/github.com/aws/aws-sdk-go/service/emr/doc.go new file mode 100644 index 00000000..9b9fe1e7 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/emr/doc.go @@ -0,0 +1,83 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package emr provides the client and types for making API +// requests to Amazon Elastic MapReduce. +// +// Amazon EMR is a web service that makes it easy to process large amounts of +// data efficiently. Amazon EMR uses Hadoop processing combined with several +// AWS products to do tasks such as web indexing, data mining, log file analysis, +// machine learning, scientific simulation, and data warehousing. +// +// See https://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31 for more information on this service. +// +// See emr package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/emr/ +// +// Using the Client +// +// To use the client for Amazon Elastic MapReduce 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 := emr.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 MapReduce client EMR for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/emr/#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.AddInstanceFleet(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("AddInstanceFleet 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.AddInstanceFleetWithContext(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 emr diff --git a/vendor/github.com/aws/aws-sdk-go/service/emr/service.go b/vendor/github.com/aws/aws-sdk-go/service/emr/service.go index 04d982bc..61fc4258 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/emr/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/emr/service.go @@ -11,13 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon EMR is a web service that makes it easy to process large amounts of -// data efficiently. Amazon EMR uses Hadoop processing combined with several -// AWS products to do tasks such as web indexing, data mining, log file analysis, -// machine learning, scientific simulation, and data warehousing. -// 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/elasticmapreduce-2009-03-31 +// EMR provides the API operation methods for making requests to +// Amazon Elastic MapReduce. See this package's package overview docs +// for details on the service. +// +// EMR methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type EMR struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/firehose/api.go b/vendor/github.com/aws/aws-sdk-go/service/firehose/api.go index 0a4eb541..f404386c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/firehose/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/firehose/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package firehose provides a client for Amazon Kinesis Firehose. package firehose import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/firehose/doc.go b/vendor/github.com/aws/aws-sdk-go/service/firehose/doc.go new file mode 100644 index 00000000..96f708af --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/firehose/doc.go @@ -0,0 +1,82 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package firehose provides the client and types for making API +// requests to Amazon Kinesis Firehose. +// +// Amazon Kinesis Firehose is a fully-managed service that delivers real-time +// streaming data to destinations such as Amazon Simple Storage Service (Amazon +// S3), Amazon Elasticsearch Service (Amazon ES), and Amazon Redshift. +// +// See https://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04 for more information on this service. +// +// See firehose package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/firehose/ +// +// Using the Client +// +// To use the client for Amazon Kinesis Firehose 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 := firehose.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 Kinesis Firehose client Firehose for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/firehose/#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.CreateDeliveryStream(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("CreateDeliveryStream 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.CreateDeliveryStreamWithContext(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 firehose diff --git a/vendor/github.com/aws/aws-sdk-go/service/firehose/service.go b/vendor/github.com/aws/aws-sdk-go/service/firehose/service.go index 08350cf6..973386c0 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/firehose/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/firehose/service.go @@ -11,12 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon Kinesis Firehose is a fully-managed service that delivers real-time -// streaming data to destinations such as Amazon Simple Storage Service (Amazon -// S3), Amazon Elasticsearch Service (Amazon ES), and Amazon Redshift. -// 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/firehose-2015-08-04 +// Firehose provides the API operation methods for making requests to +// Amazon Kinesis Firehose. See this package's package overview docs +// for details on the service. +// +// Firehose methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Firehose struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/gamelift/api.go b/vendor/github.com/aws/aws-sdk-go/service/gamelift/api.go index cdea4350..f1ffffec 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/gamelift/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/gamelift/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package gamelift provides a client for Amazon GameLift. package gamelift import ( @@ -294,13 +293,17 @@ func (c *GameLift) CreateFleetRequest(input *CreateFleetInput) (req *request.Req // A newly created fleet passes through several statuses; once it reaches the // ACTIVE status, it can begin hosting game sessions. // -// To create a new fleet, provide a fleet name, an EC2 instance type, and a -// build ID of the game build to deploy. You can also configure the new fleet -// with the following settings: (1) a runtime configuration describing what -// server processes to run on each instance in the fleet (required to create -// fleet), (2) access permissions for inbound traffic, (3) fleet-wide game session -// protection, and (4) the location of default log files for Amazon GameLift -// to upload and store. +// To create a new fleet, you must specify the following: (1) fleet name, (2) +// build ID of an uploaded game build, (3) an EC2 instance type, and (4) a runtime +// configuration that describes which server processes to run on each instance +// in the fleet. (Although the runtime configuration is not a required parameter, +// the fleet cannot be successfully created without it.) You can also configure +// the new fleet with the following settings: fleet description, access permissions +// for inbound traffic, fleet-wide game session protection, and resource creation +// limit. If you use Amazon CloudWatch for metrics, you can add the new fleet +// to a metric group, which allows you to view aggregated metrics for a set +// of fleets. Once you specify a metric group, the new fleet's metrics are included +// in the metric group's data. // // If the CreateFleet call is successful, Amazon GameLift performs the following // tasks: @@ -637,6 +640,10 @@ func (c *GameLift) CreateGameSessionQueueRequest(input *CreateGameSessionQueueIn // * ErrCodeUnauthorizedException "UnauthorizedException" // The client failed authentication. Clients should not retry such requests. // +// * ErrCodeLimitExceededException "LimitExceededException" +// The requested operation would cause the resource to exceed the allowed service +// limit. Resolve the issue before retrying. +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateGameSessionQueue func (c *GameLift) CreateGameSessionQueue(input *CreateGameSessionQueueInput) (*CreateGameSessionQueueOutput, error) { req, out := c.CreateGameSessionQueueRequest(input) @@ -3985,33 +3992,44 @@ func (c *GameLift) StartGameSessionPlacementRequest(input *StartGameSessionPlace // Places a request for a new game session in a queue (see CreateGameSessionQueue). // When processing a placement request, Amazon GameLift searches for available // resources on the queue's destinations, scanning each until it finds resources -// or the placement request times out. A game session placement request can -// also request player sessions. When a new game session is successfully created, -// Amazon GameLift creates a player session for each player included in the -// request. +// or the placement request times out. +// +// A game session placement request can also request player sessions. When a +// new game session is successfully created, Amazon GameLift creates a player +// session for each player included in the request. // // When placing a game session, by default Amazon GameLift tries each fleet // in the order they are listed in the queue configuration. Ideally, a queue's -// destinations are listed in preference order. Alternatively, when requesting -// a game session with players, you can also provide latency data for each player -// in relevant regions. Latency data indicates the performance lag a player -// experiences when connected to a fleet in the region. Amazon GameLift uses -// latency data to reorder the list of destinations to place the game session -// in a region with minimal lag. If latency data is provided for multiple players, -// Amazon GameLift calculates each region's average lag for all players and -// reorders to get the best game play across all players. -// -// To place a new game session request, specify the queue name and a set of -// game session properties and settings. Also provide a unique ID (such as a -// UUID) for the placement. You'll use this ID to track the status of the placement -// request. Optionally, provide a set of IDs and player data for each player -// you want to join to the new game session. To optimize game play for the players, -// also provide latency data for all players. If successful, a new game session -// placement is created. To track the status of a placement request, call DescribeGameSessionPlacement +// destinations are listed in preference order. +// +// Alternatively, when requesting a game session with players, you can also +// provide latency data for each player in relevant regions. Latency data indicates +// the performance lag a player experiences when connected to a fleet in the +// region. Amazon GameLift uses latency data to reorder the list of destinations +// to place the game session in a region with minimal lag. If latency data is +// provided for multiple players, Amazon GameLift calculates each region's average +// lag for all players and reorders to get the best game play across all players. +// +// To place a new game session request, specify the following: +// +// * The queue name and a set of game session properties and settings +// +// * A unique ID (such as a UUID) for the placement. You use this ID to track +// the status of the placement request +// +// * (Optional) A set of IDs and player data for each player you want to +// join to the new game session +// +// * Latency data for all players (if you want to optimize game play for +// the players) +// +// If successful, a new game session placement is created. +// +// To track the status of a placement request, call DescribeGameSessionPlacement // and check the request's status. If the status is Fulfilled, a new game session // has been created and a game session ARN and region are referenced. If the -// placement request times out, you have the option of resubmitting the request -// or retrying it with a different queue. +// placement request times out, you can resubmit the request or retry it with +// a different queue. // // 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 @@ -5511,6 +5529,11 @@ type CreateFleetInput struct { // See more information in the Server API Reference (http://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api-ref.html#gamelift-sdk-server-api-ref-dataypes-process). LogPaths []*string `type:"list"` + // Names of metric groups to add this fleet to. Use an existing metric group + // name to add this fleet to the group, or use a new name to create a new metric + // group. Currently, a fleet can only be included in one metric group at a time. + MetricGroups []*string `type:"list"` + // Descriptive label that is associated with a fleet. Fleet names do not need // to be unique. // @@ -5646,6 +5669,12 @@ func (s *CreateFleetInput) SetLogPaths(v []*string) *CreateFleetInput { return s } +// SetMetricGroups sets the MetricGroups field's value. +func (s *CreateFleetInput) SetMetricGroups(v []*string) *CreateFleetInput { + s.MetricGroups = v + return s +} + // SetName sets the Name field's value. func (s *CreateFleetInput) SetName(v string) *CreateFleetInput { s.Name = &v @@ -8355,6 +8384,12 @@ type FleetAttributes struct { // stored logs. LogPaths []*string `type:"list"` + // Names of metric groups that this fleet is included in. In Amazon CloudWatch, + // you can view metrics for an individual fleet or aggregated metrics for a + // fleets that are in a fleet metric group. Currently, a fleet can be included + // in only one metric group at a time. + MetricGroups []*string `type:"list"` + // Descriptive label that is associated with a fleet. Fleet names do not need // to be unique. Name *string `min:"1" type:"string"` @@ -8460,6 +8495,12 @@ func (s *FleetAttributes) SetLogPaths(v []*string) *FleetAttributes { return s } +// SetMetricGroups sets the MetricGroups field's value. +func (s *FleetAttributes) SetMetricGroups(v []*string) *FleetAttributes { + s.MetricGroups = v + return s +} + // SetName sets the Name field's value. func (s *FleetAttributes) SetName(v string) *FleetAttributes { s.Name = &v @@ -9096,7 +9137,7 @@ type GameSessionQueue struct { // ARN. Destinations are listed in default preference order. Destinations []*GameSessionQueueDestination `type:"list"` - // Amazon Resource Name (ARN (http://docs.aws.amazon.com/docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html)) + // Amazon Resource Name (ARN (http://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html)) // that is assigned to a game session queue and uniquely identifies it. Format // is arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. GameSessionQueueArn *string `min:"1" type:"string"` @@ -10730,8 +10771,18 @@ func (s *RoutingStrategy) SetType(v string) *RoutingStrategy { type RuntimeConfiguration struct { _ struct{} `type:"structure"` - // Collection of server process configurations describing what server processes - // to run on each instance in a fleet + // Maximum amount of time (in seconds) that a game session can remain in status + // ACTIVATING. If the game session is not active before the timeout, activation + // is terminated and the game session status is changed to TERMINATED. + GameSessionActivationTimeoutSeconds *int64 `min:"1" type:"integer"` + + // Maximum number of game sessions with status ACTIVATING to allow on an instance + // simultaneously. This setting limits the amount of instance resources that + // can be used for new game activations at any one time. + MaxConcurrentGameSessionActivations *int64 `min:"1" type:"integer"` + + // Collection of server process configurations that describe which server processes + // to run on each instance in a fleet. ServerProcesses []*ServerProcess `min:"1" type:"list"` } @@ -10748,6 +10799,12 @@ func (s RuntimeConfiguration) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *RuntimeConfiguration) Validate() error { invalidParams := request.ErrInvalidParams{Context: "RuntimeConfiguration"} + if s.GameSessionActivationTimeoutSeconds != nil && *s.GameSessionActivationTimeoutSeconds < 1 { + invalidParams.Add(request.NewErrParamMinValue("GameSessionActivationTimeoutSeconds", 1)) + } + if s.MaxConcurrentGameSessionActivations != nil && *s.MaxConcurrentGameSessionActivations < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxConcurrentGameSessionActivations", 1)) + } if s.ServerProcesses != nil && len(s.ServerProcesses) < 1 { invalidParams.Add(request.NewErrParamMinLen("ServerProcesses", 1)) } @@ -10768,6 +10825,18 @@ func (s *RuntimeConfiguration) Validate() error { return nil } +// SetGameSessionActivationTimeoutSeconds sets the GameSessionActivationTimeoutSeconds field's value. +func (s *RuntimeConfiguration) SetGameSessionActivationTimeoutSeconds(v int64) *RuntimeConfiguration { + s.GameSessionActivationTimeoutSeconds = &v + return s +} + +// SetMaxConcurrentGameSessionActivations sets the MaxConcurrentGameSessionActivations field's value. +func (s *RuntimeConfiguration) SetMaxConcurrentGameSessionActivations(v int64) *RuntimeConfiguration { + s.MaxConcurrentGameSessionActivations = &v + return s +} + // SetServerProcesses sets the ServerProcesses field's value. func (s *RuntimeConfiguration) SetServerProcesses(v []*ServerProcess) *RuntimeConfiguration { s.ServerProcesses = v @@ -11704,6 +11773,13 @@ type UpdateFleetAttributesInput struct { // FleetId is a required field FleetId *string `type:"string" required:"true"` + // Names of metric groups to include this fleet with. A fleet metric group is + // used in Amazon CloudWatch to aggregate metrics from multiple fleets. Use + // an existing metric group name to add this fleet to the group, or use a new + // name to create a new metric group. Currently, a fleet can only be included + // in one metric group at a time. + MetricGroups []*string `type:"list"` + // Descriptive label that is associated with a fleet. Fleet names do not need // to be unique. Name *string `min:"1" type:"string"` @@ -11765,6 +11841,12 @@ func (s *UpdateFleetAttributesInput) SetFleetId(v string) *UpdateFleetAttributes return s } +// SetMetricGroups sets the MetricGroups field's value. +func (s *UpdateFleetAttributesInput) SetMetricGroups(v []*string) *UpdateFleetAttributesInput { + s.MetricGroups = v + return s +} + // SetName sets the Name field's value. func (s *UpdateFleetAttributesInput) SetName(v string) *UpdateFleetAttributesInput { s.Name = &v @@ -12609,6 +12691,9 @@ const ( // MetricNameActiveInstances is a MetricName enum value MetricNameActiveInstances = "ActiveInstances" + // MetricNameAvailableGameSessions is a MetricName enum value + MetricNameAvailableGameSessions = "AvailableGameSessions" + // MetricNameAvailablePlayerSessions is a MetricName enum value MetricNameAvailablePlayerSessions = "AvailablePlayerSessions" @@ -12618,6 +12703,12 @@ const ( // MetricNameIdleInstances is a MetricName enum value MetricNameIdleInstances = "IdleInstances" + // MetricNamePercentAvailableGameSessions is a MetricName enum value + MetricNamePercentAvailableGameSessions = "PercentAvailableGameSessions" + + // MetricNamePercentIdleInstances is a MetricName enum value + MetricNamePercentIdleInstances = "PercentIdleInstances" + // MetricNameQueueDepth is a MetricName enum value MetricNameQueueDepth = "QueueDepth" diff --git a/vendor/github.com/aws/aws-sdk-go/service/gamelift/doc.go b/vendor/github.com/aws/aws-sdk-go/service/gamelift/doc.go new file mode 100644 index 00000000..51a79ec8 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/gamelift/doc.go @@ -0,0 +1,291 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package gamelift provides the client and types for making API +// requests to Amazon GameLift. +// +// Amazon GameLift is a managed service for developers who need a scalable, +// dedicated server solution for their multiplayer games. Amazon GameLift provides +// tools to acquire computing resources and deploy game servers, scale game +// server capacity to meet player demand, and track in-depth metrics on player +// usage and server performance. +// +// The Amazon GameLift service API includes important features: +// +// * Find game sessions and match players to games – Retrieve information +// on available game sessions; create new game sessions; send player requests +// to join a game session. +// +// * Configure and manage game server resources – Manage builds, fleets, +// queues, and aliases; set autoscaling policies; retrieve logs and metrics. +// +// This reference guide describes the low-level service API for Amazon GameLift. +// We recommend using either the Amazon Web Services software development kit +// (AWS SDK (http://aws.amazon.com/tools/#sdk)), available in multiple languages, +// or the AWS command-line interface (http://aws.amazon.com/cli/) (CLI) tool. +// Both of these align with the low-level service API. In addition, you can +// use the AWS Management Console (https://console.aws.amazon.com/gamelift/home) +// for Amazon GameLift for many administrative actions. +// +// You can use some API actions with Amazon GameLift Local, a testing tool that +// lets you test your game integration locally before deploying on Amazon GameLift. +// You can call these APIs from the AWS CLI or programmatically; API calls to +// Amazon GameLift Local servers perform exactly as they do when calling Amazon +// GameLift web servers. For more information on using Amazon GameLift Local, +// see Testing an Integration (http://docs.aws.amazon.com/gamelift/latest/developerguide/integration-testing-local.html). +// +// MORE RESOURCES +// +// * Amazon GameLift Developer Guide (http://docs.aws.amazon.com/gamelift/latest/developerguide/) +// – Learn more about Amazon GameLift features and how to use them. +// +// * Lumberyard and Amazon GameLift Tutorials (https://gamedev.amazon.com/forums/tutorials) +// – Get started fast with walkthroughs and sample projects. +// +// * GameDev Blog (http://aws.amazon.com/blogs/gamedev/) – Stay up to date +// with new features and techniques. +// +// * GameDev Forums (https://gamedev.amazon.com/forums/spaces/123/gamelift-discussion.html) +// – Connect with the GameDev community. +// +// * Amazon GameLift Document History (http://docs.aws.amazon.com/gamelift/latest/developerguide/doc-history.html) +// – See changes to the Amazon GameLift service, SDKs, and documentation, +// as well as links to release notes. +// +// API SUMMARY +// +// This list offers a functional overview of the Amazon GameLift service API. +// +// Finding Games and Joining Players +// +// You can enable players to connect to game servers on Amazon GameLift from +// a game client or through a game service (such as a matchmaking service). +// You can use these operations to discover actively running game or start new +// games. You can also match players to games, either singly or as a group. +// +// * Discover existing game sessions +// +// SearchGameSessions – Get all available game sessions or search for game sessions +// that match a set of criteria. Available in Amazon GameLift Local. +// +// * Start a new game session +// +// Game session placement – Use a queue to process new game session requests +// and create game sessions on fleets designated for the queue. +// +// StartGameSessionPlacement – Request a new game session placement and add +// one or more players to it. +// +// DescribeGameSessionPlacement – Get details on a placement request, including +// status. +// +// StopGameSessionPlacement – Cancel a placement request. +// +// CreateGameSession – Start a new game session on a specific fleet. Available +// in Amazon GameLift Local. +// +// * Manage game session objects +// +// DescribeGameSessions – Retrieve metadata for one or more game sessions, including +// length of time active and current player count. Available in Amazon GameLift +// Local. +// +// DescribeGameSessionDetails – Retrieve metadata and the game session protection +// setting for one or more game sessions. +// +// UpdateGameSession – Change game session settings, such as maximum player +// count and join policy. +// +// GetGameSessionLogUrl – Get the location of saved logs for a game session. +// +// * Manage player sessions objects +// +// CreatePlayerSession – Send a request for a player to join a game session. +// Available in Amazon GameLift Local. +// +// CreatePlayerSessions – Send a request for multiple players to join a game +// session. Available in Amazon GameLift Local. +// +// DescribePlayerSessions – Get details on player activity, including status, +// playing time, and player data. Available in Amazon GameLift Local. +// +// Setting Up and Managing Game Servers +// +// When setting up Amazon GameLift, first create a game build and upload the +// files to Amazon GameLift. Then use these operations to set up a fleet of +// resources to run your game servers. Manage games to scale capacity, adjust +// configuration settings, access raw utilization data, and more. +// +// * Manage game builds +// +// CreateBuild – Create a new build by uploading files stored in an Amazon S3 +// bucket. (To create a build stored at a local file location, use the AWS +// CLI command upload-build.) +// +// ListBuilds – Get a list of all builds uploaded to a Amazon GameLift region. +// +// DescribeBuild – Retrieve information associated with a build. +// +// UpdateBuild – Change build metadata, including build name and version. +// +// DeleteBuild – Remove a build from Amazon GameLift. +// +// * Manage fleets +// +// CreateFleet – Configure and activate a new fleet to run a build's game servers. +// +// DeleteFleet – Terminate a fleet that is no longer running game servers or +// hosting players. +// +// View / update fleet configurations. +// +// ListFleets – Get a list of all fleet IDs in a Amazon GameLift region (all +// statuses). +// +// DescribeFleetAttributes / UpdateFleetAttributes – View or change a fleet's +// metadata and settings for game session protection and resource creation +// limits. +// +// DescribeFleetPortSettings / UpdateFleetPortSettings – View or change the +// inbound permissions (IP address and port setting ranges) allowed for a +// fleet. +// +// DescribeRuntimeConfiguration / UpdateRuntimeConfiguration – View or change +// what server processes (and how many) to run on each instance in a fleet. +// +// DescribeInstances – Get information on each instance in a fleet, including +// instance ID, IP address, and status. +// +// * Control fleet capacity +// +// DescribeEC2InstanceLimits – Retrieve maximum number of instances allowed +// for the current AWS account and the current usage level. +// +// DescribeFleetCapacity / UpdateFleetCapacity – Retrieve the capacity settings +// and the current number of instances in a fleet; adjust fleet capacity +// settings to scale up or down. +// +// Autoscale – Manage autoscaling rules and apply them to a fleet. +// +// PutScalingPolicy – Create a new autoscaling policy, or update an existing +// one. +// +// DescribeScalingPolicies – Retrieve an existing autoscaling policy. +// +// DeleteScalingPolicy – Delete an autoscaling policy and stop it from affecting +// a fleet's capacity. +// +// * Access fleet activity statistics +// +// DescribeFleetUtilization – Get current data on the number of server processes, +// game sessions, and players currently active on a fleet. +// +// DescribeFleetEvents – Get a fleet's logged events for a specified time span. +// +// DescribeGameSessions – Retrieve metadata associated with one or more game +// sessions, including length of time active and current player count. +// +// * Remotely access an instance +// +// GetInstanceAccess – Request access credentials needed to remotely connect +// to a specified instance in a fleet. +// +// * Manage fleet aliases +// +// CreateAlias – Define a new alias and optionally assign it to a fleet. +// +// ListAliases – Get all fleet aliases defined in a Amazon GameLift region. +// +// DescribeAlias – Retrieve information on an existing alias. +// +// UpdateAlias – Change settings for a alias, such as redirecting it from one +// fleet to another. +// +// DeleteAlias – Remove an alias from the region. +// +// ResolveAlias – Get the fleet ID that a specified alias points to. +// +// * Manage game session queues +// +// CreateGameSessionQueue – Create a queue for processing requests for new game +// sessions. +// +// DescribeGameSessionQueues – Get data on all game session queues defined in +// a Amazon GameLift region. +// +// UpdateGameSessionQueue – Change the configuration of a game session queue. +// +// DeleteGameSessionQueue – Remove a game session queue from the region. +// +// See https://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01 for more information on this service. +// +// See gamelift package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/gamelift/ +// +// Using the Client +// +// To use the client for Amazon GameLift 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 := gamelift.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 GameLift client GameLift for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/gamelift/#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.CreateAlias(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("CreateAlias 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.CreateAliasWithContext(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 gamelift diff --git a/vendor/github.com/aws/aws-sdk-go/service/gamelift/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/gamelift/examples_test.go index 4c596e86..c871a86d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/gamelift/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/gamelift/examples_test.go @@ -93,12 +93,18 @@ func ExampleGameLift_CreateFleet() { aws.String("NonZeroAndMaxString"), // Required // More values... }, + MetricGroups: []*string{ + aws.String("MetricGroup"), // Required + // More values... + }, NewGameSessionProtectionPolicy: aws.String("ProtectionPolicy"), ResourceCreationLimitPolicy: &gamelift.ResourceCreationLimitPolicy{ NewGameSessionsPerCreator: aws.Int64(1), PolicyPeriodInMinutes: aws.Int64(1), }, RuntimeConfiguration: &gamelift.RuntimeConfiguration{ + GameSessionActivationTimeoutSeconds: aws.Int64(1), + MaxConcurrentGameSessionActivations: aws.Int64(1), ServerProcesses: []*gamelift.ServerProcess{ { // Required ConcurrentExecutions: aws.Int64(1), // Required @@ -1067,7 +1073,11 @@ func ExampleGameLift_UpdateFleetAttributes() { params := &gamelift.UpdateFleetAttributesInput{ FleetId: aws.String("FleetId"), // Required Description: aws.String("NonZeroAndMaxString"), - Name: aws.String("NonZeroAndMaxString"), + MetricGroups: []*string{ + aws.String("MetricGroup"), // Required + // More values... + }, + Name: aws.String("NonZeroAndMaxString"), NewGameSessionProtectionPolicy: aws.String("ProtectionPolicy"), ResourceCreationLimitPolicy: &gamelift.ResourceCreationLimitPolicy{ NewGameSessionsPerCreator: aws.Int64(1), @@ -1218,6 +1228,8 @@ func ExampleGameLift_UpdateRuntimeConfiguration() { params := &gamelift.UpdateRuntimeConfigurationInput{ FleetId: aws.String("FleetId"), // Required RuntimeConfiguration: &gamelift.RuntimeConfiguration{ // Required + GameSessionActivationTimeoutSeconds: aws.Int64(1), + MaxConcurrentGameSessionActivations: aws.Int64(1), ServerProcesses: []*gamelift.ServerProcess{ { // Required ConcurrentExecutions: aws.Int64(1), // Required diff --git a/vendor/github.com/aws/aws-sdk-go/service/gamelift/service.go b/vendor/github.com/aws/aws-sdk-go/service/gamelift/service.go index 80e33b2a..b79ac204 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/gamelift/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/gamelift/service.go @@ -11,221 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon GameLift is a managed service for developers who need a scalable, -// dedicated server solution for their multiplayer games. Amazon GameLift provides -// tools to acquire computing resources and deploy game servers, scale game -// server capacity to meet player demand, and track in-depth metrics on player -// usage and server performance. +// GameLift provides the API operation methods for making requests to +// Amazon GameLift. See this package's package overview docs +// for details on the service. // -// The Amazon GameLift service API includes important features: -// -// * Find game sessions and match players to games – Retrieve information -// on available game sessions; create new game sessions; send player requests -// to join a game session. -// -// * Configure and manage game server resources – Manage builds, fleets, -// queues, and aliases; set autoscaling policies; retrieve logs and metrics. -// -// This reference guide describes the low-level service API for Amazon GameLift. -// We recommend using either the Amazon Web Services software development kit -// (AWS SDK (http://aws.amazon.com/tools/#sdk)), available in multiple languages, -// or the AWS command-line interface (http://aws.amazon.com/cli/) (CLI) tool. -// Both of these align with the low-level service API. In addition, you can -// use the AWS Management Console (https://console.aws.amazon.com/gamelift/home) -// for Amazon GameLift for many administrative actions. -// -// You can use some API actions with Amazon GameLift Local, a testing tool that -// lets you test your game integration locally before deploying on Amazon GameLift. -// You can call these APIs from the AWS CLI or programmatically; API calls to -// Amazon GameLift Local servers perform exactly as they do when calling Amazon -// GameLift web servers. For more information on using Amazon GameLift Local, -// see Testing an Integration (http://docs.aws.amazon.com/gamelift/latest/developerguide/integration-testing-local.html). -// -// MORE RESOURCES -// -// * Amazon GameLift Developer Guide (http://docs.aws.amazon.com/gamelift/latest/developerguide/) -// – Learn more about Amazon GameLift features and how to use them. -// -// * Lumberyard and Amazon GameLift Tutorials (https://gamedev.amazon.com/forums/tutorials) -// – Get started fast with walkthroughs and sample projects. -// -// * GameDev Blog (http://aws.amazon.com/blogs/gamedev/) – Stay up to date -// with new features and techniques. -// -// * GameDev Forums (https://gamedev.amazon.com/forums/spaces/123/gamelift-discussion.html) -// – Connect with the GameDev community. -// -// * Amazon GameLift Document History (http://docs.aws.amazon.com/gamelift/latest/developerguide/doc-history.html) -// – See changes to the Amazon GameLift service, SDKs, and documentation, -// as well as links to release notes. -// -// API SUMMARY -// -// This list offers a functional overview of the Amazon GameLift service API. -// -// Finding Games and Joining Players -// -// You can enable players to connect to game servers on Amazon GameLift from -// a game client or through a game service (such as a matchmaking service). -// You can use these operations to discover actively running game or start new -// games. You can also match players to games, either singly or as a group. -// -// * Discover existing game sessions -// -// SearchGameSessions – Get all available game sessions or search for game sessions -// that match a set of criteria. Available in Amazon GameLift Local. -// -// * Start a new game session -// -// Game session placement – Use a queue to process new game session requests -// and create game sessions on fleets designated for the queue. -// -// StartGameSessionPlacement – Request a new game session placement and add -// one or more players to it. -// -// DescribeGameSessionPlacement – Get details on a placement request, including -// status. -// -// StopGameSessionPlacement – Cancel a placement request. -// -// CreateGameSession – Start a new game session on a specific fleet. Available -// in Amazon GameLift Local. -// -// * Manage game session objects -// -// DescribeGameSessions – Retrieve metadata for one or more game sessions, including -// length of time active and current player count. Available in Amazon GameLift -// Local. -// -// DescribeGameSessionDetails – Retrieve metadata and the game session protection -// setting for one or more game sessions. -// -// UpdateGameSession – Change game session settings, such as maximum player -// count and join policy. -// -// GetGameSessionLogUrl – Get the location of saved logs for a game session. -// -// * Manage player sessions objects -// -// CreatePlayerSession – Send a request for a player to join a game session. -// Available in Amazon GameLift Local. -// -// CreatePlayerSessions – Send a request for multiple players to join a game -// session. Available in Amazon GameLift Local. -// -// DescribePlayerSessions – Get details on player activity, including status, -// playing time, and player data. Available in Amazon GameLift Local. -// -// Setting Up and Managing Game Servers -// -// When setting up Amazon GameLift, first create a game build and upload the -// files to Amazon GameLift. Then use these operations to set up a fleet of -// resources to run your game servers. Manage games to scale capacity, adjust -// configuration settings, access raw utilization data, and more. -// -// * Manage game builds -// -// CreateBuild – Create a new build by uploading files stored in an Amazon S3 -// bucket. (To create a build stored at a local file location, use the AWS -// CLI command upload-build.) -// -// ListBuilds – Get a list of all builds uploaded to a Amazon GameLift region. -// -// DescribeBuild – Retrieve information associated with a build. -// -// UpdateBuild – Change build metadata, including build name and version. -// -// DeleteBuild – Remove a build from Amazon GameLift. -// -// * Manage fleets -// -// CreateFleet – Configure and activate a new fleet to run a build's game servers. -// -// DeleteFleet – Terminate a fleet that is no longer running game servers or -// hosting players. -// -// View / update fleet configurations. -// -// ListFleets – Get a list of all fleet IDs in a Amazon GameLift region (all -// statuses). -// -// DescribeFleetAttributes / UpdateFleetAttributes – View or change a fleet's -// metadata and settings for game session protection and resource creation -// limits. -// -// DescribeFleetPortSettings / UpdateFleetPortSettings – View or change the -// inbound permissions (IP address and port setting ranges) allowed for a -// fleet. -// -// DescribeRuntimeConfiguration / UpdateRuntimeConfiguration – View or change -// what server processes (and how many) to run on each instance in a fleet. -// -// DescribeInstances – Get information on each instance in a fleet, including -// instance ID, IP address, and status. -// -// * Control fleet capacity -// -// DescribeEC2InstanceLimits – Retrieve maximum number of instances allowed -// for the current AWS account and the current usage level. -// -// DescribeFleetCapacity / UpdateFleetCapacity – Retrieve the capacity settings -// and the current number of instances in a fleet; adjust fleet capacity -// settings to scale up or down. -// -// Autoscale – Manage autoscaling rules and apply them to a fleet. -// -// PutScalingPolicy – Create a new autoscaling policy, or update an existing -// one. -// -// DescribeScalingPolicies – Retrieve an existing autoscaling policy. -// -// DeleteScalingPolicy – Delete an autoscaling policy and stop it from affecting -// a fleet's capacity. -// -// * Access fleet activity statistics -// -// DescribeFleetUtilization – Get current data on the number of server processes, -// game sessions, and players currently active on a fleet. -// -// DescribeFleetEvents – Get a fleet's logged events for a specified time span. -// -// DescribeGameSessions – Retrieve metadata associated with one or more game -// sessions, including length of time active and current player count. -// -// * Remotely access an instance -// -// GetInstanceAccess – Request access credentials needed to remotely connect -// to a specified instance in a fleet. -// -// * Manage fleet aliases -// -// CreateAlias – Define a new alias and optionally assign it to a fleet. -// -// ListAliases – Get all fleet aliases defined in a Amazon GameLift region. -// -// DescribeAlias – Retrieve information on an existing alias. -// -// UpdateAlias – Change settings for a alias, such as redirecting it from one -// fleet to another. -// -// DeleteAlias – Remove an alias from the region. -// -// ResolveAlias – Get the fleet ID that a specified alias points to. -// -// * Manage game session queues -// -// CreateGameSessionQueue – Create a queue for processing requests for new game -// sessions. -// -// DescribeGameSessionQueues – Get data on all game session queues defined in -// a Amazon GameLift region. -// -// UpdateGameSessionQueue – Change the configuration of a game session queue. -// -// DeleteGameSessionQueue – Remove a game session queue from the region. -// 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/gamelift-2015-10-01 +// GameLift methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type GameLift struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/glacier/api.go b/vendor/github.com/aws/aws-sdk-go/service/glacier/api.go index 2fc06cc1..d7f70375 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/glacier/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/glacier/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package glacier provides a client for Amazon Glacier. package glacier import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/glacier/doc.go b/vendor/github.com/aws/aws-sdk-go/service/glacier/doc.go new file mode 100644 index 00000000..1aa05e8e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/glacier/doc.go @@ -0,0 +1,108 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package glacier provides the client and types for making API +// requests to Amazon Glacier. +// +// Amazon Glacier is a storage solution for "cold data." +// +// Amazon Glacier is an extremely low-cost storage service that provides secure, +// durable, and easy-to-use storage for data backup and archival. With Amazon +// Glacier, customers can store their data cost effectively for months, years, +// or decades. Amazon Glacier also enables customers to offload the administrative +// burdens of operating and scaling storage to AWS, so they don't have to worry +// about capacity planning, hardware provisioning, data replication, hardware +// failure and recovery, or time-consuming hardware migrations. +// +// Amazon Glacier is a great storage choice when low storage cost is paramount, +// your data is rarely retrieved, and retrieval latency of several hours is +// acceptable. If your application requires fast or frequent access to your +// data, consider using Amazon S3. For more information, see Amazon Simple Storage +// Service (Amazon S3) (http://aws.amazon.com/s3/). +// +// You can store any kind of data in any format. There is no maximum limit on +// the total amount of data you can store in Amazon Glacier. +// +// If you are a first-time user of Amazon Glacier, we recommend that you begin +// by reading the following sections in the Amazon Glacier Developer Guide: +// +// * What is Amazon Glacier (http://docs.aws.amazon.com/amazonglacier/latest/dev/introduction.html) +// - This section of the Developer Guide describes the underlying data model, +// the operations it supports, and the AWS SDKs that you can use to interact +// with the service. +// +// * Getting Started with Amazon Glacier (http://docs.aws.amazon.com/amazonglacier/latest/dev/amazon-glacier-getting-started.html) +// - The Getting Started section walks you through the process of creating +// a vault, uploading archives, creating jobs to download archives, retrieving +// the job output, and deleting archives. +// +// See glacier package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/glacier/ +// +// Using the Client +// +// To use the client for Amazon Glacier 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 := glacier.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 Glacier client Glacier for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/glacier/#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.AbortMultipartUpload(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("AbortMultipartUpload 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.AbortMultipartUploadWithContext(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 glacier diff --git a/vendor/github.com/aws/aws-sdk-go/service/glacier/service.go b/vendor/github.com/aws/aws-sdk-go/service/glacier/service.go index 7caefefd..b875f0fa 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/glacier/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/glacier/service.go @@ -11,39 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Amazon Glacier is a storage solution for "cold data." +// Glacier provides the API operation methods for making requests to +// Amazon Glacier. See this package's package overview docs +// for details on the service. // -// Amazon Glacier is an extremely low-cost storage service that provides secure, -// durable, and easy-to-use storage for data backup and archival. With Amazon -// Glacier, customers can store their data cost effectively for months, years, -// or decades. Amazon Glacier also enables customers to offload the administrative -// burdens of operating and scaling storage to AWS, so they don't have to worry -// about capacity planning, hardware provisioning, data replication, hardware -// failure and recovery, or time-consuming hardware migrations. -// -// Amazon Glacier is a great storage choice when low storage cost is paramount, -// your data is rarely retrieved, and retrieval latency of several hours is -// acceptable. If your application requires fast or frequent access to your -// data, consider using Amazon S3. For more information, see Amazon Simple Storage -// Service (Amazon S3) (http://aws.amazon.com/s3/). -// -// You can store any kind of data in any format. There is no maximum limit on -// the total amount of data you can store in Amazon Glacier. -// -// If you are a first-time user of Amazon Glacier, we recommend that you begin -// by reading the following sections in the Amazon Glacier Developer Guide: -// -// * What is Amazon Glacier (http://docs.aws.amazon.com/amazonglacier/latest/dev/introduction.html) -// - This section of the Developer Guide describes the underlying data model, -// the operations it supports, and the AWS SDKs that you can use to interact -// with the service. -// -// * Getting Started with Amazon Glacier (http://docs.aws.amazon.com/amazonglacier/latest/dev/amazon-glacier-getting-started.html) -// - The Getting Started section walks you through the process of creating -// a vault, uploading archives, creating jobs to download archives, retrieving -// the job output, and deleting archives. -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// Glacier methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Glacier struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/health/api.go b/vendor/github.com/aws/aws-sdk-go/service/health/api.go index 62794ff3..e9db9ca8 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/health/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/health/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package health provides a client for AWS Health APIs and Notifications. package health import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/health/doc.go b/vendor/github.com/aws/aws-sdk-go/service/health/doc.go new file mode 100644 index 00000000..4cdd9f97 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/health/doc.go @@ -0,0 +1,117 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package health provides the client and types for making API +// requests to AWS Health APIs and Notifications. +// +// The AWS Health API provides programmatic access to the AWS Health information +// that is presented in the AWS Personal Health Dashboard (https://phd.aws.amazon.com/phd/home#/). +// You can get information about events that affect your AWS resources: +// +// * DescribeEvents: Summary information about events. +// +// * DescribeEventDetails: Detailed information about one or more events. +// +// * DescribeAffectedEntities: Information about AWS resources that are affected +// by one or more events. +// +// In addition, these operations provide information about event types and summary +// counts of events or affected entities: +// +// * DescribeEventTypes: Information about the kinds of events that AWS Health +// tracks. +// +// * DescribeEventAggregates: A count of the number of events that meet specified +// criteria. +// +// * DescribeEntityAggregates: A count of the number of affected entities +// that meet specified criteria. +// +// The Health API requires a Business or Enterprise support plan from AWS Support +// (http://aws.amazon.com/premiumsupport/). Calling the Health API from an account +// that does not have a Business or Enterprise support plan causes a SubscriptionRequiredException. +// +// For authentication of requests, AWS Health uses the Signature Version 4 Signing +// Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). +// +// See the AWS Health User Guide (http://docs.aws.amazon.com/health/latest/ug/what-is-aws-health.html) +// for information about how to use the API. +// +// Service Endpoint +// +// The HTTP endpoint for the AWS Health API is: +// +// * https://health.us-east-1.amazonaws.com +// +// See https://docs.aws.amazon.com/goto/WebAPI/health-2016-08-04 for more information on this service. +// +// See health package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/health/ +// +// Using the Client +// +// To use the client for AWS Health APIs and Notifications 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 := health.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 Health APIs and Notifications client Health for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/health/#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.DescribeAffectedEntities(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("DescribeAffectedEntities 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.DescribeAffectedEntitiesWithContext(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 health diff --git a/vendor/github.com/aws/aws-sdk-go/service/health/service.go b/vendor/github.com/aws/aws-sdk-go/service/health/service.go index d8e8f6ba..e85c6844 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/health/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/health/service.go @@ -11,47 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// The AWS Health API provides programmatic access to the AWS Health information -// that is presented in the AWS Personal Health Dashboard (https://phd.aws.amazon.com/phd/home#/). -// You can get information about events that affect your AWS resources: +// Health provides the API operation methods for making requests to +// AWS Health APIs and Notifications. See this package's package overview docs +// for details on the service. // -// * DescribeEvents: Summary information about events. -// -// * DescribeEventDetails: Detailed information about one or more events. -// -// * DescribeAffectedEntities: Information about AWS resources that are affected -// by one or more events. -// -// In addition, these operations provide information about event types and summary -// counts of events or affected entities: -// -// * DescribeEventTypes: Information about the kinds of events that AWS Health -// tracks. -// -// * DescribeEventAggregates: A count of the number of events that meet specified -// criteria. -// -// * DescribeEntityAggregates: A count of the number of affected entities -// that meet specified criteria. -// -// The Health API requires a Business or Enterprise support plan from AWS Support -// (http://aws.amazon.com/premiumsupport/). Calling the Health API from an account -// that does not have a Business or Enterprise support plan causes a SubscriptionRequiredException. -// -// For authentication of requests, AWS Health uses the Signature Version 4 Signing -// Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). -// -// See the AWS Health User Guide (http://docs.aws.amazon.com/health/latest/ug/what-is-aws-health.html) -// for information about how to use the API. -// -// Service Endpoint -// -// The HTTP endpoint for the AWS Health API is: -// -// * https://health.us-east-1.amazonaws.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/health-2016-08-04 +// Health methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Health struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/iam/api.go b/vendor/github.com/aws/aws-sdk-go/service/iam/api.go index a36cb5d1..9e73c110 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/iam/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/iam/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package iam provides a client for AWS Identity and Access Management. package iam import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/iam/doc.go b/vendor/github.com/aws/aws-sdk-go/service/iam/doc.go new file mode 100644 index 00000000..0f70af3b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/iam/doc.go @@ -0,0 +1,132 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package iam provides the client and types for making API +// requests to AWS Identity and Access Management. +// +// AWS Identity and Access Management (IAM) is a web service that you can use +// to manage users and user permissions under your AWS account. This guide provides +// descriptions of IAM actions that you can call programmatically. For general +// information about IAM, see AWS Identity and Access Management (IAM) (http://aws.amazon.com/iam/). +// For the user guide for IAM, see Using IAM (http://docs.aws.amazon.com/IAM/latest/UserGuide/). +// +// 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 IAM and AWS. For +// example, the SDKs take care of tasks such as cryptographically signing requests +// (see below), 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 (http://aws.amazon.com/tools/) page. +// +// We recommend that you use the AWS SDKs to make programmatic API calls to +// IAM. However, you can also use the IAM Query API to make direct calls to +// the IAM web service. To learn more about the IAM Query API, see Making Query +// Requests (http://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_UsingQueryAPI.html) +// in the Using IAM guide. IAM supports GET and POST requests for all actions. +// That is, the API does not require you to use GET for some actions and POST +// for others. However, GET requests are subject to the limitation size of a +// URL. Therefore, for operations that require larger sizes, use a POST request. +// +// Signing Requests +// +// Requests must be signed using an access key ID and a secret access key. We +// strongly recommend that you do not use your AWS account access key ID and +// secret access key for everyday work with IAM. You can use the access key +// ID and secret access key for an IAM user or you can use the AWS Security +// Token Service to generate temporary security credentials and use those to +// sign requests. +// +// To sign requests, we recommend that you use Signature Version 4 (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). +// If you have an existing application that uses Signature Version 2, you do +// not have to update it to use Signature Version 4. However, some operations +// now require Signature Version 4. The documentation for operations that require +// version 4 indicate this requirement. +// +// Additional Resources +// +// For more information, see the following: +// +// * AWS Security Credentials (http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). +// This topic provides general information about the types of credentials +// used for accessing AWS. +// +// * IAM Best Practices (http://docs.aws.amazon.com/IAM/latest/UserGuide/IAMBestPractices.html). +// This topic presents a list of suggestions for using the IAM service to +// help secure your AWS resources. +// +// * Signing AWS API Requests (http://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html). +// This set of topics walk you through the process of signing a request using +// an access key ID and secret access key. +// +// See https://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08 for more information on this service. +// +// See iam package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/iam/ +// +// Using the Client +// +// To use the client for AWS Identity and Access Management 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 := iam.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 Identity and Access Management client IAM for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/iam/#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.AddClientIDToOpenIDConnectProvider(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("AddClientIDToOpenIDConnectProvider 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.AddClientIDToOpenIDConnectProviderWithContext(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 iam diff --git a/vendor/github.com/aws/aws-sdk-go/service/iam/service.go b/vendor/github.com/aws/aws-sdk-go/service/iam/service.go index 73ea1bac..4f798c63 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/iam/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/iam/service.go @@ -11,62 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// AWS Identity and Access Management (IAM) is a web service that you can use -// to manage users and user permissions under your AWS account. This guide provides -// descriptions of IAM actions that you can call programmatically. For general -// information about IAM, see AWS Identity and Access Management (IAM) (http://aws.amazon.com/iam/). -// For the user guide for IAM, see Using IAM (http://docs.aws.amazon.com/IAM/latest/UserGuide/). +// IAM provides the API operation methods for making requests to +// AWS Identity and Access Management. 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 IAM and AWS. For -// example, the SDKs take care of tasks such as cryptographically signing requests -// (see below), 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 (http://aws.amazon.com/tools/) page. -// -// We recommend that you use the AWS SDKs to make programmatic API calls to -// IAM. However, you can also use the IAM Query API to make direct calls to -// the IAM web service. To learn more about the IAM Query API, see Making Query -// Requests (http://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_UsingQueryAPI.html) -// in the Using IAM guide. IAM supports GET and POST requests for all actions. -// That is, the API does not require you to use GET for some actions and POST -// for others. However, GET requests are subject to the limitation size of a -// URL. Therefore, for operations that require larger sizes, use a POST request. -// -// Signing Requests -// -// Requests must be signed using an access key ID and a secret access key. We -// strongly recommend that you do not use your AWS account access key ID and -// secret access key for everyday work with IAM. You can use the access key -// ID and secret access key for an IAM user or you can use the AWS Security -// Token Service to generate temporary security credentials and use those to -// sign requests. -// -// To sign requests, we recommend that you use Signature Version 4 (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). -// If you have an existing application that uses Signature Version 2, you do -// not have to update it to use Signature Version 4. However, some operations -// now require Signature Version 4. The documentation for operations that require -// version 4 indicate this requirement. -// -// Additional Resources -// -// For more information, see the following: -// -// * AWS Security Credentials (http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). -// This topic provides general information about the types of credentials -// used for accessing AWS. -// -// * IAM Best Practices (http://docs.aws.amazon.com/IAM/latest/UserGuide/IAMBestPractices.html). -// This topic presents a list of suggestions for using the IAM service to -// help secure your AWS resources. -// -// * Signing AWS API Requests (http://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html). -// This set of topics walk you through the process of signing a request using -// an access key ID and secret access key. -// 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/iam-2010-05-08 +// IAM methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type IAM struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/inspector/api.go b/vendor/github.com/aws/aws-sdk-go/service/inspector/api.go index 51aa84db..277aa296 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/inspector/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/inspector/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package inspector provides a client for Amazon Inspector. package inspector import ( @@ -1277,6 +1276,109 @@ func (c *Inspector) DescribeRulesPackagesWithContext(ctx aws.Context, input *Des return out, req.Send() } +const opGetAssessmentReport = "GetAssessmentReport" + +// GetAssessmentReportRequest generates a "aws/request.Request" representing the +// client's request for the GetAssessmentReport operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See GetAssessmentReport for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the GetAssessmentReport method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the GetAssessmentReportRequest method. +// req, resp := client.GetAssessmentReportRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReport +func (c *Inspector) GetAssessmentReportRequest(input *GetAssessmentReportInput) (req *request.Request, output *GetAssessmentReportOutput) { + op := &request.Operation{ + Name: opGetAssessmentReport, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &GetAssessmentReportInput{} + } + + output = &GetAssessmentReportOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetAssessmentReport API operation for Amazon Inspector. +// +// Produces an assessment report that includes detailed and comprehensive results +// of a specified assessment run. +// +// 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. +// +// See the AWS API reference guide for Amazon Inspector's +// API operation GetAssessmentReport for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInternalException "InternalException" +// Internal server error. +// +// * ErrCodeInvalidInputException "InvalidInputException" +// The request was rejected because an invalid or out-of-range value was supplied +// for an input parameter. +// +// * ErrCodeAccessDeniedException "AccessDeniedException" +// You do not have required permissions to access the requested resource. +// +// * ErrCodeNoSuchEntityException "NoSuchEntityException" +// The request was rejected because it referenced an entity that does not exist. +// The error code describes the entity. +// +// * ErrCodeAssessmentRunInProgressException "AssessmentRunInProgressException" +// You cannot perform a specified action if an assessment run is currently in +// progress. +// +// * ErrCodeUnsupportedFeatureException "UnsupportedFeatureException" +// Used by the GetAssessmentReport API. The request was rejected because you +// tried to generate a report for an assessment run that existed before reporting +// was supported in Amazon Inspector. You can only generate reports for assessment +// runs that took place or will take place after generating reports in Amazon +// Inspector became available. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReport +func (c *Inspector) GetAssessmentReport(input *GetAssessmentReportInput) (*GetAssessmentReportOutput, error) { + req, out := c.GetAssessmentReportRequest(input) + return out, req.Send() +} + +// GetAssessmentReportWithContext is the same as GetAssessmentReport with the addition of +// the ability to pass a context and additional request options. +// +// See GetAssessmentReport for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Inspector) GetAssessmentReportWithContext(ctx aws.Context, input *GetAssessmentReportInput, opts ...request.Option) (*GetAssessmentReportOutput, error) { + req, out := c.GetAssessmentReportRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opGetTelemetryMetadata = "GetTelemetryMetadata" // GetTelemetryMetadataRequest generates a "aws/request.Request" representing the @@ -3223,6 +3325,11 @@ type AssessmentRun struct { // DurationInSeconds is a required field DurationInSeconds *int64 `locationName:"durationInSeconds" min:"180" type:"integer" required:"true"` + // Provides a total count of generated findings per severity. + // + // FindingCounts is a required field + FindingCounts map[string]*int64 `locationName:"findingCounts" type:"map" required:"true"` + // The auto-generated name for the assessment run. // // Name is a required field @@ -3309,6 +3416,12 @@ func (s *AssessmentRun) SetDurationInSeconds(v int64) *AssessmentRun { return s } +// SetFindingCounts sets the FindingCounts field's value. +func (s *AssessmentRun) SetFindingCounts(v map[string]*int64) *AssessmentRun { + s.FindingCounts = v + return s +} + // SetName sets the Name field's value. func (s *AssessmentRun) SetName(v string) *AssessmentRun { s.Name = &v @@ -3581,6 +3694,7 @@ type AssessmentRunNotification struct { // Event is a required field Event *string `locationName:"event" type:"string" required:"true" enum:"Event"` + // The message included in the notification. Message *string `locationName:"message" type:"string"` // The status code of the SNS notification. @@ -5574,6 +5688,116 @@ func (s *FindingFilter) SetUserAttributes(v []*Attribute) *FindingFilter { return s } +// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReportRequest +type GetAssessmentReportInput struct { + _ struct{} `type:"structure"` + + // The ARN that specifies the assessment run for which you want to generate + // a report. + // + // AssessmentRunArn is a required field + AssessmentRunArn *string `locationName:"assessmentRunArn" min:"1" type:"string" required:"true"` + + // Specifies the file format (html or pdf) of the assessment report that you + // want to generate. + // + // ReportFileFormat is a required field + ReportFileFormat *string `locationName:"reportFileFormat" type:"string" required:"true" enum:"ReportFileFormat"` + + // Specifies the type of the assessment report that you want to generate. There + // are two types of assessment reports: a finding report and a full report. + // For more information, see Assessment Reports (http://docs.aws.amazon.com/inspector/latest/userguide/inspector_reports.html). + // + // ReportType is a required field + ReportType *string `locationName:"reportType" type:"string" required:"true" enum:"ReportType"` +} + +// String returns the string representation +func (s GetAssessmentReportInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetAssessmentReportInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetAssessmentReportInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetAssessmentReportInput"} + if s.AssessmentRunArn == nil { + invalidParams.Add(request.NewErrParamRequired("AssessmentRunArn")) + } + if s.AssessmentRunArn != nil && len(*s.AssessmentRunArn) < 1 { + invalidParams.Add(request.NewErrParamMinLen("AssessmentRunArn", 1)) + } + if s.ReportFileFormat == nil { + invalidParams.Add(request.NewErrParamRequired("ReportFileFormat")) + } + if s.ReportType == nil { + invalidParams.Add(request.NewErrParamRequired("ReportType")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAssessmentRunArn sets the AssessmentRunArn field's value. +func (s *GetAssessmentReportInput) SetAssessmentRunArn(v string) *GetAssessmentReportInput { + s.AssessmentRunArn = &v + return s +} + +// SetReportFileFormat sets the ReportFileFormat field's value. +func (s *GetAssessmentReportInput) SetReportFileFormat(v string) *GetAssessmentReportInput { + s.ReportFileFormat = &v + return s +} + +// SetReportType sets the ReportType field's value. +func (s *GetAssessmentReportInput) SetReportType(v string) *GetAssessmentReportInput { + s.ReportType = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReportResponse +type GetAssessmentReportOutput struct { + _ struct{} `type:"structure"` + + // Specifies the status of the request to generate an assessment report. + // + // Status is a required field + Status *string `locationName:"status" type:"string" required:"true" enum:"ReportStatus"` + + // Specifies the URL where you can find the generated assessment report. This + // parameter is only returned if the report is successfully generated. + Url *string `locationName:"url" type:"string"` +} + +// String returns the string representation +func (s GetAssessmentReportOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetAssessmentReportOutput) GoString() string { + return s.String() +} + +// SetStatus sets the Status field's value. +func (s *GetAssessmentReportOutput) SetStatus(v string) *GetAssessmentReportOutput { + s.Status = &v + return s +} + +// SetUrl sets the Url field's value. +func (s *GetAssessmentReportOutput) SetUrl(v string) *GetAssessmentReportOutput { + s.Url = &v + return s +} + // Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetTelemetryMetadataRequest type GetTelemetryMetadataInput struct { _ struct{} `type:"structure"` @@ -7718,12 +7942,18 @@ const ( // AssessmentRunStateDataCollected is a AssessmentRunState enum value AssessmentRunStateDataCollected = "DATA_COLLECTED" + // AssessmentRunStateStartEvaluatingRulesPending is a AssessmentRunState enum value + AssessmentRunStateStartEvaluatingRulesPending = "START_EVALUATING_RULES_PENDING" + // AssessmentRunStateEvaluatingRules is a AssessmentRunState enum value AssessmentRunStateEvaluatingRules = "EVALUATING_RULES" // AssessmentRunStateFailed is a AssessmentRunState enum value AssessmentRunStateFailed = "FAILED" + // AssessmentRunStateError is a AssessmentRunState enum value + AssessmentRunStateError = "ERROR" + // AssessmentRunStateCompleted is a AssessmentRunState enum value AssessmentRunStateCompleted = "COMPLETED" @@ -7994,6 +8224,33 @@ const ( ) const ( + // ReportFileFormatHtml is a ReportFileFormat enum value + ReportFileFormatHtml = "HTML" + + // ReportFileFormatPdf is a ReportFileFormat enum value + ReportFileFormatPdf = "PDF" +) + +const ( + // ReportStatusWorkInProgress is a ReportStatus enum value + ReportStatusWorkInProgress = "WORK_IN_PROGRESS" + + // ReportStatusFailed is a ReportStatus enum value + ReportStatusFailed = "FAILED" + + // ReportStatusCompleted is a ReportStatus enum value + ReportStatusCompleted = "COMPLETED" +) + +const ( + // ReportTypeFinding is a ReportType enum value + ReportTypeFinding = "FINDING" + + // ReportTypeFull is a ReportType enum value + ReportTypeFull = "FULL" +) + +const ( // SeverityLow is a Severity enum value SeverityLow = "Low" diff --git a/vendor/github.com/aws/aws-sdk-go/service/inspector/doc.go b/vendor/github.com/aws/aws-sdk-go/service/inspector/doc.go new file mode 100644 index 00000000..1d83fc5a --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/inspector/doc.go @@ -0,0 +1,82 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package inspector provides the client and types for making API +// requests to Amazon Inspector. +// +// Amazon Inspector enables you to analyze the behavior of your AWS resources +// and to identify potential security issues. For more information, see Amazon +// Inspector User Guide (http://docs.aws.amazon.com/inspector/latest/userguide/inspector_introduction.html). +// +// See https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16 for more information on this service. +// +// See inspector package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/inspector/ +// +// Using the Client +// +// To use the client for Amazon Inspector 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 := inspector.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 Inspector client Inspector for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/inspector/#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.AddAttributesToFindings(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("AddAttributesToFindings 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.AddAttributesToFindingsWithContext(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 inspector diff --git a/vendor/github.com/aws/aws-sdk-go/service/inspector/errors.go b/vendor/github.com/aws/aws-sdk-go/service/inspector/errors.go index 2178a76b..abdadccc 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/inspector/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/inspector/errors.go @@ -57,4 +57,14 @@ const ( // The request was rejected because it referenced an entity that does not exist. // The error code describes the entity. ErrCodeNoSuchEntityException = "NoSuchEntityException" + + // ErrCodeUnsupportedFeatureException for service response error code + // "UnsupportedFeatureException". + // + // Used by the GetAssessmentReport API. The request was rejected because you + // tried to generate a report for an assessment run that existed before reporting + // was supported in Amazon Inspector. You can only generate reports for assessment + // runs that took place or will take place after generating reports in Amazon + // Inspector became available. + ErrCodeUnsupportedFeatureException = "UnsupportedFeatureException" ) diff --git a/vendor/github.com/aws/aws-sdk-go/service/inspector/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/inspector/examples_test.go index 08d4f3f0..3f4b2a6b 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/inspector/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/inspector/examples_test.go @@ -357,6 +357,29 @@ func ExampleInspector_DescribeRulesPackages() { fmt.Println(resp) } +func ExampleInspector_GetAssessmentReport() { + sess := session.Must(session.NewSession()) + + svc := inspector.New(sess) + + params := &inspector.GetAssessmentReportInput{ + AssessmentRunArn: aws.String("Arn"), // Required + ReportFileFormat: aws.String("ReportFileFormat"), // Required + ReportType: aws.String("ReportType"), // Required + } + resp, err := svc.GetAssessmentReport(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + func ExampleInspector_GetTelemetryMetadata() { sess := session.Must(session.NewSession()) diff --git a/vendor/github.com/aws/aws-sdk-go/service/inspector/inspectoriface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/inspector/inspectoriface/interface.go index 280aac6a..3e4742c3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/inspector/inspectoriface/interface.go +++ b/vendor/github.com/aws/aws-sdk-go/service/inspector/inspectoriface/interface.go @@ -116,6 +116,10 @@ type InspectorAPI interface { DescribeRulesPackagesWithContext(aws.Context, *inspector.DescribeRulesPackagesInput, ...request.Option) (*inspector.DescribeRulesPackagesOutput, error) DescribeRulesPackagesRequest(*inspector.DescribeRulesPackagesInput) (*request.Request, *inspector.DescribeRulesPackagesOutput) + GetAssessmentReport(*inspector.GetAssessmentReportInput) (*inspector.GetAssessmentReportOutput, error) + GetAssessmentReportWithContext(aws.Context, *inspector.GetAssessmentReportInput, ...request.Option) (*inspector.GetAssessmentReportOutput, error) + GetAssessmentReportRequest(*inspector.GetAssessmentReportInput) (*request.Request, *inspector.GetAssessmentReportOutput) + GetTelemetryMetadata(*inspector.GetTelemetryMetadataInput) (*inspector.GetTelemetryMetadataOutput, error) GetTelemetryMetadataWithContext(aws.Context, *inspector.GetTelemetryMetadataInput, ...request.Option) (*inspector.GetTelemetryMetadataOutput, error) GetTelemetryMetadataRequest(*inspector.GetTelemetryMetadataInput) (*request.Request, *inspector.GetTelemetryMetadataOutput) diff --git a/vendor/github.com/aws/aws-sdk-go/service/inspector/service.go b/vendor/github.com/aws/aws-sdk-go/service/inspector/service.go index 81feadcc..1d65f070 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/inspector/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/inspector/service.go @@ -11,12 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon Inspector enables you to analyze the behavior of your AWS resources -// and to identify potential security issues. For more information, see Amazon -// Inspector User Guide (http://docs.aws.amazon.com/inspector/latest/userguide/inspector_introduction.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/inspector-2016-02-16 +// Inspector provides the API operation methods for making requests to +// Amazon Inspector. See this package's package overview docs +// for details on the service. +// +// Inspector methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Inspector struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/iot/api.go b/vendor/github.com/aws/aws-sdk-go/service/iot/api.go index a55c0cbc..0ca7142e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/iot/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/iot/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package iot provides a client for AWS IoT. package iot import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/iot/doc.go b/vendor/github.com/aws/aws-sdk-go/service/iot/doc.go new file mode 100644 index 00000000..fe722aef --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/iot/doc.go @@ -0,0 +1,85 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package iot provides the client and types for making API +// requests to AWS IoT. +// +// AWS IoT provides secure, bi-directional communication between Internet-connected +// things (such as sensors, actuators, embedded devices, or smart appliances) +// and the AWS cloud. You can discover your custom IoT-Data endpoint to communicate +// with, configure rules for data processing and integration with other services, +// organize resources associated with each thing (Thing Registry), configure +// logging, and create and manage policies and credentials to authenticate things. +// +// For more information about how AWS IoT works, see the Developer Guide (http://docs.aws.amazon.com/iot/latest/developerguide/aws-iot-how-it-works.html). +// +// See iot package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/iot/ +// +// Using the Client +// +// To use the client for AWS IoT 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 := iot.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 IoT client IoT for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/iot/#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.AcceptCertificateTransfer(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("AcceptCertificateTransfer 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.AcceptCertificateTransferWithContext(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 iot diff --git a/vendor/github.com/aws/aws-sdk-go/service/iot/service.go b/vendor/github.com/aws/aws-sdk-go/service/iot/service.go index 3e2e2f77..530757a1 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/iot/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/iot/service.go @@ -11,16 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// AWS IoT provides secure, bi-directional communication between Internet-connected -// things (such as sensors, actuators, embedded devices, or smart appliances) -// and the AWS cloud. You can discover your custom IoT-Data endpoint to communicate -// with, configure rules for data processing and integration with other services, -// organize resources associated with each thing (Thing Registry), configure -// logging, and create and manage policies and credentials to authenticate things. +// IoT provides the API operation methods for making requests to +// AWS IoT. See this package's package overview docs +// for details on the service. // -// For more information about how AWS IoT works, see the Developer Guide (http://docs.aws.amazon.com/iot/latest/developerguide/aws-iot-how-it-works.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. +// IoT methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type IoT struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/api.go b/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/api.go index 9d11fe1a..8c40d33d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package iotdataplane provides a client for AWS IoT Data Plane. package iotdataplane import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/doc.go b/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/doc.go new file mode 100644 index 00000000..906f78fe --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/doc.go @@ -0,0 +1,85 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package iotdataplane provides the client and types for making API +// requests to AWS IoT Data Plane. +// +// AWS IoT-Data enables secure, bi-directional communication between Internet-connected +// things (such as sensors, actuators, embedded devices, or smart appliances) +// and the AWS cloud. It implements a broker for applications and things to +// publish messages over HTTP (Publish) and retrieve, update, and delete thing +// shadows. A thing shadow is a persistent representation of your things and +// their state in the AWS cloud. +// +// See https://docs.aws.amazon.com/goto/WebAPI/iot-data-2015-05-28 for more information on this service. +// +// See iotdataplane package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/iotdataplane/ +// +// Using the Client +// +// To use the client for AWS IoT Data Plane 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 := iotdataplane.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 IoT Data Plane client IoTDataPlane for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/iotdataplane/#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.DeleteThingShadow(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("DeleteThingShadow 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.DeleteThingShadowWithContext(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 iotdataplane diff --git a/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/service.go b/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/service.go index e6ac80c9..1ce0dfaa 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/iotdataplane/service.go @@ -11,15 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// AWS IoT-Data enables secure, bi-directional communication between Internet-connected -// things (such as sensors, actuators, embedded devices, or smart appliances) -// and the AWS cloud. It implements a broker for applications and things to -// publish messages over HTTP (Publish) and retrieve, update, and delete thing -// shadows. A thing shadow is a persistent representation of your things and -// their state in the AWS cloud. -// 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/iot-data-2015-05-28 +// IoTDataPlane provides the API operation methods for making requests to +// AWS IoT Data Plane. See this package's package overview docs +// for details on the service. +// +// IoTDataPlane methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type IoTDataPlane struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/kinesis/api.go b/vendor/github.com/aws/aws-sdk-go/service/kinesis/api.go index e0b42ad5..0cf5f919 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/kinesis/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/kinesis/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package kinesis provides a client for Amazon Kinesis. package kinesis import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/kinesis/doc.go b/vendor/github.com/aws/aws-sdk-go/service/kinesis/doc.go new file mode 100644 index 00000000..a64d6b70 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/kinesis/doc.go @@ -0,0 +1,81 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package kinesis provides the client and types for making API +// requests to Amazon Kinesis. +// +// Amazon Kinesis Streams is a managed service that scales elastically for real +// time processing of streaming big data. +// +// See https://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02 for more information on this service. +// +// See kinesis package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/kinesis/ +// +// Using the Client +// +// To use the client for Amazon Kinesis 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 := kinesis.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 Kinesis client Kinesis for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/kinesis/#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.AddTagsToStream(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("AddTagsToStream 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.AddTagsToStreamWithContext(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 kinesis diff --git a/vendor/github.com/aws/aws-sdk-go/service/kinesis/service.go b/vendor/github.com/aws/aws-sdk-go/service/kinesis/service.go index 212a54c7..17a59119 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/kinesis/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/kinesis/service.go @@ -11,11 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon Kinesis Streams is a managed service that scales elastically for real -// time processing of streaming big data. -// 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/kinesis-2013-12-02 +// Kinesis provides the API operation methods for making requests to +// Amazon Kinesis. See this package's package overview docs +// for details on the service. +// +// Kinesis methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Kinesis struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/api.go b/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/api.go index 5b99c172..fb9e18e4 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package kinesisanalytics provides a client for Amazon Kinesis Analytics. package kinesisanalytics import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/doc.go b/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/doc.go new file mode 100644 index 00000000..5009a1b9 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/doc.go @@ -0,0 +1,78 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package kinesisanalytics provides the client and types for making API +// requests to Amazon Kinesis Analytics. +// +// See https://docs.aws.amazon.com/goto/WebAPI/kinesisanalytics-2015-08-14 for more information on this service. +// +// See kinesisanalytics package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/kinesisanalytics/ +// +// Using the Client +// +// To use the client for Amazon Kinesis Analytics 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 := kinesisanalytics.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 Kinesis Analytics client KinesisAnalytics for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/kinesisanalytics/#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.AddApplicationInput(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("AddApplicationInput 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.AddApplicationInputWithContext(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 kinesisanalytics diff --git a/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/service.go b/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/service.go index 0c4f80b1..1a8d574d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/kinesisanalytics/service.go @@ -11,10 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// KinesisAnalytics is a client for Kinesis Analytics. -// 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/kinesisanalytics-2015-08-14 +// KinesisAnalytics provides the API operation methods for making requests to +// Amazon Kinesis Analytics. See this package's package overview docs +// for details on the service. +// +// KinesisAnalytics methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type KinesisAnalytics struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/kms/api.go b/vendor/github.com/aws/aws-sdk-go/service/kms/api.go index c7e0da51..fa60d024 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/kms/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/kms/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package kms provides a client for AWS Key Management Service. package kms import ( @@ -4337,9 +4336,9 @@ type CreateGrantInput struct { // // To specify the principal, use the Amazon Resource Name (ARN) (http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) // of an AWS principal. Valid AWS principals include AWS accounts (root), IAM - // users, federated users, and assumed role users. For examples of the ARN syntax - // to use for specifying a principal, see AWS Identity and Access Management - // (IAM) (http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam) + // users, IAM roles, federated users, and assumed role users. For examples of + // the ARN syntax to use for specifying a principal, see AWS Identity and Access + // Management (IAM) (http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam) // in the Example ARNs section of the AWS General Reference. // // GranteePrincipal is a required field diff --git a/vendor/github.com/aws/aws-sdk-go/service/kms/doc.go b/vendor/github.com/aws/aws-sdk-go/service/kms/doc.go new file mode 100644 index 00000000..6e1eb48f --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/kms/doc.go @@ -0,0 +1,150 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package kms provides the client and types for making API +// requests to AWS Key Management Service. +// +// AWS Key Management Service (AWS KMS) is an encryption and key management +// web service. This guide describes the AWS KMS operations that you can call +// programmatically. For general information about AWS KMS, see the AWS Key +// Management Service Developer Guide (http://docs.aws.amazon.com/kms/latest/developerguide/). +// +// 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 KMS and other +// AWS services. For example, the SDKs take care of tasks such as signing requests +// (see below), managing errors, and retrying requests automatically. 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/). +// +// We recommend that you use the AWS SDKs to make programmatic API calls to +// AWS KMS. +// +// Clients must support TLS (Transport Layer Security) 1.0. We recommend TLS +// 1.2. Clients must also support cipher suites with Perfect Forward Secrecy +// (PFS) such as Ephemeral Diffie-Hellman (DHE) or Elliptic Curve Ephemeral +// Diffie-Hellman (ECDHE). Most modern systems such as Java 7 and later support +// these modes. +// +// Signing Requests +// +// Requests must be signed by using an access key ID and a secret access key. +// We strongly recommend that you do not use your AWS account (root) access +// key ID and secret key for everyday work with AWS KMS. Instead, use the access +// key ID and secret access key for an IAM user, or you can use the AWS Security +// Token Service to generate temporary security credentials that you can use +// to sign requests. +// +// All AWS KMS operations require Signature Version 4 (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). +// +// Logging API Requests +// +// AWS KMS supports AWS CloudTrail, a service that logs AWS API calls and related +// events for your AWS account and delivers them to an Amazon S3 bucket that +// you specify. By using the information collected by CloudTrail, you can determine +// what requests were made to AWS KMS, who made the request, when it was made, +// and so on. To learn more about CloudTrail, including how to turn it on and +// find your log files, see the AWS CloudTrail User Guide (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/). +// +// Additional Resources +// +// For more information about credentials and request signing, see the following: +// +// * AWS Security Credentials (http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html) +// - This topic provides general information about the types of credentials +// used for accessing AWS. +// +// * Temporary Security Credentials (http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) +// - This section of the IAM User Guide describes how to create and use temporary +// security credentials. +// +// * Signature Version 4 Signing Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) +// - This set of topics walks you through the process of signing a request +// using an access key ID and a secret access key. +// +// Commonly Used APIs +// +// Of the APIs discussed in this guide, the following will prove the most useful +// for most applications. You will likely perform actions other than these, +// such as creating keys and assigning policies, by using the console. +// +// * Encrypt +// +// * Decrypt +// +// * GenerateDataKey +// +// * GenerateDataKeyWithoutPlaintext +// +// See https://docs.aws.amazon.com/goto/WebAPI/kms-2014-11-01 for more information on this service. +// +// See kms package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/kms/ +// +// Using the Client +// +// To use the client for AWS Key Management 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 := kms.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 Key Management Service client KMS for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/kms/#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.CancelKeyDeletion(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("CancelKeyDeletion 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.CancelKeyDeletionWithContext(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 kms diff --git a/vendor/github.com/aws/aws-sdk-go/service/kms/service.go b/vendor/github.com/aws/aws-sdk-go/service/kms/service.go index 10aeb248..3ff65de5 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/kms/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/kms/service.go @@ -11,80 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Key Management Service (AWS KMS) is an encryption and key management -// web service. This guide describes the AWS KMS operations that you can call -// programmatically. For general information about AWS KMS, see the AWS Key -// Management Service Developer Guide (http://docs.aws.amazon.com/kms/latest/developerguide/). +// KMS provides the API operation methods for making requests to +// AWS Key Management 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 KMS and other -// AWS services. For example, the SDKs take care of tasks such as signing requests -// (see below), managing errors, and retrying requests automatically. 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/). -// -// We recommend that you use the AWS SDKs to make programmatic API calls to -// AWS KMS. -// -// Clients must support TLS (Transport Layer Security) 1.0. We recommend TLS -// 1.2. Clients must also support cipher suites with Perfect Forward Secrecy -// (PFS) such as Ephemeral Diffie-Hellman (DHE) or Elliptic Curve Ephemeral -// Diffie-Hellman (ECDHE). Most modern systems such as Java 7 and later support -// these modes. -// -// Signing Requests -// -// Requests must be signed by using an access key ID and a secret access key. -// We strongly recommend that you do not use your AWS account (root) access -// key ID and secret key for everyday work with AWS KMS. Instead, use the access -// key ID and secret access key for an IAM user, or you can use the AWS Security -// Token Service to generate temporary security credentials that you can use -// to sign requests. -// -// All AWS KMS operations require Signature Version 4 (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). -// -// Logging API Requests -// -// AWS KMS supports AWS CloudTrail, a service that logs AWS API calls and related -// events for your AWS account and delivers them to an Amazon S3 bucket that -// you specify. By using the information collected by CloudTrail, you can determine -// what requests were made to AWS KMS, who made the request, when it was made, -// and so on. To learn more about CloudTrail, including how to turn it on and -// find your log files, see the AWS CloudTrail User Guide (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/). -// -// Additional Resources -// -// For more information about credentials and request signing, see the following: -// -// * AWS Security Credentials (http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html) -// - This topic provides general information about the types of credentials -// used for accessing AWS. -// -// * Temporary Security Credentials (http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) -// - This section of the IAM User Guide describes how to create and use temporary -// security credentials. -// -// * Signature Version 4 Signing Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) -// - This set of topics walks you through the process of signing a request -// using an access key ID and a secret access key. -// -// Commonly Used APIs -// -// Of the APIs discussed in this guide, the following will prove the most useful -// for most applications. You will likely perform actions other than these, -// such as creating keys and assigning policies, by using the console. -// -// * Encrypt -// -// * Decrypt -// -// * GenerateDataKey -// -// * GenerateDataKeyWithoutPlaintext -// 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/kms-2014-11-01 +// KMS methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type KMS struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/lambda/api.go b/vendor/github.com/aws/aws-sdk-go/service/lambda/api.go index 7602de11..019cf510 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lambda/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lambda/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package lambda provides a client for AWS Lambda. package lambda import ( @@ -3895,7 +3894,6 @@ type Environment struct { _ struct{} `type:"structure"` // The key-value pairs that represent your environment's configuration settings. - // The value you specify cannot contain a ",". Variables map[string]*string `type:"map"` } @@ -6026,6 +6024,14 @@ func (s *UpdateEventSourceMappingInput) SetUUID(v string) *UpdateEventSourceMapp type UpdateFunctionCodeInput struct { _ struct{} `type:"structure"` + // This boolean parameter can be used to test your request to AWS Lambda to + // update the Lambda function and publish a version as an atomic operation. + // It will do all necessary computation and validation of your code but will + // not upload it or a publish a version. Each time this operation is invoked, + // the CodeSha256 hash value the provided code will also be computed and returned + // in the response. + DryRun *bool `type:"boolean"` + // The existing Lambda function name whose code you want to replace. // // You can specify a function name (for example, Thumbnail) or you can specify @@ -6098,6 +6104,12 @@ func (s *UpdateFunctionCodeInput) Validate() error { return nil } +// SetDryRun sets the DryRun field's value. +func (s *UpdateFunctionCodeInput) SetDryRun(v bool) *UpdateFunctionCodeInput { + s.DryRun = &v + return s +} + // SetFunctionName sets the FunctionName field's value. func (s *UpdateFunctionCodeInput) SetFunctionName(v string) *UpdateFunctionCodeInput { s.FunctionName = &v diff --git a/vendor/github.com/aws/aws-sdk-go/service/lambda/doc.go b/vendor/github.com/aws/aws-sdk-go/service/lambda/doc.go new file mode 100644 index 00000000..b51b2a41 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/lambda/doc.go @@ -0,0 +1,84 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package lambda provides the client and types for making API +// requests to AWS Lambda. +// +// Overview +// +// This is the AWS Lambda API Reference. The AWS Lambda Developer Guide provides +// additional information. For the service overview, see What is AWS Lambda +// (http://docs.aws.amazon.com/lambda/latest/dg/welcome.html), and for information +// about how the service works, see AWS Lambda: How it Works (http://docs.aws.amazon.com/lambda/latest/dg/lambda-introduction.html) +// in the AWS Lambda Developer Guide. +// +// See lambda package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lambda/ +// +// Using the Client +// +// To use the client for AWS Lambda 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 := lambda.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 Lambda client Lambda for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lambda/#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.AddPermission(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("AddPermission 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.AddPermissionWithContext(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 lambda diff --git a/vendor/github.com/aws/aws-sdk-go/service/lambda/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/lambda/examples_test.go index 6c68cdfc..cab0d996 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lambda/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lambda/examples_test.go @@ -660,6 +660,7 @@ func ExampleLambda_UpdateFunctionCode() { params := &lambda.UpdateFunctionCodeInput{ FunctionName: aws.String("FunctionName"), // Required + DryRun: aws.Bool(true), Publish: aws.Bool(true), S3Bucket: aws.String("S3Bucket"), S3Key: aws.String("S3Key"), diff --git a/vendor/github.com/aws/aws-sdk-go/service/lambda/service.go b/vendor/github.com/aws/aws-sdk-go/service/lambda/service.go index 619c583f..83c5e309 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lambda/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lambda/service.go @@ -11,15 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Overview +// Lambda provides the API operation methods for making requests to +// AWS Lambda. See this package's package overview docs +// for details on the service. // -// This is the AWS Lambda API Reference. The AWS Lambda Developer Guide provides -// additional information. For the service overview, see What is AWS Lambda -// (http://docs.aws.amazon.com/lambda/latest/dg/welcome.html), and for information -// about how the service works, see AWS Lambda: How it Works (http://docs.aws.amazon.com/lambda/latest/dg/lambda-introduction.html) -// in the AWS Lambda 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. +// Lambda methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Lambda struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/api.go index 44a6f7e9..9cb6b085 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package lexmodelbuildingservice provides a client for Amazon Lex Model Building Service. package lexmodelbuildingservice import ( @@ -388,9 +387,8 @@ func (c *LexModelBuildingService) DeleteBotRequest(input *DeleteBotInput) (req * // DeleteBot API operation for Amazon Lex Model Building Service. // -// Deletes a bot. If you specify a bot version in the request, the API deletes -// only the specified bot version. If you don't specify a version, the API deletes -// all versions of the bot, including the $LATEST version. +// Deletes all versions of the bot, including the $LATEST version. To delete +// a specific version of the bot, use the operation. // // If a bot has an alias, you can't delete it. Instead, the DeleteBot operation // returns a ResourceInUseException exception that includes a reference to the @@ -676,6 +674,118 @@ func (c *LexModelBuildingService) DeleteBotChannelAssociationWithContext(ctx aws return out, req.Send() } +const opDeleteBotVersion = "DeleteBotVersion" + +// DeleteBotVersionRequest generates a "aws/request.Request" representing the +// client's request for the DeleteBotVersion operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See DeleteBotVersion for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the DeleteBotVersion method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the DeleteBotVersionRequest method. +// req, resp := client.DeleteBotVersionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteBotVersion +func (c *LexModelBuildingService) DeleteBotVersionRequest(input *DeleteBotVersionInput) (req *request.Request, output *DeleteBotVersionOutput) { + op := &request.Operation{ + Name: opDeleteBotVersion, + HTTPMethod: "DELETE", + HTTPPath: "/bots/{name}/versions/{version}", + } + + if input == nil { + input = &DeleteBotVersionInput{} + } + + output = &DeleteBotVersionOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler) + req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteBotVersion API operation for Amazon Lex Model Building Service. +// +// Deletes a specific version of a bot. To delete all versions of a bot, use +// the operation. +// +// This operation requires permissions for the lex:DeleteBotVersion action. +// +// 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. +// +// See the AWS API reference guide for Amazon Lex Model Building Service's +// API operation DeleteBotVersion for usage and error information. +// +// Returned Error Codes: +// * ErrCodeNotFoundException "NotFoundException" +// The resource specified in the request was not found. Check the resource and +// try again. +// +// * ErrCodeConflictException "ConflictException" +// There was a conflict processing the request. Try your request again. +// +// * ErrCodeLimitExceededException "LimitExceededException" +// The request exceeded a limit. Try your request again. +// +// * ErrCodeInternalFailureException "InternalFailureException" +// An internal Amazon Lex error occurred. Try your request again. +// +// * ErrCodeBadRequestException "BadRequestException" +// The request is not well formed. For example, a value is invalid or a required +// field is missing. Check the field values, and try again. +// +// * ErrCodeResourceInUseException "ResourceInUseException" +// The resource that you are attempting to delete is referred to by another +// resource. Use this information to remove references to the resource that +// you are trying to delete. +// +// The body of the exception contains a JSON object that describes the resource. +// +// { "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT, +// +// "resourceReference": { +// +// "name": string, "version": string } } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteBotVersion +func (c *LexModelBuildingService) DeleteBotVersion(input *DeleteBotVersionInput) (*DeleteBotVersionOutput, error) { + req, out := c.DeleteBotVersionRequest(input) + return out, req.Send() +} + +// DeleteBotVersionWithContext is the same as DeleteBotVersion with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteBotVersion for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *LexModelBuildingService) DeleteBotVersionWithContext(ctx aws.Context, input *DeleteBotVersionInput, opts ...request.Option) (*DeleteBotVersionOutput, error) { + req, out := c.DeleteBotVersionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteIntent = "DeleteIntent" // DeleteIntentRequest generates a "aws/request.Request" representing the @@ -723,10 +833,8 @@ func (c *LexModelBuildingService) DeleteIntentRequest(input *DeleteIntentInput) // DeleteIntent API operation for Amazon Lex Model Building Service. // -// Deletes an intent. If you specify a version in the request, the API deletes -// only the specified version of the intent. If you don't specify a version -// in the request, the API deletes all of the versions of the intent, including -// the $LATEST version. +// Deletes all versions of the intent, including the $LATEST version. To delete +// a specific version of the intent, use the operation. // // You can delete a version of an intent only if it is not referenced. To delete // an intent that is referred to in one or more bots (see how-it-works), you @@ -800,6 +908,118 @@ func (c *LexModelBuildingService) DeleteIntentWithContext(ctx aws.Context, input return out, req.Send() } +const opDeleteIntentVersion = "DeleteIntentVersion" + +// DeleteIntentVersionRequest generates a "aws/request.Request" representing the +// client's request for the DeleteIntentVersion operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See DeleteIntentVersion for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the DeleteIntentVersion method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the DeleteIntentVersionRequest method. +// req, resp := client.DeleteIntentVersionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteIntentVersion +func (c *LexModelBuildingService) DeleteIntentVersionRequest(input *DeleteIntentVersionInput) (req *request.Request, output *DeleteIntentVersionOutput) { + op := &request.Operation{ + Name: opDeleteIntentVersion, + HTTPMethod: "DELETE", + HTTPPath: "/intents/{name}/versions/{version}", + } + + if input == nil { + input = &DeleteIntentVersionInput{} + } + + output = &DeleteIntentVersionOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler) + req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteIntentVersion API operation for Amazon Lex Model Building Service. +// +// Deletes a specific version of an intent. To delete all versions of a intent, +// use the operation. +// +// This operation requires permissions for the lex:DeleteIntentVersion action. +// +// 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. +// +// See the AWS API reference guide for Amazon Lex Model Building Service's +// API operation DeleteIntentVersion for usage and error information. +// +// Returned Error Codes: +// * ErrCodeNotFoundException "NotFoundException" +// The resource specified in the request was not found. Check the resource and +// try again. +// +// * ErrCodeConflictException "ConflictException" +// There was a conflict processing the request. Try your request again. +// +// * ErrCodeLimitExceededException "LimitExceededException" +// The request exceeded a limit. Try your request again. +// +// * ErrCodeInternalFailureException "InternalFailureException" +// An internal Amazon Lex error occurred. Try your request again. +// +// * ErrCodeBadRequestException "BadRequestException" +// The request is not well formed. For example, a value is invalid or a required +// field is missing. Check the field values, and try again. +// +// * ErrCodeResourceInUseException "ResourceInUseException" +// The resource that you are attempting to delete is referred to by another +// resource. Use this information to remove references to the resource that +// you are trying to delete. +// +// The body of the exception contains a JSON object that describes the resource. +// +// { "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT, +// +// "resourceReference": { +// +// "name": string, "version": string } } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteIntentVersion +func (c *LexModelBuildingService) DeleteIntentVersion(input *DeleteIntentVersionInput) (*DeleteIntentVersionOutput, error) { + req, out := c.DeleteIntentVersionRequest(input) + return out, req.Send() +} + +// DeleteIntentVersionWithContext is the same as DeleteIntentVersion with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteIntentVersion for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *LexModelBuildingService) DeleteIntentVersionWithContext(ctx aws.Context, input *DeleteIntentVersionInput, opts ...request.Option) (*DeleteIntentVersionOutput, error) { + req, out := c.DeleteIntentVersionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteSlotType = "DeleteSlotType" // DeleteSlotTypeRequest generates a "aws/request.Request" representing the @@ -847,19 +1067,19 @@ func (c *LexModelBuildingService) DeleteSlotTypeRequest(input *DeleteSlotTypeInp // DeleteSlotType API operation for Amazon Lex Model Building Service. // -// Deletes a slot type. If you specify a version in the request, the API deletes -// the specific version. If you don't specify a version in the request, the -// API deletes all versions of the slot type, including the $LATEST version. +// Deletes all versions of the slot type, including the $LATEST version. To +// delete a specific version of the slot type, use the operation. // // You can delete a version of a slot type only if it is not referenced. To // delete a slot type that is referred to in one or more intents, you must remove // those references first. // -// If you get the SlotTypeInUse exception, the exception provides an example -// reference that shows the intent where the slot type is referenced. To remove -// the reference to the slot type, either update the intent or delete it. If -// you get the same exception when you attempt to delete the intent again, repeat -// until the intent has no references and the DeleteSlotType call is successful. +// If you get the ResourceInUseException exception, the exception provides an +// example reference that shows the intent where the slot type is referenced. +// To remove the reference to the slot type, either update the intent or delete +// it. If you get the same exception when you attempt to delete the slot type +// again, repeat until the slot type has no references and the DeleteSlotType +// call is successful. // // This operation requires permission for the lex:DeleteSlotType action. // @@ -923,6 +1143,118 @@ func (c *LexModelBuildingService) DeleteSlotTypeWithContext(ctx aws.Context, inp return out, req.Send() } +const opDeleteSlotTypeVersion = "DeleteSlotTypeVersion" + +// DeleteSlotTypeVersionRequest generates a "aws/request.Request" representing the +// client's request for the DeleteSlotTypeVersion operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See DeleteSlotTypeVersion for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the DeleteSlotTypeVersion method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the DeleteSlotTypeVersionRequest method. +// req, resp := client.DeleteSlotTypeVersionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteSlotTypeVersion +func (c *LexModelBuildingService) DeleteSlotTypeVersionRequest(input *DeleteSlotTypeVersionInput) (req *request.Request, output *DeleteSlotTypeVersionOutput) { + op := &request.Operation{ + Name: opDeleteSlotTypeVersion, + HTTPMethod: "DELETE", + HTTPPath: "/slottypes/{name}/version/{version}", + } + + if input == nil { + input = &DeleteSlotTypeVersionInput{} + } + + output = &DeleteSlotTypeVersionOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler) + req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteSlotTypeVersion API operation for Amazon Lex Model Building Service. +// +// Deletes a specific version of a slot type. To delete all versions of a slot +// type, use the operation. +// +// This operation requires permissions for the lex:DeleteSlotTypeVersion action. +// +// 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. +// +// See the AWS API reference guide for Amazon Lex Model Building Service's +// API operation DeleteSlotTypeVersion for usage and error information. +// +// Returned Error Codes: +// * ErrCodeNotFoundException "NotFoundException" +// The resource specified in the request was not found. Check the resource and +// try again. +// +// * ErrCodeConflictException "ConflictException" +// There was a conflict processing the request. Try your request again. +// +// * ErrCodeLimitExceededException "LimitExceededException" +// The request exceeded a limit. Try your request again. +// +// * ErrCodeInternalFailureException "InternalFailureException" +// An internal Amazon Lex error occurred. Try your request again. +// +// * ErrCodeBadRequestException "BadRequestException" +// The request is not well formed. For example, a value is invalid or a required +// field is missing. Check the field values, and try again. +// +// * ErrCodeResourceInUseException "ResourceInUseException" +// The resource that you are attempting to delete is referred to by another +// resource. Use this information to remove references to the resource that +// you are trying to delete. +// +// The body of the exception contains a JSON object that describes the resource. +// +// { "resourceType": BOT | BOTALIAS | BOTCHANNEL | INTENT, +// +// "resourceReference": { +// +// "name": string, "version": string } } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteSlotTypeVersion +func (c *LexModelBuildingService) DeleteSlotTypeVersion(input *DeleteSlotTypeVersionInput) (*DeleteSlotTypeVersionOutput, error) { + req, out := c.DeleteSlotTypeVersionRequest(input) + return out, req.Send() +} + +// DeleteSlotTypeVersionWithContext is the same as DeleteSlotTypeVersion with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteSlotTypeVersion for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *LexModelBuildingService) DeleteSlotTypeVersionWithContext(ctx aws.Context, input *DeleteSlotTypeVersionInput, opts ...request.Option) (*DeleteSlotTypeVersionOutput, error) { + req, out := c.DeleteSlotTypeVersionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteUtterances = "DeleteUtterances" // DeleteUtterancesRequest generates a "aws/request.Request" representing the @@ -972,9 +1304,13 @@ func (c *LexModelBuildingService) DeleteUtterancesRequest(input *DeleteUtterance // // Deletes stored utterances. // -// When you create or update a bot using the operation, configure your bot to -// store user utterances by setting privacySetting to STORE_UTTERANCES. Use -// DeleteUtterances to remove the stored utterances for a specific user . +// Amazon Lex stores the utterances that users send to your bot unless the childDirected +// field in the bot is set to true. Utterances are stored for 15 days for use +// with the operation, and then stored indefinately for use in improving the +// ability of your bot to respond to user input. +// +// Use the DeleteStoredUtterances operation to manually delete stored utterances +// for a specific user. // // This operation requires permissions for the lex:DeleteUtterances action. // @@ -1164,6 +1500,8 @@ func (c *LexModelBuildingService) GetBotAliasRequest(input *GetBotAliasInput) (r // Returns information about an Amazon Lex bot alias. For more information about // aliases, see versioning-aliases. // +// This operation requires permissions for the lex:GetBotAlias action. +// // 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. @@ -1261,6 +1599,8 @@ func (c *LexModelBuildingService) GetBotAliasesRequest(input *GetBotAliasesInput // // Returns a list of aliases for a specified Amazon Lex bot. // +// This operation requires permissions for the lex:GetBotAliases action. +// // 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. @@ -1399,6 +1739,9 @@ func (c *LexModelBuildingService) GetBotChannelAssociationRequest(input *GetBotC // Returns information about the association between an Amazon Lex bot and a // messaging platform. // +// This operation requires permissions for the lex:GetBotChannelAssociation +// action. +// // 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. @@ -1496,6 +1839,9 @@ func (c *LexModelBuildingService) GetBotChannelAssociationsRequest(input *GetBot // // Returns a list of all of the channels associated with the specified bot. // +// The GetBotChannelAssociations operation requires permissions for the lex:GetBotChannelAssociations +// action. +// // 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. @@ -1647,6 +1993,8 @@ func (c *LexModelBuildingService) GetBotVersionsRequest(input *GetBotVersionsInp // The GetBotVersions operation always returns at least one version, the $LATEST // version. // +// This operation requires permissions for the lex:GetBotVersions action. +// // 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. @@ -2438,6 +2786,8 @@ func (c *LexModelBuildingService) GetIntentVersionsRequest(input *GetIntentVersi // The GetIntentVersions operation always returns at least one version, the // $LATEST version. // +// This operation requires permissions for the lex:GetIntentVersions action. +// // 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. @@ -2842,6 +3192,8 @@ func (c *LexModelBuildingService) GetSlotTypeVersionsRequest(input *GetSlotTypeV // The GetSlotTypeVersions operation always returns at least one version, the // $LATEST version. // +// This operation requires permissions for the lex:GetSlotTypeVersions action. +// // 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. @@ -3151,8 +3503,15 @@ func (c *LexModelBuildingService) GetUtterancesViewRequest(input *GetUtterancesV // old version and the new so that you can compare the performance across the // two versions. // -// You can request information for up to 5 versions in each request. The response -// contains information about a maximum of 100 utterances for each version. +// Data is available for the last 15 days. You can request information for up +// to 5 versions in each request. The response contains information about a +// maximum of 100 utterances for each version. +// +// If the bot's childDirected field is set to true, utterances for the bot are +// not stored and cannot be retrieved with the GetUtterancesView operation. +// For more information, see . +// +// This operation requires permissions for the lex:GetUtterancesView action. // // 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 @@ -3240,10 +3599,10 @@ func (c *LexModelBuildingService) PutBotRequest(input *PutBotInput) (req *reques // PutBot API operation for Amazon Lex Model Building Service. // // Creates an Amazon Lex conversational bot or replaces an existing bot. When -// you create or update an intent you only required to specify a name. You can -// use this to add intents later, or to remove intents from an existing bot. -// When you create a bot with a name only, the bot is created or updated but -// Amazon Lex returns the response FAILED. You can build the bot after you add one or more intents. For more information +// you create or update a bot you only required to specify a name. You can use +// this to add intents later, or to remove intents from an existing bot. When +// you create a bot with a name only, the bot is created or updated but Amazon +// Lex returns the response FAILED. You can build the bot after you add one or more intents. For more information // about Amazon Lex bots, see how-it-works. // // If you specify the name of an existing bot, the fields in the request replace @@ -3486,8 +3845,7 @@ func (c *LexModelBuildingService) PutIntentRequest(input *PutIntentInput) (req * // // For more information, see how-it-works. // -// This operation requires permissions for the lex:PutIntent action. For more -// information, see auth-and-access-control. +// This operation requires permissions for the lex:PutIntent action. // // 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 @@ -4101,7 +4459,7 @@ type CreateBotVersionOutput struct { // see . AbortStatement *Statement `locationName:"abortStatement" type:"structure"` - // Checksum identifying the version of the boat that was created. + // Checksum identifying the version of the bot that was created. Checksum *string `locationName:"checksum" type:"string"` // For each Amazon Lex bot created with the Amazon Lex Model Building Service, @@ -4794,9 +5152,6 @@ type DeleteBotInput struct { // // Name is a required field Name *string `location:"uri" locationName:"name" min:"2" type:"string" required:"true"` - - // The version of the bot. - Version *string `locationName:"version" min:"1" type:"string"` } // String returns the string representation @@ -4818,6 +5173,72 @@ func (s *DeleteBotInput) Validate() error { if s.Name != nil && len(*s.Name) < 2 { invalidParams.Add(request.NewErrParamMinLen("Name", 2)) } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetName sets the Name field's value. +func (s *DeleteBotInput) SetName(v string) *DeleteBotInput { + s.Name = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteBotOutput +type DeleteBotOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DeleteBotOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteBotOutput) GoString() string { + return s.String() +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteBotVersionRequest +type DeleteBotVersionInput struct { + _ struct{} `type:"structure"` + + // The name of the bot. + // + // Name is a required field + Name *string `location:"uri" locationName:"name" min:"2" type:"string" required:"true"` + + // The version of the bot to delete. You cannot delete the $LATEST version of + // the bot. To delete the $LATEST version, use the operation. + // + // Version is a required field + Version *string `location:"uri" locationName:"version" min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s DeleteBotVersionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteBotVersionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteBotVersionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteBotVersionInput"} + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 2 { + invalidParams.Add(request.NewErrParamMinLen("Name", 2)) + } + if s.Version == nil { + invalidParams.Add(request.NewErrParamRequired("Version")) + } if s.Version != nil && len(*s.Version) < 1 { invalidParams.Add(request.NewErrParamMinLen("Version", 1)) } @@ -4829,29 +5250,29 @@ func (s *DeleteBotInput) Validate() error { } // SetName sets the Name field's value. -func (s *DeleteBotInput) SetName(v string) *DeleteBotInput { +func (s *DeleteBotVersionInput) SetName(v string) *DeleteBotVersionInput { s.Name = &v return s } // SetVersion sets the Version field's value. -func (s *DeleteBotInput) SetVersion(v string) *DeleteBotInput { +func (s *DeleteBotVersionInput) SetVersion(v string) *DeleteBotVersionInput { s.Version = &v return s } -// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteBotOutput -type DeleteBotOutput struct { +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteBotVersionOutput +type DeleteBotVersionOutput struct { _ struct{} `type:"structure"` } // String returns the string representation -func (s DeleteBotOutput) String() string { +func (s DeleteBotVersionOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s DeleteBotOutput) GoString() string { +func (s DeleteBotVersionOutput) GoString() string { return s.String() } @@ -4863,9 +5284,6 @@ type DeleteIntentInput struct { // // Name is a required field Name *string `location:"uri" locationName:"name" min:"1" type:"string" required:"true"` - - // The version of the intent. - Version *string `locationName:"version" min:"1" type:"string"` } // String returns the string representation @@ -4887,6 +5305,72 @@ func (s *DeleteIntentInput) Validate() error { if s.Name != nil && len(*s.Name) < 1 { invalidParams.Add(request.NewErrParamMinLen("Name", 1)) } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetName sets the Name field's value. +func (s *DeleteIntentInput) SetName(v string) *DeleteIntentInput { + s.Name = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteIntentOutput +type DeleteIntentOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DeleteIntentOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteIntentOutput) GoString() string { + return s.String() +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteIntentVersionRequest +type DeleteIntentVersionInput struct { + _ struct{} `type:"structure"` + + // The name of the intent. + // + // Name is a required field + Name *string `location:"uri" locationName:"name" min:"1" type:"string" required:"true"` + + // The version of the intent to delete. You cannot delete the $LATEST version + // of the intent. To delete the $LATEST version, use the operation. + // + // Version is a required field + Version *string `location:"uri" locationName:"version" min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s DeleteIntentVersionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteIntentVersionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteIntentVersionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteIntentVersionInput"} + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + if s.Version == nil { + invalidParams.Add(request.NewErrParamRequired("Version")) + } if s.Version != nil && len(*s.Version) < 1 { invalidParams.Add(request.NewErrParamMinLen("Version", 1)) } @@ -4898,29 +5382,29 @@ func (s *DeleteIntentInput) Validate() error { } // SetName sets the Name field's value. -func (s *DeleteIntentInput) SetName(v string) *DeleteIntentInput { +func (s *DeleteIntentVersionInput) SetName(v string) *DeleteIntentVersionInput { s.Name = &v return s } // SetVersion sets the Version field's value. -func (s *DeleteIntentInput) SetVersion(v string) *DeleteIntentInput { +func (s *DeleteIntentVersionInput) SetVersion(v string) *DeleteIntentVersionInput { s.Version = &v return s } -// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteIntentOutput -type DeleteIntentOutput struct { +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteIntentVersionOutput +type DeleteIntentVersionOutput struct { _ struct{} `type:"structure"` } // String returns the string representation -func (s DeleteIntentOutput) String() string { +func (s DeleteIntentVersionOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s DeleteIntentOutput) GoString() string { +func (s DeleteIntentVersionOutput) GoString() string { return s.String() } @@ -4932,9 +5416,6 @@ type DeleteSlotTypeInput struct { // // Name is a required field Name *string `location:"uri" locationName:"name" min:"1" type:"string" required:"true"` - - // The version of the slot type. - Version *string `locationName:"version" min:"1" type:"string"` } // String returns the string representation @@ -4956,6 +5437,72 @@ func (s *DeleteSlotTypeInput) Validate() error { if s.Name != nil && len(*s.Name) < 1 { invalidParams.Add(request.NewErrParamMinLen("Name", 1)) } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetName sets the Name field's value. +func (s *DeleteSlotTypeInput) SetName(v string) *DeleteSlotTypeInput { + s.Name = &v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteSlotTypeOutput +type DeleteSlotTypeOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DeleteSlotTypeOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteSlotTypeOutput) GoString() string { + return s.String() +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteSlotTypeVersionRequest +type DeleteSlotTypeVersionInput struct { + _ struct{} `type:"structure"` + + // The name of the slot type. + // + // Name is a required field + Name *string `location:"uri" locationName:"name" min:"1" type:"string" required:"true"` + + // The version of the slot type to delete. You cannot delete the $LATEST version + // of the slot type. To delete the $LATEST version, use the operation. + // + // Version is a required field + Version *string `location:"uri" locationName:"version" min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s DeleteSlotTypeVersionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteSlotTypeVersionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteSlotTypeVersionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteSlotTypeVersionInput"} + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + if s.Version == nil { + invalidParams.Add(request.NewErrParamRequired("Version")) + } if s.Version != nil && len(*s.Version) < 1 { invalidParams.Add(request.NewErrParamMinLen("Version", 1)) } @@ -4967,29 +5514,29 @@ func (s *DeleteSlotTypeInput) Validate() error { } // SetName sets the Name field's value. -func (s *DeleteSlotTypeInput) SetName(v string) *DeleteSlotTypeInput { +func (s *DeleteSlotTypeVersionInput) SetName(v string) *DeleteSlotTypeVersionInput { s.Name = &v return s } // SetVersion sets the Version field's value. -func (s *DeleteSlotTypeInput) SetVersion(v string) *DeleteSlotTypeInput { +func (s *DeleteSlotTypeVersionInput) SetVersion(v string) *DeleteSlotTypeVersionInput { s.Version = &v return s } -// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteSlotTypeOutput -type DeleteSlotTypeOutput struct { +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19/DeleteSlotTypeVersionOutput +type DeleteSlotTypeVersionOutput struct { _ struct{} `type:"structure"` } // String returns the string representation -func (s DeleteSlotTypeOutput) String() string { +func (s DeleteSlotTypeVersionOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s DeleteSlotTypeOutput) GoString() string { +func (s DeleteSlotTypeVersionOutput) GoString() string { return s.String() } @@ -8929,12 +9476,12 @@ type Slot struct { // Name is a required field Name *string `locationName:"name" min:"1" type:"string" required:"true"` - // Specifies the order in which to elicit slot values from the user. For example, - // if the intent has two slots with priorities 1 and 2, AWS Amazon Lex first + // Directs Lex the order in which to elicit this slot value from the user. For + // example, if the intent has two slots with priorities 1 and 2, AWS Lex first // elicits a value for the slot with priority 1. // - // If multiple slots share the same priority, the order in which Amazon Lex - // elicits values is arbitrary. + // If multiple slots share the same priority, the order in which Lex elicits + // values is arbitrary. Priority *int64 `locationName:"priority" type:"integer"` // A set of possible responses for the slot type used by text-based clients. diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/doc.go new file mode 100644 index 00000000..62060f3e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/doc.go @@ -0,0 +1,82 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package lexmodelbuildingservice provides the client and types for making API +// requests to Amazon Lex Model Building Service. +// +// Amazon Lex is an AWS service for building conversational voice and text interfaces. +// Use these actions to create, update, and delete conversational bots for new +// and existing client applications. +// +// See https://docs.aws.amazon.com/goto/WebAPI/lex-models-2017-04-19 for more information on this service. +// +// See lexmodelbuildingservice package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lexmodelbuildingservice/ +// +// Using the Client +// +// To use the client for Amazon Lex Model Building 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 := lexmodelbuildingservice.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 Lex Model Building Service client LexModelBuildingService for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lexmodelbuildingservice/#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.CreateBotVersion(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("CreateBotVersion 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.CreateBotVersionWithContext(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 lexmodelbuildingservice diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/examples_test.go index cbd392e4..2ccfd9bf 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/examples_test.go @@ -87,8 +87,7 @@ func ExampleLexModelBuildingService_DeleteBot() { svc := lexmodelbuildingservice.New(sess) params := &lexmodelbuildingservice.DeleteBotInput{ - Name: aws.String("BotName"), // Required - Version: aws.String("Version"), + Name: aws.String("BotName"), // Required } resp, err := svc.DeleteBot(params) @@ -148,14 +147,35 @@ func ExampleLexModelBuildingService_DeleteBotChannelAssociation() { fmt.Println(resp) } +func ExampleLexModelBuildingService_DeleteBotVersion() { + sess := session.Must(session.NewSession()) + + svc := lexmodelbuildingservice.New(sess) + + params := &lexmodelbuildingservice.DeleteBotVersionInput{ + Name: aws.String("BotName"), // Required + Version: aws.String("NumericalVersion"), // Required + } + resp, err := svc.DeleteBotVersion(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + func ExampleLexModelBuildingService_DeleteIntent() { sess := session.Must(session.NewSession()) svc := lexmodelbuildingservice.New(sess) params := &lexmodelbuildingservice.DeleteIntentInput{ - Name: aws.String("IntentName"), // Required - Version: aws.String("Version"), + Name: aws.String("IntentName"), // Required } resp, err := svc.DeleteIntent(params) @@ -170,14 +190,35 @@ func ExampleLexModelBuildingService_DeleteIntent() { fmt.Println(resp) } +func ExampleLexModelBuildingService_DeleteIntentVersion() { + sess := session.Must(session.NewSession()) + + svc := lexmodelbuildingservice.New(sess) + + params := &lexmodelbuildingservice.DeleteIntentVersionInput{ + Name: aws.String("IntentName"), // Required + Version: aws.String("NumericalVersion"), // Required + } + resp, err := svc.DeleteIntentVersion(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + func ExampleLexModelBuildingService_DeleteSlotType() { sess := session.Must(session.NewSession()) svc := lexmodelbuildingservice.New(sess) params := &lexmodelbuildingservice.DeleteSlotTypeInput{ - Name: aws.String("SlotTypeName"), // Required - Version: aws.String("Version"), + Name: aws.String("SlotTypeName"), // Required } resp, err := svc.DeleteSlotType(params) @@ -192,6 +233,28 @@ func ExampleLexModelBuildingService_DeleteSlotType() { fmt.Println(resp) } +func ExampleLexModelBuildingService_DeleteSlotTypeVersion() { + sess := session.Must(session.NewSession()) + + svc := lexmodelbuildingservice.New(sess) + + params := &lexmodelbuildingservice.DeleteSlotTypeVersionInput{ + Name: aws.String("SlotTypeName"), // Required + Version: aws.String("NumericalVersion"), // Required + } + resp, err := svc.DeleteSlotTypeVersion(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + func ExampleLexModelBuildingService_DeleteUtterances() { sess := session.Must(session.NewSession()) diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/lexmodelbuildingserviceiface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/lexmodelbuildingserviceiface/interface.go index 283f4c92..980b1173 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/lexmodelbuildingserviceiface/interface.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/lexmodelbuildingserviceiface/interface.go @@ -84,14 +84,26 @@ type LexModelBuildingServiceAPI interface { DeleteBotChannelAssociationWithContext(aws.Context, *lexmodelbuildingservice.DeleteBotChannelAssociationInput, ...request.Option) (*lexmodelbuildingservice.DeleteBotChannelAssociationOutput, error) DeleteBotChannelAssociationRequest(*lexmodelbuildingservice.DeleteBotChannelAssociationInput) (*request.Request, *lexmodelbuildingservice.DeleteBotChannelAssociationOutput) + DeleteBotVersion(*lexmodelbuildingservice.DeleteBotVersionInput) (*lexmodelbuildingservice.DeleteBotVersionOutput, error) + DeleteBotVersionWithContext(aws.Context, *lexmodelbuildingservice.DeleteBotVersionInput, ...request.Option) (*lexmodelbuildingservice.DeleteBotVersionOutput, error) + DeleteBotVersionRequest(*lexmodelbuildingservice.DeleteBotVersionInput) (*request.Request, *lexmodelbuildingservice.DeleteBotVersionOutput) + DeleteIntent(*lexmodelbuildingservice.DeleteIntentInput) (*lexmodelbuildingservice.DeleteIntentOutput, error) DeleteIntentWithContext(aws.Context, *lexmodelbuildingservice.DeleteIntentInput, ...request.Option) (*lexmodelbuildingservice.DeleteIntentOutput, error) DeleteIntentRequest(*lexmodelbuildingservice.DeleteIntentInput) (*request.Request, *lexmodelbuildingservice.DeleteIntentOutput) + DeleteIntentVersion(*lexmodelbuildingservice.DeleteIntentVersionInput) (*lexmodelbuildingservice.DeleteIntentVersionOutput, error) + DeleteIntentVersionWithContext(aws.Context, *lexmodelbuildingservice.DeleteIntentVersionInput, ...request.Option) (*lexmodelbuildingservice.DeleteIntentVersionOutput, error) + DeleteIntentVersionRequest(*lexmodelbuildingservice.DeleteIntentVersionInput) (*request.Request, *lexmodelbuildingservice.DeleteIntentVersionOutput) + DeleteSlotType(*lexmodelbuildingservice.DeleteSlotTypeInput) (*lexmodelbuildingservice.DeleteSlotTypeOutput, error) DeleteSlotTypeWithContext(aws.Context, *lexmodelbuildingservice.DeleteSlotTypeInput, ...request.Option) (*lexmodelbuildingservice.DeleteSlotTypeOutput, error) DeleteSlotTypeRequest(*lexmodelbuildingservice.DeleteSlotTypeInput) (*request.Request, *lexmodelbuildingservice.DeleteSlotTypeOutput) + DeleteSlotTypeVersion(*lexmodelbuildingservice.DeleteSlotTypeVersionInput) (*lexmodelbuildingservice.DeleteSlotTypeVersionOutput, error) + DeleteSlotTypeVersionWithContext(aws.Context, *lexmodelbuildingservice.DeleteSlotTypeVersionInput, ...request.Option) (*lexmodelbuildingservice.DeleteSlotTypeVersionOutput, error) + DeleteSlotTypeVersionRequest(*lexmodelbuildingservice.DeleteSlotTypeVersionInput) (*request.Request, *lexmodelbuildingservice.DeleteSlotTypeVersionOutput) + DeleteUtterances(*lexmodelbuildingservice.DeleteUtterancesInput) (*lexmodelbuildingservice.DeleteUtterancesOutput, error) DeleteUtterancesWithContext(aws.Context, *lexmodelbuildingservice.DeleteUtterancesInput, ...request.Option) (*lexmodelbuildingservice.DeleteUtterancesOutput, error) DeleteUtterancesRequest(*lexmodelbuildingservice.DeleteUtterancesInput) (*request.Request, *lexmodelbuildingservice.DeleteUtterancesOutput) diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/service.go index bae10a6b..89486046 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lexmodelbuildingservice/service.go @@ -11,12 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Amazon Lex is an AWS service for building conversational voice and text interfaces. -// Use these actions to create, update, and delete conversational bots for new -// and existing client applications. -// 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/lex-models-2017-04-19 +// LexModelBuildingService provides the API operation methods for making requests to +// Amazon Lex Model Building Service. See this package's package overview docs +// for details on the service. +// +// LexModelBuildingService methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type LexModelBuildingService struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/api.go index 31b8a4a6..ea77c100 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package lexruntimeservice provides a client for Amazon Lex Runtime Service. package lexruntimeservice import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/doc.go new file mode 100644 index 00000000..f0b9124f --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/doc.go @@ -0,0 +1,90 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package lexruntimeservice provides the client and types for making API +// requests to Amazon Lex Runtime Service. +// +// Amazon Lex provides both build and runtime endpoints. Each endpoint provides +// a set of operations (API). Your conversational bot uses the runtime API to +// understand user utterances (user input text or voice). For example, suppose +// a user says "I want pizza", your bot sends this input to Amazon Lex using +// the runtime API. Amazon Lex recognizes that the user request is for the OrderPizza +// intent (one of the intents defined in the bot). Then Amazon Lex engages in +// user conversation on behalf of the bot to elicit required information (slot +// values, such as pizza size and crust type), and then performs fulfillment +// activity (that you configured when you created the bot). You use the build-time +// API to create and manage your Amazon Lex bot. For a list of build-time operations, +// see the build-time API, . +// +// See https://docs.aws.amazon.com/goto/WebAPI/runtime.lex-2016-11-28 for more information on this service. +// +// See lexruntimeservice package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lexruntimeservice/ +// +// Using the Client +// +// To use the client for Amazon Lex Runtime 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 := lexruntimeservice.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 Lex Runtime Service client LexRuntimeService for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lexruntimeservice/#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.PostContent(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("PostContent 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.PostContentWithContext(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 lexruntimeservice diff --git a/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/service.go index df414680..346a5570 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lexruntimeservice/service.go @@ -11,20 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Amazon Lex provides both build and runtime endpoints. Each endpoint provides -// a set of operations (API). Your conversational bot uses the runtime API to -// understand user utterances (user input text or voice). For example, suppose -// a user says "I want pizza", your bot sends this input to Amazon Lex using -// the runtime API. Amazon Lex recognizes that the user request is for the OrderPizza -// intent (one of the intents defined in the bot). Then Amazon Lex engages in -// user conversation on behalf of the bot to elicit required information (slot -// values, such as pizza size and crust type), and then performs fulfillment -// activity (that you configured when you created the bot). You use the build-time -// API to create and manage your Amazon Lex bot. For a list of build-time operations, -// see the build-time API, . -// 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/runtime.lex-2016-11-28 +// LexRuntimeService provides the API operation methods for making requests to +// Amazon Lex Runtime Service. See this package's package overview docs +// for details on the service. +// +// LexRuntimeService methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type LexRuntimeService struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/lightsail/api.go b/vendor/github.com/aws/aws-sdk-go/service/lightsail/api.go index b61e0eaa..f8313b0e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lightsail/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lightsail/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package lightsail provides a client for Amazon Lightsail. package lightsail import ( @@ -73,6 +72,10 @@ func (c *Lightsail) AllocateStaticIpRequest(input *AllocateStaticIpInput) (req * // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -174,6 +177,10 @@ func (c *Lightsail) AttachStaticIpRequest(input *AttachStaticIpInput) (req *requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -275,6 +282,10 @@ func (c *Lightsail) CloseInstancePublicPortsRequest(input *CloseInstancePublicPo // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -376,6 +387,10 @@ func (c *Lightsail) CreateDomainRequest(input *CreateDomainInput) (req *request. // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -478,6 +493,10 @@ func (c *Lightsail) CreateDomainEntryRequest(input *CreateDomainEntryInput) (req // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -580,6 +599,10 @@ func (c *Lightsail) CreateInstanceSnapshotRequest(input *CreateInstanceSnapshotI // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -681,6 +704,10 @@ func (c *Lightsail) CreateInstancesRequest(input *CreateInstancesInput) (req *re // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -783,6 +810,10 @@ func (c *Lightsail) CreateInstancesFromSnapshotRequest(input *CreateInstancesFro // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -884,6 +915,10 @@ func (c *Lightsail) CreateKeyPairRequest(input *CreateKeyPairInput) (req *reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -985,6 +1020,10 @@ func (c *Lightsail) DeleteDomainRequest(input *DeleteDomainInput) (req *request. // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1086,6 +1125,10 @@ func (c *Lightsail) DeleteDomainEntryRequest(input *DeleteDomainEntryInput) (req // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1187,6 +1230,10 @@ func (c *Lightsail) DeleteInstanceRequest(input *DeleteInstanceInput) (req *requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1288,6 +1335,10 @@ func (c *Lightsail) DeleteInstanceSnapshotRequest(input *DeleteInstanceSnapshotI // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1389,6 +1440,10 @@ func (c *Lightsail) DeleteKeyPairRequest(input *DeleteKeyPairInput) (req *reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1490,6 +1545,10 @@ func (c *Lightsail) DetachStaticIpRequest(input *DetachStaticIpInput) (req *requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1591,6 +1650,10 @@ func (c *Lightsail) DownloadDefaultKeyPairRequest(input *DownloadDefaultKeyPairI // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1692,6 +1755,10 @@ func (c *Lightsail) GetActiveNamesRequest(input *GetActiveNamesInput) (req *requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1796,6 +1863,10 @@ func (c *Lightsail) GetBlueprintsRequest(input *GetBlueprintsInput) (req *reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1898,6 +1969,10 @@ func (c *Lightsail) GetBundlesRequest(input *GetBundlesInput) (req *request.Requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -1999,6 +2074,10 @@ func (c *Lightsail) GetDomainRequest(input *GetDomainInput) (req *request.Reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2100,6 +2179,10 @@ func (c *Lightsail) GetDomainsRequest(input *GetDomainsInput) (req *request.Requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2202,6 +2285,10 @@ func (c *Lightsail) GetInstanceRequest(input *GetInstanceInput) (req *request.Re // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2304,6 +2391,10 @@ func (c *Lightsail) GetInstanceAccessDetailsRequest(input *GetInstanceAccessDeta // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2406,6 +2497,10 @@ func (c *Lightsail) GetInstanceMetricDataRequest(input *GetInstanceMetricDataInp // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2507,6 +2602,10 @@ func (c *Lightsail) GetInstancePortStatesRequest(input *GetInstancePortStatesInp // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2608,6 +2707,10 @@ func (c *Lightsail) GetInstanceSnapshotRequest(input *GetInstanceSnapshotInput) // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2709,6 +2812,10 @@ func (c *Lightsail) GetInstanceSnapshotsRequest(input *GetInstanceSnapshotsInput // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2810,6 +2917,10 @@ func (c *Lightsail) GetInstanceStateRequest(input *GetInstanceStateInput) (req * // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -2912,6 +3023,10 @@ func (c *Lightsail) GetInstancesRequest(input *GetInstancesInput) (req *request. // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3013,6 +3128,10 @@ func (c *Lightsail) GetKeyPairRequest(input *GetKeyPairInput) (req *request.Requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3114,6 +3233,10 @@ func (c *Lightsail) GetKeyPairsRequest(input *GetKeyPairsInput) (req *request.Re // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3217,6 +3340,10 @@ func (c *Lightsail) GetOperationRequest(input *GetOperationInput) (req *request. // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3322,6 +3449,10 @@ func (c *Lightsail) GetOperationsRequest(input *GetOperationsInput) (req *reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3423,6 +3554,10 @@ func (c *Lightsail) GetOperationsForResourceRequest(input *GetOperationsForResou // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3507,7 +3642,8 @@ func (c *Lightsail) GetRegionsRequest(input *GetRegionsInput) (req *request.Requ // GetRegions API operation for Amazon Lightsail. // -// Returns a list of all valid regions for Amazon Lightsail. +// Returns a list of all valid regions for Amazon Lightsail. Use the include +// availability zones parameter to also return the availability zones in a region. // // 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 @@ -3524,6 +3660,10 @@ func (c *Lightsail) GetRegionsRequest(input *GetRegionsInput) (req *request.Requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3625,6 +3765,10 @@ func (c *Lightsail) GetStaticIpRequest(input *GetStaticIpInput) (req *request.Re // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3726,6 +3870,10 @@ func (c *Lightsail) GetStaticIpsRequest(input *GetStaticIpsInput) (req *request. // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3827,6 +3975,10 @@ func (c *Lightsail) ImportKeyPairRequest(input *ImportKeyPairInput) (req *reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -3928,6 +4080,10 @@ func (c *Lightsail) IsVpcPeeredRequest(input *IsVpcPeeredInput) (req *request.Re // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4029,6 +4185,10 @@ func (c *Lightsail) OpenInstancePublicPortsRequest(input *OpenInstancePublicPort // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4130,6 +4290,10 @@ func (c *Lightsail) PeerVpcRequest(input *PeerVpcInput) (req *request.Request, o // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4169,6 +4333,112 @@ func (c *Lightsail) PeerVpcWithContext(ctx aws.Context, input *PeerVpcInput, opt return out, req.Send() } +const opPutInstancePublicPorts = "PutInstancePublicPorts" + +// PutInstancePublicPortsRequest generates a "aws/request.Request" representing the +// client's request for the PutInstancePublicPorts operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See PutInstancePublicPorts for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the PutInstancePublicPorts method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the PutInstancePublicPortsRequest method. +// req, resp := client.PutInstancePublicPortsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPorts +func (c *Lightsail) PutInstancePublicPortsRequest(input *PutInstancePublicPortsInput) (req *request.Request, output *PutInstancePublicPortsOutput) { + op := &request.Operation{ + Name: opPutInstancePublicPorts, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &PutInstancePublicPortsInput{} + } + + output = &PutInstancePublicPortsOutput{} + req = c.newRequest(op, input, output) + return +} + +// PutInstancePublicPorts API operation for Amazon Lightsail. +// +// Sets the specified open ports for an Amazon Lightsail instance, and closes +// all ports for every protocol not included in the current request. +// +// 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. +// +// See the AWS API reference guide for Amazon Lightsail's +// API operation PutInstancePublicPorts for usage and error information. +// +// Returned Error Codes: +// * ErrCodeServiceException "ServiceException" +// A general service exception. +// +// * ErrCodeInvalidInputException "InvalidInputException" +// Lightsail throws this exception when user input does not conform to the validation +// rules of an input field. +// +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// +// * ErrCodeNotFoundException "NotFoundException" +// Lightsail throws this exception when it cannot find a resource. +// +// * ErrCodeOperationFailureException "OperationFailureException" +// Lightsail throws this exception when an operation fails to execute. +// +// * ErrCodeAccessDeniedException "AccessDeniedException" +// Lightsail throws this exception when the user cannot be authenticated or +// uses invalid credentials to access a resource. +// +// * ErrCodeAccountSetupInProgressException "AccountSetupInProgressException" +// Lightsail throws this exception when an account is still in the setup in +// progress state. +// +// * ErrCodeUnauthenticatedException "UnauthenticatedException" +// Lightsail throws this exception when the user has not been authenticated. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPorts +func (c *Lightsail) PutInstancePublicPorts(input *PutInstancePublicPortsInput) (*PutInstancePublicPortsOutput, error) { + req, out := c.PutInstancePublicPortsRequest(input) + return out, req.Send() +} + +// PutInstancePublicPortsWithContext is the same as PutInstancePublicPorts with the addition of +// the ability to pass a context and additional request options. +// +// See PutInstancePublicPorts for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Lightsail) PutInstancePublicPortsWithContext(ctx aws.Context, input *PutInstancePublicPortsInput, opts ...request.Option) (*PutInstancePublicPortsOutput, error) { + req, out := c.PutInstancePublicPortsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opRebootInstance = "RebootInstance" // RebootInstanceRequest generates a "aws/request.Request" representing the @@ -4234,6 +4504,10 @@ func (c *Lightsail) RebootInstanceRequest(input *RebootInstanceInput) (req *requ // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4335,6 +4609,10 @@ func (c *Lightsail) ReleaseStaticIpRequest(input *ReleaseStaticIpInput) (req *re // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4437,6 +4715,10 @@ func (c *Lightsail) StartInstanceRequest(input *StartInstanceInput) (req *reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4538,6 +4820,10 @@ func (c *Lightsail) StopInstanceRequest(input *StopInstanceInput) (req *request. // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4639,6 +4925,10 @@ func (c *Lightsail) UnpeerVpcRequest(input *UnpeerVpcInput) (req *request.Reques // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4740,6 +5030,10 @@ func (c *Lightsail) UpdateDomainEntryRequest(input *UpdateDomainEntryInput) (req // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. // +// Domain-related APIs are only available in the N. Virginia (us-east-1) Region. +// Please set your Region configuration to us-east-1 to create, view, or edit +// these resources. +// // * ErrCodeNotFoundException "NotFoundException" // Lightsail throws this exception when it cannot find a resource. // @@ -4928,7 +5222,7 @@ type AvailabilityZone struct { // The state of the Availability Zone. State *string `locationName:"state" type:"string"` - // The name of the Availability Zone. + // The name of the Availability Zone. The format is us-east-1a (case-sensitive). ZoneName *string `locationName:"zoneName" type:"string"` } @@ -5488,7 +5782,10 @@ type CreateInstancesFromSnapshotInput struct { _ struct{} `type:"structure"` // The Availability Zone where you want to create your instances. Use the following - // formatting: us-east-1a (case sensitive). + // formatting: us-east-1a (case sensitive). You can get a list of availability + // zones by using the get regions (http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html) + // operation. Be sure to add the include availability zones parameter to your + // request. // // AvailabilityZone is a required field AvailabilityZone *string `locationName:"availabilityZone" type:"string" required:"true"` @@ -5622,7 +5919,10 @@ type CreateInstancesInput struct { _ struct{} `type:"structure"` // The Availability Zone in which to create your instance. Use the following - // format: us-east-1a (case sensitive). + // format: us-east-1a (case sensitive). You can get a list of availability zones + // by using the get regions (http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html) + // operation. Be sure to add the include availability zones parameter to your + // request. // // AvailabilityZone is a required field AvailabilityZone *string `locationName:"availabilityZone" type:"string" required:"true"` @@ -7247,7 +7547,7 @@ type GetInstancePortStatesOutput struct { _ struct{} `type:"structure"` // Information about the port states resulting from your request. - PortStates []*string `locationName:"portStates" type:"list"` + PortStates []*InstancePortState `locationName:"portStates" type:"list"` } // String returns the string representation @@ -7261,7 +7561,7 @@ func (s GetInstancePortStatesOutput) GoString() string { } // SetPortStates sets the PortStates field's value. -func (s *GetInstancePortStatesOutput) SetPortStates(v []*string) *GetInstancePortStatesOutput { +func (s *GetInstancePortStatesOutput) SetPortStates(v []*InstancePortState) *GetInstancePortStatesOutput { s.PortStates = v return s } @@ -8464,7 +8764,24 @@ type InstancePortInfo struct { // The first port in the range. FromPort *int64 `locationName:"fromPort" type:"integer"` - // The protocol. + // The protocol being used. Can be one of the following. + // + // * tcp - Transmission Control Protocol (TCP) provides reliable, ordered, + // and error-checked delivery of streamed data between applications running + // on hosts communicating by an IP network. If you have an application that + // doesn't require reliable data stream service, use UDP instead. + // + // * all - All transport layer protocol types. For more general information, + // see Transport layer (https://en.wikipedia.org/wiki/Transport_layer) on + // Wikipedia. + // + // * udp - With User Datagram Protocol (UDP), computer applications can send + // messages (or datagrams) to other hosts on an Internet Protocol (IP) network. + // Prior communications are not required to set up transmission channels + // or data paths. Applications that don't require reliable data stream service + // can use UDP, which provides a connectionless datagram service that emphasizes + // reduced latency over reliability. If you do require reliable data stream + // service, use TCP instead. Protocol *string `locationName:"protocol" type:"string" enum:"NetworkProtocol"` // The last port in the range. @@ -8523,6 +8840,75 @@ func (s *InstancePortInfo) SetToPort(v int64) *InstancePortInfo { return s } +// Describes the port state. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/InstancePortState +type InstancePortState struct { + _ struct{} `type:"structure"` + + // The first port in the range. + FromPort *int64 `locationName:"fromPort" type:"integer"` + + // The protocol being used. Can be one of the following. + // + // * tcp - Transmission Control Protocol (TCP) provides reliable, ordered, + // and error-checked delivery of streamed data between applications running + // on hosts communicating by an IP network. If you have an application that + // doesn't require reliable data stream service, use UDP instead. + // + // * all - All transport layer protocol types. For more general information, + // see Transport layer (https://en.wikipedia.org/wiki/Transport_layer) on + // Wikipedia. + // + // * udp - With User Datagram Protocol (UDP), computer applications can send + // messages (or datagrams) to other hosts on an Internet Protocol (IP) network. + // Prior communications are not required to set up transmission channels + // or data paths. Applications that don't require reliable data stream service + // can use UDP, which provides a connectionless datagram service that emphasizes + // reduced latency over reliability. If you do require reliable data stream + // service, use TCP instead. + Protocol *string `locationName:"protocol" type:"string" enum:"NetworkProtocol"` + + // Specifies whether the instance port is open or closed. + State *string `locationName:"state" type:"string" enum:"PortState"` + + // The last port in the range. + ToPort *int64 `locationName:"toPort" type:"integer"` +} + +// String returns the string representation +func (s InstancePortState) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s InstancePortState) GoString() string { + return s.String() +} + +// SetFromPort sets the FromPort field's value. +func (s *InstancePortState) SetFromPort(v int64) *InstancePortState { + s.FromPort = &v + return s +} + +// SetProtocol sets the Protocol field's value. +func (s *InstancePortState) SetProtocol(v string) *InstancePortState { + s.Protocol = &v + return s +} + +// SetState sets the State field's value. +func (s *InstancePortState) SetState(v string) *InstancePortState { + s.State = &v + return s +} + +// SetToPort sets the ToPort field's value. +func (s *InstancePortState) SetToPort(v int64) *InstancePortState { + s.ToPort = &v + return s +} + // Describes the snapshot of the virtual private server, or instance. // Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/InstanceSnapshot type InstanceSnapshot struct { @@ -9204,6 +9590,83 @@ func (s *PortInfo) SetToPort(v int64) *PortInfo { return s } +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPortsRequest +type PutInstancePublicPortsInput struct { + _ struct{} `type:"structure"` + + // The Lightsail instance name of the public port(s) you are setting. + // + // InstanceName is a required field + InstanceName *string `locationName:"instanceName" type:"string" required:"true"` + + // Specifies information about the public port(s). + // + // PortInfos is a required field + PortInfos []*PortInfo `locationName:"portInfos" type:"list" required:"true"` +} + +// String returns the string representation +func (s PutInstancePublicPortsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutInstancePublicPortsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *PutInstancePublicPortsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "PutInstancePublicPortsInput"} + if s.InstanceName == nil { + invalidParams.Add(request.NewErrParamRequired("InstanceName")) + } + if s.PortInfos == nil { + invalidParams.Add(request.NewErrParamRequired("PortInfos")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetInstanceName sets the InstanceName field's value. +func (s *PutInstancePublicPortsInput) SetInstanceName(v string) *PutInstancePublicPortsInput { + s.InstanceName = &v + return s +} + +// SetPortInfos sets the PortInfos field's value. +func (s *PutInstancePublicPortsInput) SetPortInfos(v []*PortInfo) *PutInstancePublicPortsInput { + s.PortInfos = v + return s +} + +// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPortsResult +type PutInstancePublicPortsOutput struct { + _ struct{} `type:"structure"` + + // Describes metadata about the operation you just executed. + Operation *Operation `locationName:"operation" type:"structure"` +} + +// String returns the string representation +func (s PutInstancePublicPortsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PutInstancePublicPortsOutput) GoString() string { + return s.String() +} + +// SetOperation sets the Operation field's value. +func (s *PutInstancePublicPortsOutput) SetOperation(v *Operation) *PutInstancePublicPortsOutput { + s.Operation = v + return s +} + // Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/RebootInstanceRequest type RebootInstanceInput struct { _ struct{} `type:"structure"` @@ -9272,7 +9735,7 @@ func (s *RebootInstanceOutput) SetOperations(v []*Operation) *RebootInstanceOutp type Region struct { _ struct{} `type:"structure"` - // The Availability Zones. + // The Availability Zones. Follows the format us-east-1a (case-sensitive). AvailabilityZones []*AvailabilityZone `locationName:"availabilityZones" type:"list"` // The continent code (e.g., NA, meaning North America). @@ -9397,7 +9860,7 @@ func (s *ReleaseStaticIpOutput) SetOperations(v []*Operation) *ReleaseStaticIpOu type ResourceLocation struct { _ struct{} `type:"structure"` - // The Availability Zone. + // The Availability Zone. Follows the format us-east-1a (case-sensitive). AvailabilityZone *string `locationName:"availabilityZone" type:"string"` // The AWS Region name. @@ -9966,6 +10429,9 @@ const ( // OperationTypeOpenInstancePublicPorts is a OperationType enum value OperationTypeOpenInstancePublicPorts = "OpenInstancePublicPorts" + // OperationTypePutInstancePublicPorts is a OperationType enum value + OperationTypePutInstancePublicPorts = "PutInstancePublicPorts" + // OperationTypeCloseInstancePublicPorts is a OperationType enum value OperationTypeCloseInstancePublicPorts = "CloseInstancePublicPorts" diff --git a/vendor/github.com/aws/aws-sdk-go/service/lightsail/doc.go b/vendor/github.com/aws/aws-sdk-go/service/lightsail/doc.go new file mode 100644 index 00000000..0e2e9ee6 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/lightsail/doc.go @@ -0,0 +1,92 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package lightsail provides the client and types for making API +// requests to Amazon Lightsail. +// +// Amazon Lightsail is the easiest way to get started with AWS for developers +// who just need virtual private servers. Lightsail includes everything you +// need to launch your project quickly - a virtual machine, SSD-based storage, +// data transfer, DNS management, and a static IP - for a low, predictable price. +// You manage those Lightsail servers through the Lightsail console or by using +// the API or command-line interface (CLI). +// +// For more information about Lightsail concepts and tasks, see the Lightsail +// Dev Guide (https://lightsail.aws.amazon.com/ls/docs/all). +// +// To use the Lightsail API or the CLI, you will need to use AWS Identity and +// Access Management (IAM) to generate access keys. For details about how to +// set this up, see the Lightsail Dev Guide (http://lightsail.aws.amazon.com/ls/docs/how-to/article/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli). +// +// See https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28 for more information on this service. +// +// See lightsail package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lightsail/ +// +// Using the Client +// +// To use the client for Amazon Lightsail 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 := lightsail.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 Lightsail client Lightsail for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/lightsail/#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.AllocateStaticIp(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("AllocateStaticIp 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.AllocateStaticIpWithContext(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 lightsail diff --git a/vendor/github.com/aws/aws-sdk-go/service/lightsail/errors.go b/vendor/github.com/aws/aws-sdk-go/service/lightsail/errors.go index a42a1393..d1ef481f 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lightsail/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lightsail/errors.go @@ -23,6 +23,10 @@ const ( // // Lightsail throws this exception when user input does not conform to the validation // rules of an input field. + // + // Domain-related APIs are only available in the N. Virginia (us-east-1) Region. + // Please set your Region configuration to us-east-1 to create, view, or edit + // these resources. ErrCodeInvalidInputException = "InvalidInputException" // ErrCodeNotFoundException for service response error code diff --git a/vendor/github.com/aws/aws-sdk-go/service/lightsail/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/lightsail/examples_test.go index d1198da8..f648047e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lightsail/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lightsail/examples_test.go @@ -933,6 +933,35 @@ func ExampleLightsail_PeerVpc() { fmt.Println(resp) } +func ExampleLightsail_PutInstancePublicPorts() { + sess := session.Must(session.NewSession()) + + svc := lightsail.New(sess) + + params := &lightsail.PutInstancePublicPortsInput{ + InstanceName: aws.String("ResourceName"), // Required + PortInfos: []*lightsail.PortInfo{ // Required + { // Required + FromPort: aws.Int64(1), + Protocol: aws.String("NetworkProtocol"), + ToPort: aws.Int64(1), + }, + // More values... + }, + } + resp, err := svc.PutInstancePublicPorts(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} + func ExampleLightsail_RebootInstance() { sess := session.Must(session.NewSession()) diff --git a/vendor/github.com/aws/aws-sdk-go/service/lightsail/lightsailiface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/lightsail/lightsailiface/interface.go index 7c96e9c2..40a449bd 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lightsail/lightsailiface/interface.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lightsail/lightsailiface/interface.go @@ -224,6 +224,10 @@ type LightsailAPI interface { PeerVpcWithContext(aws.Context, *lightsail.PeerVpcInput, ...request.Option) (*lightsail.PeerVpcOutput, error) PeerVpcRequest(*lightsail.PeerVpcInput) (*request.Request, *lightsail.PeerVpcOutput) + PutInstancePublicPorts(*lightsail.PutInstancePublicPortsInput) (*lightsail.PutInstancePublicPortsOutput, error) + PutInstancePublicPortsWithContext(aws.Context, *lightsail.PutInstancePublicPortsInput, ...request.Option) (*lightsail.PutInstancePublicPortsOutput, error) + PutInstancePublicPortsRequest(*lightsail.PutInstancePublicPortsInput) (*request.Request, *lightsail.PutInstancePublicPortsOutput) + RebootInstance(*lightsail.RebootInstanceInput) (*lightsail.RebootInstanceOutput, error) RebootInstanceWithContext(aws.Context, *lightsail.RebootInstanceInput, ...request.Option) (*lightsail.RebootInstanceOutput, error) RebootInstanceRequest(*lightsail.RebootInstanceInput) (*request.Request, *lightsail.RebootInstanceOutput) diff --git a/vendor/github.com/aws/aws-sdk-go/service/lightsail/service.go b/vendor/github.com/aws/aws-sdk-go/service/lightsail/service.go index 544902d8..a76cf79e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/lightsail/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/lightsail/service.go @@ -11,22 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon Lightsail is the easiest way to get started with AWS for developers -// who just need virtual private servers. Lightsail includes everything you -// need to launch your project quickly - a virtual machine, SSD-based storage, -// data transfer, DNS management, and a static IP - for a low, predictable price. -// You manage those Lightsail servers through the Lightsail console or by using -// the API or command-line interface (CLI). +// Lightsail provides the API operation methods for making requests to +// Amazon Lightsail. See this package's package overview docs +// for details on the service. // -// For more information about Lightsail concepts and tasks, see the Lightsail -// Dev Guide (http://lightsail.aws.amazon.com/ls/docs). -// -// To use the Lightsail API or the CLI, you will need to use AWS Identity and -// Access Management (IAM) to generate access keys. For details about how to -// set this up, see the Lightsail Dev Guide (http://lightsail.aws.amazon.com/ls/docs/how-to/articles/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli). -// 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/lightsail-2016-11-28 +// Lightsail methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Lightsail struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/machinelearning/api.go b/vendor/github.com/aws/aws-sdk-go/service/machinelearning/api.go index df0ae266..927e74b2 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/machinelearning/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/machinelearning/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package machinelearning provides a client for Amazon Machine Learning. package machinelearning import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/machinelearning/doc.go b/vendor/github.com/aws/aws-sdk-go/service/machinelearning/doc.go new file mode 100644 index 00000000..ba53f209 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/machinelearning/doc.go @@ -0,0 +1,78 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package machinelearning provides the client and types for making API +// requests to Amazon Machine Learning. +// +// Definition of the public APIs exposed by Amazon Machine Learning +// +// See machinelearning package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/machinelearning/ +// +// Using the Client +// +// To use the client for Amazon Machine Learning 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 := machinelearning.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 Machine Learning client MachineLearning for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/machinelearning/#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 machinelearning diff --git a/vendor/github.com/aws/aws-sdk-go/service/machinelearning/service.go b/vendor/github.com/aws/aws-sdk-go/service/machinelearning/service.go index 1bb71324..c68da96a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/machinelearning/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/machinelearning/service.go @@ -11,9 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Definition of the public APIs exposed by Amazon Machine Learning -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// MachineLearning provides the API operation methods for making requests to +// Amazon Machine Learning. See this package's package overview docs +// for details on the service. +// +// MachineLearning methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type MachineLearning struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/api.go b/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/api.go index 85feacbd..dd5458cc 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package marketplacecommerceanalytics provides a client for AWS Marketplace Commerce Analytics. package marketplacecommerceanalytics import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/doc.go b/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/doc.go new file mode 100644 index 00000000..4d112f6f --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/doc.go @@ -0,0 +1,80 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package marketplacecommerceanalytics provides the client and types for making API +// requests to AWS Marketplace Commerce Analytics. +// +// Provides AWS Marketplace business intelligence data on-demand. +// +// See https://docs.aws.amazon.com/goto/WebAPI/marketplacecommerceanalytics-2015-07-01 for more information on this service. +// +// See marketplacecommerceanalytics package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/marketplacecommerceanalytics/ +// +// Using the Client +// +// To use the client for AWS Marketplace Commerce Analytics 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 := marketplacecommerceanalytics.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 Marketplace Commerce Analytics client MarketplaceCommerceAnalytics for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/marketplacecommerceanalytics/#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.GenerateDataSet(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("GenerateDataSet 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.GenerateDataSetWithContext(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 marketplacecommerceanalytics diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/service.go b/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/service.go index c26e59cb..4c782f29 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplacecommerceanalytics/service.go @@ -11,10 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Provides AWS Marketplace business intelligence data on-demand. -// 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/marketplacecommerceanalytics-2015-07-01 +// MarketplaceCommerceAnalytics provides the API operation methods for making requests to +// AWS Marketplace Commerce Analytics. See this package's package overview docs +// for details on the service. +// +// MarketplaceCommerceAnalytics methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type MarketplaceCommerceAnalytics struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/api.go b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/api.go new file mode 100644 index 00000000..809909bd --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/api.go @@ -0,0 +1,352 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package marketplaceentitlementservice + +import ( + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/awsutil" + "github.com/aws/aws-sdk-go/aws/request" +) + +const opGetEntitlements = "GetEntitlements" + +// GetEntitlementsRequest generates a "aws/request.Request" representing the +// client's request for the GetEntitlements operation. The "output" return +// value can be used to capture response data after the request's "Send" method +// is called. +// +// See GetEntitlements for usage and error information. +// +// Creating a request object using this method should be used when you want to inject +// custom logic into the request's lifecycle using a custom handler, or if you want to +// access properties on the request object before or after sending the request. If +// you just want the service response, call the GetEntitlements method directly +// instead. +// +// Note: You must call the "Send" method on the returned request object in order +// to execute the request. +// +// // Example sending a request using the GetEntitlementsRequest method. +// req, resp := client.GetEntitlementsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/GetEntitlements +func (c *MarketplaceEntitlementService) GetEntitlementsRequest(input *GetEntitlementsInput) (req *request.Request, output *GetEntitlementsOutput) { + op := &request.Operation{ + Name: opGetEntitlements, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &GetEntitlementsInput{} + } + + output = &GetEntitlementsOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetEntitlements API operation for AWS Marketplace Entitlement Service. +// +// GetEntitlements retrieves entitlement values for a given product. The results +// can be filtered based on customer identifier or product dimensions. +// +// 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. +// +// See the AWS API reference guide for AWS Marketplace Entitlement Service's +// API operation GetEntitlements for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidParameterException "InvalidParameterException" +// One or more parameters in your request was invalid. +// +// * ErrCodeThrottlingException "ThrottlingException" +// The calls to the GetEntitlements API are throttled. +// +// * ErrCodeInternalServiceErrorException "InternalServiceErrorException" +// An internal error has occurred. Retry your request. If the problem persists, +// post a message with details on the AWS forums. +// +// Please also see https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/GetEntitlements +func (c *MarketplaceEntitlementService) GetEntitlements(input *GetEntitlementsInput) (*GetEntitlementsOutput, error) { + req, out := c.GetEntitlementsRequest(input) + return out, req.Send() +} + +// GetEntitlementsWithContext is the same as GetEntitlements with the addition of +// the ability to pass a context and additional request options. +// +// See GetEntitlements for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *MarketplaceEntitlementService) GetEntitlementsWithContext(ctx aws.Context, input *GetEntitlementsInput, opts ...request.Option) (*GetEntitlementsOutput, error) { + req, out := c.GetEntitlementsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// An entitlement represents capacity in a product owned by the customer. For +// example, a customer might own some number of users or seats in an SaaS application +// or some amount of data capacity in a multi-tenant database. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/Entitlement +type Entitlement struct { + _ struct{} `type:"structure"` + + // The customer identifier is a handle to each unique customer in an application. + // Customer identifiers are obtained through the ResolveCustomer operation in + // AWS Marketplace Metering Service. + CustomerIdentifier *string `type:"string"` + + // The dimension for which the given entitlement applies. Dimensions represent + // categories of capacity in a product and are specified when the product is + // listed in AWS Marketplace. + Dimension *string `type:"string"` + + // The expiration date represents the minimum date through which this entitlement + // is expected to remain valid. For contractual products listed on AWS Marketplace, + // the expiration date is the date at which the customer will renew or cancel + // their contract. Customers who are opting to renew their contract will still + // have entitlements with an expiration date. + ExpirationDate *time.Time `type:"timestamp" timestampFormat:"unix"` + + // The product code for which the given entitlement applies. Product codes are + // provided by AWS Marketplace when the product listing is created. + ProductCode *string `min:"1" type:"string"` + + // The EntitlementValue represents the amount of capacity that the customer + // is entitled to for the product. + Value *EntitlementValue `type:"structure"` +} + +// String returns the string representation +func (s Entitlement) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s Entitlement) GoString() string { + return s.String() +} + +// SetCustomerIdentifier sets the CustomerIdentifier field's value. +func (s *Entitlement) SetCustomerIdentifier(v string) *Entitlement { + s.CustomerIdentifier = &v + return s +} + +// SetDimension sets the Dimension field's value. +func (s *Entitlement) SetDimension(v string) *Entitlement { + s.Dimension = &v + return s +} + +// SetExpirationDate sets the ExpirationDate field's value. +func (s *Entitlement) SetExpirationDate(v time.Time) *Entitlement { + s.ExpirationDate = &v + return s +} + +// SetProductCode sets the ProductCode field's value. +func (s *Entitlement) SetProductCode(v string) *Entitlement { + s.ProductCode = &v + return s +} + +// SetValue sets the Value field's value. +func (s *Entitlement) SetValue(v *EntitlementValue) *Entitlement { + s.Value = v + return s +} + +// The EntitlementValue represents the amount of capacity that the customer +// is entitled to for the product. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/EntitlementValue +type EntitlementValue struct { + _ struct{} `type:"structure"` + + // The BooleanValue field will be populated with a boolean value when the entitlement + // is a boolean type. Otherwise, the field will not be set. + BooleanValue *bool `type:"boolean"` + + // The DoubleValue field will be populated with a double value when the entitlement + // is a double type. Otherwise, the field will not be set. + DoubleValue *float64 `type:"double"` + + // The IntegerValue field will be populated with an integer value when the entitlement + // is an integer type. Otherwise, the field will not be set. + IntegerValue *int64 `type:"integer"` + + // The StringValue field will be populated with a string value when the entitlement + // is a string type. Otherwise, the field will not be set. + StringValue *string `type:"string"` +} + +// String returns the string representation +func (s EntitlementValue) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s EntitlementValue) GoString() string { + return s.String() +} + +// SetBooleanValue sets the BooleanValue field's value. +func (s *EntitlementValue) SetBooleanValue(v bool) *EntitlementValue { + s.BooleanValue = &v + return s +} + +// SetDoubleValue sets the DoubleValue field's value. +func (s *EntitlementValue) SetDoubleValue(v float64) *EntitlementValue { + s.DoubleValue = &v + return s +} + +// SetIntegerValue sets the IntegerValue field's value. +func (s *EntitlementValue) SetIntegerValue(v int64) *EntitlementValue { + s.IntegerValue = &v + return s +} + +// SetStringValue sets the StringValue field's value. +func (s *EntitlementValue) SetStringValue(v string) *EntitlementValue { + s.StringValue = &v + return s +} + +// The GetEntitlementsRequest contains parameters for the GetEntitlements operation. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/GetEntitlementsRequest +type GetEntitlementsInput struct { + _ struct{} `type:"structure"` + + // Filter is used to return entitlements for a specific customer or for a specific + // dimension. Filters are described as keys mapped to a lists of values. Filtered + // requests are unioned for each value in the value list, and then intersected + // for each filter key. + Filter map[string][]*string `type:"map"` + + // The maximum number of items to retrieve from the GetEntitlements operation. + // For pagination, use the NextToken field in subsequent calls to GetEntitlements. + MaxResults *int64 `type:"integer"` + + // For paginated calls to GetEntitlements, pass the NextToken from the previous + // GetEntitlementsResult. + NextToken *string `type:"string"` + + // Product code is used to uniquely identify a product in AWS Marketplace. The + // product code will be provided by AWS Marketplace when the product listing + // is created. + // + // ProductCode is a required field + ProductCode *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s GetEntitlementsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetEntitlementsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetEntitlementsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetEntitlementsInput"} + if s.ProductCode == nil { + invalidParams.Add(request.NewErrParamRequired("ProductCode")) + } + if s.ProductCode != nil && len(*s.ProductCode) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProductCode", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetFilter sets the Filter field's value. +func (s *GetEntitlementsInput) SetFilter(v map[string][]*string) *GetEntitlementsInput { + s.Filter = v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *GetEntitlementsInput) SetMaxResults(v int64) *GetEntitlementsInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *GetEntitlementsInput) SetNextToken(v string) *GetEntitlementsInput { + s.NextToken = &v + return s +} + +// SetProductCode sets the ProductCode field's value. +func (s *GetEntitlementsInput) SetProductCode(v string) *GetEntitlementsInput { + s.ProductCode = &v + return s +} + +// The GetEntitlementsRequest contains results from the GetEntitlements operation. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11/GetEntitlementsResult +type GetEntitlementsOutput struct { + _ struct{} `type:"structure"` + + // The set of entitlements found through the GetEntitlements operation. If the + // result contains an empty set of entitlements, NextToken might still be present + // and should be used. + Entitlements []*Entitlement `type:"list"` + + // For paginated results, use NextToken in subsequent calls to GetEntitlements. + // If the result contains an empty set of entitlements, NextToken might still + // be present and should be used. + NextToken *string `type:"string"` +} + +// String returns the string representation +func (s GetEntitlementsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s GetEntitlementsOutput) GoString() string { + return s.String() +} + +// SetEntitlements sets the Entitlements field's value. +func (s *GetEntitlementsOutput) SetEntitlements(v []*Entitlement) *GetEntitlementsOutput { + s.Entitlements = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *GetEntitlementsOutput) SetNextToken(v string) *GetEntitlementsOutput { + s.NextToken = &v + return s +} + +const ( + // GetEntitlementFilterNameCustomerIdentifier is a GetEntitlementFilterName enum value + GetEntitlementFilterNameCustomerIdentifier = "CUSTOMER_IDENTIFIER" + + // GetEntitlementFilterNameDimension is a GetEntitlementFilterName enum value + GetEntitlementFilterNameDimension = "DIMENSION" +) diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/doc.go b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/doc.go new file mode 100644 index 00000000..1d8b910c --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/doc.go @@ -0,0 +1,91 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package marketplaceentitlementservice provides the client and types for making API +// requests to AWS Marketplace Entitlement Service. +// +// This reference provides descriptions of the AWS Marketplace Entitlement Service +// API. +// +// AWS Marketplace Entitlement Service is used to determine the entitlement +// of a customer to a given product. An entitlement represents capacity in a +// product owned by the customer. For example, a customer might own some number +// of users or seats in an SaaS application or some amount of data capacity +// in a multi-tenant database. +// +// Getting Entitlement Records +// +// * GetEntitlements- Gets the entitlements for a Marketplace product. +// +// See https://docs.aws.amazon.com/goto/WebAPI/entitlement.marketplace-2017-01-11 for more information on this service. +// +// See marketplaceentitlementservice package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/marketplaceentitlementservice/ +// +// Using the Client +// +// To use the client for AWS Marketplace Entitlement 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 := marketplaceentitlementservice.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 Marketplace Entitlement Service client MarketplaceEntitlementService for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/marketplaceentitlementservice/#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.GetEntitlements(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("GetEntitlements 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.GetEntitlementsWithContext(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 marketplaceentitlementservice diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/errors.go b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/errors.go new file mode 100644 index 00000000..2876f45b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/errors.go @@ -0,0 +1,25 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package marketplaceentitlementservice + +const ( + + // ErrCodeInternalServiceErrorException for service response error code + // "InternalServiceErrorException". + // + // An internal error has occurred. Retry your request. If the problem persists, + // post a message with details on the AWS forums. + ErrCodeInternalServiceErrorException = "InternalServiceErrorException" + + // ErrCodeInvalidParameterException for service response error code + // "InvalidParameterException". + // + // One or more parameters in your request was invalid. + ErrCodeInvalidParameterException = "InvalidParameterException" + + // ErrCodeThrottlingException for service response error code + // "ThrottlingException". + // + // The calls to the GetEntitlements API are throttled. + ErrCodeThrottlingException = "ThrottlingException" +) diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/examples_test.go new file mode 100644 index 00000000..101c882e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/examples_test.go @@ -0,0 +1,46 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package marketplaceentitlementservice_test + +import ( + "bytes" + "fmt" + "time" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/session" + "github.com/aws/aws-sdk-go/service/marketplaceentitlementservice" +) + +var _ time.Duration +var _ bytes.Buffer + +func ExampleMarketplaceEntitlementService_GetEntitlements() { + sess := session.Must(session.NewSession()) + + svc := marketplaceentitlementservice.New(sess) + + params := &marketplaceentitlementservice.GetEntitlementsInput{ + ProductCode: aws.String("ProductCode"), // Required + Filter: map[string][]*string{ + "Key": { // Required + aws.String("FilterValue"), // Required + // More values... + }, + // More values... + }, + MaxResults: aws.Int64(1), + NextToken: aws.String("NonEmptyString"), + } + resp, err := svc.GetEntitlements(params) + + if err != nil { + // Print the error, cast err to awserr.Error to get the Code and + // Message from an error. + fmt.Println(err.Error()) + return + } + + // Pretty-print the response data. + fmt.Println(resp) +} diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/marketplaceentitlementserviceiface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/marketplaceentitlementserviceiface/interface.go new file mode 100644 index 00000000..a512b545 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/marketplaceentitlementserviceiface/interface.go @@ -0,0 +1,68 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package marketplaceentitlementserviceiface provides an interface to enable mocking the AWS Marketplace Entitlement Service service client +// for testing your code. +// +// It is important to note that this interface will have breaking changes +// when the service model is updated and adds new API operations, paginators, +// and waiters. +package marketplaceentitlementserviceiface + +import ( + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/service/marketplaceentitlementservice" +) + +// MarketplaceEntitlementServiceAPI provides an interface to enable mocking the +// marketplaceentitlementservice.MarketplaceEntitlementService service client's API operation, +// paginators, and waiters. This make unit testing your code that calls out +// to the SDK's service client's calls easier. +// +// The best way to use this interface is so the SDK's service client's calls +// can be stubbed out for unit testing your code with the SDK without needing +// to inject custom request handlers into the the SDK's request pipeline. +// +// // myFunc uses an SDK service client to make a request to +// // AWS Marketplace Entitlement Service. +// func myFunc(svc marketplaceentitlementserviceiface.MarketplaceEntitlementServiceAPI) bool { +// // Make svc.GetEntitlements request +// } +// +// func main() { +// sess := session.New() +// svc := marketplaceentitlementservice.New(sess) +// +// myFunc(svc) +// } +// +// In your _test.go file: +// +// // Define a mock struct to be used in your unit tests of myFunc. +// type mockMarketplaceEntitlementServiceClient struct { +// marketplaceentitlementserviceiface.MarketplaceEntitlementServiceAPI +// } +// func (m *mockMarketplaceEntitlementServiceClient) GetEntitlements(input *marketplaceentitlementservice.GetEntitlementsInput) (*marketplaceentitlementservice.GetEntitlementsOutput, error) { +// // mock response/functionality +// } +// +// func TestMyFunc(t *testing.T) { +// // Setup Test +// mockSvc := &mockMarketplaceEntitlementServiceClient{} +// +// myfunc(mockSvc) +// +// // Verify myFunc's functionality +// } +// +// It is important to note that this interface will have breaking changes +// when the service model is updated and adds new API operations, paginators, +// and waiters. Its suggested to use the pattern above for testing, or using +// tooling to generate mocks to satisfy the interfaces. +type MarketplaceEntitlementServiceAPI interface { + GetEntitlements(*marketplaceentitlementservice.GetEntitlementsInput) (*marketplaceentitlementservice.GetEntitlementsOutput, error) + GetEntitlementsWithContext(aws.Context, *marketplaceentitlementservice.GetEntitlementsInput, ...request.Option) (*marketplaceentitlementservice.GetEntitlementsOutput, error) + GetEntitlementsRequest(*marketplaceentitlementservice.GetEntitlementsInput) (*request.Request, *marketplaceentitlementservice.GetEntitlementsOutput) +} + +var _ MarketplaceEntitlementServiceAPI = (*marketplaceentitlementservice.MarketplaceEntitlementService)(nil) diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/service.go b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/service.go new file mode 100644 index 00000000..b623b96b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplaceentitlementservice/service.go @@ -0,0 +1,98 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +package marketplaceentitlementservice + +import ( + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/aws/client" + "github.com/aws/aws-sdk-go/aws/client/metadata" + "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/aws/signer/v4" + "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" +) + +// MarketplaceEntitlementService provides the API operation methods for making requests to +// AWS Marketplace Entitlement Service. See this package's package overview docs +// for details on the service. +// +// MarketplaceEntitlementService methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. +type MarketplaceEntitlementService struct { + *client.Client +} + +// Used for custom client initialization logic +var initClient func(*client.Client) + +// Used for custom request initialization logic +var initRequest func(*request.Request) + +// Service information constants +const ( + ServiceName = "entitlement.marketplace" // Service endpoint prefix API calls made to. + EndpointsID = ServiceName // Service ID for Regions and Endpoints metadata. +) + +// New creates a new instance of the MarketplaceEntitlementService client with a session. +// If additional configuration is needed for the client instance use the optional +// aws.Config parameter to add your extra config. +// +// Example: +// // Create a MarketplaceEntitlementService client from just a session. +// svc := marketplaceentitlementservice.New(mySession) +// +// // Create a MarketplaceEntitlementService client with additional configuration +// svc := marketplaceentitlementservice.New(mySession, aws.NewConfig().WithRegion("us-west-2")) +func New(p client.ConfigProvider, cfgs ...*aws.Config) *MarketplaceEntitlementService { + c := p.ClientConfig(EndpointsID, cfgs...) + return newClient(*c.Config, c.Handlers, c.Endpoint, c.SigningRegion, c.SigningName) +} + +// newClient creates, initializes and returns a new service client instance. +func newClient(cfg aws.Config, handlers request.Handlers, endpoint, signingRegion, signingName string) *MarketplaceEntitlementService { + if len(signingName) == 0 { + signingName = "aws-marketplace" + } + svc := &MarketplaceEntitlementService{ + Client: client.New( + cfg, + metadata.ClientInfo{ + ServiceName: ServiceName, + SigningName: signingName, + SigningRegion: signingRegion, + Endpoint: endpoint, + APIVersion: "2017-01-11", + JSONVersion: "1.1", + TargetPrefix: "AWSMPEntitlementService", + }, + handlers, + ), + } + + // Handlers + svc.Handlers.Sign.PushBackNamed(v4.SignRequestHandler) + svc.Handlers.Build.PushBackNamed(jsonrpc.BuildHandler) + svc.Handlers.Unmarshal.PushBackNamed(jsonrpc.UnmarshalHandler) + svc.Handlers.UnmarshalMeta.PushBackNamed(jsonrpc.UnmarshalMetaHandler) + svc.Handlers.UnmarshalError.PushBackNamed(jsonrpc.UnmarshalErrorHandler) + + // Run custom client initialization if present + if initClient != nil { + initClient(svc.Client) + } + + return svc +} + +// newRequest creates a new request for a MarketplaceEntitlementService operation and runs any +// custom request initialization. +func (c *MarketplaceEntitlementService) newRequest(op *request.Operation, params, data interface{}) *request.Request { + req := c.NewRequest(op, params, data) + + // Run custom request initialization if present + if initRequest != nil { + initRequest(req) + } + + return req +} diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/api.go b/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/api.go index 71b048e1..888f3e27 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package marketplacemetering provides a client for AWSMarketplace Metering. package marketplacemetering import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/doc.go b/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/doc.go new file mode 100644 index 00000000..fd0535c4 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/doc.go @@ -0,0 +1,100 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package marketplacemetering provides the client and types for making API +// requests to AWSMarketplace Metering. +// +// This reference provides descriptions of the low-level AWS Marketplace Metering +// Service API. +// +// AWS Marketplace sellers can use this API to submit usage data for custom +// usage dimensions. +// +// Submitting Metering Records +// +// * MeterUsage- Submits the metering record for a Marketplace product. MeterUsage +// is called from an EC2 instance. +// +// * BatchMeterUsage- Submits the metering record for a set of customers. +// BatchMeterUsage is called from a software-as-a-service (SaaS) application. +// +// Accepting New Customers +// +// * ResolveCustomer- Called by a SaaS application during the registration +// process. When a buyer visits your website during the registration process, +// the buyer submits a Registration Token through the browser. The Registration +// Token is resolved through this API to obtain a CustomerIdentifier and +// Product Code. +// +// See https://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14 for more information on this service. +// +// See marketplacemetering package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/marketplacemetering/ +// +// Using the Client +// +// To use the client for AWSMarketplace Metering 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 := marketplacemetering.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 AWSMarketplace Metering client MarketplaceMetering for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/marketplacemetering/#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.BatchMeterUsage(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("BatchMeterUsage 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.BatchMeterUsageWithContext(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 marketplacemetering diff --git a/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/service.go b/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/service.go index 606600ee..1f42af61 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/marketplacemetering/service.go @@ -11,30 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This reference provides descriptions of the low-level AWS Marketplace Metering -// Service API. +// MarketplaceMetering provides the API operation methods for making requests to +// AWSMarketplace Metering. See this package's package overview docs +// for details on the service. // -// AWS Marketplace sellers can use this API to submit usage data for custom -// usage dimensions. -// -// Submitting Metering Records -// -// * MeterUsage- Submits the metering record for a Marketplace product. MeterUsage -// is called from an EC2 instance. -// -// * BatchMeterUsage- Submits the metering record for a set of customers. -// BatchMeterUsage is called from a software-as-a-service (SaaS) application. -// -// Accepting New Customers -// -// * ResolveCustomer- Called by a SaaS application during the registration -// process. When a buyer visits your website during the registration process, -// the buyer submits a Registration Token through the browser. The Registration -// Token is resolved through this API to obtain a CustomerIdentifier and -// Product Code. -// 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/meteringmarketplace-2016-01-14 +// MarketplaceMetering methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type MarketplaceMetering struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/api.go b/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/api.go index 56c8d990..49136d6d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package mobileanalytics provides a client for Amazon Mobile Analytics. package mobileanalytics import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/doc.go b/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/doc.go new file mode 100644 index 00000000..c242ac2b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/doc.go @@ -0,0 +1,79 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package mobileanalytics provides the client and types for making API +// requests to Amazon Mobile Analytics. +// +// Amazon Mobile Analytics is a service for collecting, visualizing, and understanding +// app usage data at scale. +// +// See mobileanalytics package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/mobileanalytics/ +// +// Using the Client +// +// To use the client for Amazon Mobile Analytics 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 := mobileanalytics.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 Mobile Analytics client MobileAnalytics for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/mobileanalytics/#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.PutEvents(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("PutEvents 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.PutEventsWithContext(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 mobileanalytics diff --git a/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/service.go b/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/service.go index 3df9e736..bfdcea03 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/mobileanalytics/service.go @@ -11,10 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Amazon Mobile Analytics is a service for collecting, visualizing, and understanding -// app usage data at scale. -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// MobileAnalytics provides the API operation methods for making requests to +// Amazon Mobile Analytics. See this package's package overview docs +// for details on the service. +// +// MobileAnalytics methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type MobileAnalytics struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/mturk/api.go b/vendor/github.com/aws/aws-sdk-go/service/mturk/api.go index c84a08bd..9223ecb3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/mturk/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/mturk/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package mturk provides a client for Amazon Mechanical Turk. package mturk import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/mturk/doc.go b/vendor/github.com/aws/aws-sdk-go/service/mturk/doc.go new file mode 100644 index 00000000..dd98d587 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/mturk/doc.go @@ -0,0 +1,80 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package mturk provides the client and types for making API +// requests to Amazon Mechanical Turk. +// +// Amazon Mechanical Turk API Reference +// +// See https://docs.aws.amazon.com/goto/WebAPI/mturk-requester-2017-01-17 for more information on this service. +// +// See mturk package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/mturk/ +// +// Using the Client +// +// To use the client for Amazon Mechanical Turk 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 := mturk.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 Mechanical Turk client MTurk for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/mturk/#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.AcceptQualificationRequest(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("AcceptQualificationRequest 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.AcceptQualificationRequestWithContext(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 mturk diff --git a/vendor/github.com/aws/aws-sdk-go/service/mturk/service.go b/vendor/github.com/aws/aws-sdk-go/service/mturk/service.go index 6fea7ee8..6823e2fb 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/mturk/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/mturk/service.go @@ -11,9 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// 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/mturk-requester-2017-01-17 +// MTurk provides the API operation methods for making requests to +// Amazon Mechanical Turk. See this package's package overview docs +// for details on the service. +// +// MTurk methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type MTurk struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/opsworks/api.go b/vendor/github.com/aws/aws-sdk-go/service/opsworks/api.go index e415f79e..3f725f6b 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/opsworks/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/opsworks/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package opsworks provides a client for AWS OpsWorks. package opsworks import ( @@ -15768,6 +15767,7 @@ type UpdateLayerInput struct { // LayerId is a required field LayerId *string `type:"string" required:"true"` + // Specifies the lifecycle event configuration LifecycleEventConfiguration *LifecycleEventConfiguration `type:"structure"` // The layer name, which is used by the console. diff --git a/vendor/github.com/aws/aws-sdk-go/service/opsworks/doc.go b/vendor/github.com/aws/aws-sdk-go/service/opsworks/doc.go new file mode 100644 index 00000000..91746b4f --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/opsworks/doc.go @@ -0,0 +1,149 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package opsworks provides the client and types for making API +// requests to AWS OpsWorks. +// +// Welcome to the AWS OpsWorks Stacks API Reference. This guide provides descriptions, +// syntax, and usage examples for AWS OpsWorks Stacks actions and data types, +// including common parameters and error codes. +// +// AWS OpsWorks Stacks is an application management service that provides an +// integrated experience for overseeing the complete application lifecycle. +// For information about this product, go to the AWS OpsWorks (http://aws.amazon.com/opsworks/) +// details page. +// +// SDKs and CLI +// +// The most common way to use the AWS OpsWorks Stacks API is by using the AWS +// Command Line Interface (CLI) or by using one of the AWS SDKs to implement +// applications in your preferred language. For more information, see: +// +// * AWS CLI (http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) +// +// * AWS SDK for Java (http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/opsworks/AWSOpsWorksClient.html) +// +// * AWS SDK for .NET (http://docs.aws.amazon.com/sdkfornet/latest/apidocs/html/N_Amazon_OpsWorks.htm) +// +// * AWS SDK for PHP 2 (http://docs.aws.amazon.com/aws-sdk-php-2/latest/class-Aws.OpsWorks.OpsWorksClient.html) +// +// * AWS SDK for Ruby (http://docs.aws.amazon.com/sdkforruby/api/) +// +// * AWS SDK for Node.js (http://aws.amazon.com/documentation/sdkforjavascript/) +// +// * AWS SDK for Python(Boto) (http://docs.pythonboto.org/en/latest/ref/opsworks.html) +// +// Endpoints +// +// AWS OpsWorks Stacks supports the following endpoints, all HTTPS. You must +// connect to one of the following endpoints. Stacks can only be accessed or +// managed within the endpoint in which they are created. +// +// * opsworks.us-east-1.amazonaws.com +// +// * opsworks.us-east-2.amazonaws.com +// +// * opsworks.us-west-1.amazonaws.com +// +// * opsworks.us-west-2.amazonaws.com +// +// * opsworks.eu-west-1.amazonaws.com +// +// * opsworks.eu-west-2.amazonaws.com +// +// * opsworks.eu-central-1.amazonaws.com +// +// * opsworks.ap-northeast-1.amazonaws.com +// +// * opsworks.ap-northeast-2.amazonaws.com +// +// * opsworks.ap-south-1.amazonaws.com +// +// * opsworks.ap-southeast-1.amazonaws.com +// +// * opsworks.ap-southeast-2.amazonaws.com +// +// * opsworks.sa-east-1.amazonaws.com +// +// Chef Versions +// +// When you call CreateStack, CloneStack, or UpdateStack we recommend you use +// the ConfigurationManager parameter to specify the Chef version. The recommended +// and default value for Linux stacks is currently 12. Windows stacks use Chef +// 12.2. For more information, see Chef Versions (http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html). +// +// You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend +// migrating your existing Linux stacks to Chef 12 as soon as possible. +// +// See https://docs.aws.amazon.com/goto/WebAPI/opsworks-2013-02-18 for more information on this service. +// +// See opsworks package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/opsworks/ +// +// Using the Client +// +// To use the client for AWS OpsWorks 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 := opsworks.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 OpsWorks client OpsWorks for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/opsworks/#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.AssignInstance(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("AssignInstance 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.AssignInstanceWithContext(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 opsworks diff --git a/vendor/github.com/aws/aws-sdk-go/service/opsworks/service.go b/vendor/github.com/aws/aws-sdk-go/service/opsworks/service.go index 440f0f72..3e94bb43 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/opsworks/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/opsworks/service.go @@ -11,79 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Welcome to the AWS OpsWorks Stacks API Reference. This guide provides descriptions, -// syntax, and usage examples for AWS OpsWorks Stacks actions and data types, -// including common parameters and error codes. +// OpsWorks provides the API operation methods for making requests to +// AWS OpsWorks. See this package's package overview docs +// for details on the service. // -// AWS OpsWorks Stacks is an application management service that provides an -// integrated experience for overseeing the complete application lifecycle. -// For information about this product, go to the AWS OpsWorks (http://aws.amazon.com/opsworks/) -// details page. -// -// SDKs and CLI -// -// The most common way to use the AWS OpsWorks Stacks API is by using the AWS -// Command Line Interface (CLI) or by using one of the AWS SDKs to implement -// applications in your preferred language. For more information, see: -// -// * AWS CLI (http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) -// -// * AWS SDK for Java (http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/opsworks/AWSOpsWorksClient.html) -// -// * AWS SDK for .NET (http://docs.aws.amazon.com/sdkfornet/latest/apidocs/html/N_Amazon_OpsWorks.htm) -// -// * AWS SDK for PHP 2 (http://docs.aws.amazon.com/aws-sdk-php-2/latest/class-Aws.OpsWorks.OpsWorksClient.html) -// -// * AWS SDK for Ruby (http://docs.aws.amazon.com/sdkforruby/api/) -// -// * AWS SDK for Node.js (http://aws.amazon.com/documentation/sdkforjavascript/) -// -// * AWS SDK for Python(Boto) (http://docs.pythonboto.org/en/latest/ref/opsworks.html) -// -// Endpoints -// -// AWS OpsWorks Stacks supports the following endpoints, all HTTPS. You must -// connect to one of the following endpoints. Stacks can only be accessed or -// managed within the endpoint in which they are created. -// -// * opsworks.us-east-1.amazonaws.com -// -// * opsworks.us-east-2.amazonaws.com -// -// * opsworks.us-west-1.amazonaws.com -// -// * opsworks.us-west-2.amazonaws.com -// -// * opsworks.eu-west-1.amazonaws.com -// -// * opsworks.eu-west-2.amazonaws.com -// -// * opsworks.eu-central-1.amazonaws.com -// -// * opsworks.ap-northeast-1.amazonaws.com -// -// * opsworks.ap-northeast-2.amazonaws.com -// -// * opsworks.ap-south-1.amazonaws.com -// -// * opsworks.ap-southeast-1.amazonaws.com -// -// * opsworks.ap-southeast-2.amazonaws.com -// -// * opsworks.sa-east-1.amazonaws.com -// -// Chef Versions -// -// When you call CreateStack, CloneStack, or UpdateStack we recommend you use -// the ConfigurationManager parameter to specify the Chef version. The recommended -// and default value for Linux stacks is currently 12. Windows stacks use Chef -// 12.2. For more information, see Chef Versions (http://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html). -// -// You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend -// migrating your existing Linux stacks to Chef 12 as soon as possible. -// 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/opsworks-2013-02-18 +// OpsWorks methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OpsWorks struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/api.go b/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/api.go index fe4ab162..06fd48c3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package opsworkscm provides a client for AWS OpsWorks for Chef Automate. package opsworkscm import ( @@ -2651,7 +2650,6 @@ type DescribeNodeAssociationStatusOutput struct { // * FAILED: The association or disassociation failed. // // * IN_PROGRESS: The association or disassociation is still in progress. - // NodeAssociationStatus *string `type:"string" enum:"NodeAssociationStatus"` } @@ -3608,7 +3606,6 @@ const ( // * FAILED: The association or disassociation failed. // // * IN_PROGRESS: The association or disassociation is still in progress. -// const ( // NodeAssociationStatusSuccess is a NodeAssociationStatus enum value NodeAssociationStatusSuccess = "SUCCESS" diff --git a/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/doc.go b/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/doc.go new file mode 100644 index 00000000..ea573bd6 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/doc.go @@ -0,0 +1,127 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package opsworkscm provides the client and types for making API +// requests to AWS OpsWorks for Chef Automate. +// +// AWS OpsWorks for Chef Automate is a service that runs and manages configuration +// management servers. +// +// Glossary of terms +// +// * Server: A configuration management server that can be highly-available. +// The configuration manager runs on your instances by using various AWS +// services, such as Amazon Elastic Compute Cloud (EC2), and potentially +// Amazon Relational Database Service (RDS). A server is a generic abstraction +// over the configuration manager that you want to use, much like Amazon +// RDS. In AWS OpsWorks for Chef Automate, you do not start or stop servers. +// After you create servers, they continue to run until they are deleted. +// +// * Engine: The specific configuration manager that you want to use (such +// as Chef) is the engine. +// +// * Backup: This is an application-level backup of the data that the configuration +// manager stores. A backup creates a .tar.gz file that is stored in an Amazon +// Simple Storage Service (S3) bucket in your account. AWS OpsWorks for Chef +// Automate creates the S3 bucket when you launch the first instance. A backup +// maintains a snapshot of all of a server's important attributes at the +// time of the backup. +// +// * Events: Events are always related to a server. Events are written during +// server creation, when health checks run, when backups are created, etc. +// When you delete a server, the server's events are also deleted. +// +// * AccountAttributes: Every account has attributes that are assigned in +// the AWS OpsWorks for Chef Automate database. These attributes store information +// about configuration limits (servers, backups, etc.) and your customer +// account. +// +// Endpoints +// +// AWS OpsWorks for Chef Automate supports the following endpoints, all HTTPS. +// You must connect to one of the following endpoints. Chef servers can only +// be accessed or managed within the endpoint in which they are created. +// +// * opsworks-cm.us-east-1.amazonaws.com +// +// * opsworks-cm.us-west-2.amazonaws.com +// +// * opsworks-cm.eu-west-1.amazonaws.com +// +// Throttling limits +// +// All API operations allow for five requests per second with a burst of 10 +// requests per second. +// +// See https://docs.aws.amazon.com/goto/WebAPI/opsworkscm-2016-11-01 for more information on this service. +// +// See opsworkscm package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/opsworkscm/ +// +// Using the Client +// +// To use the client for AWS OpsWorks for Chef Automate 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 := opsworkscm.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 OpsWorks for Chef Automate client OpsWorksCM for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/opsworkscm/#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.AssociateNode(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("AssociateNode 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.AssociateNodeWithContext(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 opsworkscm diff --git a/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/service.go b/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/service.go index 9df903a2..f73c5a7a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/opsworkscm/service.go @@ -11,57 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS OpsWorks for Chef Automate is a service that runs and manages configuration -// management servers. +// OpsWorksCM provides the API operation methods for making requests to +// AWS OpsWorks for Chef Automate. See this package's package overview docs +// for details on the service. // -// Glossary of terms -// -// * Server: A configuration management server that can be highly-available. -// The configuration manager runs on your instances by using various AWS -// services, such as Amazon Elastic Compute Cloud (EC2), and potentially -// Amazon Relational Database Service (RDS). A server is a generic abstraction -// over the configuration manager that you want to use, much like Amazon -// RDS. In AWS OpsWorks for Chef Automate, you do not start or stop servers. -// After you create servers, they continue to run until they are deleted. -// -// * Engine: The specific configuration manager that you want to use (such -// as Chef) is the engine. -// -// * Backup: This is an application-level backup of the data that the configuration -// manager stores. A backup creates a .tar.gz file that is stored in an Amazon -// Simple Storage Service (S3) bucket in your account. AWS OpsWorks for Chef -// Automate creates the S3 bucket when you launch the first instance. A backup -// maintains a snapshot of all of a server's important attributes at the -// time of the backup. -// -// * Events: Events are always related to a server. Events are written during -// server creation, when health checks run, when backups are created, etc. -// When you delete a server, the server's events are also deleted. -// -// * AccountAttributes: Every account has attributes that are assigned in -// the AWS OpsWorks for Chef Automate database. These attributes store information -// about configuration limits (servers, backups, etc.) and your customer -// account. -// -// Endpoints -// -// AWS OpsWorks for Chef Automate supports the following endpoints, all HTTPS. -// You must connect to one of the following endpoints. Chef servers can only -// be accessed or managed within the endpoint in which they are created. -// -// * opsworks-cm.us-east-1.amazonaws.com -// -// * opsworks-cm.us-west-2.amazonaws.com -// -// * opsworks-cm.eu-west-1.amazonaws.com -// -// Throttling limits -// -// All API operations allow for five requests per second with a burst of 10 -// requests per second. -// 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/opsworkscm-2016-11-01 +// OpsWorksCM methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type OpsWorksCM struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/organizations/api.go b/vendor/github.com/aws/aws-sdk-go/service/organizations/api.go index a9a3ce37..b732cc76 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/organizations/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/organizations/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package organizations provides a client for AWS Organizations. package organizations import ( @@ -100,6 +99,37 @@ func (c *Organizations) AcceptHandshakeRequest(input *AcceptHandshakeInput) (req // The requested operation would violate the constraint identified in the reason // code. // +// * ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on +// the number of accounts in an organization. Note: deleted and closed accounts +// still count toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * ALREADY_IN_AN_ORGANIZATION: The handshake request is invalid because +// the invited account is already a member of an organization. +// +// * ORGANIZATION_ALREADY_HAS_ALL_FEATURES: The handshake request is invalid +// because the organization has already enabled all features. +// +// * INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES: You cannot issue new invitations +// to join an organization while it is in the process of enabling all features. +// You can resume inviting accounts after you finalize the process when all +// accounts have agreed to the change. +// +// * PAYMENT_INSTRUMENT_REQUIRED: You cannot complete the operation with +// an account that does not have a payment instrument, such as a credit card, +// associated with it. +// +// * ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD: The request failed because +// the account is from a different marketplace than the accounts in the organization. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be from the same +// marketplace. +// +// * ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED: You attempted to +// change the membership of an account too quickly after its previous change. +// // * ErrCodeHandshakeNotFoundException "HandshakeNotFoundException" // We can't find a handshake with the HandshakeId that you specified. // @@ -113,7 +143,54 @@ func (c *Organizations) AcceptHandshakeRequest(input *AcceptHandshakeInput) (req // can't accept a handshake that was already accepted. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeConcurrentModificationException "ConcurrentModificationException" // The target of the operation is currently being modified by a different request. @@ -263,13 +340,106 @@ func (c *Organizations) AttachPolicyRequest(input *AttachPolicyInput) (req *requ // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeDuplicatePolicyAttachmentException "DuplicatePolicyAttachmentException" // The selected policy is already attached to the specified target. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodePolicyNotFoundException "PolicyNotFoundException" // We can't find a policy with the PolicyId that you specified. @@ -394,7 +564,54 @@ func (c *Organizations) CancelHandshakeRequest(input *CancelHandshakeInput) (req // can't accept a handshake that was already accepted. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -491,13 +708,13 @@ func (c *Organizations) CreateAccountRequest(input *CreateAccountInput) (req *re // That also means that you cannot delete an organization that contains an account // that is created with this operation. // -// When you create a member account with this operation, the account is created -// with the IAM User and Role Access to Billing Information switch enabled. -// This allows IAM users and roles that are granted appropriate permissions -// to view billing information. If this is disabled, then only the account root -// user can access billing information. For information about how to disable -// this for an account, see Granting Access to Your Billing Information and -// Tools (http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html). +// When you create a member account with this operation, you can choose whether +// to create the account with the IAM User and Role Access to Billing Information +// switch enabled. If you enable it, IAM users and roles that have appropriate +// permissions can view billing information for the account. If you disable +// this, then only the account root user can access billing information. For +// information about how to disable this for an account, see Granting Access +// to Your Billing Information and Tools (http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html). // // This operation can be called only from the organization's master account. // @@ -524,10 +741,103 @@ func (c *Organizations) CreateAccountRequest(input *CreateAccountInput) (req *re // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeFinalizingOrganizationException "FinalizingOrganizationException" // AWS Organizations could not finalize the creation of your organization. Try @@ -650,10 +960,103 @@ func (c *Organizations) CreateOrganizationRequest(input *CreateOrganizationInput // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -764,13 +1167,106 @@ func (c *Organizations) CreateOrganizationalUnitRequest(input *CreateOrganizatio // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeDuplicateOrganizationalUnitException "DuplicateOrganizationalUnitException" // An organizational unit (OU) with the same name already exists. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeParentNotFoundException "ParentNotFoundException" // We can't find a root or organizational unit (OU) with the ParentId that you @@ -886,13 +1382,106 @@ func (c *Organizations) CreatePolicyRequest(input *CreatePolicyInput) (req *requ // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeDuplicatePolicyException "DuplicatePolicyException" // A policy with the same name already exists. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeMalformedPolicyDocumentException "MalformedPolicyDocumentException" // The provided policy document does not meet the requirements of the specified @@ -1018,7 +1607,54 @@ func (c *Organizations) DeclineHandshakeRequest(input *DeclineHandshakeInput) (r // can't accept a handshake that was already accepted. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -1129,7 +1765,54 @@ func (c *Organizations) DeleteOrganizationRequest(input *DeleteOrganizationInput // Try again later. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeOrganizationNotEmptyException "OrganizationNotEmptyException" // The organization isn't empty. To delete an organization, you must first remove @@ -1242,7 +1925,54 @@ func (c *Organizations) DeleteOrganizationalUnitRequest(input *DeleteOrganizatio // Try again later. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeOrganizationalUnitNotEmptyException "OrganizationalUnitNotEmptyException" // The specified organizational unit (OU) is not empty. Move all accounts to @@ -1359,7 +2089,54 @@ func (c *Organizations) DeletePolicyRequest(input *DeletePolicyInput) (req *requ // Try again later. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodePolicyInUseException "PolicyInUseException" // The policy is attached to one or more entities. You must detach it from all @@ -1472,7 +2249,54 @@ func (c *Organizations) DescribeAccountRequest(input *DescribeAccountInput) (req // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -1577,7 +2401,54 @@ func (c *Organizations) DescribeCreateAccountStatusRequest(input *DescribeCreate // you specified. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -1679,7 +2550,54 @@ func (c *Organizations) DescribeHandshakeRequest(input *DescribeHandshakeInput) // We can't find a handshake with the HandshakeId that you specified. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -1879,7 +2797,54 @@ func (c *Organizations) DescribeOrganizationalUnitRequest(input *DescribeOrganiz // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeOrganizationalUnitNotFoundException "OrganizationalUnitNotFoundException" // We can't find an organizational unit (OU) with the OrganizationalUnitId that @@ -1984,7 +2949,54 @@ func (c *Organizations) DescribePolicyRequest(input *DescribePolicyInput) (req * // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodePolicyNotFoundException "PolicyNotFoundException" // We can't find a policy with the PolicyId that you specified. @@ -2109,10 +3121,103 @@ func (c *Organizations) DetachPolicyRequest(input *DetachPolicyInput) (req *requ // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodePolicyNotAttachedException "PolicyNotAttachedException" // The policy isn't attached to the specified target in the specified root. @@ -2233,10 +3338,103 @@ func (c *Organizations) DisablePolicyTypeRequest(input *DisablePolicyTypeInput) // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodePolicyTypeNotEnabledException "PolicyTypeNotEnabledException" // The specified policy type is not currently enabled in this root. You cannot @@ -2374,8 +3572,86 @@ func (c *Organizations) EnableAllFeaturesRequest(input *EnableAllFeaturesInput) // The requested operation would violate the constraint identified in the reason // code. // +// * ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on +// the number of accounts in an organization. Note: deleted and closed accounts +// still count toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * ALREADY_IN_AN_ORGANIZATION: The handshake request is invalid because +// the invited account is already a member of an organization. +// +// * ORGANIZATION_ALREADY_HAS_ALL_FEATURES: The handshake request is invalid +// because the organization has already enabled all features. +// +// * INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES: You cannot issue new invitations +// to join an organization while it is in the process of enabling all features. +// You can resume inviting accounts after you finalize the process when all +// accounts have agreed to the change. +// +// * PAYMENT_INSTRUMENT_REQUIRED: You cannot complete the operation with +// an account that does not have a payment instrument, such as a credit card, +// associated with it. +// +// * ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD: The request failed because +// the account is from a different marketplace than the accounts in the organization. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be from the same +// marketplace. +// +// * ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED: You attempted to +// change the membership of an account too quickly after its previous change. +// // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -2485,10 +3761,103 @@ func (c *Organizations) EnablePolicyTypeRequest(input *EnablePolicyTypeInput) (r // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodePolicyTypeAlreadyEnabledException "PolicyTypeAlreadyEnabledException" // The specified policy type is already enabled in the specified root. @@ -2608,6 +3977,37 @@ func (c *Organizations) InviteAccountToOrganizationRequest(input *InviteAccountT // The requested operation would violate the constraint identified in the reason // code. // +// * ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on +// the number of accounts in an organization. Note: deleted and closed accounts +// still count toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * ALREADY_IN_AN_ORGANIZATION: The handshake request is invalid because +// the invited account is already a member of an organization. +// +// * ORGANIZATION_ALREADY_HAS_ALL_FEATURES: The handshake request is invalid +// because the organization has already enabled all features. +// +// * INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES: You cannot issue new invitations +// to join an organization while it is in the process of enabling all features. +// You can resume inviting accounts after you finalize the process when all +// accounts have agreed to the change. +// +// * PAYMENT_INSTRUMENT_REQUIRED: You cannot complete the operation with +// an account that does not have a payment instrument, such as a credit card, +// associated with it. +// +// * ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD: The request failed because +// the account is from a different marketplace than the accounts in the organization. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be from the same +// marketplace. +// +// * ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED: You attempted to +// change the membership of an account too quickly after its previous change. +// // * ErrCodeDuplicateHandshakeException "DuplicateHandshakeException" // A handshake with the same action and target already exists. For example, // if you invited an account to join your organization, the invited account @@ -2616,7 +4016,54 @@ func (c *Organizations) InviteAccountToOrganizationRequest(input *InviteAccountT // might be considered duplicates are canceled or declined. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeFinalizingOrganizationException "FinalizingOrganizationException" // AWS Organizations could not finalize the creation of your organization. Try @@ -2743,10 +4190,103 @@ func (c *Organizations) LeaveOrganizationRequest(input *LeaveOrganizationInput) // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeMasterCannotLeaveOrganizationException "MasterCannotLeaveOrganizationException" // You can't remove a master account from an organization. If you want the master @@ -2815,6 +4355,12 @@ func (c *Organizations) ListAccountsRequest(input *ListAccountsInput) (req *requ Name: opListAccounts, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -2853,7 +4399,54 @@ func (c *Organizations) ListAccountsRequest(input *ListAccountsInput) (req *requ // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -2885,6 +4478,56 @@ func (c *Organizations) ListAccountsWithContext(ctx aws.Context, input *ListAcco return out, req.Send() } +// ListAccountsPages iterates over the pages of a ListAccounts operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListAccounts method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListAccounts operation. +// pageNum := 0 +// err := client.ListAccountsPages(params, +// func(page *ListAccountsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListAccountsPages(input *ListAccountsInput, fn func(*ListAccountsOutput, bool) bool) error { + return c.ListAccountsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListAccountsPagesWithContext same as ListAccountsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListAccountsPagesWithContext(ctx aws.Context, input *ListAccountsInput, fn func(*ListAccountsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListAccountsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListAccountsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListAccountsOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListAccountsForParent = "ListAccountsForParent" // ListAccountsForParentRequest generates a "aws/request.Request" representing the @@ -2917,6 +4560,12 @@ func (c *Organizations) ListAccountsForParentRequest(input *ListAccountsForParen Name: opListAccountsForParent, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -2957,7 +4606,54 @@ func (c *Organizations) ListAccountsForParentRequest(input *ListAccountsForParen // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeParentNotFoundException "ParentNotFoundException" // We can't find a root or organizational unit (OU) with the ParentId that you @@ -2993,6 +4689,56 @@ func (c *Organizations) ListAccountsForParentWithContext(ctx aws.Context, input return out, req.Send() } +// ListAccountsForParentPages iterates over the pages of a ListAccountsForParent operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListAccountsForParent method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListAccountsForParent operation. +// pageNum := 0 +// err := client.ListAccountsForParentPages(params, +// func(page *ListAccountsForParentOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListAccountsForParentPages(input *ListAccountsForParentInput, fn func(*ListAccountsForParentOutput, bool) bool) error { + return c.ListAccountsForParentPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListAccountsForParentPagesWithContext same as ListAccountsForParentPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListAccountsForParentPagesWithContext(ctx aws.Context, input *ListAccountsForParentInput, fn func(*ListAccountsForParentOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListAccountsForParentInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListAccountsForParentRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListAccountsForParentOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListChildren = "ListChildren" // ListChildrenRequest generates a "aws/request.Request" representing the @@ -3025,6 +4771,12 @@ func (c *Organizations) ListChildrenRequest(input *ListChildrenInput) (req *requ Name: opListChildren, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3062,7 +4814,54 @@ func (c *Organizations) ListChildrenRequest(input *ListChildrenInput) (req *requ // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeParentNotFoundException "ParentNotFoundException" // We can't find a root or organizational unit (OU) with the ParentId that you @@ -3098,6 +4897,56 @@ func (c *Organizations) ListChildrenWithContext(ctx aws.Context, input *ListChil return out, req.Send() } +// ListChildrenPages iterates over the pages of a ListChildren operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListChildren method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListChildren operation. +// pageNum := 0 +// err := client.ListChildrenPages(params, +// func(page *ListChildrenOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListChildrenPages(input *ListChildrenInput, fn func(*ListChildrenOutput, bool) bool) error { + return c.ListChildrenPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListChildrenPagesWithContext same as ListChildrenPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListChildrenPagesWithContext(ctx aws.Context, input *ListChildrenInput, fn func(*ListChildrenOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListChildrenInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListChildrenRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListChildrenOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListCreateAccountStatus = "ListCreateAccountStatus" // ListCreateAccountStatusRequest generates a "aws/request.Request" representing the @@ -3130,6 +4979,12 @@ func (c *Organizations) ListCreateAccountStatusRequest(input *ListCreateAccountS Name: opListCreateAccountStatus, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3168,7 +5023,54 @@ func (c *Organizations) ListCreateAccountStatusRequest(input *ListCreateAccountS // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -3200,6 +5102,56 @@ func (c *Organizations) ListCreateAccountStatusWithContext(ctx aws.Context, inpu return out, req.Send() } +// ListCreateAccountStatusPages iterates over the pages of a ListCreateAccountStatus operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListCreateAccountStatus method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListCreateAccountStatus operation. +// pageNum := 0 +// err := client.ListCreateAccountStatusPages(params, +// func(page *ListCreateAccountStatusOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListCreateAccountStatusPages(input *ListCreateAccountStatusInput, fn func(*ListCreateAccountStatusOutput, bool) bool) error { + return c.ListCreateAccountStatusPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListCreateAccountStatusPagesWithContext same as ListCreateAccountStatusPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListCreateAccountStatusPagesWithContext(ctx aws.Context, input *ListCreateAccountStatusInput, fn func(*ListCreateAccountStatusOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListCreateAccountStatusInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListCreateAccountStatusRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListCreateAccountStatusOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListHandshakesForAccount = "ListHandshakesForAccount" // ListHandshakesForAccountRequest generates a "aws/request.Request" representing the @@ -3232,6 +5184,12 @@ func (c *Organizations) ListHandshakesForAccountRequest(input *ListHandshakesFor Name: opListHandshakesForAccount, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3266,7 +5224,54 @@ func (c *Organizations) ListHandshakesForAccountRequest(input *ListHandshakesFor // in the IAM User Guide. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -3298,6 +5303,56 @@ func (c *Organizations) ListHandshakesForAccountWithContext(ctx aws.Context, inp return out, req.Send() } +// ListHandshakesForAccountPages iterates over the pages of a ListHandshakesForAccount operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListHandshakesForAccount method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListHandshakesForAccount operation. +// pageNum := 0 +// err := client.ListHandshakesForAccountPages(params, +// func(page *ListHandshakesForAccountOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListHandshakesForAccountPages(input *ListHandshakesForAccountInput, fn func(*ListHandshakesForAccountOutput, bool) bool) error { + return c.ListHandshakesForAccountPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListHandshakesForAccountPagesWithContext same as ListHandshakesForAccountPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListHandshakesForAccountPagesWithContext(ctx aws.Context, input *ListHandshakesForAccountInput, fn func(*ListHandshakesForAccountOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListHandshakesForAccountInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListHandshakesForAccountRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListHandshakesForAccountOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListHandshakesForOrganization = "ListHandshakesForOrganization" // ListHandshakesForOrganizationRequest generates a "aws/request.Request" representing the @@ -3330,6 +5385,12 @@ func (c *Organizations) ListHandshakesForOrganizationRequest(input *ListHandshak Name: opListHandshakesForOrganization, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3370,7 +5431,54 @@ func (c *Organizations) ListHandshakesForOrganizationRequest(input *ListHandshak // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -3402,6 +5510,56 @@ func (c *Organizations) ListHandshakesForOrganizationWithContext(ctx aws.Context return out, req.Send() } +// ListHandshakesForOrganizationPages iterates over the pages of a ListHandshakesForOrganization operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListHandshakesForOrganization method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListHandshakesForOrganization operation. +// pageNum := 0 +// err := client.ListHandshakesForOrganizationPages(params, +// func(page *ListHandshakesForOrganizationOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListHandshakesForOrganizationPages(input *ListHandshakesForOrganizationInput, fn func(*ListHandshakesForOrganizationOutput, bool) bool) error { + return c.ListHandshakesForOrganizationPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListHandshakesForOrganizationPagesWithContext same as ListHandshakesForOrganizationPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListHandshakesForOrganizationPagesWithContext(ctx aws.Context, input *ListHandshakesForOrganizationInput, fn func(*ListHandshakesForOrganizationOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListHandshakesForOrganizationInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListHandshakesForOrganizationRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListHandshakesForOrganizationOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListOrganizationalUnitsForParent = "ListOrganizationalUnitsForParent" // ListOrganizationalUnitsForParentRequest generates a "aws/request.Request" representing the @@ -3434,6 +5592,12 @@ func (c *Organizations) ListOrganizationalUnitsForParentRequest(input *ListOrgan Name: opListOrganizationalUnitsForParent, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3471,7 +5635,54 @@ func (c *Organizations) ListOrganizationalUnitsForParentRequest(input *ListOrgan // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeParentNotFoundException "ParentNotFoundException" // We can't find a root or organizational unit (OU) with the ParentId that you @@ -3507,6 +5718,56 @@ func (c *Organizations) ListOrganizationalUnitsForParentWithContext(ctx aws.Cont return out, req.Send() } +// ListOrganizationalUnitsForParentPages iterates over the pages of a ListOrganizationalUnitsForParent operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListOrganizationalUnitsForParent method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListOrganizationalUnitsForParent operation. +// pageNum := 0 +// err := client.ListOrganizationalUnitsForParentPages(params, +// func(page *ListOrganizationalUnitsForParentOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListOrganizationalUnitsForParentPages(input *ListOrganizationalUnitsForParentInput, fn func(*ListOrganizationalUnitsForParentOutput, bool) bool) error { + return c.ListOrganizationalUnitsForParentPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListOrganizationalUnitsForParentPagesWithContext same as ListOrganizationalUnitsForParentPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListOrganizationalUnitsForParentPagesWithContext(ctx aws.Context, input *ListOrganizationalUnitsForParentInput, fn func(*ListOrganizationalUnitsForParentOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListOrganizationalUnitsForParentInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListOrganizationalUnitsForParentRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListOrganizationalUnitsForParentOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListParents = "ListParents" // ListParentsRequest generates a "aws/request.Request" representing the @@ -3539,6 +5800,12 @@ func (c *Organizations) ListParentsRequest(input *ListParentsInput) (req *reques Name: opListParents, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3584,7 +5851,54 @@ func (c *Organizations) ListParentsRequest(input *ListParentsInput) (req *reques // that you specified. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -3616,6 +5930,56 @@ func (c *Organizations) ListParentsWithContext(ctx aws.Context, input *ListParen return out, req.Send() } +// ListParentsPages iterates over the pages of a ListParents operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListParents method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListParents operation. +// pageNum := 0 +// err := client.ListParentsPages(params, +// func(page *ListParentsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListParentsPages(input *ListParentsInput, fn func(*ListParentsOutput, bool) bool) error { + return c.ListParentsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListParentsPagesWithContext same as ListParentsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListParentsPagesWithContext(ctx aws.Context, input *ListParentsInput, fn func(*ListParentsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListParentsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListParentsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListParentsOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListPolicies = "ListPolicies" // ListPoliciesRequest generates a "aws/request.Request" representing the @@ -3648,6 +6012,12 @@ func (c *Organizations) ListPoliciesRequest(input *ListPoliciesInput) (req *requ Name: opListPolicies, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3685,7 +6055,54 @@ func (c *Organizations) ListPoliciesRequest(input *ListPoliciesInput) (req *requ // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -3717,6 +6134,56 @@ func (c *Organizations) ListPoliciesWithContext(ctx aws.Context, input *ListPoli return out, req.Send() } +// ListPoliciesPages iterates over the pages of a ListPolicies operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListPolicies method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListPolicies operation. +// pageNum := 0 +// err := client.ListPoliciesPages(params, +// func(page *ListPoliciesOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListPoliciesPages(input *ListPoliciesInput, fn func(*ListPoliciesOutput, bool) bool) error { + return c.ListPoliciesPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListPoliciesPagesWithContext same as ListPoliciesPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListPoliciesPagesWithContext(ctx aws.Context, input *ListPoliciesInput, fn func(*ListPoliciesOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListPoliciesInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListPoliciesRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListPoliciesOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListPoliciesForTarget = "ListPoliciesForTarget" // ListPoliciesForTargetRequest generates a "aws/request.Request" representing the @@ -3749,6 +6216,12 @@ func (c *Organizations) ListPoliciesForTargetRequest(input *ListPoliciesForTarge Name: opListPoliciesForTarget, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3788,7 +6261,54 @@ func (c *Organizations) ListPoliciesForTargetRequest(input *ListPoliciesForTarge // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -3823,6 +6343,56 @@ func (c *Organizations) ListPoliciesForTargetWithContext(ctx aws.Context, input return out, req.Send() } +// ListPoliciesForTargetPages iterates over the pages of a ListPoliciesForTarget operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListPoliciesForTarget method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListPoliciesForTarget operation. +// pageNum := 0 +// err := client.ListPoliciesForTargetPages(params, +// func(page *ListPoliciesForTargetOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListPoliciesForTargetPages(input *ListPoliciesForTargetInput, fn func(*ListPoliciesForTargetOutput, bool) bool) error { + return c.ListPoliciesForTargetPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListPoliciesForTargetPagesWithContext same as ListPoliciesForTargetPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListPoliciesForTargetPagesWithContext(ctx aws.Context, input *ListPoliciesForTargetInput, fn func(*ListPoliciesForTargetOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListPoliciesForTargetInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListPoliciesForTargetRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListPoliciesForTargetOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListRoots = "ListRoots" // ListRootsRequest generates a "aws/request.Request" representing the @@ -3855,6 +6425,12 @@ func (c *Organizations) ListRootsRequest(input *ListRootsInput) (req *request.Re Name: opListRoots, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3892,7 +6468,54 @@ func (c *Organizations) ListRootsRequest(input *ListRootsInput) (req *request.Re // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeServiceException "ServiceException" // AWS Organizations can't complete your request because of an internal service @@ -3924,6 +6547,56 @@ func (c *Organizations) ListRootsWithContext(ctx aws.Context, input *ListRootsIn return out, req.Send() } +// ListRootsPages iterates over the pages of a ListRoots operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListRoots method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListRoots operation. +// pageNum := 0 +// err := client.ListRootsPages(params, +// func(page *ListRootsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListRootsPages(input *ListRootsInput, fn func(*ListRootsOutput, bool) bool) error { + return c.ListRootsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListRootsPagesWithContext same as ListRootsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListRootsPagesWithContext(ctx aws.Context, input *ListRootsInput, fn func(*ListRootsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListRootsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListRootsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListRootsOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListTargetsForPolicy = "ListTargetsForPolicy" // ListTargetsForPolicyRequest generates a "aws/request.Request" representing the @@ -3956,6 +6629,12 @@ func (c *Organizations) ListTargetsForPolicyRequest(input *ListTargetsForPolicyI Name: opListTargetsForPolicy, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -3993,7 +6672,54 @@ func (c *Organizations) ListTargetsForPolicyRequest(input *ListTargetsForPolicyI // must use the credentials of an account that belongs to an organization. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodePolicyNotFoundException "PolicyNotFoundException" // We can't find a policy with the PolicyId that you specified. @@ -4028,6 +6754,56 @@ func (c *Organizations) ListTargetsForPolicyWithContext(ctx aws.Context, input * return out, req.Send() } +// ListTargetsForPolicyPages iterates over the pages of a ListTargetsForPolicy operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListTargetsForPolicy method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListTargetsForPolicy operation. +// pageNum := 0 +// err := client.ListTargetsForPolicyPages(params, +// func(page *ListTargetsForPolicyOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *Organizations) ListTargetsForPolicyPages(input *ListTargetsForPolicyInput, fn func(*ListTargetsForPolicyOutput, bool) bool) error { + return c.ListTargetsForPolicyPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListTargetsForPolicyPagesWithContext same as ListTargetsForPolicyPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *Organizations) ListTargetsForPolicyPagesWithContext(ctx aws.Context, input *ListTargetsForPolicyInput, fn func(*ListTargetsForPolicyOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListTargetsForPolicyInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListTargetsForPolicyRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListTargetsForPolicyOutput), !p.HasNextPage()) + } + return p.Err() +} + const opMoveAccount = "MoveAccount" // MoveAccountRequest generates a "aws/request.Request" representing the @@ -4096,7 +6872,54 @@ func (c *Organizations) MoveAccountRequest(input *MoveAccountInput) (req *reques // in the IAM User Guide. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeSourceParentNotFoundException "SourceParentNotFoundException" // We can't find a source root or OU with the ParentId that you specified. @@ -4244,10 +7067,103 @@ func (c *Organizations) RemoveAccountFromOrganizationRequest(input *RemoveAccoun // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeMasterCannotLeaveOrganizationException "MasterCannotLeaveOrganizationException" // You can't remove a master account from an organization. If you want the master @@ -4362,7 +7278,54 @@ func (c *Organizations) UpdateOrganizationalUnitRequest(input *UpdateOrganizatio // An organizational unit (OU) with the same name already exists. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeOrganizationalUnitNotFoundException "OrganizationalUnitNotFoundException" // We can't find an organizational unit (OU) with the OrganizationalUnitId that @@ -4476,13 +7439,106 @@ func (c *Organizations) UpdatePolicyRequest(input *UpdatePolicyInput) (req *requ // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many -// policies to an account, OU, or root. +// policies to an account, OU, or root. This exception includes a reason that +// contains additional information about the violated limit: +// +// ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number +// of accounts in an organization. Note: deleted and closed accounts still count +// toward your limit. +// +// * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of +// handshakes you can send in one day. +// +// * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational +// units you can have in an organization. +// +// * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit +// tree that is too many levels deep. +// +// * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of +// policies that you can have in an organization. +// +// * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the +// number of policies of a certain type that can be attached to an entity +// at one time. +// +// * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a +// policy from an entity that would cause the entity to have fewer than the +// minimum number of policies of a certain type required. +// +// * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account +// from an organization that was created from within organizations. +// +// * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization +// with this account, you first must associate a payment instrument, such +// as a credit card, with the account. +// +// * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation +// with this member account, you first must associate a payment instrument, +// such as a credit card, with the account. +// +// * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number +// of accounts that you can create in one day. +// +// * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account +// in this organization, you first must migrate the organization's master +// account to the marketplace that corresponds to the master account's address. +// For example, accounts with India addresses must be associated with the +// AISPL marketplace. All accounts in an organization must be associated +// with the same marketplace. // // * ErrCodeDuplicatePolicyException "DuplicatePolicyException" // A policy with the same name already exists. // // * ErrCodeInvalidInputException "InvalidInputException" -// You provided invalid values for one or more of the request parameters. +// The requested operation failed because you provided invalid values for one +// or more of the request parameters. This exception includes a reason that +// contains additional information about the violated limit: +// +// * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, +// organization, or email) as a party. +// +// * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the +// organization. +// +// * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. +// +// * INVALID_ENUM: You specified a value that is not valid for that parameter. +// +// * INVALID_LIST_MEMBER: You provided a list to a parameter that contains +// at least one invalid value. +// +// * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer +// than allowed. +// +// * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger +// value than allowed. +// +// * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter +// than allowed. +// +// * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller +// value than allowed. +// +// * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and +// cannot be modified. +// +// * INVALID_PATTERN: You provided a value that doesn't match the required +// pattern. +// +// * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't +// match the required pattern. +// +// * INPUT_REQUIRED: You must include a value for all required parameters. +// +// * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter +// from the response to a previous call of the operation. +// +// * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter +// for the operation. +// +// * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only +// between entities in the same root. // // * ErrCodeMalformedPolicyDocumentException "MalformedPolicyDocumentException" // The provided policy document does not meet the requirements of the specified @@ -4601,6 +7657,12 @@ type Account struct { // in the AWS Organizations User Guide. Arn *string `type:"string"` + // The email address associated with the AWS account. + // + // The regex pattern (http://wikipedia.org/wiki/regex) for this parameter is + // a string of characters that represents a standard Internet email address. + Email *string `min:"6" type:"string"` + // The unique identifier (ID) of the account. // // The regex pattern (http://wikipedia.org/wiki/regex) for an account ID string @@ -4640,6 +7702,12 @@ func (s *Account) SetArn(v string) *Account { return s } +// SetEmail sets the Email field's value. +func (s *Account) SetEmail(v string) *Account { + s.Email = &v + return s +} + // SetId sets the Id field's value. func (s *Account) SetId(v string) *Account { s.Id = &v @@ -4889,6 +7957,10 @@ type CreateAccountInput struct { // For more information, see Activating Access to the Billing and Cost Management // Console (http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/grantaccess.html#ControllingAccessWebsite-Activate) // in the AWS Billing and Cost Management User Guide. + // + // If you do not specify this parameter, the value defaults to ALLOW, and IAM + // users and roles with the required permissions can access billing information + // for the new account. IamUserAccessToBilling *string `type:"string" enum:"IAMUserAccessToBilling"` // (Optional) @@ -5018,6 +8090,21 @@ type CreateAccountStatus struct { CompletedTimestamp *time.Time `type:"timestamp" timestampFormat:"unix"` // If the request failed, a description of the reason for the failure. + // + // * ACCOUNT_LIMIT_EXCEEDED: The account could not be created because you + // have reached the limit on the number of accounts in your organization. + // + // * EMAIL_ALREADY_EXISTS: The account could not be created because another + // AWS account with that email address already exists. + // + // * INVALID_ADDRESS: The account could not be created because the address + // you provided is not valid. + // + // * INVALID_EMAIL: The account could not be created because the email address + // you provided is not valid. + // + // * INTERNAL_FAILURE: The account could not be created because of an internal + // failure. Try again later. If the problem persists, contact Customer Support. FailureReason *string `type:"string" enum:"CreateAccountFailureReason"` // The unique identifier (ID) that references this request. You get this value @@ -8932,8 +12019,14 @@ const ( // ConstraintViolationExceptionReasonMasterAccountPaymentInstrumentRequired is a ConstraintViolationExceptionReason enum value ConstraintViolationExceptionReasonMasterAccountPaymentInstrumentRequired = "MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED" + // ConstraintViolationExceptionReasonMemberAccountPaymentInstrumentRequired is a ConstraintViolationExceptionReason enum value + ConstraintViolationExceptionReasonMemberAccountPaymentInstrumentRequired = "MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED" + // ConstraintViolationExceptionReasonAccountCreationRateLimitExceeded is a ConstraintViolationExceptionReason enum value ConstraintViolationExceptionReasonAccountCreationRateLimitExceeded = "ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED" + + // ConstraintViolationExceptionReasonMasterAccountAddressDoesNotMatchMarketplace is a ConstraintViolationExceptionReason enum value + ConstraintViolationExceptionReasonMasterAccountAddressDoesNotMatchMarketplace = "MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE" ) const ( @@ -8946,6 +12039,9 @@ const ( // CreateAccountFailureReasonInvalidAddress is a CreateAccountFailureReason enum value CreateAccountFailureReasonInvalidAddress = "INVALID_ADDRESS" + // CreateAccountFailureReasonInvalidEmail is a CreateAccountFailureReason enum value + CreateAccountFailureReasonInvalidEmail = "INVALID_EMAIL" + // CreateAccountFailureReasonInternalFailure is a CreateAccountFailureReason enum value CreateAccountFailureReasonInternalFailure = "INTERNAL_FAILURE" ) diff --git a/vendor/github.com/aws/aws-sdk-go/service/organizations/doc.go b/vendor/github.com/aws/aws-sdk-go/service/organizations/doc.go new file mode 100644 index 00000000..4adb150c --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/organizations/doc.go @@ -0,0 +1,191 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package organizations provides the client and types for making API +// requests to AWS Organizations. +// +// AWS Organizations is a web service that enables you to consolidate your multiple +// AWS accounts into an organization and centrally manage your accounts and +// their resources. +// +// This guide provides descriptions of the Organizations API. For more information +// about using this service, see the AWS Organizations User Guide (http://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html). +// +// API Version +// +// This version of the Organizations API Reference documents the Organizations +// API version 2016-11-28. +// +// As an alternative to using the API directly, 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, and more). The SDKs provide +// a convenient way to create programmatic access to AWS Organizations. For +// example, the SDKs take care of cryptographically signing requests, managing +// errors, and retrying requests automatically. 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/). +// +// We recommend that you use the AWS SDKs to make programmatic API calls to +// Organizations. However, you also can use the Organizations Query API to make +// direct calls to the Organizations web service. To learn more about the Organizations +// Query API, see Making Query Requests (http://docs.aws.amazon.com/organizations/latest/userguide/orgs_query-requests.html) +// in the AWS Organizations User Guide. Organizations supports GET and POST +// requests for all actions. That is, the API does not require you to use GET +// for some actions and POST for others. However, GET requests are subject to +// the limitation size of a URL. Therefore, for operations that require larger +// sizes, use a POST request. +// +// Signing Requests +// +// When you send HTTP requests to AWS, you must sign the requests so that AWS +// can identify who sent them. You sign requests with your AWS access key, which +// consists of an access key ID and a secret access key. We strongly recommend +// that you do not create an access key for your root account. Anyone who has +// the access key for your root account has unrestricted access to all the resources +// in your account. Instead, create an access key for an IAM user account that +// has administrative privileges. As another option, use AWS Security Token +// Service to generate temporary security credentials, and use those credentials +// to sign requests. +// +// To sign requests, we recommend that you use Signature Version 4 (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). +// If you have an existing application that uses Signature Version 2, you do +// not have to update it to use Signature Version 4. However, some operations +// now require Signature Version 4. The documentation for operations that require +// version 4 indicate this requirement. +// +// When you use the AWS Command Line Interface (AWS CLI) or one of the AWS SDKs +// to make requests to AWS, these tools automatically sign the requests for +// you with the access key that you specify when you configure the tools. +// +// In this release, each organization can have only one root. In a future release, +// a single organization will support multiple roots. +// +// Support and Feedback for AWS Organizations +// +// We welcome your feedback. Send your comments to feedback-awsorganizations@amazon.com +// (mailto:feedback-awsorganizations@amazon.com) or post your feedback and questions +// in our private AWS Organizations support forum (http://forums.aws.amazon.com/forum.jspa?forumID=219). +// If you don't have access to the forum, send a request for access to the email +// address, along with your forum user ID. For more information about the AWS +// support forums, see Forums Help (http://forums.aws.amazon.com/help.jspa). +// +// Endpoint to Call When Using the CLI or the AWS API +// +// For the current release of Organizations, you must specify the us-east-1 +// region for all AWS API and CLI calls. You can do this in the CLI by using +// these parameters and commands: +// +// * Use the following parameter with each command to specify both the endpoint +// and its region: +// +// --endpoint-url https://organizations.us-east-1.amazonaws.com +// +// * Use the default endpoint, but configure your default region with this +// command: +// +// aws configure set default.region us-east-1 +// +// * Use the following parameter with each command to specify the endpoint: +// +// --region us-east-1 +// +// For the various SDKs used to call the APIs, see the documentation for the +// SDK of interest to learn how to direct the requests to a specific endpoint. +// For more information, see Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#sts_region) +// in the AWS General Reference. +// +// How examples are presented +// +// The JSON returned by the AWS Organizations service as response to your requests +// is returned as a single long string without line breaks or formatting whitespace. +// Both line breaks and whitespace are included in the examples in this guide +// to improve readability. When example input parameters also would result in +// long strings that would extend beyond the screen, we insert line breaks to +// enhance readability. You should always submit the input as a single JSON +// text string. +// +// Recording API Requests +// +// AWS Organizations supports AWS CloudTrail, a service that records AWS API +// calls for your AWS account and delivers log files to an Amazon S3 bucket. +// By using information collected by AWS CloudTrail, you can determine which +// requests were successfully made to Organizations, who made the request, when +// it was made, and so on. For more about AWS Organizations and its support +// for AWS CloudTrail, see Logging AWS Organizations Events with AWS CloudTrail +// (http://docs.aws.amazon.com/organizations/latest/userguide/orgs_cloudtrail-integration.html) +// in the AWS Organizations User Guide. To learn more about CloudTrail, including +// how to turn it on and find your log files, see the AWS CloudTrail User Guide +// (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/what_is_cloud_trail_top_level.html). +// +// See https://docs.aws.amazon.com/goto/WebAPI/organizations-2016-11-28 for more information on this service. +// +// See organizations package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/organizations/ +// +// Using the Client +// +// To use the client for AWS Organizations 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 := organizations.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 Organizations client Organizations for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/organizations/#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.AcceptHandshake(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("AcceptHandshake 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.AcceptHandshakeWithContext(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 organizations diff --git a/vendor/github.com/aws/aws-sdk-go/service/organizations/errors.go b/vendor/github.com/aws/aws-sdk-go/service/organizations/errors.go index d9c041d0..af7c2d64 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/organizations/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/organizations/errors.go @@ -56,7 +56,53 @@ const ( // Performing this operation violates a minimum or maximum value limit. For // example, attempting to removing the last SCP from an OU or root, inviting // or creating too many accounts to the organization, or attaching too many - // policies to an account, OU, or root. + // policies to an account, OU, or root. This exception includes a reason that + // contains additional information about the violated limit: + // + // ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on the number + // of accounts in an organization. Note: deleted and closed accounts still count + // toward your limit. + // + // * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of + // handshakes you can send in one day. + // + // * OU_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the number of organizational + // units you can have in an organization. + // + // * OU_DEPTH_LIMIT_EXCEEDED: You attempted to create an organizational unit + // tree that is too many levels deep. + // + // * POLICY_NUMBER_LIMIT_EXCEEDED. You attempted to exceed the number of + // policies that you can have in an organization. + // + // * MAX_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to exceed the + // number of policies of a certain type that can be attached to an entity + // at one time. + // + // * MIN_POLICY_TYPE_ATTACHMENT_LIMIT_EXCEEDED: You attempted to detach a + // policy from an entity that would cause the entity to have fewer than the + // minimum number of policies of a certain type required. + // + // * ACCOUNT_CANNOT_LEAVE_ORGANIZATION: You attempted to remove an account + // from an organization that was created from within organizations. + // + // * MASTER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To create an organization + // with this account, you first must associate a payment instrument, such + // as a credit card, with the account. + // + // * MEMBER_ACCOUNT_PAYMENT_INSTRUMENT_REQUIRED: To complete this operation + // with this member account, you first must associate a payment instrument, + // such as a credit card, with the account. + // + // * ACCOUNT_CREATION_RATE_LIMIT_EXCEEDED: You attempted to exceed the number + // of accounts that you can create in one day. + // + // * MASTER_ACCOUNT_ADDRESS_DOES_NOT_MATCH_MARKETPLACE: To create an account + // in this organization, you first must migrate the organization's master + // account to the marketplace that corresponds to the master account's address. + // For example, accounts with India addresses must be associated with the + // AISPL marketplace. All accounts in an organization must be associated + // with the same marketplace. ErrCodeConstraintViolationException = "ConstraintViolationException" // ErrCodeCreateAccountStatusNotFoundException for service response error code @@ -126,6 +172,37 @@ const ( // // The requested operation would violate the constraint identified in the reason // code. + // + // * ACCOUNT_NUMBER_LIMIT_EXCEEDED: You attempted to exceed the limit on + // the number of accounts in an organization. Note: deleted and closed accounts + // still count toward your limit. + // + // * HANDSHAKE_RATE_LIMIT_EXCEEDED: You attempted to exceed the number of + // handshakes you can send in one day. + // + // * ALREADY_IN_AN_ORGANIZATION: The handshake request is invalid because + // the invited account is already a member of an organization. + // + // * ORGANIZATION_ALREADY_HAS_ALL_FEATURES: The handshake request is invalid + // because the organization has already enabled all features. + // + // * INVITE_DISABLED_DURING_ENABLE_ALL_FEATURES: You cannot issue new invitations + // to join an organization while it is in the process of enabling all features. + // You can resume inviting accounts after you finalize the process when all + // accounts have agreed to the change. + // + // * PAYMENT_INSTRUMENT_REQUIRED: You cannot complete the operation with + // an account that does not have a payment instrument, such as a credit card, + // associated with it. + // + // * ORGANIZATION_FROM_DIFFERENT_SELLER_OF_RECORD: The request failed because + // the account is from a different marketplace than the accounts in the organization. + // For example, accounts with India addresses must be associated with the + // AISPL marketplace. All accounts in an organization must be from the same + // marketplace. + // + // * ORGANIZATION_MEMBERSHIP_CHANGE_RATE_LIMIT_EXCEEDED: You attempted to + // change the membership of an account too quickly after its previous change. ErrCodeHandshakeConstraintViolationException = "HandshakeConstraintViolationException" // ErrCodeHandshakeNotFoundException for service response error code @@ -145,7 +222,54 @@ const ( // ErrCodeInvalidInputException for service response error code // "InvalidInputException". // - // You provided invalid values for one or more of the request parameters. + // The requested operation failed because you provided invalid values for one + // or more of the request parameters. This exception includes a reason that + // contains additional information about the violated limit: + // + // * INVALID_PARTY_TYPE_TARGET: You specified the wrong type of entity (account, + // organization, or email) as a party. + // + // * INVALID_SYNTAX_ORGANIZATION_ARN: You specified an invalid ARN for the + // organization. + // + // * INVALID_SYNTAX_POLICY_ID: You specified an invalid policy ID. + // + // * INVALID_ENUM: You specified a value that is not valid for that parameter. + // + // * INVALID_LIST_MEMBER: You provided a list to a parameter that contains + // at least one invalid value. + // + // * MAX_LENGTH_EXCEEDED: You provided a string parameter that is longer + // than allowed. + // + // * MAX_VALUE_EXCEEDED: You provided a numeric parameter that has a larger + // value than allowed. + // + // * MIN_LENGTH_EXCEEDED: You provided a string parameter that is shorter + // than allowed. + // + // * MIN_VALUE_EXCEEDED: You provided a numeric parameter that has a smaller + // value than allowed. + // + // * IMMUTABLE_POLICY: You specified a policy that is managed by AWS and + // cannot be modified. + // + // * INVALID_PATTERN: You provided a value that doesn't match the required + // pattern. + // + // * INVALID_PATTERN_TARGET_ID: You specified a policy target ID that doesn't + // match the required pattern. + // + // * INPUT_REQUIRED: You must include a value for all required parameters. + // + // * INVALID_PAGINATION_TOKEN: Get the value for the NextToken parameter + // from the response to a previous call of the operation. + // + // * MAX_FILTER_LIMIT_EXCEEDED: You can specify only one filter parameter + // for the operation. + // + // * MOVING_ACCOUNT_BETWEEN_DIFFERENT_ROOTS: You can move an account only + // between entities in the same root. ErrCodeInvalidInputException = "InvalidInputException" // ErrCodeMalformedPolicyDocumentException for service response error code diff --git a/vendor/github.com/aws/aws-sdk-go/service/organizations/organizationsiface/interface.go b/vendor/github.com/aws/aws-sdk-go/service/organizations/organizationsiface/interface.go index 1b7fe834..2142e360 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/organizations/organizationsiface/interface.go +++ b/vendor/github.com/aws/aws-sdk-go/service/organizations/organizationsiface/interface.go @@ -156,50 +156,86 @@ type OrganizationsAPI interface { ListAccountsWithContext(aws.Context, *organizations.ListAccountsInput, ...request.Option) (*organizations.ListAccountsOutput, error) ListAccountsRequest(*organizations.ListAccountsInput) (*request.Request, *organizations.ListAccountsOutput) + ListAccountsPages(*organizations.ListAccountsInput, func(*organizations.ListAccountsOutput, bool) bool) error + ListAccountsPagesWithContext(aws.Context, *organizations.ListAccountsInput, func(*organizations.ListAccountsOutput, bool) bool, ...request.Option) error + ListAccountsForParent(*organizations.ListAccountsForParentInput) (*organizations.ListAccountsForParentOutput, error) ListAccountsForParentWithContext(aws.Context, *organizations.ListAccountsForParentInput, ...request.Option) (*organizations.ListAccountsForParentOutput, error) ListAccountsForParentRequest(*organizations.ListAccountsForParentInput) (*request.Request, *organizations.ListAccountsForParentOutput) + ListAccountsForParentPages(*organizations.ListAccountsForParentInput, func(*organizations.ListAccountsForParentOutput, bool) bool) error + ListAccountsForParentPagesWithContext(aws.Context, *organizations.ListAccountsForParentInput, func(*organizations.ListAccountsForParentOutput, bool) bool, ...request.Option) error + ListChildren(*organizations.ListChildrenInput) (*organizations.ListChildrenOutput, error) ListChildrenWithContext(aws.Context, *organizations.ListChildrenInput, ...request.Option) (*organizations.ListChildrenOutput, error) ListChildrenRequest(*organizations.ListChildrenInput) (*request.Request, *organizations.ListChildrenOutput) + ListChildrenPages(*organizations.ListChildrenInput, func(*organizations.ListChildrenOutput, bool) bool) error + ListChildrenPagesWithContext(aws.Context, *organizations.ListChildrenInput, func(*organizations.ListChildrenOutput, bool) bool, ...request.Option) error + ListCreateAccountStatus(*organizations.ListCreateAccountStatusInput) (*organizations.ListCreateAccountStatusOutput, error) ListCreateAccountStatusWithContext(aws.Context, *organizations.ListCreateAccountStatusInput, ...request.Option) (*organizations.ListCreateAccountStatusOutput, error) ListCreateAccountStatusRequest(*organizations.ListCreateAccountStatusInput) (*request.Request, *organizations.ListCreateAccountStatusOutput) + ListCreateAccountStatusPages(*organizations.ListCreateAccountStatusInput, func(*organizations.ListCreateAccountStatusOutput, bool) bool) error + ListCreateAccountStatusPagesWithContext(aws.Context, *organizations.ListCreateAccountStatusInput, func(*organizations.ListCreateAccountStatusOutput, bool) bool, ...request.Option) error + ListHandshakesForAccount(*organizations.ListHandshakesForAccountInput) (*organizations.ListHandshakesForAccountOutput, error) ListHandshakesForAccountWithContext(aws.Context, *organizations.ListHandshakesForAccountInput, ...request.Option) (*organizations.ListHandshakesForAccountOutput, error) ListHandshakesForAccountRequest(*organizations.ListHandshakesForAccountInput) (*request.Request, *organizations.ListHandshakesForAccountOutput) + ListHandshakesForAccountPages(*organizations.ListHandshakesForAccountInput, func(*organizations.ListHandshakesForAccountOutput, bool) bool) error + ListHandshakesForAccountPagesWithContext(aws.Context, *organizations.ListHandshakesForAccountInput, func(*organizations.ListHandshakesForAccountOutput, bool) bool, ...request.Option) error + ListHandshakesForOrganization(*organizations.ListHandshakesForOrganizationInput) (*organizations.ListHandshakesForOrganizationOutput, error) ListHandshakesForOrganizationWithContext(aws.Context, *organizations.ListHandshakesForOrganizationInput, ...request.Option) (*organizations.ListHandshakesForOrganizationOutput, error) ListHandshakesForOrganizationRequest(*organizations.ListHandshakesForOrganizationInput) (*request.Request, *organizations.ListHandshakesForOrganizationOutput) + ListHandshakesForOrganizationPages(*organizations.ListHandshakesForOrganizationInput, func(*organizations.ListHandshakesForOrganizationOutput, bool) bool) error + ListHandshakesForOrganizationPagesWithContext(aws.Context, *organizations.ListHandshakesForOrganizationInput, func(*organizations.ListHandshakesForOrganizationOutput, bool) bool, ...request.Option) error + ListOrganizationalUnitsForParent(*organizations.ListOrganizationalUnitsForParentInput) (*organizations.ListOrganizationalUnitsForParentOutput, error) ListOrganizationalUnitsForParentWithContext(aws.Context, *organizations.ListOrganizationalUnitsForParentInput, ...request.Option) (*organizations.ListOrganizationalUnitsForParentOutput, error) ListOrganizationalUnitsForParentRequest(*organizations.ListOrganizationalUnitsForParentInput) (*request.Request, *organizations.ListOrganizationalUnitsForParentOutput) + ListOrganizationalUnitsForParentPages(*organizations.ListOrganizationalUnitsForParentInput, func(*organizations.ListOrganizationalUnitsForParentOutput, bool) bool) error + ListOrganizationalUnitsForParentPagesWithContext(aws.Context, *organizations.ListOrganizationalUnitsForParentInput, func(*organizations.ListOrganizationalUnitsForParentOutput, bool) bool, ...request.Option) error + ListParents(*organizations.ListParentsInput) (*organizations.ListParentsOutput, error) ListParentsWithContext(aws.Context, *organizations.ListParentsInput, ...request.Option) (*organizations.ListParentsOutput, error) ListParentsRequest(*organizations.ListParentsInput) (*request.Request, *organizations.ListParentsOutput) + ListParentsPages(*organizations.ListParentsInput, func(*organizations.ListParentsOutput, bool) bool) error + ListParentsPagesWithContext(aws.Context, *organizations.ListParentsInput, func(*organizations.ListParentsOutput, bool) bool, ...request.Option) error + ListPolicies(*organizations.ListPoliciesInput) (*organizations.ListPoliciesOutput, error) ListPoliciesWithContext(aws.Context, *organizations.ListPoliciesInput, ...request.Option) (*organizations.ListPoliciesOutput, error) ListPoliciesRequest(*organizations.ListPoliciesInput) (*request.Request, *organizations.ListPoliciesOutput) + ListPoliciesPages(*organizations.ListPoliciesInput, func(*organizations.ListPoliciesOutput, bool) bool) error + ListPoliciesPagesWithContext(aws.Context, *organizations.ListPoliciesInput, func(*organizations.ListPoliciesOutput, bool) bool, ...request.Option) error + ListPoliciesForTarget(*organizations.ListPoliciesForTargetInput) (*organizations.ListPoliciesForTargetOutput, error) ListPoliciesForTargetWithContext(aws.Context, *organizations.ListPoliciesForTargetInput, ...request.Option) (*organizations.ListPoliciesForTargetOutput, error) ListPoliciesForTargetRequest(*organizations.ListPoliciesForTargetInput) (*request.Request, *organizations.ListPoliciesForTargetOutput) + ListPoliciesForTargetPages(*organizations.ListPoliciesForTargetInput, func(*organizations.ListPoliciesForTargetOutput, bool) bool) error + ListPoliciesForTargetPagesWithContext(aws.Context, *organizations.ListPoliciesForTargetInput, func(*organizations.ListPoliciesForTargetOutput, bool) bool, ...request.Option) error + ListRoots(*organizations.ListRootsInput) (*organizations.ListRootsOutput, error) ListRootsWithContext(aws.Context, *organizations.ListRootsInput, ...request.Option) (*organizations.ListRootsOutput, error) ListRootsRequest(*organizations.ListRootsInput) (*request.Request, *organizations.ListRootsOutput) + ListRootsPages(*organizations.ListRootsInput, func(*organizations.ListRootsOutput, bool) bool) error + ListRootsPagesWithContext(aws.Context, *organizations.ListRootsInput, func(*organizations.ListRootsOutput, bool) bool, ...request.Option) error + ListTargetsForPolicy(*organizations.ListTargetsForPolicyInput) (*organizations.ListTargetsForPolicyOutput, error) ListTargetsForPolicyWithContext(aws.Context, *organizations.ListTargetsForPolicyInput, ...request.Option) (*organizations.ListTargetsForPolicyOutput, error) ListTargetsForPolicyRequest(*organizations.ListTargetsForPolicyInput) (*request.Request, *organizations.ListTargetsForPolicyOutput) + ListTargetsForPolicyPages(*organizations.ListTargetsForPolicyInput, func(*organizations.ListTargetsForPolicyOutput, bool) bool) error + ListTargetsForPolicyPagesWithContext(aws.Context, *organizations.ListTargetsForPolicyInput, func(*organizations.ListTargetsForPolicyOutput, bool) bool, ...request.Option) error + MoveAccount(*organizations.MoveAccountInput) (*organizations.MoveAccountOutput, error) MoveAccountWithContext(aws.Context, *organizations.MoveAccountInput, ...request.Option) (*organizations.MoveAccountOutput, error) MoveAccountRequest(*organizations.MoveAccountInput) (*request.Request, *organizations.MoveAccountOutput) diff --git a/vendor/github.com/aws/aws-sdk-go/service/organizations/service.go b/vendor/github.com/aws/aws-sdk-go/service/organizations/service.go index 094b8b4b..0ca4f04f 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/organizations/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/organizations/service.go @@ -11,121 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Organizations is a web service that enables you to consolidate your multiple -// AWS accounts into an organization and centrally manage your accounts and -// their resources. +// Organizations provides the API operation methods for making requests to +// AWS Organizations. See this package's package overview docs +// for details on the service. // -// This guide provides descriptions of the Organizations API. For more information -// about using this service, see the AWS Organizations User Guide (http://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html). -// -// API Version -// -// This version of the Organizations API Reference documents the Organizations -// API version 2016-11-28. -// -// As an alternative to using the API directly, 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, and more). The SDKs provide -// a convenient way to create programmatic access to AWS Organizations. For -// example, the SDKs take care of cryptographically signing requests, managing -// errors, and retrying requests automatically. 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/). -// -// We recommend that you use the AWS SDKs to make programmatic API calls to -// Organizations. However, you also can use the Organizations Query API to make -// direct calls to the Organizations web service. To learn more about the Organizations -// Query API, see Making Query Requests (http://docs.aws.amazon.com/organizations/latest/userguide/orgs_query-requests.html) -// in the AWS Organizations User Guide. Organizations supports GET and POST -// requests for all actions. That is, the API does not require you to use GET -// for some actions and POST for others. However, GET requests are subject to -// the limitation size of a URL. Therefore, for operations that require larger -// sizes, use a POST request. -// -// Signing Requests -// -// When you send HTTP requests to AWS, you must sign the requests so that AWS -// can identify who sent them. You sign requests with your AWS access key, which -// consists of an access key ID and a secret access key. We strongly recommend -// that you do not create an access key for your root account. Anyone who has -// the access key for your root account has unrestricted access to all the resources -// in your account. Instead, create an access key for an IAM user account that -// has administrative privileges. As another option, use AWS Security Token -// Service to generate temporary security credentials, and use those credentials -// to sign requests. -// -// To sign requests, we recommend that you use Signature Version 4 (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). -// If you have an existing application that uses Signature Version 2, you do -// not have to update it to use Signature Version 4. However, some operations -// now require Signature Version 4. The documentation for operations that require -// version 4 indicate this requirement. -// -// When you use the AWS Command Line Interface (AWS CLI) or one of the AWS SDKs -// to make requests to AWS, these tools automatically sign the requests for -// you with the access key that you specify when you configure the tools. -// -// In this release, each organization can have only one root. In a future release, -// a single organization will support multiple roots. -// -// Support and Feedback for AWS Organizations -// -// We welcome your feedback. Send your comments to feedback-awsorganizations@amazon.com -// (mailto:feedback-awsorganizations@amazon.com) or post your feedback and questions -// in our private AWS Organizations support forum (http://forums.aws.amazon.com/forum.jspa?forumID=219). -// If you don't have access to the forum, send a request for access to the email -// address, along with your forum user ID. For more information about the AWS -// support forums, see Forums Help (http://forums.aws.amazon.com/help.jspa). -// -// Endpoint to Call When Using the CLI or the AWS API -// -// For the current release of Organizations, you must specify the us-east-1 -// region for all AWS API and CLI calls. You can do this in the CLI by using -// these parameters and commands: -// -// * Use the following parameter with each command to specify both the endpoint -// and its region: -// -// --endpoint-url https://organizations.us-east-1.amazonaws.com -// -// * Use the default endpoint, but configure your default region with this -// command: -// -// aws configure set default.region us-east-1 -// -// * Use the following parameter with each command to specify the endpoint: -// -// --region us-east-1 -// -// For the various SDKs used to call the APIs, see the documentation for the -// SDK of interest to learn how to direct the requests to a specific endpoint. -// For more information, see Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#sts_region) -// in the AWS General Reference. -// -// How examples are presented -// -// The JSON returned by the AWS Organizations service as response to your requests -// is returned as a single long string without line breaks or formatting whitespace. -// Both line breaks and whitespace are included in the examples in this guide -// to improve readability. When example input parameters also would result in -// long strings that would extend beyond the screen, we insert line breaks to -// enhance readability. You should always submit the input as a single JSON -// text string. -// -// Recording API Requests -// -// AWS Organizations supports AWS CloudTrail, a service that records AWS API -// calls for your AWS account and delivers log files to an Amazon S3 bucket. -// By using information collected by AWS CloudTrail, you can determine which -// requests were successfully made to Organizations, who made the request, when -// it was made, and so on. For more about AWS Organizations and its support -// for AWS CloudTrail, see Logging AWS Organizations Events with AWS CloudTrail -// (http://docs.aws.amazon.com/organizations/latest/userguide/orgs_cloudtrail-integration.html) -// in the AWS Organizations User Guide. To learn more about CloudTrail, including -// how to turn it on and find your log files, see the AWS CloudTrail User Guide -// (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/what_is_cloud_trail_top_level.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/organizations-2016-11-28 +// Organizations methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Organizations struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/pinpoint/api.go b/vendor/github.com/aws/aws-sdk-go/service/pinpoint/api.go index 5ab42c26..322823be 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/pinpoint/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/pinpoint/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package pinpoint provides a client for Amazon Pinpoint. package pinpoint import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/pinpoint/doc.go b/vendor/github.com/aws/aws-sdk-go/service/pinpoint/doc.go new file mode 100644 index 00000000..d9bccd86 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/pinpoint/doc.go @@ -0,0 +1,76 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package pinpoint provides the client and types for making API +// requests to Amazon Pinpoint. +// +// See pinpoint package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/pinpoint/ +// +// Using the Client +// +// To use the client for Amazon Pinpoint 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 := pinpoint.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 Pinpoint client Pinpoint for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/pinpoint/#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.CreateCampaign(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("CreateCampaign 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.CreateCampaignWithContext(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 pinpoint diff --git a/vendor/github.com/aws/aws-sdk-go/service/pinpoint/service.go b/vendor/github.com/aws/aws-sdk-go/service/pinpoint/service.go index 8c19476f..cfcfc6cb 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/pinpoint/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/pinpoint/service.go @@ -11,9 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Pinpoint is a client for Amazon Pinpoint. -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// Pinpoint provides the API operation methods for making requests to +// Amazon Pinpoint. See this package's package overview docs +// for details on the service. +// +// Pinpoint methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Pinpoint struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/polly/api.go b/vendor/github.com/aws/aws-sdk-go/service/polly/api.go index a1f3e24c..cd9713b4 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/polly/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/polly/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package polly provides a client for Amazon Polly. package polly import ( @@ -1559,4 +1558,7 @@ const ( // VoiceIdFiliz is a VoiceId enum value VoiceIdFiliz = "Filiz" + + // VoiceIdVicki is a VoiceId enum value + VoiceIdVicki = "Vicki" ) diff --git a/vendor/github.com/aws/aws-sdk-go/service/polly/doc.go b/vendor/github.com/aws/aws-sdk-go/service/polly/doc.go new file mode 100644 index 00000000..b558484e --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/polly/doc.go @@ -0,0 +1,86 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package polly provides the client and types for making API +// requests to Amazon Polly. +// +// Amazon Polly is a web service that makes it easy to synthesize speech from +// text. +// +// The Amazon Polly service provides API operations for synthesizing high-quality +// speech from plain text and Speech Synthesis Markup Language (SSML), along +// with managing pronunciations lexicons that enable you to get the best results +// for your application domain. +// +// See https://docs.aws.amazon.com/goto/WebAPI/polly-2016-06-10 for more information on this service. +// +// See polly package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/polly/ +// +// Using the Client +// +// To use the client for Amazon Polly 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 := polly.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 Polly client Polly for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/polly/#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.DeleteLexicon(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("DeleteLexicon 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.DeleteLexiconWithContext(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 polly diff --git a/vendor/github.com/aws/aws-sdk-go/service/polly/service.go b/vendor/github.com/aws/aws-sdk-go/service/polly/service.go index 56a23b77..0e7b93f4 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/polly/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/polly/service.go @@ -11,16 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// Amazon Polly is a web service that makes it easy to synthesize speech from -// text. +// Polly provides the API operation methods for making requests to +// Amazon Polly. See this package's package overview docs +// for details on the service. // -// The Amazon Polly service provides API operations for synthesizing high-quality -// speech from plain text and Speech Synthesis Markup Language (SSML), along -// with managing pronunciations lexicons that enable you to get the best results -// for your application domain. -// 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/polly-2016-06-10 +// Polly methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Polly struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/rds/api.go b/vendor/github.com/aws/aws-sdk-go/service/rds/api.go index 606191fb..786172c7 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/rds/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/rds/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package rds provides a client for Amazon Relational Database Service. package rds import ( @@ -14248,6 +14247,11 @@ type DBClusterSnapshot struct { // Provides the type of the DB cluster snapshot. SnapshotType *string `type:"string"` + // If the DB cluster snapshot was copied from a source DB cluster snapshot, + // the Amazon Resource Name (ARN) for the source DB cluster snapshot; otherwise, + // a null value. + SourceDBClusterSnapshotArn *string `type:"string"` + // Specifies the status of this DB cluster snapshot. Status *string `type:"string"` @@ -14364,6 +14368,12 @@ func (s *DBClusterSnapshot) SetSnapshotType(v string) *DBClusterSnapshot { return s } +// SetSourceDBClusterSnapshotArn sets the SourceDBClusterSnapshotArn field's value. +func (s *DBClusterSnapshot) SetSourceDBClusterSnapshotArn(v string) *DBClusterSnapshot { + s.SourceDBClusterSnapshotArn = &v + return s +} + // SetStatus sets the Status field's value. func (s *DBClusterSnapshot) SetStatus(v string) *DBClusterSnapshot { s.Status = &v diff --git a/vendor/github.com/aws/aws-sdk-go/service/rds/doc.go b/vendor/github.com/aws/aws-sdk-go/service/rds/doc.go new file mode 100644 index 00000000..c3365d9f --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/rds/doc.go @@ -0,0 +1,121 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package rds provides the client and types for making API +// requests to Amazon Relational Database Service. +// +// Amazon Relational Database Service (Amazon RDS) is a web service that makes +// it easier to set up, operate, and scale a relational database in the cloud. +// It provides cost-efficient, resizable capacity for an industry-standard relational +// database and manages common database administration tasks, freeing up developers +// to focus on what makes their applications and businesses unique. +// +// Amazon RDS gives you access to the capabilities of a MySQL, MariaDB, PostgreSQL, +// Microsoft SQL Server, Oracle, or Amazon Aurora database server. These capabilities +// mean that the code, applications, and tools you already use today with your +// existing databases work with Amazon RDS without modification. Amazon RDS +// automatically backs up your database and maintains the database software +// that powers your DB instance. Amazon RDS is flexible: you can scale your +// database instance's compute resources and storage capacity to meet your application's +// demand. As with all Amazon Web Services, there are no up-front investments, +// and you pay only for the resources you use. +// +// This interface reference for Amazon RDS contains documentation for a programming +// or command line interface you can use to manage Amazon RDS. Note that Amazon +// RDS is asynchronous, which means that some interfaces might require techniques +// such as polling or callback functions to determine when a command has been +// applied. In this reference, the parameter descriptions indicate whether a +// command is applied immediately, on the next instance reboot, or during the +// maintenance window. The reference structure is as follows, and we list following +// some related topics from the user guide. +// +// Amazon RDS API Reference +// +// * For the alphabetical list of API actions, see API Actions (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Operations.html). +// +// * For the alphabetical list of data types, see Data Types (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Types.html). +// +// * For a list of common query parameters, see Common Parameters (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonParameters.html). +// +// * For descriptions of the error codes, see Common Errors (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonErrors.html). +// +// Amazon RDS User Guide +// +// * For a summary of the Amazon RDS interfaces, see Available RDS Interfaces +// (http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Interfaces). +// +// * For more information about how to use the Query API, see Using the Query +// API (http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Using_the_Query_API.html). +// +// See https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31 for more information on this service. +// +// See rds package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/rds/ +// +// Using the Client +// +// To use the client for Amazon Relational Database 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 := rds.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 Relational Database Service client RDS for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/rds/#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.AddRoleToDBCluster(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("AddRoleToDBCluster 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.AddRoleToDBClusterWithContext(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 rds diff --git a/vendor/github.com/aws/aws-sdk-go/service/rds/doc_custom.go b/vendor/github.com/aws/aws-sdk-go/service/rds/doc_custom.go new file mode 100644 index 00000000..3a4b8790 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/rds/doc_custom.go @@ -0,0 +1,25 @@ +// IAM User or Role Database Authentication +// +// The rdsutil package's BuildAuthToken function provides a connection +// authentication token builder. Given an endpoint of the RDS database, +// AWS region, DB user, and AWS credentials the function will create an +// presigned URL to use as the authentication token for the database's +// connection. +// +// The following example shows how to use BuildAuthToken to create an authentication +// token for connecting to a MySQL database in RDS. +// +// authToken, err := rdsutils.BuildAuthToken(dbEndpoint, awsRegion, dbUser, awsCreds) +// +// // Create the MySQL DNS string for the DB connection +// // user:password@protocol(endpoint)/dbname?<params> +// dnsStr = fmt.Sprintf("%s:%s@tcp(%s)/%s?tls=true", +// dbUser, authToken, dbEndpoint, dbName, +// ) +// +// // Use db to perform SQL operations on database +// db, err := sql.Open("mysql", dnsStr) +// +// See rdsutil package for more information. +// http://docs.aws.amazon.com/sdk-for-go/api/service/rds/rdsutils/ +package rds diff --git a/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect.go b/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect.go index 28415d17..cfa92318 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect.go +++ b/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect.go @@ -9,16 +9,39 @@ import ( "github.com/aws/aws-sdk-go/aws/signer/v4" ) -// BuildAuthToken is used for generate a autherized presigned URL to connect to -// the database. +// BuildAuthToken will return a authentication token for the database's connect +// based on the RDS database endpoint, AWS region, IAM user or role, and AWS credentials. // -// The endpoint consists of the scheme, hostname, and port. IE {scheme}://{hostname}[:port]. The -// region is the region of database that the auth token would be generated for. The dbUser is the user -// that the request would be authenticated with. The creds are the credentials the auth token is signed -// with. +// Endpoint consists of the hostname and port, IE hostname:port, of the RDS database. +// Region is the AWS region the RDS database is in and where the authentication token +// will be generated for. DbUser is the IAM user or role the request will be authenticated +// for. The creds is the AWS credentials the authentication token is signed with. // -// The url that is returned will not contain the scheme. +// An error is returned if the authentication token is unable to be signed with +// the credentials, or the endpoint is not a valid URL. +// +// The following example shows how to use BuildAuthToken to create an authentication +// token for connecting to a MySQL database in RDS. +// +// authToken, err := BuildAuthToken(dbEndpoint, awsRegion, dbUser, awsCreds) +// +// // Create the MySQL DNS string for the DB connection +// // user:password@protocol(endpoint)/dbname?<params> +// dnsStr = fmt.Sprintf("%s:%s@tcp(%s)/%s?tls=true", +// dbUser, authToken, dbEndpoint, dbName, +// ) +// +// // Use db to perform SQL operations on database +// db, err := sql.Open("mysql", dnsStr) +// +// See http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html +// for more information on using IAM database authentication with RDS. func BuildAuthToken(endpoint, region, dbUser string, creds *credentials.Credentials) (string, error) { + // the scheme is arbitrary and is only needed because validation of the URL requires one. + if !(strings.HasPrefix(endpoint, "http://") || strings.HasPrefix(endpoint, "https://")) { + endpoint = "https://" + endpoint + } + req, err := http.NewRequest("GET", endpoint, nil) if err != nil { return "", err diff --git a/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect_test.go b/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect_test.go index af42bf18..2d65700a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/rds/rdsutils/connect_test.go @@ -10,12 +10,30 @@ import ( ) func TestBuildAuthToken(t *testing.T) { - endpoint := "https://prod-instance.us-east-1.rds.amazonaws.com:3306" - region := "us-west-2" - creds := credentials.NewStaticCredentials("AKID", "SECRET", "SESSION") - user := "mysqlUser" + cases := []struct { + endpoint string + region string + user string + expectedRegex string + }{ + { + "https://prod-instance.us-east-1.rds.amazonaws.com:3306", + "us-west-2", + "mysqlUser", + `^prod-instance\.us-east-1\.rds\.amazonaws\.com:3306\?Action=connect.*?DBUser=mysqlUser.*`, + }, + { + "prod-instance.us-east-1.rds.amazonaws.com:3306", + "us-west-2", + "mysqlUser", + `^prod-instance\.us-east-1\.rds\.amazonaws\.com:3306\?Action=connect.*?DBUser=mysqlUser.*`, + }, + } - url, err := rdsutils.BuildAuthToken(endpoint, region, user, creds) - assert.NoError(t, err) - assert.Regexp(t, `^prod-instance\.us-east-1\.rds\.amazonaws\.com:3306\?Action=connect.*?DBUser=mysqlUser.*`, url) + for _, c := range cases { + creds := credentials.NewStaticCredentials("AKID", "SECRET", "SESSION") + url, err := rdsutils.BuildAuthToken(c.endpoint, c.region, c.user, creds) + assert.NoError(t, err) + assert.Regexp(t, c.expectedRegex, url) + } } diff --git a/vendor/github.com/aws/aws-sdk-go/service/rds/service.go b/vendor/github.com/aws/aws-sdk-go/service/rds/service.go index 0c02c621..2e2ec2e9 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/rds/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/rds/service.go @@ -11,52 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) +// RDS provides the API operation methods for making requests to +// Amazon Relational Database Service. See this package's package overview docs +// for details on the service. // -// Amazon Relational Database Service (Amazon RDS) is a web service that makes -// it easier to set up, operate, and scale a relational database in the cloud. -// It provides cost-efficient, resizable capacity for an industry-standard relational -// database and manages common database administration tasks, freeing up developers -// to focus on what makes their applications and businesses unique. -// -// Amazon RDS gives you access to the capabilities of a MySQL, MariaDB, PostgreSQL, -// Microsoft SQL Server, Oracle, or Amazon Aurora database server. These capabilities -// mean that the code, applications, and tools you already use today with your -// existing databases work with Amazon RDS without modification. Amazon RDS -// automatically backs up your database and maintains the database software -// that powers your DB instance. Amazon RDS is flexible: you can scale your -// database instance's compute resources and storage capacity to meet your application's -// demand. As with all Amazon Web Services, there are no up-front investments, -// and you pay only for the resources you use. -// -// This interface reference for Amazon RDS contains documentation for a programming -// or command line interface you can use to manage Amazon RDS. Note that Amazon -// RDS is asynchronous, which means that some interfaces might require techniques -// such as polling or callback functions to determine when a command has been -// applied. In this reference, the parameter descriptions indicate whether a -// command is applied immediately, on the next instance reboot, or during the -// maintenance window. The reference structure is as follows, and we list following -// some related topics from the user guide. -// -// Amazon RDS API Reference -// -// * For the alphabetical list of API actions, see API Actions (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Operations.html). -// -// * For the alphabetical list of data types, see Data Types (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Types.html). -// -// * For a list of common query parameters, see Common Parameters (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonParameters.html). -// -// * For descriptions of the error codes, see Common Errors (http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonErrors.html). -// -// Amazon RDS User Guide -// -// * For a summary of the Amazon RDS interfaces, see Available RDS Interfaces -// (http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Interfaces). -// -// * For more information about how to use the Query API, see Using the Query -// API (http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Using_the_Query_API.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/rds-2014-10-31 +// RDS methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type RDS struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/redshift/api.go b/vendor/github.com/aws/aws-sdk-go/service/redshift/api.go index 60617559..6fab8fc6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/redshift/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/redshift/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package redshift provides a client for Amazon Redshift. package redshift import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/redshift/doc.go b/vendor/github.com/aws/aws-sdk-go/service/redshift/doc.go new file mode 100644 index 00000000..3a3fb7d1 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/redshift/doc.go @@ -0,0 +1,103 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package redshift provides the client and types for making API +// requests to Amazon Redshift. +// +// Overview +// +// This is an interface reference for Amazon Redshift. It contains documentation +// for one of the programming or command line interfaces you can use to manage +// Amazon Redshift clusters. Note that Amazon Redshift is asynchronous, which +// means that some interfaces may require techniques, such as polling or asynchronous +// callback handlers, to determine when a command has been applied. In this +// reference, the parameter descriptions indicate whether a change is applied +// immediately, on the next instance reboot, or during the next maintenance +// window. For a summary of the Amazon Redshift cluster management interfaces, +// go to Using the Amazon Redshift Management Interfaces (http://docs.aws.amazon.com/redshift/latest/mgmt/using-aws-sdk.html). +// +// Amazon Redshift manages all the work of setting up, operating, and scaling +// a data warehouse: provisioning capacity, monitoring and backing up the cluster, +// and applying patches and upgrades to the Amazon Redshift engine. You can +// focus on using your data to acquire new insights for your business and customers. +// +// If you are a first-time user of Amazon Redshift, we recommend that you begin +// by reading the Amazon Redshift Getting Started Guide (http://docs.aws.amazon.com/redshift/latest/gsg/getting-started.html). +// +// If you are a database developer, the Amazon Redshift Database Developer Guide +// (http://docs.aws.amazon.com/redshift/latest/dg/welcome.html) explains how +// to design, build, query, and maintain the databases that make up your data +// warehouse. +// +// See https://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01 for more information on this service. +// +// See redshift package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/redshift/ +// +// Using the Client +// +// To use the client for Amazon Redshift 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 := redshift.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 Redshift client Redshift for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/redshift/#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.AuthorizeClusterSecurityGroupIngress(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("AuthorizeClusterSecurityGroupIngress 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.AuthorizeClusterSecurityGroupIngressWithContext(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 redshift diff --git a/vendor/github.com/aws/aws-sdk-go/service/redshift/service.go b/vendor/github.com/aws/aws-sdk-go/service/redshift/service.go index fd96e4bb..b859170a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/redshift/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/redshift/service.go @@ -11,33 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// Overview +// Redshift provides the API operation methods for making requests to +// Amazon Redshift. See this package's package overview docs +// for details on the service. // -// This is an interface reference for Amazon Redshift. It contains documentation -// for one of the programming or command line interfaces you can use to manage -// Amazon Redshift clusters. Note that Amazon Redshift is asynchronous, which -// means that some interfaces may require techniques, such as polling or asynchronous -// callback handlers, to determine when a command has been applied. In this -// reference, the parameter descriptions indicate whether a change is applied -// immediately, on the next instance reboot, or during the next maintenance -// window. For a summary of the Amazon Redshift cluster management interfaces, -// go to Using the Amazon Redshift Management Interfaces (http://docs.aws.amazon.com/redshift/latest/mgmt/using-aws-sdk.html). -// -// Amazon Redshift manages all the work of setting up, operating, and scaling -// a data warehouse: provisioning capacity, monitoring and backing up the cluster, -// and applying patches and upgrades to the Amazon Redshift engine. You can -// focus on using your data to acquire new insights for your business and customers. -// -// If you are a first-time user of Amazon Redshift, we recommend that you begin -// by reading the Amazon Redshift Getting Started Guide (http://docs.aws.amazon.com/redshift/latest/gsg/getting-started.html). -// -// If you are a database developer, the Amazon Redshift Database Developer Guide -// (http://docs.aws.amazon.com/redshift/latest/dg/welcome.html) explains how -// to design, build, query, and maintain the databases that make up your data -// warehouse. -// 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/redshift-2012-12-01 +// Redshift methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Redshift struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/rekognition/api.go b/vendor/github.com/aws/aws-sdk-go/service/rekognition/api.go index f7aa666a..0f312b57 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/rekognition/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/rekognition/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package rekognition provides a client for Amazon Rekognition. package rekognition import ( @@ -791,6 +790,9 @@ func (c *Rekognition) DetectModerationLabelsRequest(input *DetectModerationLabel // The number of requests exceeded your throughput limit. If you want to increase // this limit, contact Amazon Rekognition. // +// * ErrCodeInvalidImageFormatException "InvalidImageFormatException" +// The provided image format is not supported. +// func (c *Rekognition) DetectModerationLabels(input *DetectModerationLabelsInput) (*DetectModerationLabelsOutput, error) { req, out := c.DetectModerationLabelsRequest(input) return out, req.Send() diff --git a/vendor/github.com/aws/aws-sdk-go/service/rekognition/doc.go b/vendor/github.com/aws/aws-sdk-go/service/rekognition/doc.go new file mode 100644 index 00000000..d9a6ca6b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/rekognition/doc.go @@ -0,0 +1,78 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package rekognition provides the client and types for making API +// requests to Amazon Rekognition. +// +// This is the Amazon Rekognition API reference. +// +// See rekognition package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/rekognition/ +// +// Using the Client +// +// To use the client for Amazon Rekognition 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 := rekognition.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 Rekognition client Rekognition for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/rekognition/#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.CompareFaces(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("CompareFaces 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.CompareFacesWithContext(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 rekognition diff --git a/vendor/github.com/aws/aws-sdk-go/service/rekognition/service.go b/vendor/github.com/aws/aws-sdk-go/service/rekognition/service.go index 7c0b8bde..97f89579 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/rekognition/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/rekognition/service.go @@ -11,9 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This is the Amazon Rekognition API 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. +// Rekognition provides the API operation methods for making requests to +// Amazon Rekognition. See this package's package overview docs +// for details on the service. +// +// Rekognition methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Rekognition struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/api.go b/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/api.go index 8b82e16e..03f7677f 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package resourcegroupstaggingapi provides a client for AWS Resource Groups Tagging API. package resourcegroupstaggingapi import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/doc.go b/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/doc.go new file mode 100644 index 00000000..9291616b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/doc.go @@ -0,0 +1,116 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package resourcegroupstaggingapi provides the client and types for making API +// requests to AWS Resource Groups Tagging API. +// +// This guide describes the API operations for the resource groups tagging. +// +// A tag is a label that you assign to an AWS resource. A tag consists of a +// key and a value, both of which you define. For example, if you have two Amazon +// EC2 instances, you might assign both a tag key of "Stack." But the value +// of "Stack" might be "Testing" for one and "Production" for the other. +// +// Tagging can help you organize your resources and enables you to simplify +// resource management, access management and cost allocation. For more information +// about tagging, see Working with Tag Editor (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) +// and Working with Resource Groups (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/resource-groups.html). +// For more information about permissions you need to use the resource groups +// tagging APIs, see Obtaining Permissions for Resource Groups (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-resource-groups.html) +// and Obtaining Permissions for Tagging (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html). +// +// You can use the resource groups tagging APIs to complete the following tasks: +// +// * Tag and untag supported resources located in the specified region for +// the AWS account +// +// * Use tag-based filters to search for resources located in the specified +// region for the AWS account +// +// * List all existing tag keys in the specified region for the AWS account +// +// * List all existing values for the specified key in the specified region +// for the AWS account +// +// Not all resources can have tags. For a list of resources that support tagging, +// see Supported Resources (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/supported-resources.html) +// in the AWS Resource Groups and Tag Editor User Guide. +// +// To make full use of the resource groups tagging APIs, you might need additional +// IAM permissions, including permission to access the resources of individual +// services as well as permission to view and apply tags to those resources. +// For more information, see Obtaining Permissions for Tagging (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html) +// in the AWS Resource Groups and Tag Editor User Guide. +// +// See https://docs.aws.amazon.com/goto/WebAPI/resourcegroupstaggingapi-2017-01-26 for more information on this service. +// +// See resourcegroupstaggingapi package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/resourcegroupstaggingapi/ +// +// Using the Client +// +// To use the client for AWS Resource Groups Tagging API 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 := resourcegroupstaggingapi.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 Resource Groups Tagging API client ResourceGroupsTaggingAPI for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/resourcegroupstaggingapi/#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.GetResources(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("GetResources 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.GetResourcesWithContext(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 resourcegroupstaggingapi diff --git a/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/service.go b/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/service.go index 96666c20..554a10d1 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/resourcegroupstaggingapi/service.go @@ -11,46 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This guide describes the API operations for the resource groups tagging. +// ResourceGroupsTaggingAPI provides the API operation methods for making requests to +// AWS Resource Groups Tagging API. See this package's package overview docs +// for details on the service. // -// A tag is a label that you assign to an AWS resource. A tag consists of a -// key and a value, both of which you define. For example, if you have two Amazon -// EC2 instances, you might assign both a tag key of "Stack." But the value -// of "Stack" might be "Testing" for one and "Production" for the other. -// -// Tagging can help you organize your resources and enables you to simplify -// resource management, access management and cost allocation. For more information -// about tagging, see Working with Tag Editor (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) -// and Working with Resource Groups (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/resource-groups.html). -// For more information about permissions you need to use the resource groups -// tagging APIs, see Obtaining Permissions for Resource Groups (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-resource-groups.html) -// and Obtaining Permissions for Tagging (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html). -// -// You can use the resource groups tagging APIs to complete the following tasks: -// -// * Tag and untag supported resources located in the specified region for -// the AWS account -// -// * Use tag-based filters to search for resources located in the specified -// region for the AWS account -// -// * List all existing tag keys in the specified region for the AWS account -// -// * List all existing values for the specified key in the specified region -// for the AWS account -// -// Not all resources can have tags. For a list of resources that support tagging, -// see Supported Resources (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/supported-resources.html) -// in the AWS Resource Groups and Tag Editor User Guide. -// -// To make full use of the resource groups tagging APIs, you might need additional -// IAM permissions, including permission to access the resources of individual -// services as well as permission to view and apply tags to those resources. -// For more information, see Obtaining Permissions for Tagging (http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html) -// in the AWS Resource Groups and Tag Editor User 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/resourcegroupstaggingapi-2017-01-26 +// ResourceGroupsTaggingAPI methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type ResourceGroupsTaggingAPI struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/route53/api.go b/vendor/github.com/aws/aws-sdk-go/service/route53/api.go index 58aadd60..df9f44ff 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/route53/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/route53/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package route53 provides a client for Amazon Route 53. package route53 import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/route53/doc.go b/vendor/github.com/aws/aws-sdk-go/service/route53/doc.go new file mode 100644 index 00000000..361449aa --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/route53/doc.go @@ -0,0 +1,78 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package route53 provides the client and types for making API +// requests to Amazon Route 53. +// +// See https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01 for more information on this service. +// +// See route53 package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/route53/ +// +// Using the Client +// +// To use the client for Amazon Route 53 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 := route53.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 Route 53 client Route53 for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/route53/#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.AssociateVPCWithHostedZone(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("AssociateVPCWithHostedZone 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.AssociateVPCWithHostedZoneWithContext(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 route53 diff --git a/vendor/github.com/aws/aws-sdk-go/service/route53/service.go b/vendor/github.com/aws/aws-sdk-go/service/route53/service.go index 9b2e767c..98ba1c8f 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/route53/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/route53/service.go @@ -11,10 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restxml" ) -// Route53 is a client for Route 53. -// 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/route53-2013-04-01 +// Route53 provides the API operation methods for making requests to +// Amazon Route 53. See this package's package overview docs +// for details on the service. +// +// Route53 methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Route53 struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/route53domains/api.go b/vendor/github.com/aws/aws-sdk-go/service/route53domains/api.go index c89602b3..cf1d71ce 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/route53domains/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/route53domains/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package route53domains provides a client for Amazon Route 53 Domains. package route53domains import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/route53domains/doc.go b/vendor/github.com/aws/aws-sdk-go/service/route53domains/doc.go new file mode 100644 index 00000000..e0c46708 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/route53domains/doc.go @@ -0,0 +1,81 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package route53domains provides the client and types for making API +// requests to Amazon Route 53 Domains. +// +// Amazon Route 53 API actions let you register domain names and perform related +// operations. +// +// See https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15 for more information on this service. +// +// See route53domains package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/route53domains/ +// +// Using the Client +// +// To use the client for Amazon Route 53 Domains 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 := route53domains.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 Route 53 Domains client Route53Domains for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/route53domains/#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.CheckDomainAvailability(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("CheckDomainAvailability 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.CheckDomainAvailabilityWithContext(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 route53domains diff --git a/vendor/github.com/aws/aws-sdk-go/service/route53domains/service.go b/vendor/github.com/aws/aws-sdk-go/service/route53domains/service.go index 0b9d8262..299c0770 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/route53domains/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/route53domains/service.go @@ -11,11 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon Route 53 API actions let you register domain names and perform related -// operations. -// 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/route53domains-2014-05-15 +// Route53Domains provides the API operation methods for making requests to +// Amazon Route 53 Domains. See this package's package overview docs +// for details on the service. +// +// Route53Domains methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Route53Domains struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/api.go b/vendor/github.com/aws/aws-sdk-go/service/s3/api.go index 6799ce85..52ac02ca 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/s3/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package s3 provides a client for Amazon Simple Storage Service. package s3 import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/bucket_location.go b/vendor/github.com/aws/aws-sdk-go/service/s3/bucket_location.go index 83547047..bc68a46a 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/s3/bucket_location.go +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/bucket_location.go @@ -69,7 +69,7 @@ var NormalizeBucketLocationHandler = request.NamedHandler{ // &s3.GetBucketLocationInput{ // Bucket: aws.String(bucket), // }, -// WithNormalizeBucketLocation, +// s3.WithNormalizeBucketLocation, // ) func WithNormalizeBucketLocation(r *request.Request) { r.Handlers.Unmarshal.PushBackNamed(NormalizeBucketLocationHandler) diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/doc.go b/vendor/github.com/aws/aws-sdk-go/service/s3/doc.go new file mode 100644 index 00000000..f045fd0d --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/doc.go @@ -0,0 +1,78 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package s3 provides the client and types for making API +// requests to Amazon Simple Storage Service. +// +// See https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01 for more information on this service. +// +// See s3 package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/s3/ +// +// Using the Client +// +// To use the client for Amazon Simple Storage 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 := s3.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 Simple Storage Service client S3 for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/s3/#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.AbortMultipartUpload(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("AbortMultipartUpload 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.AbortMultipartUploadWithContext(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 s3 diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/doc_custom.go b/vendor/github.com/aws/aws-sdk-go/service/s3/doc_custom.go new file mode 100644 index 00000000..b794a63b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/doc_custom.go @@ -0,0 +1,109 @@ +// Upload Managers +// +// The s3manager package's Uploader provides concurrent upload of content to S3 +// by taking advantage of S3's Multipart APIs. The Uploader also supports both +// io.Reader for streaming uploads, and will also take advantage of io.ReadSeeker +// for optimizations if the Body satisfies that type. Once the Uploader instance +// is created you can call Upload concurrently from multiple goroutines safely. +// +// // The session the S3 Uploader will use +// sess := session.Must(session.NewSession()) +// +// // Create an uploader with the session and default options +// uploader := s3manager.NewUploader(sess) +// +// f, err := os.Open(filename) +// if err != nil { +// return fmt.Errorf("failed to open file %q, %v", filename, err) +// } +// +// // Upload the file to S3. +// result, err := uploader.Upload(&s3manager.UploadInput{ +// Bucket: aws.String(myBucket), +// Key: aws.String(myString), +// Body: f, +// }) +// if err != nil { +// return fmt.Errorf("failed to upload file, %v", err) +// } +// fmt.Printf("file uploaded to, %s\n", aws.StringValue(result.Location)) +// +// See the s3manager package's Uploader type documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#Uploader +// +// Download Manager +// +// The s3manager package's Downloader provides concurrently downloading of Objects +// from S3. The Downloader will write S3 Object content with an io.WriterAt. +// Once the Downloader instance is created you can call Upload concurrently from +// multiple goroutines safely. +// +// // The session the S3 Downloader will use +// sess := session.Must(session.NewSession()) +// +// // Create a downloader with the session and default options +// downloader := s3manager.NewDownloader(sess) +// +// // Create a file to write the S3 Object contents to. +// f, err := os.Create(filename) +// if err != nil { +// return fmt.Errorf("failed to create file %q, %v", filename, err) +// } +// +// // Write the contents of S3 Object to the file +// n, err := downloader.Download(f, &s3.GetObjectInput{ +// Bucket: aws.String(myBucket), +// Key: aws.String(myString), +// }) +// if err != nil { +// return fmt.Errorf("failed to upload file, %v", err) +// } +// fmt.Printf("file downloaded, %d bytes\n", n) +// +// See the s3manager package's Downloader type documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#Downloader +// +// Get Bucket Region +// +// GetBucketRegion will attempt to get the region for a bucket using a region +// hint to determine which AWS partition to perform the query on. Use this utility +// to determine the region a bucket is in. +// +// sess := session.Must(session.NewSession()) +// +// bucket := "my-bucket" +// region, err := s3manager.GetBucketRegion(ctx, sess, bucket, "us-west-2") +// if err != nil { +// if aerr, ok := err.(awserr.Error); ok && aerr.Code() == "NotFound" { +// fmt.Fprintf(os.Stderr, "unable to find bucket %s's region not found\n", bucket) +// } +// return err +// } +// fmt.Printf("Bucket %s is in %s region\n", bucket, region) +// +// See the s3manager package's GetBucketRegion function documentation for more information +// https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#GetBucketRegion +// +// S3 Crypto Client +// +// The s3crypto package provides the tools to upload and download encrypted +// content from S3. The Encryption and Decryption clients can be used concurrently +// once the client is created. +// +// sess := session.Must(session.NewSession()) +// +// // Create the decryption client. +// svc := s3crypto.NewDecryptionClient(sess) +// +// // The object will be downloaded from S3 and decrypted locally. By metadata +// // about the object's encryption will instruct the decryption client how +// // decrypt the content of the object. By default KMS is used for keys. +// result, err := svc.GetObject(&s3.GetObjectInput { +// Bucket: aws.String(myBucket), +// Key: aws.String(myKey), +// }) +// +// See the s3crypto package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3crypto/ +// +package s3 diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/s3crypto/cipher_builder.go b/vendor/github.com/aws/aws-sdk-go/service/s3/s3crypto/cipher_builder.go index 02d23f05..b3a0d318 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/s3/s3crypto/cipher_builder.go +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/s3crypto/cipher_builder.go @@ -15,7 +15,7 @@ type ContentCipher interface { GetCipherData() CipherData } -// CipherData is used for content encryption. It used for storing the +// CipherData is used for content encryption. It is used for storing the // metadata of the encrypted content. type CipherData struct { Key []byte diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download.go b/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download.go index 3ac5cee6..002df1c3 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download.go +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download.go @@ -31,7 +31,7 @@ const DefaultDownloadConcurrency = 5 type Downloader struct { // The buffer size (in bytes) to use when buffering data into chunks and // sending them as parts to S3. The minimum allowed part size is 5MB, and - // if this value is set to zero, the DefaultPartSize value will be used. + // if this value is set to zero, the DefaultDownloadPartSize value will be used. PartSize int64 // The number of goroutines to spin up in parallel when sending parts. @@ -255,13 +255,17 @@ func (d *downloader) downloadPart(ch chan dlchunk) { defer d.wg.Done() for { chunk, ok := <-ch - if !ok || d.getErr() != nil { + if !ok { break } + if d.getErr() != nil { + // Drain the channel if there is an error, to prevent deadlocking + // of download producer. + continue + } if err := d.downloadChunk(chunk); err != nil { d.setErr(err) - break } } } @@ -354,7 +358,7 @@ func (d *downloader) setTotalBytes(resp *s3.GetObjectOutput) { } if resp.ContentRange == nil { - // ContentRange is nil when the full file contents is provied, and + // ContentRange is nil when the full file contents is provided, and // is not chunked. Use ContentLength instead. if resp.ContentLength != nil { d.totalBytes = *resp.ContentLength diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download_test.go b/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download_test.go index 8159854e..f272c492 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/download_test.go @@ -11,6 +11,7 @@ import ( "strings" "sync" "testing" + "time" "github.com/stretchr/testify/assert" @@ -434,6 +435,63 @@ func TestDownloadWithContextCanceled(t *testing.T) { } } +func TestDownload_WithFailure(t *testing.T) { + svc := s3.New(unit.Session) + svc.Handlers.Send.Clear() + + first := true + svc.Handlers.Send.PushBack(func(r *request.Request) { + if first { + first = false + body := bytes.NewReader(make([]byte, s3manager.DefaultDownloadPartSize)) + r.HTTPResponse = &http.Response{ + StatusCode: http.StatusOK, + Status: http.StatusText(http.StatusOK), + ContentLength: int64(body.Len()), + Body: ioutil.NopCloser(body), + Header: http.Header{}, + } + r.HTTPResponse.Header.Set("Content-Length", strconv.Itoa(body.Len())) + r.HTTPResponse.Header.Set("Content-Range", + fmt.Sprintf("bytes 0-%d/%d", body.Len()-1, body.Len()*10)) + return + } + + // Give a chance for the multipart chunks to be queued up + time.Sleep(1 * time.Second) + + r.HTTPResponse = &http.Response{ + Header: http.Header{}, + Body: ioutil.NopCloser(&bytes.Buffer{}), + } + r.Error = awserr.New("ConnectionError", "some connection error", nil) + r.Retryable = aws.Bool(false) + }) + + start := time.Now() + d := s3manager.NewDownloaderWithClient(svc, func(d *s3manager.Downloader) { + d.Concurrency = 2 + }) + + w := &aws.WriteAtBuffer{} + params := s3.GetObjectInput{ + Bucket: aws.String("Bucket"), + Key: aws.String("Key"), + } + + // Expect this request to exit quickly after failure + _, err := d.Download(w, ¶ms) + if err == nil { + t.Fatalf("expect error, got none") + } + + limit := start.Add(5 * time.Second) + dur := time.Now().Sub(start) + if time.Now().After(limit) { + t.Errorf("expect time to be less than %v, took %v", limit, dur) + } +} + type testErrReader struct { Buf []byte Err error diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/upload.go b/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/upload.go index 0f9c57ed..cec171f0 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/upload.go +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/s3manager/upload.go @@ -215,7 +215,7 @@ func WithUploaderRequestOptions(opts ...request.Option) func(*Uploader) { type Uploader struct { // The buffer size (in bytes) to use when buffering data into chunks and // sending them as parts to S3. The minimum allowed part size is 5MB, and - // if this value is set to zero, the DefaultPartSize value will be used. + // if this value is set to zero, the DefaultUploadPartSize value will be used. PartSize int64 // The number of goroutines to spin up in parallel when sending parts. diff --git a/vendor/github.com/aws/aws-sdk-go/service/s3/service.go b/vendor/github.com/aws/aws-sdk-go/service/s3/service.go index 3fb5b3be..614e477d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/s3/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/s3/service.go @@ -11,10 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restxml" ) -// S3 is a client for Amazon S3. -// 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/s3-2006-03-01 +// S3 provides the API operation methods for making requests to +// Amazon Simple Storage Service. See this package's package overview docs +// for details on the service. +// +// S3 methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type S3 struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/api.go b/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/api.go index 75707e17..01811da4 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package servicecatalog provides a client for AWS Service Catalog. package servicecatalog import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/doc.go b/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/doc.go new file mode 100644 index 00000000..ac6f587f --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/doc.go @@ -0,0 +1,92 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package servicecatalog provides the client and types for making API +// requests to AWS Service Catalog. +// +// Overview +// +// AWS Service Catalog (https://aws.amazon.com/servicecatalog/) allows organizations +// to create and manage catalogs of IT services that are approved for use on +// AWS. This documentation provides reference material for the AWS Service Catalog +// end user API. To get the most out of this documentation, you need to be familiar +// with the terminology discussed in AWS Service Catalog Concepts (http://docs.aws.amazon.com/servicecatalog/latest/userguide/what-is_concepts.html). +// +// Additional Resources +// +// * AWS Service Catalog Administrator Guide (http://docs.aws.amazon.com/servicecatalog/latest/adminguide/introduction.html) +// +// * AWS Service Catalog User Guide (http://docs.aws.amazon.com/servicecatalog/latest/userguide/introduction.html) +// +// See https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10 for more information on this service. +// +// See servicecatalog package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/servicecatalog/ +// +// Using the Client +// +// To use the client for AWS Service Catalog 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 := servicecatalog.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 Service Catalog client ServiceCatalog for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/servicecatalog/#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.AcceptPortfolioShare(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("AcceptPortfolioShare 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.AcceptPortfolioShareWithContext(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 servicecatalog diff --git a/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/service.go b/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/service.go index 210c8400..05ced0ca 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/servicecatalog/service.go @@ -11,22 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Overview +// ServiceCatalog provides the API operation methods for making requests to +// AWS Service Catalog. See this package's package overview docs +// for details on the service. // -// AWS Service Catalog (https://aws.amazon.com/servicecatalog/) allows organizations -// to create and manage catalogs of IT services that are approved for use on -// AWS. This documentation provides reference material for the AWS Service Catalog -// end user API. To get the most out of this documentation, you need to be familiar -// with the terminology discussed in AWS Service Catalog Concepts (http://docs.aws.amazon.com/servicecatalog/latest/userguide/what-is_concepts.html). -// -// Additional Resources -// -// * AWS Service Catalog Administrator Guide (http://docs.aws.amazon.com/servicecatalog/latest/adminguide/introduction.html) -// -// * AWS Service Catalog User Guide (http://docs.aws.amazon.com/servicecatalog/latest/userguide/introduction.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/servicecatalog-2015-12-10 +// ServiceCatalog methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type ServiceCatalog struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/ses/api.go b/vendor/github.com/aws/aws-sdk-go/service/ses/api.go index 30156443..80e738dd 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ses/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ses/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package ses provides a client for Amazon Simple Email Service. package ses import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/ses/doc.go b/vendor/github.com/aws/aws-sdk-go/service/ses/doc.go new file mode 100644 index 00000000..21c30ecb --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/ses/doc.go @@ -0,0 +1,86 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package ses provides the client and types for making API +// requests to Amazon Simple Email Service. +// +// This is the API Reference for Amazon Simple Email Service (Amazon SES). This +// documentation is intended to be used in conjunction with the Amazon SES Developer +// Guide (http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html). +// +// For a list of Amazon SES endpoints to use in service requests, see Regions +// and Amazon SES (http://docs.aws.amazon.com/ses/latest/DeveloperGuide/regions.html) +// in the Amazon SES Developer Guide. +// +// See https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01 for more information on this service. +// +// See ses package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/ses/ +// +// Using the Client +// +// To use the client for Amazon Simple Email 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 := ses.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 Simple Email Service client SES for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/ses/#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.CloneReceiptRuleSet(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("CloneReceiptRuleSet 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.CloneReceiptRuleSetWithContext(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 ses diff --git a/vendor/github.com/aws/aws-sdk-go/service/ses/service.go b/vendor/github.com/aws/aws-sdk-go/service/ses/service.go index 25b20e06..b0788930 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ses/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ses/service.go @@ -11,16 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// This is the API Reference for Amazon Simple Email Service (Amazon SES). This -// documentation is intended to be used in conjunction with the Amazon SES Developer -// Guide (http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html). +// SES provides the API operation methods for making requests to +// Amazon Simple Email Service. See this package's package overview docs +// for details on the service. // -// For a list of Amazon SES endpoints to use in service requests, see Regions -// and Amazon SES (http://docs.aws.amazon.com/ses/latest/DeveloperGuide/regions.html) -// in the Amazon SES 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/email-2010-12-01 +// SES methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SES struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/sfn/api.go b/vendor/github.com/aws/aws-sdk-go/service/sfn/api.go index 701c3fbf..57f44237 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sfn/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sfn/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package sfn provides a client for AWS Step Functions. package sfn import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/sfn/doc.go b/vendor/github.com/aws/aws-sdk-go/service/sfn/doc.go new file mode 100644 index 00000000..09e2ce50 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/sfn/doc.go @@ -0,0 +1,95 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package sfn provides the client and types for making API +// requests to AWS Step Functions. +// +// AWS Step Functions is a web service that enables you to coordinate the components +// of distributed applications and microservices using visual workflows. You +// build applications from individual components that each perform a discrete +// function, or task, allowing you to scale and change applications quickly. +// Step Functions provides a graphical console to visualize the components of +// your application as a series of steps. It automatically triggers and tracks +// each step, and retries when there are errors, so your application executes +// in order and as expected, every time. Step Functions logs the state of each +// step, so when things do go wrong, you can diagnose and debug problems quickly. +// +// Step Functions manages the operations and underlying infrastructure for you +// to ensure your application is available at any scale. You can run tasks on +// the AWS cloud, on your own servers, or an any system that has access to AWS. +// Step Functions can be accessed and used with the Step Functions console, +// the AWS SDKs (included with your Beta release invitation email), or an HTTP +// API (the subject of this document). +// +// See https://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23 for more information on this service. +// +// See sfn package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sfn/ +// +// Using the Client +// +// To use the client for AWS Step Functions 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 := sfn.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 Step Functions client SFN for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sfn/#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.CreateActivity(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("CreateActivity 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.CreateActivityWithContext(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 sfn diff --git a/vendor/github.com/aws/aws-sdk-go/service/sfn/service.go b/vendor/github.com/aws/aws-sdk-go/service/sfn/service.go index 4ac61d37..f9d12a58 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sfn/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sfn/service.go @@ -11,25 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Step Functions is a web service that enables you to coordinate the components -// of distributed applications and microservices using visual workflows. You -// build applications from individual components that each perform a discrete -// function, or task, allowing you to scale and change applications quickly. -// Step Functions provides a graphical console to visualize the components of -// your application as a series of steps. It automatically triggers and tracks -// each step, and retries when there are errors, so your application executes -// in order and as expected, every time. Step Functions logs the state of each -// step, so when things do go wrong, you can diagnose and debug problems quickly. +// SFN provides the API operation methods for making requests to +// AWS Step Functions. See this package's package overview docs +// for details on the service. // -// Step Functions manages the operations and underlying infrastructure for you -// to ensure your application is available at any scale. You can run tasks on -// the AWS cloud, on your own servers, or an any system that has access to AWS. -// Step Functions can be accessed and used with the Step Functions console, -// the AWS SDKs (included with your Beta release invitation email), or an HTTP -// API (the subject of this document). -// 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/states-2016-11-23 +// SFN methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SFN struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/shield/api.go b/vendor/github.com/aws/aws-sdk-go/service/shield/api.go index 6fa2d100..f25fe189 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/shield/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/shield/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package shield provides a client for AWS Shield. package shield import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/shield/doc.go b/vendor/github.com/aws/aws-sdk-go/service/shield/doc.go new file mode 100644 index 00000000..056acf69 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/shield/doc.go @@ -0,0 +1,84 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package shield provides the client and types for making API +// requests to AWS Shield. +// +// This is the AWS Shield Advanced API Reference. This guide is for developers +// who need detailed information about the AWS Shield Advanced API actions, +// data types, and errors. For detailed information about AWS WAF and AWS Shield +// Advanced features and an overview of how to use the AWS WAF and AWS Shield +// Advanced APIs, see the AWS WAF and AWS Shield Developer Guide (http://docs.aws.amazon.com/waf/latest/developerguide/). +// +// See https://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02 for more information on this service. +// +// See shield package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/shield/ +// +// Using the Client +// +// To use the client for AWS Shield 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 := shield.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 Shield client Shield for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/shield/#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.CreateProtection(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("CreateProtection 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.CreateProtectionWithContext(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 shield diff --git a/vendor/github.com/aws/aws-sdk-go/service/shield/service.go b/vendor/github.com/aws/aws-sdk-go/service/shield/service.go index 6bc05d2c..31680396 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/shield/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/shield/service.go @@ -11,14 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This is the AWS Shield Advanced API Reference. This guide is for developers -// who need detailed information about the AWS Shield Advanced API actions, -// data types, and errors. For detailed information about AWS WAF and AWS Shield -// Advanced features and an overview of how to use the AWS WAF and AWS Shield -// Advanced APIs, see the AWS WAF and AWS Shield Developer Guide (http://docs.aws.amazon.com/waf/latest/developerguide/). -// 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/shield-2016-06-02 +// Shield provides the API operation methods for making requests to +// AWS Shield. See this package's package overview docs +// for details on the service. +// +// Shield methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Shield struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/simpledb/api.go b/vendor/github.com/aws/aws-sdk-go/service/simpledb/api.go index 1a40436d..9bc84823 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/simpledb/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/simpledb/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package simpledb provides a client for Amazon SimpleDB. package simpledb import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/simpledb/doc.go b/vendor/github.com/aws/aws-sdk-go/service/simpledb/doc.go new file mode 100644 index 00000000..cb06efc4 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/simpledb/doc.go @@ -0,0 +1,92 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package simpledb provides the client and types for making API +// requests to Amazon SimpleDB. +// +// Amazon SimpleDB is a web service providing the core database functions of +// data indexing and querying in the cloud. By offloading the time and effort +// associated with building and operating a web-scale database, SimpleDB provides +// developers the freedom to focus on application development. A traditional, +// clustered relational database requires a sizable upfront capital outlay, +// is complex to design, and often requires extensive and repetitive database +// administration. Amazon SimpleDB is dramatically simpler, requiring no schema, +// automatically indexing your data and providing a simple API for storage and +// access. This approach eliminates the administrative burden of data modeling, +// index maintenance, and performance tuning. Developers gain access to this +// functionality within Amazon's proven computing environment, are able to scale +// instantly, and pay only for what they use. +// +// Visit http://aws.amazon.com/simpledb/ (http://aws.amazon.com/simpledb/) for +// more information. +// +// See simpledb package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/simpledb/ +// +// Using the Client +// +// To use the client for Amazon SimpleDB 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 := simpledb.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 SimpleDB client SimpleDB for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/simpledb/#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.BatchDeleteAttributes(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("BatchDeleteAttributes 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.BatchDeleteAttributesWithContext(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 simpledb diff --git a/vendor/github.com/aws/aws-sdk-go/service/simpledb/service.go b/vendor/github.com/aws/aws-sdk-go/service/simpledb/service.go index f2bbf6af..fb3a0e3c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/simpledb/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/simpledb/service.go @@ -12,23 +12,12 @@ import ( "github.com/aws/aws-sdk-go/private/signer/v2" ) -// Amazon SimpleDB is a web service providing the core database functions of -// data indexing and querying in the cloud. By offloading the time and effort -// associated with building and operating a web-scale database, SimpleDB provides -// developers the freedom to focus on application development. A traditional, -// clustered relational database requires a sizable upfront capital outlay, -// is complex to design, and often requires extensive and repetitive database -// administration. Amazon SimpleDB is dramatically simpler, requiring no schema, -// automatically indexing your data and providing a simple API for storage and -// access. This approach eliminates the administrative burden of data modeling, -// index maintenance, and performance tuning. Developers gain access to this -// functionality within Amazon's proven computing environment, are able to scale -// instantly, and pay only for what they use. +// SimpleDB provides the API operation methods for making requests to +// Amazon SimpleDB. See this package's package overview docs +// for details on the service. // -// Visit http://aws.amazon.com/simpledb/ (http://aws.amazon.com/simpledb/) for -// more information. -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// SimpleDB methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SimpleDB struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/sms/api.go b/vendor/github.com/aws/aws-sdk-go/service/sms/api.go index 658938c1..e8269f58 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sms/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sms/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package sms provides a client for AWS Server Migration Service. package sms import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/sms/doc.go b/vendor/github.com/aws/aws-sdk-go/service/sms/doc.go new file mode 100644 index 00000000..b5cb2cb9 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/sms/doc.go @@ -0,0 +1,81 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package sms provides the client and types for making API +// requests to AWS Server Migration Service. +// +// Amazon Server Migration Service automates the process of migrating servers +// to EC2. +// +// See https://docs.aws.amazon.com/goto/WebAPI/sms-2016-10-24 for more information on this service. +// +// See sms package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sms/ +// +// Using the Client +// +// To use the client for AWS Server 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 := sms.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 Server Migration Service client SMS for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sms/#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.CreateReplicationJob(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("CreateReplicationJob 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.CreateReplicationJobWithContext(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 sms diff --git a/vendor/github.com/aws/aws-sdk-go/service/sms/service.go b/vendor/github.com/aws/aws-sdk-go/service/sms/service.go index 37feda2a..f7e192ca 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sms/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sms/service.go @@ -11,11 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon Server Migration Service automates the process of migrating servers -// to EC2. -// 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/sms-2016-10-24 +// SMS provides the API operation methods for making requests to +// AWS Server Migration Service. See this package's package overview docs +// for details on the service. +// +// SMS methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SMS struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/snowball/api.go b/vendor/github.com/aws/aws-sdk-go/service/snowball/api.go index 7958568f..25fc0053 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/snowball/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/snowball/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package snowball provides a client for Amazon Import/Export Snowball. package snowball import ( @@ -240,11 +239,10 @@ func (c *Snowball) CreateAddressRequest(input *CreateAddressInput) (req *request // CreateAddress API operation for Amazon Import/Export Snowball. // -// Creates an address for a Snowball to be shipped to. -// -// Addresses are validated at the time of creation. The address you provide -// must be located within the serviceable area of your region. If the address -// is invalid or unsupported, then an exception is thrown. +// Creates an address for a Snowball to be shipped to. In most regions, addresses +// are validated at the time of creation. The address you provide must be located +// within the serviceable area of your region. If the address is invalid or +// unsupported, then an exception is thrown. // // 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 @@ -426,7 +424,7 @@ func (c *Snowball) CreateJobRequest(input *CreateJobInput) (req *request.Request // data center. Your AWS account must have the right trust policies and permissions // in place to create a job for Snowball. If you're creating a job for a node // in a cluster, you only need to provide the clusterId value; the other job -// attributes are inherited from the cluster. . +// attributes are inherited from the cluster. // // 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 @@ -626,6 +624,10 @@ func (c *Snowball) DescribeAddressesRequest(input *DescribeAddressesInput) (req // The specified resource can't be found. Check the information you provided // in your last request, and try again. // +// * ErrCodeInvalidNextTokenException "InvalidNextTokenException" +// The NextToken string was altered unexpectedly, and the operation has stopped. +// Run the operation without changing the NextToken string, and try again. +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/snowball-2016-06-30/DescribeAddresses func (c *Snowball) DescribeAddresses(input *DescribeAddressesInput) (*DescribeAddressesOutput, error) { req, out := c.DescribeAddressesRequest(input) @@ -826,7 +828,7 @@ func (c *Snowball) DescribeJobRequest(input *DescribeJobInput) (req *request.Req // DescribeJob API operation for Amazon Import/Export Snowball. // // Returns information about a specific job including shipping information, -// job status, and other important metadata. . +// job status, and other important metadata. // // 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 @@ -1201,6 +1203,10 @@ func (c *Snowball) ListClusterJobsRequest(input *ListClusterJobsInput) (req *req // The specified resource can't be found. Check the information you provided // in your last request, and try again. // +// * ErrCodeInvalidNextTokenException "InvalidNextTokenException" +// The NextToken string was altered unexpectedly, and the operation has stopped. +// Run the operation without changing the NextToken string, and try again. +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/snowball-2016-06-30/ListClusterJobs func (c *Snowball) ListClusterJobs(input *ListClusterJobsInput) (*ListClusterJobsOutput, error) { req, out := c.ListClusterJobsRequest(input) @@ -1278,6 +1284,12 @@ func (c *Snowball) ListClustersRequest(input *ListClustersInput) (req *request.R // // See the AWS API reference guide for Amazon Import/Export Snowball's // API operation ListClusters for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidNextTokenException "InvalidNextTokenException" +// The NextToken string was altered unexpectedly, and the operation has stopped. +// Run the operation without changing the NextToken string, and try again. +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/snowball-2016-06-30/ListClusters func (c *Snowball) ListClusters(input *ListClustersInput) (*ListClustersOutput, error) { req, out := c.ListClustersRequest(input) @@ -1363,6 +1375,12 @@ func (c *Snowball) ListJobsRequest(input *ListJobsInput) (req *request.Request, // // See the AWS API reference guide for Amazon Import/Export Snowball's // API operation ListJobs for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidNextTokenException "InvalidNextTokenException" +// The NextToken string was altered unexpectedly, and the operation has stopped. +// Run the operation without changing the NextToken string, and try again. +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/snowball-2016-06-30/ListJobs func (c *Snowball) ListJobs(input *ListJobsInput) (*ListJobsOutput, error) { req, out := c.ListJobsRequest(input) @@ -1655,7 +1673,11 @@ type Address struct { // The country in an address that a Snowball is to be delivered to. Country *string `min:"1" type:"string"` - // The landmark identifying the address that the appliance will be shipped to. + // If the address you are creating is a primary address, then set this option + // to true. This field is not supported in most regions. + IsRestricted *bool `type:"boolean"` + + // This field is no longer used and the value is ignored. Landmark *string `min:"1" type:"string"` // The name of a person to receive a Snowball at an address. @@ -1668,7 +1690,7 @@ type Address struct { // The postal code in an address that a Snowball is to be delivered to. PostalCode *string `min:"1" type:"string"` - // The prefecture or district that the appliance will be shipped to. + // This field is no longer used and the value is ignored. PrefectureOrDistrict *string `min:"1" type:"string"` // The state or province in an address that a Snowball is to be delivered to. @@ -1767,6 +1789,12 @@ func (s *Address) SetCountry(v string) *Address { return s } +// SetIsRestricted sets the IsRestricted field's value. +func (s *Address) SetIsRestricted(v bool) *Address { + s.IsRestricted = &v + return s +} + // SetLandmark sets the Landmark field's value. func (s *Address) SetLandmark(v string) *Address { s.Landmark = &v @@ -2011,6 +2039,10 @@ type ClusterMetadata struct { // The optional description of the cluster. Description *string `min:"1" type:"string"` + // The ID of the address that you want a cluster shipped to, after it will be + // shipped to its primary address. This field is not supported in most regions. + ForwardingAddressId *string `min:"40" type:"string"` + // The type of job for this cluster. Currently, the only job type supported // for clusters is LOCAL_USE. JobType *string `type:"string" enum:"JobType"` @@ -2096,6 +2128,12 @@ func (s *ClusterMetadata) SetDescription(v string) *ClusterMetadata { return s } +// SetForwardingAddressId sets the ForwardingAddressId field's value. +func (s *ClusterMetadata) SetForwardingAddressId(v string) *ClusterMetadata { + s.ForwardingAddressId = &v + return s +} + // SetJobType sets the JobType field's value. func (s *ClusterMetadata) SetJobType(v string) *ClusterMetadata { s.JobType = &v @@ -2221,6 +2259,10 @@ type CreateClusterInput struct { // Data Cluster-01. Description *string `min:"1" type:"string"` + // The forwarding address ID for a cluster. This field is not supported in most + // regions. + ForwardingAddressId *string `min:"40" type:"string"` + // The type of job for this cluster. Currently, the only job type supported // for clusters is LOCAL_USE. // @@ -2296,6 +2338,9 @@ func (s *CreateClusterInput) Validate() error { if s.Description != nil && len(*s.Description) < 1 { invalidParams.Add(request.NewErrParamMinLen("Description", 1)) } + if s.ForwardingAddressId != nil && len(*s.ForwardingAddressId) < 40 { + invalidParams.Add(request.NewErrParamMinLen("ForwardingAddressId", 40)) + } if s.JobType == nil { invalidParams.Add(request.NewErrParamRequired("JobType")) } @@ -2332,6 +2377,12 @@ func (s *CreateClusterInput) SetDescription(v string) *CreateClusterInput { return s } +// SetForwardingAddressId sets the ForwardingAddressId field's value. +func (s *CreateClusterInput) SetForwardingAddressId(v string) *CreateClusterInput { + s.ForwardingAddressId = &v + return s +} + // SetJobType sets the JobType field's value. func (s *CreateClusterInput) SetJobType(v string) *CreateClusterInput { s.JobType = &v @@ -2414,6 +2465,10 @@ type CreateJobInput struct { // Photos 2016-08-11. Description *string `min:"1" type:"string"` + // The forwarding address ID for a job. This field is not supported in most + // regions. + ForwardingAddressId *string `min:"40" type:"string"` + // Defines the type of job that you're creating. JobType *string `type:"string" enum:"JobType"` @@ -2492,6 +2547,9 @@ func (s *CreateJobInput) Validate() error { if s.Description != nil && len(*s.Description) < 1 { invalidParams.Add(request.NewErrParamMinLen("Description", 1)) } + if s.ForwardingAddressId != nil && len(*s.ForwardingAddressId) < 40 { + invalidParams.Add(request.NewErrParamMinLen("ForwardingAddressId", 40)) + } if s.Resources != nil { if err := s.Resources.Validate(); err != nil { invalidParams.AddNested("Resources", err.(request.ErrInvalidParams)) @@ -2522,6 +2580,12 @@ func (s *CreateJobInput) SetDescription(v string) *CreateJobInput { return s } +// SetForwardingAddressId sets the ForwardingAddressId field's value. +func (s *CreateJobInput) SetForwardingAddressId(v string) *CreateJobInput { + s.ForwardingAddressId = &v + return s +} + // SetJobType sets the JobType field's value. func (s *CreateJobInput) SetJobType(v string) *CreateJobInput { s.JobType = &v @@ -3329,6 +3393,10 @@ type JobMetadata struct { // The description of the job, provided at job creation. Description *string `min:"1" type:"string"` + // The ID of the address that you want a job shipped to, after it will be shipped + // to its primary address. This field is not supported in most regions. + ForwardingAddressId *string `min:"40" type:"string"` + // The automatically generated ID for a job, for example JID123e4567-e89b-12d3-a456-426655440000. JobId *string `min:"1" type:"string"` @@ -3345,8 +3413,8 @@ type JobMetadata struct { JobType *string `type:"string" enum:"JobType"` // The Amazon Resource Name (ARN) for the AWS Key Management Service (AWS KMS) - // key associated with this job. This ARN was created using the CreateKey API - // action in AWS KMS. + // key associated with this job. This ARN was created using the CreateKey (http://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html) + // API action in AWS KMS. KmsKeyARN *string `type:"string"` // The Amazon Simple Notification Service (Amazon SNS) notification settings @@ -3360,6 +3428,7 @@ type JobMetadata struct { Resources *JobResource `type:"structure"` // The role ARN associated with this job. This ARN was created using the CreateRole + // (http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) // API action in AWS Identity and Access Management (IAM). RoleARN *string `type:"string"` @@ -3416,6 +3485,12 @@ func (s *JobMetadata) SetDescription(v string) *JobMetadata { return s } +// SetForwardingAddressId sets the ForwardingAddressId field's value. +func (s *JobMetadata) SetForwardingAddressId(v string) *JobMetadata { + s.ForwardingAddressId = &v + return s +} + // SetJobId sets the JobId field's value. func (s *JobMetadata) SetJobId(v string) *JobMetadata { s.JobId = &v @@ -4016,8 +4091,7 @@ func (s *S3Resource) SetKeyRange(v *KeyRange) *S3Resource { type Shipment struct { _ struct{} `type:"structure"` - // Status information for a shipment. Valid statuses include NEW, IN_TRANSIT, - // and DELIVERED. + // Status information for a shipment. Status *string `min:"1" type:"string"` // The tracking number for this job. Using this tracking number with your region's @@ -4127,6 +4201,10 @@ type UpdateClusterInput struct { // The updated description of this cluster. Description *string `min:"1" type:"string"` + // The updated ID for the forwarding address for a cluster. This field is not + // supported in most regions. + ForwardingAddressId *string `min:"40" type:"string"` + // The new or updated Notification object. Notification *Notification `type:"structure"` @@ -4168,6 +4246,9 @@ func (s *UpdateClusterInput) Validate() error { if s.Description != nil && len(*s.Description) < 1 { invalidParams.Add(request.NewErrParamMinLen("Description", 1)) } + if s.ForwardingAddressId != nil && len(*s.ForwardingAddressId) < 40 { + invalidParams.Add(request.NewErrParamMinLen("ForwardingAddressId", 40)) + } if s.Resources != nil { if err := s.Resources.Validate(); err != nil { invalidParams.AddNested("Resources", err.(request.ErrInvalidParams)) @@ -4198,6 +4279,12 @@ func (s *UpdateClusterInput) SetDescription(v string) *UpdateClusterInput { return s } +// SetForwardingAddressId sets the ForwardingAddressId field's value. +func (s *UpdateClusterInput) SetForwardingAddressId(v string) *UpdateClusterInput { + s.ForwardingAddressId = &v + return s +} + // SetNotification sets the Notification field's value. func (s *UpdateClusterInput) SetNotification(v *Notification) *UpdateClusterInput { s.Notification = v @@ -4247,6 +4334,10 @@ type UpdateJobInput struct { // The updated description of this job's JobMetadata object. Description *string `min:"1" type:"string"` + // The updated ID for the forwarding address for a job. This field is not supported + // in most regions. + ForwardingAddressId *string `min:"40" type:"string"` + // The job ID of the job that you want to update, for example JID123e4567-e89b-12d3-a456-426655440000. // // JobId is a required field @@ -4260,8 +4351,8 @@ type UpdateJobInput struct { Resources *JobResource `type:"structure"` // The new role Amazon Resource Name (ARN) that you want to associate with this - // job. To create a role ARN, use the CreateRole (http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) - // AWS Identity and Access Management (IAM) API action. + // job. To create a role ARN, use the CreateRole (http://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)AWS + // Identity and Access Management (IAM) API action. RoleARN *string `type:"string"` // The updated shipping option value of this job's ShippingDetails object. @@ -4291,6 +4382,9 @@ func (s *UpdateJobInput) Validate() error { if s.Description != nil && len(*s.Description) < 1 { invalidParams.Add(request.NewErrParamMinLen("Description", 1)) } + if s.ForwardingAddressId != nil && len(*s.ForwardingAddressId) < 40 { + invalidParams.Add(request.NewErrParamMinLen("ForwardingAddressId", 40)) + } if s.JobId == nil { invalidParams.Add(request.NewErrParamRequired("JobId")) } @@ -4321,6 +4415,12 @@ func (s *UpdateJobInput) SetDescription(v string) *UpdateJobInput { return s } +// SetForwardingAddressId sets the ForwardingAddressId field's value. +func (s *UpdateJobInput) SetForwardingAddressId(v string) *UpdateJobInput { + s.ForwardingAddressId = &v + return s +} + // SetJobId sets the JobId field's value. func (s *UpdateJobInput) SetJobId(v string) *UpdateJobInput { s.JobId = &v diff --git a/vendor/github.com/aws/aws-sdk-go/service/snowball/doc.go b/vendor/github.com/aws/aws-sdk-go/service/snowball/doc.go new file mode 100644 index 00000000..c6765ec8 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/snowball/doc.go @@ -0,0 +1,87 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package snowball provides the client and types for making API +// requests to Amazon Import/Export Snowball. +// +// AWS Snowball is a petabyte-scale data transport solution that uses secure +// appliances to transfer large amounts of data between your on-premises data +// centers and Amazon Simple Storage Service (Amazon S3). The Snowball commands +// described here provide access to the same functionality that is available +// in the AWS Snowball Management Console, which enables you to create and manage +// jobs for Snowball. To transfer data locally with a Snowball appliance, you'll +// need to use the Snowball client or the Amazon S3 API adapter for Snowball. +// For more information, see the User Guide (http://docs.aws.amazon.com/AWSImportExport/latest/ug/api-reference.html). +// +// See https://docs.aws.amazon.com/goto/WebAPI/snowball-2016-06-30 for more information on this service. +// +// See snowball package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/snowball/ +// +// Using the Client +// +// To use the client for Amazon Import/Export Snowball 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 := snowball.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 Import/Export Snowball client Snowball for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/snowball/#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.CancelCluster(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("CancelCluster 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.CancelClusterWithContext(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 snowball diff --git a/vendor/github.com/aws/aws-sdk-go/service/snowball/errors.go b/vendor/github.com/aws/aws-sdk-go/service/snowball/errors.go index 1026c800..fae2f40b 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/snowball/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/snowball/errors.go @@ -35,6 +35,13 @@ const ( // that action to be performed. ErrCodeInvalidJobStateException = "InvalidJobStateException" + // ErrCodeInvalidNextTokenException for service response error code + // "InvalidNextTokenException". + // + // The NextToken string was altered unexpectedly, and the operation has stopped. + // Run the operation without changing the NextToken string, and try again. + ErrCodeInvalidNextTokenException = "InvalidNextTokenException" + // ErrCodeInvalidResourceException for service response error code // "InvalidResourceException". // diff --git a/vendor/github.com/aws/aws-sdk-go/service/snowball/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/snowball/examples_test.go index d7f5d604..a2e7c3a5 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/snowball/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/snowball/examples_test.go @@ -68,6 +68,7 @@ func ExampleSnowball_CreateAddress() { City: aws.String("String"), Company: aws.String("String"), Country: aws.String("String"), + IsRestricted: aws.Bool(true), Landmark: aws.String("String"), Name: aws.String("String"), PhoneNumber: aws.String("String"), @@ -124,10 +125,11 @@ func ExampleSnowball_CreateCluster() { // More values... }, }, - RoleARN: aws.String("RoleARN"), // Required - ShippingOption: aws.String("ShippingOption"), // Required - Description: aws.String("String"), - KmsKeyARN: aws.String("KmsKeyARN"), + RoleARN: aws.String("RoleARN"), // Required + ShippingOption: aws.String("ShippingOption"), // Required + Description: aws.String("String"), + ForwardingAddressId: aws.String("AddressId"), + KmsKeyARN: aws.String("KmsKeyARN"), Notification: &snowball.Notification{ JobStatesToNotify: []*string{ aws.String("JobState"), // Required @@ -157,11 +159,12 @@ func ExampleSnowball_CreateJob() { svc := snowball.New(sess) params := &snowball.CreateJobInput{ - AddressId: aws.String("AddressId"), - ClusterId: aws.String("ClusterId"), - Description: aws.String("String"), - JobType: aws.String("JobType"), - KmsKeyARN: aws.String("KmsKeyARN"), + AddressId: aws.String("AddressId"), + ClusterId: aws.String("ClusterId"), + Description: aws.String("String"), + ForwardingAddressId: aws.String("AddressId"), + JobType: aws.String("JobType"), + KmsKeyARN: aws.String("KmsKeyARN"), Notification: &snowball.Notification{ JobStatesToNotify: []*string{ aws.String("JobState"), // Required @@ -431,9 +434,10 @@ func ExampleSnowball_UpdateCluster() { svc := snowball.New(sess) params := &snowball.UpdateClusterInput{ - ClusterId: aws.String("ClusterId"), // Required - AddressId: aws.String("AddressId"), - Description: aws.String("String"), + ClusterId: aws.String("ClusterId"), // Required + AddressId: aws.String("AddressId"), + Description: aws.String("String"), + ForwardingAddressId: aws.String("AddressId"), Notification: &snowball.Notification{ JobStatesToNotify: []*string{ aws.String("JobState"), // Required @@ -488,9 +492,10 @@ func ExampleSnowball_UpdateJob() { svc := snowball.New(sess) params := &snowball.UpdateJobInput{ - JobId: aws.String("JobId"), // Required - AddressId: aws.String("AddressId"), - Description: aws.String("String"), + JobId: aws.String("JobId"), // Required + AddressId: aws.String("AddressId"), + Description: aws.String("String"), + ForwardingAddressId: aws.String("AddressId"), Notification: &snowball.Notification{ JobStatesToNotify: []*string{ aws.String("JobState"), // Required diff --git a/vendor/github.com/aws/aws-sdk-go/service/snowball/service.go b/vendor/github.com/aws/aws-sdk-go/service/snowball/service.go index d4314acd..d037541b 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/snowball/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/snowball/service.go @@ -11,17 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Snowball is a petabyte-scale data transport solution that uses secure -// appliances to transfer large amounts of data between your on-premises data -// centers and Amazon Simple Storage Service (Amazon S3). The Snowball commands -// described here provide access to the same functionality that is available -// in the AWS Snowball Management Console, which enables you to create and manage -// jobs for Snowball. To transfer data locally with a Snowball appliance, you'll -// need to use the Snowball client or the Amazon S3 API adapter for Snowball. -// For more information, see the User Guide (http://docs.aws.amazon.com/AWSImportExport/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/snowball-2016-06-30 +// Snowball provides the API operation methods for making requests to +// Amazon Import/Export Snowball. See this package's package overview docs +// for details on the service. +// +// Snowball methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Snowball struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/sns/api.go b/vendor/github.com/aws/aws-sdk-go/service/sns/api.go index bec8fe5d..d5664abf 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sns/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sns/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package sns provides a client for Amazon Simple Notification Service. package sns import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/sns/doc.go b/vendor/github.com/aws/aws-sdk-go/service/sns/doc.go new file mode 100644 index 00000000..52461d3d --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/sns/doc.go @@ -0,0 +1,92 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package sns provides the client and types for making API +// requests to Amazon Simple Notification Service. +// +// Amazon Simple Notification Service (Amazon SNS) is a web service that enables +// you to build distributed web-enabled applications. Applications can use Amazon +// SNS to easily push real-time notification messages to interested subscribers +// over multiple delivery protocols. For more information about this product +// see http://aws.amazon.com/sns (http://aws.amazon.com/sns/). For detailed +// information about Amazon SNS features and their associated API calls, see +// the Amazon SNS Developer Guide (http://docs.aws.amazon.com/sns/latest/dg/). +// +// We also provide SDKs that enable you to access Amazon SNS from your preferred +// programming language. The SDKs contain functionality that automatically takes +// care of tasks such as: cryptographically signing your service requests, retrying +// requests, and handling error responses. For a list of available SDKs, go +// to Tools for Amazon Web Services (http://aws.amazon.com/tools/). +// +// See https://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31 for more information on this service. +// +// See sns package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sns/ +// +// Using the Client +// +// To use the client for Amazon Simple Notification 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 := sns.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 Simple Notification Service client SNS for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sns/#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.AddPermission(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("AddPermission 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.AddPermissionWithContext(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 sns diff --git a/vendor/github.com/aws/aws-sdk-go/service/sns/service.go b/vendor/github.com/aws/aws-sdk-go/service/sns/service.go index 8c735f5a..fb75ea60 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sns/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sns/service.go @@ -11,22 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// Amazon Simple Notification Service (Amazon SNS) is a web service that enables -// you to build distributed web-enabled applications. Applications can use Amazon -// SNS to easily push real-time notification messages to interested subscribers -// over multiple delivery protocols. For more information about this product -// see http://aws.amazon.com/sns (http://aws.amazon.com/sns/). For detailed -// information about Amazon SNS features and their associated API calls, see -// the Amazon SNS Developer Guide (http://docs.aws.amazon.com/sns/latest/dg/). +// SNS provides the API operation methods for making requests to +// Amazon Simple Notification Service. See this package's package overview docs +// for details on the service. // -// We also provide SDKs that enable you to access Amazon SNS from your preferred -// programming language. The SDKs contain functionality that automatically takes -// care of tasks such as: cryptographically signing your service requests, retrying -// requests, and handling error responses. For a list of available SDKs, go -// to 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/sns-2010-03-31 +// SNS methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SNS struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/sqs/api.go b/vendor/github.com/aws/aws-sdk-go/service/sqs/api.go index 3fea4687..97ba1631 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sqs/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sqs/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package sqs provides a client for Amazon Simple Queue Service. package sqs import ( @@ -387,9 +386,8 @@ func (c *SQS) CreateQueueRequest(input *CreateQueueInput) (req *request.Request, // CreateQueue API operation for Amazon Simple Queue Service. // -// Creates a new standard or FIFO queue or returns the URL of an existing queue. -// You can pass one or more attributes in the request. Keep the following caveats -// in mind: +// Creates a new standard or FIFO queue. You can pass one or more attributes +// in the request. Keep the following caveats in mind: // // * If you don't specify the FifoQueue attribute, Amazon SQS creates a standard // queue. @@ -529,7 +527,7 @@ func (c *SQS) DeleteMessageRequest(input *DeleteMessageInput) (req *request.Requ // DeleteMessage action, the request succeeds, but the message might not be // deleted. // -// For standard queues, it is possible to receive a message even after you deleting +// For standard queues, it is possible to receive a message even after you delete // it. This might happen on rare occasions if one of the servers storing a copy // of the message is unavailable when you send the request to delete the message. // The copy remains on the server and might be returned to you on a subsequent @@ -811,6 +809,9 @@ func (c *SQS) GetQueueAttributesRequest(input *GetQueueAttributesInput) (req *re // // Gets attributes for the specified queue. // +// To determine whether a queue is FIFO (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html), +// you can check whether QueueName ends with the .fifo suffix. +// // Some actions take lists of parameters. These lists are specified using the // param.n notation. Values of n are integers starting from 1. For example, // a parameter list with two elements looks like this: @@ -1259,7 +1260,7 @@ func (c *SQS) ReceiveMessageRequest(input *ReceiveMessageInput) (req *request.Re // // * The message body. // -// * An MD5 digest of the message body. For information on MD5, see RFC1321 +// * An MD5 digest of the message body. For information about MD5, see RFC1321 // (https://www.ietf.org/rfc/rfc1321.txt). // // * The MessageId you received when you sent the message to the queue. @@ -1451,24 +1452,13 @@ func (c *SQS) SendMessageRequest(input *SendMessageInput) (req *request.Request, // // Delivers a message to the specified queue. // -// The following list shows the characters (in Unicode) that are allowed in -// your message, according to the W3C XML specification: -// -// #x9 -// -// #xA -// -// #xD -// -// #x20 to #xD7FF +// A message can include only XML, JSON, and unformatted text. The following +// Unicode characters are allowed: // -// #xE000 to #xFFFD +// #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF // -// #x10000 to #x10FFFF -// -// For more information, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). -// If you send any characters that aren't included in this list, your request -// is rejected. +// Any characters not included in this list will be rejected. For more information, +// see the W3C specification for characters (http://www.w3.org/TR/REC-xml/#charsets). // // 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 @@ -1564,24 +1554,13 @@ func (c *SQS) SendMessageBatchRequest(input *SendMessageBatchInput) (req *reques // size (the sum of the individual lengths of all of the batched messages) are // both 256 KB (262,144 bytes). // -// The following list shows the characters (in Unicode) that are allowed in -// your message, according to the W3C XML specification: -// -// #x9 -// -// #xA -// -// #xD -// -// #x20 to #xD7FF +// A message can include only XML, JSON, and unformatted text. The following +// Unicode characters are allowed: // -// #xE000 to #xFFFD +// #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF // -// #x10000 to #x10FFFF -// -// For more information, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). -// If you send any characters that aren't included in this list, your request -// is rejected. +// Any characters not included in this list will be rejected. For more information, +// see the W3C specification for characters (http://www.w3.org/TR/REC-xml/#charsets). // // If you don't specify the DelaySeconds parameter for an entry, Amazon SQS // uses the default value for the queue. @@ -2220,26 +2199,26 @@ type CreateQueueInput struct { // The following lists the names, descriptions, and values of the special request // parameters that the CreateQueue action uses: // - // * DelaySeconds - The number of seconds for which the delivery of all messages - // in the queue is delayed. Valid values: An integer from 0 to 900 seconds - // (15 minutes). The default is 0 (zero). + // * DelaySeconds - The length of time, in seconds, for which the delivery + // of all messages in the queue is delayed. Valid values: An integer from + // 0 to 900 seconds (15 minutes). The default is 0 (zero). // // * MaximumMessageSize - The limit of how many bytes a message can contain // before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes // (1 KiB) to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB). // // - // * MessageRetentionPeriod - The number of seconds for which Amazon SQS - // retains a message. Valid values: An integer from 60 seconds (1 minute) + // * MessageRetentionPeriod - The length of time, in seconds, for which Amazon + // SQS retains a message. Valid values: An integer from 60 seconds (1 minute) // to 1,209,600 seconds (14 days). The default is 345,600 (4 days). // // * Policy - The queue's policy. A valid AWS policy. For more information // about policy structure, see Overview of AWS IAM Policies (http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html) // in the Amazon IAM User Guide. // - // * ReceiveMessageWaitTimeSeconds - The number of seconds for which a ReceiveMessage - // action waits for a message to arrive. Valid values: An integer from 0 - // to 20 (seconds). The default is 0 (zero). + // * ReceiveMessageWaitTimeSeconds - The length of time, in seconds, for + // which a ReceiveMessage action waits for a message to arrive. Valid values: + // An integer from 0 to 20 (seconds). The default is 0 (zero). // // * RedrivePolicy - The parameters for the dead letter queue functionality // of the source queue. For more information about the redrive policy and @@ -2254,17 +2233,38 @@ type CreateQueueInput struct { // about the visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html) // in the Amazon SQS Developer Guide. // + // The following attributes apply only to server-side-encryption (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html): + // + // * KmsMasterKeyId - The ID of an AWS-managed customer master key (CMK) + // for Amazon SQS or a custom CMK. For more information, see Key Terms (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms). + // While the alias of the AWS-managed CMK for Amazon SQS is always alias/aws/sqs, + // the alias of a custom CMK can, for example, be alias/aws/sqs. For more + // examples, see KeyId (http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters) + // in the AWS Key Management Service API Reference. + // + // * KmsDataKeyReusePeriodSeconds - The length of time, in seconds, for which + // Amazon SQS can reuse a data key (http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys) + // to encrypt or decrypt messages before calling AWS KMS again. An integer + // representing seconds, between 60 seconds (1 minute) and 86,400 seconds + // (24 hours). The default is 300 (5 minutes). A shorter time period provides + // better security but results in more calls to KMS which incur charges after + // Free Tier. For more information, see How Does the Data Key Reuse Period + // Work? (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work). + // + // // The following attributes apply only to FIFO (first-in-first-out) queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html): // - // * FifoQueue - Designates a queue as FIFO. You can provide this attribute - // only during queue creation. You can't change it for an existing queue. - // When you set this attribute, you must provide a MessageGroupId explicitly. + // * FifoQueue - Designates a queue as FIFO. Valid values: true, false. You + // can provide this attribute only during queue creation. You can't change + // it for an existing queue. When you set this attribute, you must also provide + // the MessageGroupId for your messages explicitly. // // For more information, see FIFO Queue Logic (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic) // in the Amazon SQS Developer Guide. // - // * ContentBasedDeduplication - Enables content-based deduplication. For - // more information, see Exactly-Once Processing (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing) + // * ContentBasedDeduplication - Enables content-based deduplication. Valid + // values: true, false. For more information, see Exactly-Once Processing + // (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing) // in the Amazon SQS Developer Guide. // // Every message must have a unique MessageDeduplicationId, @@ -2286,9 +2286,6 @@ type CreateQueueInput struct { // sent within the deduplication interval are treated as duplicates and only // one copy of the message is delivered. // - // You can also use ContentBasedDeduplication for messages with identical content - // to be treated as duplicates. - // // If you send one message with ContentBasedDeduplication enabled and then another // message with a MessageDeduplicationId that is the same as the one generated // for the first MessageDeduplicationId, the two messages are treated as @@ -2737,15 +2734,15 @@ type GetQueueAttributesInput struct { // * MaximumMessageSize - Returns the limit of how many bytes a message can // contain before Amazon SQS rejects it. // - // * MessageRetentionPeriod - Returns the number of seconds for which Amazon - // SQS retains a message. + // * MessageRetentionPeriod - Returns the length of time, in seconds, for + // which Amazon SQS retains a message. // // * Policy - Returns the policy of the queue. // // * QueueArn - Returns the Amazon resource name (ARN) of the queue. // - // * ReceiveMessageWaitTimeSeconds - Returns the number of seconds for which - // the ReceiveMessage action waits for a message to arrive. + // * ReceiveMessageWaitTimeSeconds - Returns the length of time, in seconds, + // for which the ReceiveMessage action waits for a message to arrive. // // * RedrivePolicy - Returns the parameters for dead letter queue functionality // of the source queue. For more information about the redrive policy and @@ -2757,12 +2754,26 @@ type GetQueueAttributesInput struct { // (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html) // in the Amazon SQS Developer Guide. // + // The following attributes apply only to server-side-encryption (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html): + // + // * KmsMasterKeyId - Returns the ID of an AWS-managed customer master key + // (CMK) for Amazon SQS or a custom CMK. For more information, see Key Terms + // (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms). + // + // + // * KmsDataKeyReusePeriodSeconds - Returns the length of time, in seconds, + // for which Amazon SQS can reuse a data key to encrypt or decrypt messages + // before calling AWS KMS again. + // // The following attributes apply only to FIFO (first-in-first-out) queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html): // // * FifoQueue - Returns whether the queue is FIFO. For more information, // see FIFO Queue Logic (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic) // in the Amazon SQS Developer Guide. // + // To determine whether a queue is FIFO (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html), + // you can check whether QueueName ends with the .fifo suffix. + // // * ContentBasedDeduplication - Returns whether content-based deduplication // is enabled for the queue. For more information, see Exactly-Once Processing // (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing) @@ -3055,7 +3066,7 @@ type Message struct { // An MD5 digest of the non-URL-encoded message attribute string. You can use // this attribute to verify that Amazon SQS received the message correctly. // Amazon SQS URL-decodes the message before creating the MD5 digest. For information - // on MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). + // about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). MD5OfMessageAttributes *string `type:"string"` // Each message attribute consists of a Name, Type, and Value. For more information, @@ -3710,10 +3721,10 @@ func (s *SendMessageBatchOutput) SetSuccessful(v []*SendMessageBatchResultEntry) type SendMessageBatchRequestEntry struct { _ struct{} `type:"structure"` - // The number of seconds for which a specific message is delayed. Valid values: - // 0 to 900. Maximum: 15 minutes. Messages with a positive DelaySeconds value - // become available for processing after the delay period is finished. If you - // don't specify a value, the default value for the queue is applied. + // The length of time, in seconds, for which a specific message is delayed. + // Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive DelaySeconds + // value become available for processing after the delay period is finished. + // If you don't specify a value, the default value for the queue is applied. // // When you set FifoQueue, you can't set DelaySeconds per message. You can set // this parameter only on a queue level. @@ -3764,9 +3775,6 @@ type SendMessageBatchRequestEntry struct { // content sent within the deduplication interval are treated as duplicates // and only one copy of the message is delivered. // - // * You can also use ContentBasedDeduplication for messages with identical - // content to be treated as duplicates. - // // * If you send one message with ContentBasedDeduplication enabled and then // another message with a MessageDeduplicationId that is the same as the // one generated for the first MessageDeduplicationId, the two messages are @@ -3810,6 +3818,9 @@ type SendMessageBatchRequestEntry struct { // For best practices of using MessageGroupId, see Using the MessageGroupId // Property (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property) // in the Amazon Simple Queue Service Developer Guide. + // + // MessageGroupId is required for FIFO queues. You can't use it for Standard + // queues. MessageGroupId *string `type:"string"` } @@ -3898,13 +3909,13 @@ type SendMessageBatchResultEntry struct { // An MD5 digest of the non-URL-encoded message attribute string. You can use // this attribute to verify that Amazon SQS received the message correctly. // Amazon SQS URL-decodes the message before creating the MD5 digest. For information - // on MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). + // about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). MD5OfMessageAttributes *string `type:"string"` // An MD5 digest of the non-URL-encoded message attribute string. You can use // this attribute to verify that Amazon SQS received the message correctly. // Amazon SQS URL-decodes the message before creating the MD5 digest. For information - // on MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). + // about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). // // MD5OfMessageBody is a required field MD5OfMessageBody *string `type:"string" required:"true"` @@ -3916,7 +3927,7 @@ type SendMessageBatchResultEntry struct { // This parameter applies only to FIFO (first-in-first-out) queues. // - // A large, non-consecutive number that Amazon SQS assigns to each message. + // The large, non-consecutive number that Amazon SQS assigns to each message. // // The length of SequenceNumber is 128 bits. As SequenceNumber continues to // increase for a particular MessageGroupId. @@ -3967,10 +3978,10 @@ func (s *SendMessageBatchResultEntry) SetSequenceNumber(v string) *SendMessageBa type SendMessageInput struct { _ struct{} `type:"structure"` - // The number of seconds to delay a specific message. Valid values: 0 to 900. - // Maximum: 15 minutes. Messages with a positive DelaySeconds value become available - // for processing after the delay period is finished. If you don't specify a - // value, the default value for the queue applies. + // The length of time, in seconds, for which to delay a specific message. Valid + // values: 0 to 900. Maximum: 15 minutes. Messages with a positive DelaySeconds + // value become available for processing after the delay period is finished. + // If you don't specify a value, the default value for the queue applies. // // When you set FifoQueue, you can't set DelaySeconds per message. You can set // this parameter only on a queue level. @@ -3983,24 +3994,13 @@ type SendMessageInput struct { // The message to send. The maximum string size is 256 KB. // - // The following list shows the characters (in Unicode) that are allowed in - // your message, according to the W3C XML specification: - // - // #x9 - // - // #xA - // - // #xD - // - // #x20 to #xD7FF + // A message can include only XML, JSON, and unformatted text. The following + // Unicode characters are allowed: // - // #xE000 to #xFFFD + // #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF // - // #x10000 to #x10FFFF - // - // For more information, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). - // If you send any characters that aren't included in this list, your request - // is rejected. + // Any characters not included in this list will be rejected. For more information, + // see the W3C specification for characters (http://www.w3.org/TR/REC-xml/#charsets). // // MessageBody is a required field MessageBody *string `type:"string" required:"true"` @@ -4033,9 +4033,6 @@ type SendMessageInput struct { // content sent within the deduplication interval are treated as duplicates // and only one copy of the message is delivered. // - // * You can also use ContentBasedDeduplication for messages with identical - // content to be treated as duplicates. - // // * If you send one message with ContentBasedDeduplication enabled and then // another message with a MessageDeduplicationId that is the same as the // one generated for the first MessageDeduplicationId, the two messages are @@ -4079,6 +4076,9 @@ type SendMessageInput struct { // For best practices of using MessageGroupId, see Using the MessageGroupId // Property (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property) // in the Amazon Simple Queue Service Developer Guide. + // + // MessageGroupId is required for FIFO queues. You can't use it for Standard + // queues. MessageGroupId *string `type:"string"` // The URL of the Amazon SQS queue to which a message is sent. @@ -4169,13 +4169,13 @@ type SendMessageOutput struct { // An MD5 digest of the non-URL-encoded message attribute string. You can use // this attribute to verify that Amazon SQS received the message correctly. // Amazon SQS URL-decodes the message before creating the MD5 digest. For information - // on MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). + // about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). MD5OfMessageAttributes *string `type:"string"` // An MD5 digest of the non-URL-encoded message attribute string. You can use // this attribute to verify that Amazon SQS received the message correctly. // Amazon SQS URL-decodes the message before creating the MD5 digest. For information - // on MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). + // about MD5, see RFC1321 (https://www.ietf.org/rfc/rfc1321.txt). MD5OfMessageBody *string `type:"string"` // An attribute containing the MessageId of the message sent to the queue. For @@ -4185,7 +4185,7 @@ type SendMessageOutput struct { // This parameter applies only to FIFO (first-in-first-out) queues. // - // A large, non-consecutive number that Amazon SQS assigns to each message. + // The large, non-consecutive number that Amazon SQS assigns to each message. // // The length of SequenceNumber is 128 bits. SequenceNumber continues to increase // for a particular MessageGroupId. @@ -4235,27 +4235,27 @@ type SetQueueAttributesInput struct { // The following lists the names, descriptions, and values of the special request // parameters that the SetQueueAttributes action uses: // - // * DelaySeconds - The number of seconds for which the delivery of all messages - // in the queue is delayed. Valid values: An integer from 0 to 900 (15 minutes). - // The default is 0 (zero). + // * DelaySeconds - The length of time, in seconds, for which the delivery + // of all messages in the queue is delayed. Valid values: An integer from + // 0 to 900 (15 minutes). The default is 0 (zero). // // * MaximumMessageSize - The limit of how many bytes a message can contain // before Amazon SQS rejects it. Valid values: An integer from 1,024 bytes // (1 KiB) up to 262,144 bytes (256 KiB). The default is 262,144 (256 KiB). // // - // * MessageRetentionPeriod - The number of seconds for which Amazon SQS - // retains a message. Valid values: An integer representing seconds, from - // 60 (1 minute) to 1,209,600 (14 days). The default is 345,600 (4 days). + // * MessageRetentionPeriod - The length of time, in seconds, for which Amazon + // SQS retains a message. Valid values: An integer representing seconds, + // from 60 (1 minute) to 1,209,600 (14 days). The default is 345,600 (4 days). // // // * Policy - The queue's policy. A valid AWS policy. For more information // about policy structure, see Overview of AWS IAM Policies (http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html) // in the Amazon IAM User Guide. // - // * ReceiveMessageWaitTimeSeconds - The number of seconds for which a ReceiveMessage - // action waits for a message to arrive. Valid values: an integer from 0 - // to 20 (seconds). The default is 0. + // * ReceiveMessageWaitTimeSeconds - The length of time, in seconds, for + // which a ReceiveMessage action waits for a message to arrive. Valid values: + // an integer from 0 to 20 (seconds). The default is 0. // // * RedrivePolicy - The parameters for the dead letter queue functionality // of the source queue. For more information about the redrive policy and @@ -4270,6 +4270,25 @@ type SetQueueAttributesInput struct { // about the visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html) // in the Amazon SQS Developer Guide. // + // The following attributes apply only to server-side-encryption (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html): + // + // * KmsMasterKeyId - The ID of an AWS-managed customer master key (CMK) + // for Amazon SQS or a custom CMK. For more information, see Key Terms (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms). + // While the alias of the AWS-managed CMK for Amazon SQS is always alias/aws/sqs, + // the alias of a custom CMK can, for example, be alias/aws/sqs. For more + // examples, see KeyId (http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters) + // in the AWS Key Management Service API Reference. + // + // * KmsDataKeyReusePeriodSeconds - The length of time, in seconds, for which + // Amazon SQS can reuse a data key (http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys) + // to encrypt or decrypt messages before calling AWS KMS again. An integer + // representing seconds, between 60 seconds (1 minute) and 86,400 seconds + // (24 hours). The default is 300 (5 minutes). A shorter time period provides + // better security but results in more calls to KMS which incur charges after + // Free Tier. For more information, see How Does the Data Key Reuse Period + // Work? (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work). + // + // // The following attribute applies only to FIFO (first-in-first-out) queues // (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html): // @@ -4296,9 +4315,6 @@ type SetQueueAttributesInput struct { // sent within the deduplication interval are treated as duplicates and only // one copy of the message is delivered. // - // You can also use ContentBasedDeduplication for messages with identical content - // to be treated as duplicates. - // // If you send one message with ContentBasedDeduplication enabled and then another // message with a MessageDeduplicationId that is the same as the one generated // for the first MessageDeduplicationId, the two messages are treated as @@ -4453,4 +4469,10 @@ const ( // QueueAttributeNameContentBasedDeduplication is a QueueAttributeName enum value QueueAttributeNameContentBasedDeduplication = "ContentBasedDeduplication" + + // QueueAttributeNameKmsMasterKeyId is a QueueAttributeName enum value + QueueAttributeNameKmsMasterKeyId = "KmsMasterKeyId" + + // QueueAttributeNameKmsDataKeyReusePeriodSeconds is a QueueAttributeName enum value + QueueAttributeNameKmsDataKeyReusePeriodSeconds = "KmsDataKeyReusePeriodSeconds" ) diff --git a/vendor/github.com/aws/aws-sdk-go/service/sqs/doc.go b/vendor/github.com/aws/aws-sdk-go/service/sqs/doc.go new file mode 100644 index 00000000..24189f53 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/sqs/doc.go @@ -0,0 +1,115 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package sqs provides the client and types for making API +// requests to Amazon Simple Queue Service. +// +// Welcome to the Amazon Simple Queue Service API Reference. +// +// Amazon Simple Queue Service (Amazon SQS) is a reliable, highly-scalable hosted +// queue for storing messages as they travel between applications or microservices. +// Amazon SQS moves data between distributed application components and helps +// you decouple these components. +// +// Standard queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/standard-queues.html) +// are available in all regions. FIFO queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html) +// are available in US West (Oregon) and US East (Ohio). +// +// You can use AWS SDKs (http://aws.amazon.com/tools/#sdk) to access Amazon +// SQS using your favorite programming language. The SDKs perform tasks such +// as the following automatically: +// +// * Cryptographically sign your service requests +// +// * Retry requests +// +// * Handle error responses +// +// Additional Information +// +// * Amazon SQS Product Page (http://aws.amazon.com/sqs/) +// +// * Amazon SQS Developer Guide +// +// Making API Requests (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/MakingRequestsArticle.html) +// +// Using Amazon SQS Message Attributes (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) +// +// Using Amazon SQS Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) +// +// * Amazon Web Services General Reference +// +// Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region) +// +// See https://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05 for more information on this service. +// +// See sqs package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sqs/ +// +// Using the Client +// +// To use the client for Amazon Simple Queue 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 := sqs.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 Simple Queue Service client SQS for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sqs/#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.AddPermission(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("AddPermission 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.AddPermissionWithContext(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 sqs diff --git a/vendor/github.com/aws/aws-sdk-go/service/sqs/service.go b/vendor/github.com/aws/aws-sdk-go/service/sqs/service.go index 0fee951c..50b5f4b8 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sqs/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sqs/service.go @@ -11,45 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// Welcome to the Amazon Simple Queue Service API Reference. +// SQS provides the API operation methods for making requests to +// Amazon Simple Queue Service. See this package's package overview docs +// for details on the service. // -// Amazon Simple Queue Service (Amazon SQS) is a reliable, highly-scalable hosted -// queue for storing messages as they travel between applications or microservices. -// Amazon SQS moves data between distributed application components and helps -// you decouple these components. -// -// Standard queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/standard-queues.html) -// are available in all regions. FIFO queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html) -// are available in US West (Oregon) and US East (Ohio). -// -// You can use AWS SDKs (http://aws.amazon.com/tools/#sdk) to access Amazon -// SQS using your favorite programming language. The SDKs perform tasks such -// as the following automatically: -// -// * Cryptographically sign your service requests -// -// * Retry requests -// -// * Handle error responses -// -// Additional Information -// -// * Amazon SQS Product Page (http://aws.amazon.com/sqs/) -// -// * Amazon SQS Developer Guide -// -// Making API Requests (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/MakingRequestsArticle.html) -// -// Using Amazon SQS Message Attributes (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html) -// -// Using Amazon SQS Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html) -// -// * Amazon Web Services General Reference -// -// Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region) -// 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/sqs-2012-11-05 +// SQS methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SQS struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/ssm/api.go b/vendor/github.com/aws/aws-sdk-go/service/ssm/api.go index bd233e4e..6b2155f9 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ssm/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ssm/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package ssm provides a client for Amazon Simple Systems Manager (SSM). package ssm import ( @@ -58,14 +57,16 @@ func (c *SSM) AddTagsToResourceRequest(input *AddTagsToResourceInput) (req *requ // AddTagsToResource API operation for Amazon Simple Systems Manager (SSM). // // Adds or overwrites one or more tags for the specified resource. Tags are -// metadata that you assign to your managed instances. Tags enable you to categorize -// your managed instances in different ways, for example, by purpose, owner, -// or environment. Each tag consists of a key and an optional value, both of -// which you define. For example, you could define a set of tags for your account's -// managed instances that helps you track each instance's owner and stack level. -// For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack -// and Value=Production, Pre-Production, or Test. Each resource can have a maximum -// of 10 tags. +// metadata that you assign to your managed instances, Maintenance Windows, +// or Parameter Store parameters. Tags enable you to categorize your resources +// in different ways, for example, by purpose, owner, or environment. Each tag +// consists of a key and an optional value, both of which you define. For example, +// you could define a set of tags for your account's managed instances that +// helps you track each instance's owner and stack level. For example: Key=Owner +// and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, +// or Test. +// +// Each resource can have a maximum of 10 tags. // // We recommend that you devise a set of tag keys that meets your needs for // each resource type. Using a consistent set of tag keys makes it easier for @@ -727,7 +728,7 @@ func (c *SSM) CreateMaintenanceWindowRequest(input *CreateMaintenanceWindowInput // Returned Error Codes: // * ErrCodeIdempotentParameterMismatch "IdempotentParameterMismatch" // Error returned when an idempotent operation is retried and the parameters -// don’t match the original call to the API with the same idempotency token. +// don't match the original call to the API with the same idempotency token. // // * ErrCodeResourceLimitExceededException "ResourceLimitExceededException" // Error returned when the caller has exceeded the default resource limits (e.g. @@ -815,7 +816,7 @@ func (c *SSM) CreatePatchBaselineRequest(input *CreatePatchBaselineInput) (req * // Returned Error Codes: // * ErrCodeIdempotentParameterMismatch "IdempotentParameterMismatch" // Error returned when an idempotent operation is retried and the parameters -// don’t match the original call to the API with the same idempotency token. +// don't match the original call to the API with the same idempotency token. // // * ErrCodeResourceLimitExceededException "ResourceLimitExceededException" // Error returned when the caller has exceeded the default resource limits (e.g. @@ -1435,7 +1436,7 @@ func (c *SSM) DeregisterManagedInstanceRequest(input *DeregisterManagedInstanceI // DeregisterManagedInstance API operation for Amazon Simple Systems Manager (SSM). // // Removes the server or virtual machine from the list of registered servers. -// You can reregister the instance again at any time. If you don’t plan to use +// You can reregister the instance again at any time. If you don't plan to use // Run Command on the server, we suggest uninstalling the SSM Agent first. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -1627,7 +1628,7 @@ func (c *SSM) DeregisterTargetFromMaintenanceWindowRequest(input *DeregisterTarg // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -1711,7 +1712,7 @@ func (c *SSM) DeregisterTaskFromMaintenanceWindowRequest(input *DeregisterTaskFr // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -2281,7 +2282,7 @@ func (c *SSM) DescribeDocumentPermissionRequest(input *DescribeDocumentPermissio // // Describes the permissions for a Systems Manager document. If you created // the document, you are the owner. If a document is shared, it can either be -// shared privately (by specifying a user’s AWS account ID) or publicly (All). +// shared privately (by specifying a user's AWS account ID) or publicly (All). // // 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 @@ -2483,7 +2484,7 @@ func (c *SSM) DescribeEffectivePatchesForPatchBaselineRequest(input *DescribeEff // // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -3105,7 +3106,7 @@ func (c *SSM) DescribeMaintenanceWindowExecutionTaskInvocationsRequest(input *De // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -3189,7 +3190,7 @@ func (c *SSM) DescribeMaintenanceWindowExecutionTasksRequest(input *DescribeMain // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -3355,7 +3356,7 @@ func (c *SSM) DescribeMaintenanceWindowTargetsRequest(input *DescribeMaintenance // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -3439,7 +3440,7 @@ func (c *SSM) DescribeMaintenanceWindowTasksRequest(input *DescribeMaintenanceWi // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -4549,7 +4550,7 @@ func (c *SSM) GetMaintenanceWindowRequest(input *GetMaintenanceWindowInput) (req // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -4634,7 +4635,7 @@ func (c *SSM) GetMaintenanceWindowExecutionRequest(input *GetMaintenanceWindowEx // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -4719,7 +4720,7 @@ func (c *SSM) GetMaintenanceWindowExecutionTaskRequest(input *GetMaintenanceWind // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -4969,7 +4970,7 @@ func (c *SSM) GetPatchBaselineRequest(input *GetPatchBaselineInput) (req *reques // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInvalidResourceId "InvalidResourceId" // The resource ID is not valid. Verify that you entered the correct ID and @@ -6340,7 +6341,7 @@ func (c *SSM) RegisterDefaultPatchBaselineRequest(input *RegisterDefaultPatchBas // // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -6428,7 +6429,7 @@ func (c *SSM) RegisterPatchBaselineForPatchGroupRequest(input *RegisterPatchBase // // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInvalidResourceId "InvalidResourceId" // The resource ID is not valid. Verify that you entered the correct ID and @@ -6520,11 +6521,11 @@ func (c *SSM) RegisterTargetWithMaintenanceWindowRequest(input *RegisterTargetWi // Returned Error Codes: // * ErrCodeIdempotentParameterMismatch "IdempotentParameterMismatch" // Error returned when an idempotent operation is retried and the parameters -// don’t match the original call to the API with the same idempotency token. +// don't match the original call to the API with the same idempotency token. // // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeResourceLimitExceededException "ResourceLimitExceededException" // Error returned when the caller has exceeded the default resource limits (e.g. @@ -6612,11 +6613,11 @@ func (c *SSM) RegisterTaskWithMaintenanceWindowRequest(input *RegisterTaskWithMa // Returned Error Codes: // * ErrCodeIdempotentParameterMismatch "IdempotentParameterMismatch" // Error returned when an idempotent operation is retried and the parameters -// don’t match the original call to the API with the same idempotency token. +// don't match the original call to the API with the same idempotency token. // // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeResourceLimitExceededException "ResourceLimitExceededException" // Error returned when the caller has exceeded the default resource limits (e.g. @@ -7122,6 +7123,13 @@ func (c *SSM) UpdateAssociationRequest(input *UpdateAssociationInput) (req *requ // There are concurrent updates for a resource that supports one update at a // time. // +// * ErrCodeInvalidDocument "InvalidDocument" +// The specified document does not exist. +// +// * ErrCodeInvalidTarget "InvalidTarget" +// The target is not valid or does not exist. It might not be configured for +// EC2 Systems Manager or you might not have permission to perform the operation. +// // Please also see https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociation func (c *SSM) UpdateAssociation(input *UpdateAssociationInput) (*UpdateAssociationOutput, error) { req, out := c.UpdateAssociationRequest(input) @@ -7502,7 +7510,7 @@ func (c *SSM) UpdateMaintenanceWindowRequest(input *UpdateMaintenanceWindowInput // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -7683,7 +7691,7 @@ func (c *SSM) UpdatePatchBaselineRequest(input *UpdatePatchBaselineInput) (req * // Returned Error Codes: // * ErrCodeDoesNotExistException "DoesNotExistException" // Error returned when the ID specified for a resource (e.g. a Maintenance Window) -// doesn’t exist. +// doesn't exist. // // * ErrCodeInternalServerError "InternalServerError" // An error occurred on the server side. @@ -8735,31 +8743,31 @@ type Command struct { // For more information about these statuses, see Run Command Status (http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html). // StatusDetails can be one of the following values: // - // * Pending – The command has not been sent to any instances. + // * Pending: The command has not been sent to any instances. // - // * In Progress – The command has been sent to at least one instance but + // * In Progress: The command has been sent to at least one instance but // has not reached a final state on all instances. // - // * Success – The command successfully executed on all invocations. This + // * Success: The command successfully executed on all invocations. This // is a terminal state. // - // * Delivery Timed Out – The value of MaxErrors or more command invocations + // * Delivery Timed Out: The value of MaxErrors or more command invocations // shows a status of Delivery Timed Out. This is a terminal state. // - // * Execution Timed Out – The value of MaxErrors or more command invocations + // * Execution Timed Out: The value of MaxErrors or more command invocations // shows a status of Execution Timed Out. This is a terminal state. // - // * Failed – The value of MaxErrors or more command invocations shows a - // status of Failed. This is a terminal state. + // * Failed: The value of MaxErrors or more command invocations shows a status + // of Failed. This is a terminal state. // - // * Incomplete – The command was attempted on all instances and one or more + // * Incomplete: The command was attempted on all instances and one or more // invocations does not have a value of Success but not enough invocations // failed for the status to be Failed. This is a terminal state. // - // * Canceled – The command was terminated before it was completed. This - // is a terminal state. + // * Canceled: The command was terminated before it was completed. This is + // a terminal state. // - // * Rate Exceeded – The number of instances targeted by the command exceeded + // * Rate Exceeded: The number of instances targeted by the command exceeded // the account limit for pending invocations. The system has canceled the // command before executing it on any instance. This is a terminal state. StatusDetails *string `type:"string"` @@ -9000,13 +9008,13 @@ type CommandInvocation struct { // notifications about command status changes on a per instance basis. ServiceRole *string `type:"string"` - // The URL to the plugin’s StdErr file in Amazon S3, if the Amazon S3 bucket + // The URL to the plugin's StdErr file in Amazon S3, if the Amazon S3 bucket // was defined for the parent command. For an invocation, StandardErrorUrl is // populated if there is just one plugin defined for the command, and the Amazon // S3 bucket was defined for the command. StandardErrorUrl *string `type:"string"` - // The URL to the plugin’s StdOut file in Amazon S3, if the Amazon S3 bucket + // The URL to the plugin's StdOut file in Amazon S3, if the Amazon S3 bucket // was defined for the parent command. For an invocation, StandardOutputUrl // is populated if there is just one plugin defined for the command, and the // Amazon S3 bucket was defined for the command. @@ -9022,40 +9030,40 @@ type CommandInvocation struct { // about these statuses, see Run Command Status (http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html). // StatusDetails can be one of the following values: // - // * Pending – The command has not been sent to the instance. + // * Pending: The command has not been sent to the instance. // - // * In Progress – The command has been sent to the instance but has not - // reached a terminal state. + // * In Progress: The command has been sent to the instance but has not reached + // a terminal state. // - // * Success – The execution of the command or plugin was successfully completed. + // * Success: The execution of the command or plugin was successfully completed. // This is a terminal state. // - // * Delivery Timed Out – The command was not delivered to the instance before + // * Delivery Timed Out: The command was not delivered to the instance before // the delivery timeout expired. Delivery timeouts do not count against the - // parent command’s MaxErrors limit, but they do contribute to whether the + // parent command's MaxErrors limit, but they do contribute to whether the // parent command status is Success or Incomplete. This is a terminal state. // - // * Execution Timed Out – Command execution started on the instance, but + // * Execution Timed Out: Command execution started on the instance, but // the execution was not complete before the execution timeout expired. Execution // timeouts count against the MaxErrors limit of the parent command. This // is a terminal state. // - // * Failed – The command was not successful on the instance. For a plugin, + // * Failed: The command was not successful on the instance. For a plugin, // this indicates that the result code was not zero. For a command invocation, // this indicates that the result code for one or more plugins was not zero. // Invocation failures count against the MaxErrors limit of the parent command. // This is a terminal state. // - // * Canceled – The command was terminated before it was completed. This - // is a terminal state. + // * Canceled: The command was terminated before it was completed. This is + // a terminal state. // - // * Undeliverable – The command can't be delivered to the instance. The - // instance might not exist or might not be responding. Undeliverable invocations - // don't count against the parent command’s MaxErrors limit and don't contribute + // * Undeliverable: The command can't be delivered to the instance. The instance + // might not exist or might not be responding. Undeliverable invocations + // don't count against the parent command's MaxErrors limit and don't contribute // to whether the parent command status is Success or Incomplete. This is // a terminal state. // - // * Terminated – The parent command exceeded its MaxErrors limit and subsequent + // * Terminated: The parent command exceeded its MaxErrors limit and subsequent // command invocations were canceled by the system. This is a terminal state. StatusDetails *string `type:"string"` @@ -9231,40 +9239,40 @@ type CommandPlugin struct { // For more information about these statuses, see Run Command Status (http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html). // StatusDetails can be one of the following values: // - // * Pending – The command has not been sent to the instance. + // * Pending: The command has not been sent to the instance. // - // * In Progress – The command has been sent to the instance but has not - // reached a terminal state. + // * In Progress: The command has been sent to the instance but has not reached + // a terminal state. // - // * Success – The execution of the command or plugin was successfully completed. + // * Success: The execution of the command or plugin was successfully completed. // This is a terminal state. // - // * Delivery Timed Out – The command was not delivered to the instance before + // * Delivery Timed Out: The command was not delivered to the instance before // the delivery timeout expired. Delivery timeouts do not count against the - // parent command’s MaxErrors limit, but they do contribute to whether the + // parent command's MaxErrors limit, but they do contribute to whether the // parent command status is Success or Incomplete. This is a terminal state. // - // * Execution Timed Out – Command execution started on the instance, but + // * Execution Timed Out: Command execution started on the instance, but // the execution was not complete before the execution timeout expired. Execution // timeouts count against the MaxErrors limit of the parent command. This // is a terminal state. // - // * Failed – The command was not successful on the instance. For a plugin, + // * Failed: The command was not successful on the instance. For a plugin, // this indicates that the result code was not zero. For a command invocation, // this indicates that the result code for one or more plugins was not zero. // Invocation failures count against the MaxErrors limit of the parent command. // This is a terminal state. // - // * Canceled – The command was terminated before it was completed. This - // is a terminal state. + // * Canceled: The command was terminated before it was completed. This is + // a terminal state. // - // * Undeliverable – The command can't be delivered to the instance. The - // instance might not exist, or it might not be responding. Undeliverable - // invocations don't count against the parent command’s MaxErrors limit, - // and they don't contribute to whether the parent command status is Success - // or Incomplete. This is a terminal state. + // * Undeliverable: The command can't be delivered to the instance. The instance + // might not exist, or it might not be responding. Undeliverable invocations + // don't count against the parent command's MaxErrors limit, and they don't + // contribute to whether the parent command status is Success or Incomplete. + // This is a terminal state. // - // * Terminated – The parent command exceeded its MaxErrors limit and subsequent + // * Terminated: The parent command exceeded its MaxErrors limit and subsequent // command invocations were canceled by the system. This is a terminal state. StatusDetails *string `type:"string"` } @@ -9359,7 +9367,7 @@ type CreateActivationInput struct { // EC2 console or when you use the AWS command line tools to list EC2 resources. DefaultInstanceName *string `type:"string"` - // A user-defined description of the resource that you want to register with + // A userdefined description of the resource that you want to register with // Amazon EC2. Description *string `type:"string"` @@ -9683,25 +9691,15 @@ type CreateAssociationInput struct { Name *string `type:"string" required:"true"` // An Amazon S3 bucket where you want to store the output details of the request. - // For example: - // - // "{ \"S3Location\": { \"OutputS3Region\": \"<region>\", \"OutputS3BucketName\": - // \"bucket name\", \"OutputS3KeyPrefix\": \"folder name\" } }" OutputLocation *InstanceAssociationOutputLocation `type:"structure"` // The parameters for the documents runtime configuration. Parameters map[string][]*string `type:"map"` // A cron expression when the association will be applied to the target(s). - // Supported expressions are every half, 1, 2, 4, 8 or 12 hour(s); every specified - // day and time of the week. For example: cron(0 0/30 * 1/1 * ? *) to run every - // thirty minutes; cron(0 0 0/4 1/1 * ? *) to run every four hours; and cron(0 - // 0 10 ? * SUN *) to run every Sunday at 10 a.m. ScheduleExpression *string `min:"1" type:"string"` - // The targets (either instances or tags) for the association. Instances are - // specified using Key=instanceids,Values=<instanceid1>,<instanceid2>. Tags - // are specified using Key=<tag name>,Values=<tag value>. + // The targets (either instances or tags) for the association. Targets []*Target `type:"list"` } @@ -10054,7 +10052,7 @@ type CreatePatchBaselineInput struct { // A list of explicitly approved patches for the baseline. ApprovedPatches []*string `type:"list"` - // Caller-provided idempotency token. + // User-provided idempotency token. ClientToken *string `min:"1" type:"string" idempotencyToken:"true"` // A description of the patch baseline. @@ -11832,11 +11830,11 @@ type DescribeInstancePatchStatesForPatchGroupInput struct { // Each entry in the array is a structure containing: // - // Key (string 1 ≤ length ≤ 200) + // Key (string between 1 and 200 characters) // // Values (array containing a single string) // - // Type (string “Equal”, “NotEqual”, “LessThan”, “GreaterThan”) + // Type (string "Equal", "NotEqual", "LessThan", "GreaterThan") Filters []*InstancePatchStateFilter `type:"list"` // The maximum number of patches to return (per page). @@ -12051,9 +12049,9 @@ type DescribeInstancePatchesInput struct { // Each entry in the array is a structure containing: // - // Key (string, 1 ≤ length ≤ 128) + // Key (string, between 1 and 128 characters) // - // Values (array of strings 1 ≤ length ≤ 256) + // Values (array of strings, each string between 1 and 256 characters) Filters []*PatchOrchestratorFilter `type:"list"` // The ID of the instance whose patch state information should be retrieved. @@ -12147,8 +12145,8 @@ type DescribeInstancePatchesOutput struct { // // Severity (string) // - // State (string – “INSTALLED”, “INSTALLED_OTHER”, “MISSING”, “NOT_APPLICABLE”, - // “FAILED”) + // State (string: "INSTALLED", "INSTALLED OTHER", "MISSING", "NOT APPLICABLE", + // "FAILED") // // InstalledTime (DateTime) // @@ -12445,9 +12443,9 @@ type DescribeMaintenanceWindowExecutionsInput struct { // Each entry in the array is a structure containing: // - // Key (string, 1 ≤ length ≤ 128) + // Key (string, between 1 and 128 characters) // - // Values (array of strings 1 ≤ length ≤ 256) + // Values (array of strings, each string is between 1 and 256 characters) // // The supported Keys are ExecutedBefore and ExecutedAfter with the value being // a date/time string such as 2016-11-04T05:00:00Z. @@ -13016,9 +13014,9 @@ type DescribePatchBaselinesInput struct { // Each element in the array is a structure containing: // - // Key: (string, “NAME_PREFIX” or “OWNER”) + // Key: (string, "NAME_PREFIX" or "OWNER") // - // Value: (array of strings, exactly 1 entry, 1 ≤ length ≤ 255) + // Value: (array of strings, exactly 1 entry, between 1 and 255 characters) Filters []*PatchOrchestratorFilter `type:"list"` // The maximum number of patch baselines to return (per page). @@ -13167,7 +13165,7 @@ type DescribePatchGroupStateOutput struct { // to install. InstancesWithFailedPatches *int64 `type:"integer"` - // The number of instances with patches installed that aren’t defined in the + // The number of instances with patches installed that aren't defined in the // patch baseline. InstancesWithInstalledOtherPatches *int64 `type:"integer"` @@ -13177,7 +13175,7 @@ type DescribePatchGroupStateOutput struct { // The number of instances with missing patches from the patch baseline. InstancesWithMissingPatches *int64 `type:"integer"` - // The number of instances with patches that aren’t applicable. + // The number of instances with patches that aren't applicable. InstancesWithNotApplicablePatches *int64 `type:"integer"` } @@ -13280,7 +13278,7 @@ type DescribePatchGroupsOutput struct { // Each entry in the array contains: // - // PatchGroup: string (1 ≤ length ≤ 256, Regex: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$) + // PatchGroup: string (between 1 and 256 characters, Regex: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$) // // PatchBaselineIdentity: A PatchBaselineIdentity element. Mappings []*PatchGroupPatchBaselineMapping `type:"list"` @@ -13645,7 +13643,7 @@ type DocumentParameter struct { // The name of the parameter. Name *string `type:"string"` - // The type of parameter. The type can be either “String” or “StringList”. + // The type of parameter. The type can be either String or StringList. Type *string `type:"string" enum:"DocumentParameterType"` } @@ -13820,6 +13818,51 @@ func (s *FailedCreateAssociation) SetMessage(v string) *FailedCreateAssociation return s } +// Information about an Automation failure. +// Please also see https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/FailureDetails +type FailureDetails struct { + _ struct{} `type:"structure"` + + // Detailed information about the Automation step failure. + Details map[string][]*string `min:"1" type:"map"` + + // The stage of the Automation execution when the failure occurred. The stages + // include the following: InputValidation, PreVerification, Invocation, PostVerification. + FailureStage *string `type:"string"` + + // The type of Automation failure. Failure types include the following: Action, + // Permission, Throttling, Verification, Internal. + FailureType *string `type:"string"` +} + +// String returns the string representation +func (s FailureDetails) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s FailureDetails) GoString() string { + return s.String() +} + +// SetDetails sets the Details field's value. +func (s *FailureDetails) SetDetails(v map[string][]*string) *FailureDetails { + s.Details = v + return s +} + +// SetFailureStage sets the FailureStage field's value. +func (s *FailureDetails) SetFailureStage(v string) *FailureDetails { + s.FailureStage = &v + return s +} + +// SetFailureType sets the FailureType field's value. +func (s *FailureDetails) SetFailureType(v string) *FailureDetails { + s.FailureType = &v + return s +} + // Please also see https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetAutomationExecutionRequest type GetAutomationExecutionInput struct { _ struct{} `type:"structure"` @@ -14028,45 +14071,45 @@ type GetCommandInvocationOutput struct { // Status (http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html). // StatusDetails can be one of the following values: // - // * Pending – The command has not been sent to the instance. + // * Pending: The command has not been sent to the instance. // - // * In Progress – The command has been sent to the instance but has not - // reached a terminal state. + // * In Progress: The command has been sent to the instance but has not reached + // a terminal state. // - // * Delayed – The system attempted to send the command to the target, but + // * Delayed: The system attempted to send the command to the target, but // the target was not available. The instance might not be available because // of network issues, the instance was stopped, etc. The system will try // to deliver the command again. // - // * Success – The command or plugin was executed successfully. This is a + // * Success: The command or plugin was executed successfully. This is a // terminal state. // - // * Delivery Timed Out – The command was not delivered to the instance before + // * Delivery Timed Out: The command was not delivered to the instance before // the delivery timeout expired. Delivery timeouts do not count against the - // parent command’s MaxErrors limit, but they do contribute to whether the + // parent command's MaxErrors limit, but they do contribute to whether the // parent command status is Success or Incomplete. This is a terminal state. // - // * Execution Timed Out – The command started to execute on the instance, + // * Execution Timed Out: The command started to execute on the instance, // but the execution was not complete before the timeout expired. Execution // timeouts count against the MaxErrors limit of the parent command. This // is a terminal state. // - // * Failed – The command wasn't executed successfully on the instance. For + // * Failed: The command wasn't executed successfully on the instance. For // a plugin, this indicates that the result code was not zero. For a command // invocation, this indicates that the result code for one or more plugins // was not zero. Invocation failures count against the MaxErrors limit of // the parent command. This is a terminal state. // - // * Canceled – The command was terminated before it was completed. This - // is a terminal state. + // * Canceled: The command was terminated before it was completed. This is + // a terminal state. // - // * Undeliverable – The command can't be delivered to the instance. The - // instance might not exist or might not be responding. Undeliverable invocations - // don't count against the parent command’s MaxErrors limit and don't contribute + // * Undeliverable: The command can't be delivered to the instance. The instance + // might not exist or might not be responding. Undeliverable invocations + // don't count against the parent command's MaxErrors limit and don't contribute // to whether the parent command status is Success or Incomplete. This is // a terminal state. // - // * Terminated – The parent command exceeded its MaxErrors limit and subsequent + // * Terminated: The parent command exceeded its MaxErrors limit and subsequent // command invocations were canceled by the system. This is a terminal state. StatusDetails *string `type:"string"` } @@ -14837,9 +14880,9 @@ type GetMaintenanceWindowExecutionTaskOutput struct { // The parameters passed to the task when it was executed. The map has the following // format: // - // Key: string, 1 ≤ length ≤ 255 + // Key: string, between 1 and 255 characters // - // Value: an array of strings where each string 1 ≤ length ≤ 255 + // Value: an array of strings, each string is between 1 and 255 characters TaskParameters []map[string]*MaintenanceWindowTaskParameterValueExpression `type:"list"` // The type of task executed. @@ -15997,8 +16040,8 @@ type InstanceInformationStringFilter struct { // The filter key name to describe your instances. For example: // - // "InstanceIds"|"AgentVersion"|"PingStatus"|"PlatformTypes"|"ActivationIds"|"IamRole"|"ResourceType"|”AssociationStatus”|”Tag - // Key” + // "InstanceIds"|"AgentVersion"|"PingStatus"|"PlatformTypes"|"ActivationIds"|"IamRole"|"ResourceType"|"AssociationStatus"|"Tag + // Key" // // Key is a required field Key *string `min:"1" type:"string" required:"true"` @@ -16084,11 +16127,11 @@ type InstancePatchState struct { InstanceId *string `type:"string" required:"true"` // The number of patches from the patch baseline that are applicable for the - // instance but aren’t currently installed. + // instance but aren't currently installed. MissingCount *int64 `type:"integer"` - // The number of patches from the patch baseline that aren’t applicable for - // the instance and hence aren’t installed on the instance. + // The number of patches from the patch baseline that aren't applicable for + // the instance and hence aren't installed on the instance. NotApplicableCount *int64 `type:"integer"` // The type of patching operation that was performed: SCAN (assess patch compliance @@ -18545,7 +18588,7 @@ type Patch struct { // The Microsoft Knowledge Base ID of the patch. KbNumber *string `type:"string"` - // The language of the patch if it’s language-specific. + // The language of the patch if it's language-specific. Language *string `type:"string"` // The ID of the MSRC bulletin the patch is related to. @@ -19922,8 +19965,8 @@ func (s RemoveTagsFromResourceOutput) GoString() string { type ResultAttribute struct { _ struct{} `type:"structure"` - // Name of the inventory item type. Valid value: “AWS:InstanceInformation”. - // Default Value: “AWS:InstanceInformation”. + // Name of the inventory item type. Valid value: AWS:InstanceInformation. Default + // Value: AWS:InstanceInformation. // // TypeName is a required field TypeName *string `min:"1" type:"string" required:"true"` @@ -20071,21 +20114,23 @@ type SendCommandInput struct { // DocumentName is a required field DocumentName *string `type:"string" required:"true"` - // Required. The instance IDs where the command should execute. You can specify - // a maximum of 50 IDs. + // The instance IDs where the command should execute. You can specify a maximum + // of 50 IDs. If you prefer not to list individual instance IDs, you can instead + // send commands to a fleet of instances using the Targets parameter, which + // accepts EC2 tags. InstanceIds []*string `type:"list"` // (Optional) The maximum number of instances that are allowed to execute the - // command at the same time. You can specify a number such as “10” or a percentage - // such as “10%”. The default value is 50. For more information about how to - // use MaxConcurrency, see Executing a Command Using Systems Manager Run Command + // command at the same time. You can specify a number such as 10 or a percentage + // such as 10%. The default value is 50. For more information about how to use + // MaxConcurrency, see Executing a Command Using Systems Manager Run Command // (http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html). MaxConcurrency *string `min:"1" type:"string"` // The maximum number of errors allowed without the command failing. When the // command fails one more time beyond the value of MaxErrors, the systems stops // sending the command to additional targets. You can specify a number like - // “10” or a percentage like “10%”. The default value is 50. For more information + // 10 or a percentage like 10%. The default value is 50. For more information // about how to use MaxErrors, see Executing a Command Using Systems Manager // Run Command (http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html). MaxErrors *string `min:"1" type:"string"` @@ -20387,6 +20432,9 @@ type StepExecution struct { // the step is in Pending status, this field is not populated. ExecutionStartTime *time.Time `type:"timestamp" timestampFormat:"unix"` + // Information about the Automation failure. + FailureDetails *FailureDetails `type:"structure"` + // If a step failed, this message explains why the execution failed. FailureMessage *string `type:"string"` @@ -20438,6 +20486,12 @@ func (s *StepExecution) SetExecutionStartTime(v time.Time) *StepExecution { return s } +// SetFailureDetails sets the FailureDetails field's value. +func (s *StepExecution) SetFailureDetails(v *FailureDetails) *StepExecution { + s.FailureDetails = v + return s +} + // SetFailureMessage sets the FailureMessage field's value. func (s *StepExecution) SetFailureMessage(v string) *StepExecution { s.FailureMessage = &v @@ -20667,10 +20721,10 @@ type UpdateAssociationInput struct { // The document version you want update for the association. DocumentVersion *string `type:"string"` + // The name of the association document. + Name *string `type:"string"` + // An Amazon S3 bucket where you want to store the results of this request. - // - // "{ \"S3Location\": { \"OutputS3Region\": \"<region>\", \"OutputS3BucketName\": - // \"bucket name\", \"OutputS3KeyPrefix\": \"folder name\" } }" OutputLocation *InstanceAssociationOutputLocation `type:"structure"` // The parameters you want to update for the association. If you create a parameter @@ -20678,11 +20732,10 @@ type UpdateAssociationInput struct { Parameters map[string][]*string `type:"map"` // The cron expression used to schedule the association that you want to update. - // Supported expressions are every half, 1, 2, 4, 8 or 12 hour(s); every specified - // day and time of the week. For example: cron(0 0/30 * 1/1 * ? *) to run every - // thirty minutes; cron(0 0 0/4 1/1 * ? *) to run every four hours; and cron(0 - // 0 10 ? * SUN *) to run every Sunday at 10 a.m. ScheduleExpression *string `min:"1" type:"string"` + + // The targets of the association. + Targets []*Target `type:"list"` } // String returns the string representation @@ -20709,6 +20762,16 @@ func (s *UpdateAssociationInput) Validate() error { invalidParams.AddNested("OutputLocation", err.(request.ErrInvalidParams)) } } + if s.Targets != nil { + for i, v := range s.Targets { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Targets", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -20728,6 +20791,12 @@ func (s *UpdateAssociationInput) SetDocumentVersion(v string) *UpdateAssociation return s } +// SetName sets the Name field's value. +func (s *UpdateAssociationInput) SetName(v string) *UpdateAssociationInput { + s.Name = &v + return s +} + // SetOutputLocation sets the OutputLocation field's value. func (s *UpdateAssociationInput) SetOutputLocation(v *InstanceAssociationOutputLocation) *UpdateAssociationInput { s.OutputLocation = v @@ -20746,6 +20815,12 @@ func (s *UpdateAssociationInput) SetScheduleExpression(v string) *UpdateAssociat return s } +// SetTargets sets the Targets field's value. +func (s *UpdateAssociationInput) SetTargets(v []*Target) *UpdateAssociationInput { + s.Targets = v + return s +} + // Please also see https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociationResult type UpdateAssociationOutput struct { _ struct{} `type:"structure"` diff --git a/vendor/github.com/aws/aws-sdk-go/service/ssm/doc.go b/vendor/github.com/aws/aws-sdk-go/service/ssm/doc.go new file mode 100644 index 00000000..8f15668b --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/ssm/doc.go @@ -0,0 +1,92 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package ssm provides the client and types for making API +// requests to Amazon Simple Systems Manager (SSM). +// +// Amazon EC2 Systems Manager is a collection of capabilities that helps you +// automate management tasks such as collecting system inventory, applying operating +// system (OS) patches, automating the creation of Amazon Machine Images (AMIs), +// and configuring operating systems (OSs) and applications at scale. Systems +// Manager lets you remotely and securely manage the configuration of your managed +// instances. A managed instance is any Amazon EC2 instance or on-premises machine +// in your hybrid environment that has been configured for Systems Manager. +// +// This reference is intended to be used with the Amazon EC2 Systems Manager +// User Guide (http://docs.aws.amazon.com/systems-manager/latest/userguide/). +// +// To get started, verify prerequisites and configure managed instances. For +// more information, see Systems Manager Prerequisites (http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-prereqs.html). +// +// See https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06 for more information on this service. +// +// See ssm package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/ssm/ +// +// Using the Client +// +// To use the client for Amazon Simple Systems Manager (SSM) 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 := ssm.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 Simple Systems Manager (SSM) client SSM for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/ssm/#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 ssm diff --git a/vendor/github.com/aws/aws-sdk-go/service/ssm/errors.go b/vendor/github.com/aws/aws-sdk-go/service/ssm/errors.go index 2107a874..03ee7f93 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ssm/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ssm/errors.go @@ -100,7 +100,7 @@ const ( // "DoesNotExistException". // // Error returned when the ID specified for a resource (e.g. a Maintenance Window) - // doesn’t exist. + // doesn't exist. ErrCodeDoesNotExistException = "DoesNotExistException" // ErrCodeDuplicateDocumentContent for service response error code @@ -120,7 +120,7 @@ const ( // "IdempotentParameterMismatch". // // Error returned when an idempotent operation is retried and the parameters - // don’t match the original call to the API with the same idempotency token. + // don't match the original call to the API with the same idempotency token. ErrCodeIdempotentParameterMismatch = "IdempotentParameterMismatch" // ErrCodeInternalServerError for service response error code diff --git a/vendor/github.com/aws/aws-sdk-go/service/ssm/examples_test.go b/vendor/github.com/aws/aws-sdk-go/service/ssm/examples_test.go index a9bda541..ef01280c 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ssm/examples_test.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ssm/examples_test.go @@ -2085,6 +2085,7 @@ func ExampleSSM_UpdateAssociation() { params := &ssm.UpdateAssociationInput{ AssociationId: aws.String("AssociationId"), // Required DocumentVersion: aws.String("DocumentVersion"), + Name: aws.String("DocumentName"), OutputLocation: &ssm.InstanceAssociationOutputLocation{ S3Location: &ssm.S3OutputLocation{ OutputS3BucketName: aws.String("S3BucketName"), @@ -2100,6 +2101,16 @@ func ExampleSSM_UpdateAssociation() { // More values... }, ScheduleExpression: aws.String("ScheduleExpression"), + Targets: []*ssm.Target{ + { // Required + Key: aws.String("TargetKey"), + Values: []*string{ + aws.String("TargetValue"), // Required + // More values... + }, + }, + // More values... + }, } resp, err := svc.UpdateAssociation(params) diff --git a/vendor/github.com/aws/aws-sdk-go/service/ssm/service.go b/vendor/github.com/aws/aws-sdk-go/service/ssm/service.go index 7fa443f9..d414fb7d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/ssm/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/ssm/service.go @@ -11,22 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// Amazon EC2 Systems Manager is a collection of capabilities that helps you -// automate management tasks such as collecting system inventory, applying operating -// system (OS) patches, automating the creation of Amazon Machine Images (AMIs), -// and configuring operating systems (OSs) and applications at scale. Systems -// Manager lets you remotely and securely manage the configuration of your managed -// instances. A managed instance is any Amazon EC2 instance or on-premises machine -// in your hybrid environment that has been configured for Systems Manager. +// SSM provides the API operation methods for making requests to +// Amazon Simple Systems Manager (SSM). See this package's package overview docs +// for details on the service. // -// This reference is intended to be used with the Amazon EC2 Systems Manager -// User Guide (http://docs.aws.amazon.com/systems-manager/latest/userguide/). -// -// To get started, verify prerequisites and configure managed instances. For -// more information, see Systems Manager Prerequisites (http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-prereqs.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/ssm-2014-11-06 +// SSM methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SSM struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/storagegateway/api.go b/vendor/github.com/aws/aws-sdk-go/service/storagegateway/api.go index 218d8d5d..1d8b2c1d 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/storagegateway/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/storagegateway/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package storagegateway provides a client for AWS Storage Gateway. package storagegateway import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/storagegateway/doc.go b/vendor/github.com/aws/aws-sdk-go/service/storagegateway/doc.go new file mode 100644 index 00000000..441df42d --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/storagegateway/doc.go @@ -0,0 +1,131 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package storagegateway provides the client and types for making API +// requests to AWS Storage Gateway. +// +// AWS Storage Gateway is the service that connects an on-premises software +// appliance with cloud-based storage to provide seamless and secure integration +// between an organization's on-premises IT environment and AWS's storage infrastructure. +// The service enables you to securely upload data to the AWS cloud for cost +// effective backup and rapid disaster recovery. +// +// Use the following links to get started using the AWS Storage Gateway Service +// API Reference: +// +// * AWS Storage Gateway Required Request Headers (http://docs.aws.amazon.com/storagegateway/latest/userguide/AWSStorageGatewayAPI.html#AWSStorageGatewayHTTPRequestsHeaders): +// Describes the required headers that you must send with every POST request +// to AWS Storage Gateway. +// +// * Signing Requests (http://docs.aws.amazon.com/storagegateway/latest/userguide/AWSStorageGatewayAPI.html#AWSStorageGatewaySigningRequests): +// AWS Storage Gateway requires that you authenticate every request you send; +// this topic describes how sign such a request. +// +// * Error Responses (http://docs.aws.amazon.com/storagegateway/latest/userguide/AWSStorageGatewayAPI.html#APIErrorResponses): +// Provides reference information about AWS Storage Gateway errors. +// +// * Operations in AWS Storage Gateway (http://docs.aws.amazon.com/storagegateway/latest/APIReference/API_Operations.html): +// Contains detailed descriptions of all AWS Storage Gateway operations, +// their request parameters, response elements, possible errors, and examples +// of requests and responses. +// +// * AWS Storage Gateway Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/index.html?rande.html): +// Provides a list of each of the s and endpoints available for use with +// AWS Storage Gateway. +// +// AWS Storage Gateway resource IDs are in uppercase. When you use these resource +// IDs with the Amazon EC2 API, EC2 expects resource IDs in lowercase. You must +// change your resource ID to lowercase to use it with the EC2 API. For example, +// in Storage Gateway the ID for a volume might be vol-1122AABB. When you use +// this ID with the EC2 API, you must change it to vol-1122aabb. Otherwise, +// the EC2 API might not behave as expected. +// +// IDs for Storage Gateway volumes and Amazon EBS snapshots created from gateway +// volumes are changing to a longer format. Starting in December 2016, all new +// volumes and snapshots will be created with a 17-character string. Starting +// in April 2016, you will be able to use these longer IDs so you can test your +// systems with the new format. For more information, see Longer EC2 and EBS +// Resource IDs (https://aws.amazon.com/ec2/faqs/#longer-ids). +// +// For example, a volume ARN with the longer volume ID format will look like +// this: +// +// arn:aws:storagegateway:us-west-2:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABBCCDDEEFFG. +// +// A snapshot ID with the longer ID format will look like this: snap-78e226633445566ee. +// +// For more information, see Announcement: Heads-up – Longer AWS Storage Gateway +// volume and snapshot IDs coming in 2016 (https://forums.aws.amazon.com/ann.jspa?annID=3557). +// +// See https://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30 for more information on this service. +// +// See storagegateway package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/storagegateway/ +// +// Using the Client +// +// To use the client for AWS Storage 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 := storagegateway.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 Storage Gateway client StorageGateway for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/storagegateway/#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.ActivateGateway(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("ActivateGateway 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.ActivateGatewayWithContext(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 storagegateway diff --git a/vendor/github.com/aws/aws-sdk-go/service/storagegateway/service.go b/vendor/github.com/aws/aws-sdk-go/service/storagegateway/service.go index ef75c7ff..11c486c5 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/storagegateway/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/storagegateway/service.go @@ -11,61 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// AWS Storage Gateway is the service that connects an on-premises software -// appliance with cloud-based storage to provide seamless and secure integration -// between an organization's on-premises IT environment and AWS's storage infrastructure. -// The service enables you to securely upload data to the AWS cloud for cost -// effective backup and rapid disaster recovery. +// StorageGateway provides the API operation methods for making requests to +// AWS Storage Gateway. See this package's package overview docs +// for details on the service. // -// Use the following links to get started using the AWS Storage Gateway Service -// API Reference: -// -// * AWS Storage Gateway Required Request Headers (http://docs.aws.amazon.com/storagegateway/latest/userguide/AWSStorageGatewayAPI.html#AWSStorageGatewayHTTPRequestsHeaders): -// Describes the required headers that you must send with every POST request -// to AWS Storage Gateway. -// -// * Signing Requests (http://docs.aws.amazon.com/storagegateway/latest/userguide/AWSStorageGatewayAPI.html#AWSStorageGatewaySigningRequests): -// AWS Storage Gateway requires that you authenticate every request you send; -// this topic describes how sign such a request. -// -// * Error Responses (http://docs.aws.amazon.com/storagegateway/latest/userguide/AWSStorageGatewayAPI.html#APIErrorResponses): -// Provides reference information about AWS Storage Gateway errors. -// -// * Operations in AWS Storage Gateway (http://docs.aws.amazon.com/storagegateway/latest/APIReference/API_Operations.html): -// Contains detailed descriptions of all AWS Storage Gateway operations, -// their request parameters, response elements, possible errors, and examples -// of requests and responses. -// -// * AWS Storage Gateway Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/index.html?rande.html): -// Provides a list of each of the s and endpoints available for use with -// AWS Storage Gateway. -// -// AWS Storage Gateway resource IDs are in uppercase. When you use these resource -// IDs with the Amazon EC2 API, EC2 expects resource IDs in lowercase. You must -// change your resource ID to lowercase to use it with the EC2 API. For example, -// in Storage Gateway the ID for a volume might be vol-1122AABB. When you use -// this ID with the EC2 API, you must change it to vol-1122aabb. Otherwise, -// the EC2 API might not behave as expected. -// -// IDs for Storage Gateway volumes and Amazon EBS snapshots created from gateway -// volumes are changing to a longer format. Starting in December 2016, all new -// volumes and snapshots will be created with a 17-character string. Starting -// in April 2016, you will be able to use these longer IDs so you can test your -// systems with the new format. For more information, see Longer EC2 and EBS -// Resource IDs (https://aws.amazon.com/ec2/faqs/#longer-ids). -// -// For example, a volume ARN with the longer volume ID format will look like -// this: -// -// arn:aws:storagegateway:us-west-2:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABBCCDDEEFFG. -// -// A snapshot ID with the longer ID format will look like this: snap-78e226633445566ee. -// -// For more information, see Announcement: Heads-up – Longer AWS Storage Gateway -// volume and snapshot IDs coming in 2016 (https://forums.aws.amazon.com/ann.jspa?annID=3557). -// 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/storagegateway-2013-06-30 +// StorageGateway methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type StorageGateway struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/sts/api.go b/vendor/github.com/aws/aws-sdk-go/service/sts/api.go index 19dd0bf8..2de65288 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sts/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sts/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package sts provides a client for AWS Security Token Service. package sts import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/sts/doc.go b/vendor/github.com/aws/aws-sdk-go/service/sts/doc.go new file mode 100644 index 00000000..d2af518c --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/sts/doc.go @@ -0,0 +1,124 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package sts provides the client and types for making API +// requests to AWS Security Token Service. +// +// The AWS Security Token Service (STS) is a web service that enables you to +// request temporary, limited-privilege credentials for AWS Identity and Access +// Management (IAM) users or for users that you authenticate (federated users). +// This guide provides descriptions of the STS API. For more detailed information +// about using this service, go to Temporary Security Credentials (http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html). +// +// As an alternative to using 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 STS. 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/). +// +// For information about setting up signatures and authorization through the +// API, go to Signing AWS API Requests (http://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) +// in the AWS General Reference. For general information about the Query API, +// go to Making Query Requests (http://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_UsingQueryAPI.html) +// in Using IAM. For information about using security tokens with other AWS +// products, go to AWS Services That Work with IAM (http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) +// in the IAM User Guide. +// +// If you're new to AWS and need additional technical information about a specific +// AWS product, you can find the product's technical documentation at http://aws.amazon.com/documentation/ +// (http://aws.amazon.com/documentation/). +// +// Endpoints +// +// The AWS Security Token Service (STS) has a default endpoint of https://sts.amazonaws.com +// that maps to the US East (N. Virginia) region. Additional regions are available +// and are activated by default. For more information, see Activating and Deactivating +// AWS STS in an AWS Region (http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) +// in the IAM User Guide. +// +// For information about STS endpoints, see Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#sts_region) +// in the AWS General Reference. +// +// Recording API requests +// +// STS supports AWS CloudTrail, which is a service that records AWS calls for +// your AWS account and delivers log files to an Amazon S3 bucket. By using +// information collected by CloudTrail, you can determine what requests were +// successfully made to STS, who made the request, when it was made, and so +// on. To learn more about CloudTrail, including how to turn it on and find +// your log files, see the AWS CloudTrail User Guide (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/what_is_cloud_trail_top_level.html). +// +// See https://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15 for more information on this service. +// +// See sts package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sts/ +// +// Using the Client +// +// To use the client for AWS Security Token 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 := sts.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 Security Token Service client STS for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/sts/#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.AssumeRole(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("AssumeRole 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.AssumeRoleWithContext(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 sts diff --git a/vendor/github.com/aws/aws-sdk-go/service/sts/service.go b/vendor/github.com/aws/aws-sdk-go/service/sts/service.go index be218384..1ee5839e 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/sts/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/sts/service.go @@ -11,54 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/query" ) -// The AWS Security Token Service (STS) is a web service that enables you to -// request temporary, limited-privilege credentials for AWS Identity and Access -// Management (IAM) users or for users that you authenticate (federated users). -// This guide provides descriptions of the STS API. For more detailed information -// about using this service, go to Temporary Security Credentials (http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html). +// STS provides the API operation methods for making requests to +// AWS Security Token Service. See this package's package overview docs +// for details on the service. // -// As an alternative to using 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 STS. 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/). -// -// For information about setting up signatures and authorization through the -// API, go to Signing AWS API Requests (http://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) -// in the AWS General Reference. For general information about the Query API, -// go to Making Query Requests (http://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_UsingQueryAPI.html) -// in Using IAM. For information about using security tokens with other AWS -// products, go to AWS Services That Work with IAM (http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) -// in the IAM User Guide. -// -// If you're new to AWS and need additional technical information about a specific -// AWS product, you can find the product's technical documentation at http://aws.amazon.com/documentation/ -// (http://aws.amazon.com/documentation/). -// -// Endpoints -// -// The AWS Security Token Service (STS) has a default endpoint of https://sts.amazonaws.com -// that maps to the US East (N. Virginia) region. Additional regions are available -// and are activated by default. For more information, see Activating and Deactivating -// AWS STS in an AWS Region (http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) -// in the IAM User Guide. -// -// For information about STS endpoints, see Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#sts_region) -// in the AWS General Reference. -// -// Recording API requests -// -// STS supports AWS CloudTrail, which is a service that records AWS calls for -// your AWS account and delivers log files to an Amazon S3 bucket. By using -// information collected by CloudTrail, you can determine what requests were -// successfully made to STS, who made the request, when it was made, and so -// on. To learn more about CloudTrail, including how to turn it on and find -// your log files, see the AWS CloudTrail User Guide (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/what_is_cloud_trail_top_level.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/sts-2011-06-15 +// STS methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type STS struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/support/api.go b/vendor/github.com/aws/aws-sdk-go/service/support/api.go index 68bce095..35aa9b4f 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/support/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/support/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package support provides a client for AWS Support. package support import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/support/doc.go b/vendor/github.com/aws/aws-sdk-go/service/support/doc.go new file mode 100644 index 00000000..4a7b181d --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/support/doc.go @@ -0,0 +1,129 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package support provides the client and types for making API +// requests to AWS Support. +// +// The AWS Support API reference is intended for programmers who need detailed +// information about the AWS Support operations and data types. This service +// enables you to manage your AWS Support cases programmatically. It uses HTTP +// methods that return results in JSON format. +// +// The AWS Support service also exposes a set of Trusted Advisor (http://aws.amazon.com/premiumsupport/trustedadvisor/) +// features. You can retrieve a list of checks and their descriptions, get check +// results, specify checks to refresh, and get the refresh status of checks. +// +// The following list describes the AWS Support case management operations: +// +// * Service names, issue categories, and available severity levels. The +// DescribeServices and DescribeSeverityLevels operations return AWS service +// names, service codes, service categories, and problem severity levels. +// You use these values when you call the CreateCase operation. +// +// * Case creation, case details, and case resolution. The CreateCase, DescribeCases, +// DescribeAttachment, and ResolveCase operations create AWS Support cases, +// retrieve information about cases, and resolve cases. +// +// * Case communication. The DescribeCommunications, AddCommunicationToCase, +// and AddAttachmentsToSet operations retrieve and add communications and +// attachments to AWS Support cases. +// +// The following list describes the operations available from the AWS Support +// service for Trusted Advisor: +// +// * DescribeTrustedAdvisorChecks returns the list of checks that run against +// your AWS resources. +// +// * Using the checkId for a specific check returned by DescribeTrustedAdvisorChecks, +// you can call DescribeTrustedAdvisorCheckResult to obtain the results for +// the check you specified. +// +// * DescribeTrustedAdvisorCheckSummaries returns summarized results for +// one or more Trusted Advisor checks. +// +// * RefreshTrustedAdvisorCheck requests that Trusted Advisor rerun a specified +// check. +// +// * DescribeTrustedAdvisorCheckRefreshStatuses reports the refresh status +// of one or more checks. +// +// For authentication of requests, AWS Support uses Signature Version 4 Signing +// Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). +// +// See About the AWS Support API (http://docs.aws.amazon.com/awssupport/latest/user/Welcome.html) +// in the AWS Support User Guide for information about how to use this service +// to create and manage your support cases, and how to call Trusted Advisor +// for results of checks on your resources. +// +// See https://docs.aws.amazon.com/goto/WebAPI/support-2013-04-15 for more information on this service. +// +// See support package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/support/ +// +// Using the Client +// +// To use the client for AWS Support 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 := support.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 Support client Support for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/support/#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.AddAttachmentsToSet(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("AddAttachmentsToSet 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.AddAttachmentsToSetWithContext(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 support diff --git a/vendor/github.com/aws/aws-sdk-go/service/support/service.go b/vendor/github.com/aws/aws-sdk-go/service/support/service.go index 3d369edc..e22b2d37 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/support/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/support/service.go @@ -11,59 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// The AWS Support API reference is intended for programmers who need detailed -// information about the AWS Support operations and data types. This service -// enables you to manage your AWS Support cases programmatically. It uses HTTP -// methods that return results in JSON format. +// Support provides the API operation methods for making requests to +// AWS Support. See this package's package overview docs +// for details on the service. // -// The AWS Support service also exposes a set of Trusted Advisor (http://aws.amazon.com/premiumsupport/trustedadvisor/) -// features. You can retrieve a list of checks and their descriptions, get check -// results, specify checks to refresh, and get the refresh status of checks. -// -// The following list describes the AWS Support case management operations: -// -// * Service names, issue categories, and available severity levels. The -// DescribeServices and DescribeSeverityLevels operations return AWS service -// names, service codes, service categories, and problem severity levels. -// You use these values when you call the CreateCase operation. -// -// * Case creation, case details, and case resolution. The CreateCase, DescribeCases, -// DescribeAttachment, and ResolveCase operations create AWS Support cases, -// retrieve information about cases, and resolve cases. -// -// * Case communication. The DescribeCommunications, AddCommunicationToCase, -// and AddAttachmentsToSet operations retrieve and add communications and -// attachments to AWS Support cases. -// -// The following list describes the operations available from the AWS Support -// service for Trusted Advisor: -// -// * DescribeTrustedAdvisorChecks returns the list of checks that run against -// your AWS resources. -// -// * Using the checkId for a specific check returned by DescribeTrustedAdvisorChecks, -// you can call DescribeTrustedAdvisorCheckResult to obtain the results for -// the check you specified. -// -// * DescribeTrustedAdvisorCheckSummaries returns summarized results for -// one or more Trusted Advisor checks. -// -// * RefreshTrustedAdvisorCheck requests that Trusted Advisor rerun a specified -// check. -// -// * DescribeTrustedAdvisorCheckRefreshStatuses reports the refresh status -// of one or more checks. -// -// For authentication of requests, AWS Support uses Signature Version 4 Signing -// Process (http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). -// -// See About the AWS Support API (http://docs.aws.amazon.com/awssupport/latest/user/Welcome.html) -// in the AWS Support User Guide for information about how to use this service -// to create and manage your support cases, and how to call Trusted Advisor -// for results of checks on your resources. -// 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/support-2013-04-15 +// Support methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type Support struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/swf/api.go b/vendor/github.com/aws/aws-sdk-go/service/swf/api.go index bf3cc6da..56f6b573 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/swf/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/swf/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package swf provides a client for Amazon Simple Workflow Service. package swf import ( @@ -7083,7 +7082,6 @@ type DomainInfo struct { // * DEPRECATED: The domain was deprecated using DeprecateDomain, but is // still in use. You should not create new workflow executions in this domain. // - // // Status is a required field Status *string `locationName:"status" type:"string" required:"true" enum:"RegistrationStatus"` } diff --git a/vendor/github.com/aws/aws-sdk-go/service/swf/doc.go b/vendor/github.com/aws/aws-sdk-go/service/swf/doc.go new file mode 100644 index 00000000..93791c26 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/swf/doc.go @@ -0,0 +1,90 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package swf provides the client and types for making API +// requests to Amazon Simple Workflow Service. +// +// The Amazon Simple Workflow Service (Amazon SWF) makes it easy to build applications +// that use Amazon's cloud to coordinate work across distributed components. +// In Amazon SWF, a task represents a logical unit of work that is performed +// by a component of your workflow. Coordinating tasks in a workflow involves +// managing intertask dependencies, scheduling, and concurrency in accordance +// with the logical flow of the application. +// +// Amazon SWF gives you full control over implementing tasks and coordinating +// them without worrying about underlying complexities such as tracking their +// progress and maintaining their state. +// +// This documentation serves as reference only. For a broader overview of the +// Amazon SWF programming model, see the Amazon SWF Developer Guide (http://docs.aws.amazon.com/amazonswf/latest/developerguide/). +// +// See swf package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/swf/ +// +// Using the Client +// +// To use the client for Amazon Simple Workflow 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 := swf.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 Simple Workflow Service client SWF for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/swf/#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.CountClosedWorkflowExecutions(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("CountClosedWorkflowExecutions 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.CountClosedWorkflowExecutionsWithContext(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 swf diff --git a/vendor/github.com/aws/aws-sdk-go/service/swf/service.go b/vendor/github.com/aws/aws-sdk-go/service/swf/service.go index 439d95ac..ac85f412 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/swf/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/swf/service.go @@ -11,21 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// The Amazon Simple Workflow Service (Amazon SWF) makes it easy to build applications -// that use Amazon's cloud to coordinate work across distributed components. -// In Amazon SWF, a task represents a logical unit of work that is performed -// by a component of your workflow. Coordinating tasks in a workflow involves -// managing intertask dependencies, scheduling, and concurrency in accordance -// with the logical flow of the application. +// SWF provides the API operation methods for making requests to +// Amazon Simple Workflow Service. See this package's package overview docs +// for details on the service. // -// Amazon SWF gives you full control over implementing tasks and coordinating -// them without worrying about underlying complexities such as tracking their -// progress and maintaining their state. -// -// This documentation serves as reference only. For a broader overview of the -// Amazon SWF programming model, see the Amazon SWF Developer Guide (http://docs.aws.amazon.com/amazonswf/latest/developerguide/). -// The service client's operations are safe to be used concurrently. -// It is not safe to mutate any of the client's properties though. +// SWF methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type SWF struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/waf/api.go b/vendor/github.com/aws/aws-sdk-go/service/waf/api.go index 62d8d7f4..c8d9b0b6 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/waf/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/waf/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package waf provides a client for AWS WAF. package waf import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/waf/doc.go b/vendor/github.com/aws/aws-sdk-go/service/waf/doc.go new file mode 100644 index 00000000..e2fbbfdd --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/waf/doc.go @@ -0,0 +1,86 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package waf provides the client and types for making API +// requests to AWS WAF. +// +// This is the AWS WAF API Reference for using AWS WAF with Amazon CloudFront. +// The AWS WAF actions and data types listed in the reference are available +// for protecting Amazon CloudFront distributions. You can use these actions +// and data types via the endpoint waf.amazonaws.com. This guide is for developers +// who need detailed information about the AWS WAF API actions, data types, +// and errors. For detailed information about AWS WAF features and an overview +// of how to use the AWS WAF API, see the AWS WAF Developer Guide (http://docs.aws.amazon.com/waf/latest/developerguide/). +// +// See https://docs.aws.amazon.com/goto/WebAPI/waf-2015-08-24 for more information on this service. +// +// See waf package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/waf/ +// +// Using the Client +// +// To use the client for AWS WAF 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 := waf.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 WAF client WAF for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/waf/#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.CreateByteMatchSet(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("CreateByteMatchSet 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.CreateByteMatchSetWithContext(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 waf diff --git a/vendor/github.com/aws/aws-sdk-go/service/waf/service.go b/vendor/github.com/aws/aws-sdk-go/service/waf/service.go index dadb9ca7..91648a19 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/waf/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/waf/service.go @@ -11,16 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This is the AWS WAF API Reference for using AWS WAF with Amazon CloudFront. -// The AWS WAF actions and data types listed in the reference are available -// for protecting Amazon CloudFront distributions. You can use these actions -// and data types via the endpoint waf.amazonaws.com. This guide is for developers -// who need detailed information about the AWS WAF API actions, data types, -// and errors. For detailed information about AWS WAF features and an overview -// of how to use the AWS WAF API, see the AWS WAF Developer Guide (http://docs.aws.amazon.com/waf/latest/developerguide/). -// 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/waf-2015-08-24 +// WAF provides the API operation methods for making requests to +// AWS WAF. See this package's package overview docs +// for details on the service. +// +// WAF methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type WAF struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/wafregional/api.go b/vendor/github.com/aws/aws-sdk-go/service/wafregional/api.go index 7cd68869..a772109b 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/wafregional/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/wafregional/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package wafregional provides a client for AWS WAF Regional. package wafregional import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/wafregional/doc.go b/vendor/github.com/aws/aws-sdk-go/service/wafregional/doc.go new file mode 100644 index 00000000..0e812655 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/wafregional/doc.go @@ -0,0 +1,88 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package wafregional provides the client and types for making API +// requests to AWS WAF Regional. +// +// This is the AWS WAF Regional API Reference for using AWS WAF with Elastic +// Load Balancing (ELB) Application Load Balancers. The AWS WAF actions and +// data types listed in the reference are available for protecting Application +// Load Balancers. You can use these actions and data types by means of the +// endpoints listed in AWS Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#waf_region). +// This guide is for developers who need detailed information about the AWS +// WAF API actions, data types, and errors. For detailed information about AWS +// WAF features and an overview of how to use the AWS WAF API, see the AWS WAF +// Developer Guide (http://docs.aws.amazon.com/waf/latest/developerguide/). +// +// See https://docs.aws.amazon.com/goto/WebAPI/waf-regional-2016-11-28 for more information on this service. +// +// See wafregional package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/wafregional/ +// +// Using the Client +// +// To use the client for AWS WAF Regional 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 := wafregional.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 WAF Regional client WAFRegional for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/wafregional/#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.AssociateWebACL(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("AssociateWebACL 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.AssociateWebACLWithContext(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 wafregional diff --git a/vendor/github.com/aws/aws-sdk-go/service/wafregional/service.go b/vendor/github.com/aws/aws-sdk-go/service/wafregional/service.go index 34865ddd..8f0e7094 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/wafregional/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/wafregional/service.go @@ -11,18 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This is the AWS WAF Regional API Reference for using AWS WAF with Elastic -// Load Balancing (ELB) Application Load Balancers. The AWS WAF actions and -// data types listed in the reference are available for protecting Application -// Load Balancers. You can use these actions and data types by means of the -// endpoints listed in AWS Regions and Endpoints (http://docs.aws.amazon.com/general/latest/gr/rande.html#waf_region). -// This guide is for developers who need detailed information about the AWS -// WAF API actions, data types, and errors. For detailed information about AWS -// WAF features and an overview of how to use the AWS WAF API, see the AWS WAF -// Developer Guide (http://docs.aws.amazon.com/waf/latest/developerguide/). -// 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/waf-regional-2016-11-28 +// WAFRegional provides the API operation methods for making requests to +// AWS WAF Regional. See this package's package overview docs +// for details on the service. +// +// WAFRegional methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type WAFRegional struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/workdocs/api.go b/vendor/github.com/aws/aws-sdk-go/service/workdocs/api.go index 2cd9565a..e2bd2c66 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/workdocs/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/workdocs/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package workdocs provides a client for Amazon WorkDocs. package workdocs import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/workdocs/doc.go b/vendor/github.com/aws/aws-sdk-go/service/workdocs/doc.go new file mode 100644 index 00000000..59346a42 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/workdocs/doc.go @@ -0,0 +1,110 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package workdocs provides the client and types for making API +// requests to Amazon WorkDocs. +// +// The WorkDocs API is designed for the following use cases: +// +// * File Migration: File migration applications are supported for users +// who want to migrate their files from an on-premise or off-premise file +// system or service. Users can insert files into a user directory structure, +// as well as allow for basic metadata changes, such as modifications to +// the permissions of files. +// +// * Security: Support security applications are supported for users who +// have additional security needs, such as anti-virus or data loss prevention. +// The APIs, in conjunction with Amazon CloudTrail, allow these applications +// to detect when changes occur in Amazon WorkDocs, so the application can +// take the necessary actions and replace the target file. The application +// can also choose to email the user if the target file violates the policy. +// +// * eDiscovery/Analytics: General administrative applications are supported, +// such as eDiscovery and analytics. These applications can choose to mimic +// and/or record the actions in an Amazon WorkDocs site, in conjunction with +// Amazon CloudTrails, to replicate data for eDiscovery, backup, or analytical +// applications. +// +// All Amazon WorkDocs APIs are Amazon authenticated, certificate-signed APIs. +// They not only require the use of the AWS SDK, but also allow for the exclusive +// use of IAM users and roles to help facilitate access, trust, and permission +// policies. By creating a role and allowing an IAM user to access the Amazon +// WorkDocs site, the IAM user gains full administrative visibility into the +// entire Amazon WorkDocs site (or as set in the IAM policy). This includes, +// but is not limited to, the ability to modify file permissions and upload +// any file to any user. This allows developers to perform the three use cases +// above, as well as give users the ability to grant access on a selective basis +// using the IAM model. +// +// See https://docs.aws.amazon.com/goto/WebAPI/workdocs-2016-05-01 for more information on this service. +// +// See workdocs package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/workdocs/ +// +// Using the Client +// +// To use the client for Amazon WorkDocs 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 := workdocs.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 WorkDocs client WorkDocs for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/workdocs/#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.AbortDocumentVersionUpload(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("AbortDocumentVersionUpload 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.AbortDocumentVersionUploadWithContext(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 workdocs diff --git a/vendor/github.com/aws/aws-sdk-go/service/workdocs/service.go b/vendor/github.com/aws/aws-sdk-go/service/workdocs/service.go index 6182123a..e1313753 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/workdocs/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/workdocs/service.go @@ -11,40 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// The WorkDocs API is designed for the following use cases: +// WorkDocs provides the API operation methods for making requests to +// Amazon WorkDocs. See this package's package overview docs +// for details on the service. // -// * File Migration: File migration applications are supported for users -// who want to migrate their files from an on-premise or off-premise file -// system or service. Users can insert files into a user directory structure, -// as well as allow for basic metadata changes, such as modifications to -// the permissions of files. -// -// * Security: Support security applications are supported for users who -// have additional security needs, such as anti-virus or data loss prevention. -// The APIs, in conjunction with Amazon CloudTrail, allow these applications -// to detect when changes occur in Amazon WorkDocs, so the application can -// take the necessary actions and replace the target file. The application -// can also choose to email the user if the target file violates the policy. -// -// * eDiscovery/Analytics: General administrative applications are supported, -// such as eDiscovery and analytics. These applications can choose to mimic -// and/or record the actions in an Amazon WorkDocs site, in conjunction with -// Amazon CloudTrails, to replicate data for eDiscovery, backup, or analytical -// applications. -// -// All Amazon WorkDocs APIs are Amazon authenticated, certificate-signed APIs. -// They not only require the use of the AWS SDK, but also allow for the exclusive -// use of IAM users and roles to help facilitate access, trust, and permission -// policies. By creating a role and allowing an IAM user to access the Amazon -// WorkDocs site, the IAM user gains full administrative visibility into the -// entire Amazon WorkDocs site (or as set in the IAM policy). This includes, -// but is not limited to, the ability to modify file permissions and upload -// any file to any user. This allows developers to perform the three use cases -// above, as well as give users the ability to grant access on a selective basis -// using the IAM model. -// 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/workdocs-2016-05-01 +// WorkDocs methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type WorkDocs struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/workspaces/api.go b/vendor/github.com/aws/aws-sdk-go/service/workspaces/api.go index b23f90a4..3d6ed3e2 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/workspaces/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/workspaces/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package workspaces provides a client for Amazon WorkSpaces. package workspaces import ( @@ -906,7 +905,7 @@ func (c *WorkSpaces) ModifyWorkspacePropertiesRequest(input *ModifyWorkspaceProp // ModifyWorkspaceProperties API operation for Amazon WorkSpaces. // -// Modifies the WorkSpace properties, including the RunningMode and AutoStop +// Modifies the WorkSpace properties, including the running mode and AutoStop // time. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -921,20 +920,21 @@ func (c *WorkSpaces) ModifyWorkspacePropertiesRequest(input *ModifyWorkspaceProp // One or more parameter values are not valid. // // * ErrCodeInvalidResourceStateException "InvalidResourceStateException" -// The specified WorkSpace has an invalid state for this operation. +// The state of the WorkSpace is not valid for this operation. // // * ErrCodeOperationInProgressException "OperationInProgressException" // The properties of this WorkSpace are currently being modified. Try again // in a moment. // // * ErrCodeUnsupportedWorkspaceConfigurationException "UnsupportedWorkspaceConfigurationException" -// The WorkSpace does not have the supported configuration for this operation. -// For more information, see the Amazon WorkSpaces Administration Guide (http://docs.aws.amazon.com/workspaces/latest/adminguide). +// The configuration of this WorkSpace is not supported for this operation. +// For more information, see the Amazon WorkSpaces Administration Guide (http://docs.aws.amazon.com/workspaces/latest/adminguide/). // // * ErrCodeResourceNotFoundException "ResourceNotFoundException" // The resource could not be found. // // * ErrCodeAccessDeniedException "AccessDeniedException" +// The user is not authorized to access a resource. // // * ErrCodeResourceUnavailableException "ResourceUnavailableException" // The specified resource is not available. @@ -1179,8 +1179,8 @@ func (c *WorkSpaces) StartWorkspacesRequest(input *StartWorkspacesInput) (req *r // StartWorkspaces API operation for Amazon WorkSpaces. // -// Starts the specified WorkSpaces. The API only works with WorkSpaces that -// have RunningMode configured as AutoStop and the State set to “STOPPED.” +// Starts the specified WorkSpaces. The WorkSpaces must have a running mode +// of AutoStop and a state of STOPPED. // // 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 @@ -1255,9 +1255,8 @@ func (c *WorkSpaces) StopWorkspacesRequest(input *StopWorkspacesInput) (req *req // StopWorkspaces API operation for Amazon WorkSpaces. // -// Stops the specified WorkSpaces. The API only works with WorkSpaces that have -// RunningMode configured as AutoStop and the State set to AVAILABLE, IMPAIRED, -// UNHEALTHY, or ERROR. +// Stops the specified WorkSpaces. The WorkSpaces must have a running mode of +// AutoStop and a state of AVAILABLE, IMPAIRED, UNHEALTHY, or ERROR. // // 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 diff --git a/vendor/github.com/aws/aws-sdk-go/service/workspaces/doc.go b/vendor/github.com/aws/aws-sdk-go/service/workspaces/doc.go new file mode 100644 index 00000000..dd521dd3 --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/workspaces/doc.go @@ -0,0 +1,81 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package workspaces provides the client and types for making API +// requests to Amazon WorkSpaces. +// +// This reference provides detailed information about the Amazon WorkSpaces +// operations. +// +// See https://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08 for more information on this service. +// +// See workspaces package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/workspaces/ +// +// Using the Client +// +// To use the client for Amazon WorkSpaces 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 := workspaces.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 WorkSpaces client WorkSpaces for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/workspaces/#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.CreateTags(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("CreateTags 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.CreateTagsWithContext(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 workspaces diff --git a/vendor/github.com/aws/aws-sdk-go/service/workspaces/errors.go b/vendor/github.com/aws/aws-sdk-go/service/workspaces/errors.go index 1a1cadcc..78fcbedb 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/workspaces/errors.go +++ b/vendor/github.com/aws/aws-sdk-go/service/workspaces/errors.go @@ -6,6 +6,8 @@ const ( // ErrCodeAccessDeniedException for service response error code // "AccessDeniedException". + // + // The user is not authorized to access a resource. ErrCodeAccessDeniedException = "AccessDeniedException" // ErrCodeInvalidParameterValuesException for service response error code @@ -17,7 +19,7 @@ const ( // ErrCodeInvalidResourceStateException for service response error code // "InvalidResourceStateException". // - // The specified WorkSpace has an invalid state for this operation. + // The state of the WorkSpace is not valid for this operation. ErrCodeInvalidResourceStateException = "InvalidResourceStateException" // ErrCodeOperationInProgressException for service response error code @@ -48,7 +50,7 @@ const ( // ErrCodeUnsupportedWorkspaceConfigurationException for service response error code // "UnsupportedWorkspaceConfigurationException". // - // The WorkSpace does not have the supported configuration for this operation. - // For more information, see the Amazon WorkSpaces Administration Guide (http://docs.aws.amazon.com/workspaces/latest/adminguide). + // The configuration of this WorkSpace is not supported for this operation. + // For more information, see the Amazon WorkSpaces Administration Guide (http://docs.aws.amazon.com/workspaces/latest/adminguide/). ErrCodeUnsupportedWorkspaceConfigurationException = "UnsupportedWorkspaceConfigurationException" ) diff --git a/vendor/github.com/aws/aws-sdk-go/service/workspaces/service.go b/vendor/github.com/aws/aws-sdk-go/service/workspaces/service.go index 21c2011e..45241703 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/workspaces/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/workspaces/service.go @@ -11,11 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -// This reference provides detailed information about the Amazon WorkSpaces -// operations. -// 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/workspaces-2015-04-08 +// WorkSpaces provides the API operation methods for making requests to +// Amazon WorkSpaces. See this package's package overview docs +// for details on the service. +// +// WorkSpaces methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type WorkSpaces struct { *client.Client } diff --git a/vendor/github.com/aws/aws-sdk-go/service/xray/api.go b/vendor/github.com/aws/aws-sdk-go/service/xray/api.go index 32327063..335afb5b 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/xray/api.go +++ b/vendor/github.com/aws/aws-sdk-go/service/xray/api.go @@ -1,6 +1,5 @@ // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. -// Package xray provides a client for AWS X-Ray. package xray import ( diff --git a/vendor/github.com/aws/aws-sdk-go/service/xray/doc.go b/vendor/github.com/aws/aws-sdk-go/service/xray/doc.go new file mode 100644 index 00000000..2128be4d --- /dev/null +++ b/vendor/github.com/aws/aws-sdk-go/service/xray/doc.go @@ -0,0 +1,81 @@ +// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. + +// Package xray provides the client and types for making API +// requests to AWS X-Ray. +// +// AWS X-Ray provides APIs for managing debug traces and retrieving service +// maps and other data created by processing those traces. +// +// See https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12 for more information on this service. +// +// See xray package documentation for more information. +// https://docs.aws.amazon.com/sdk-for-go/api/service/xray/ +// +// Using the Client +// +// To use the client for AWS X-Ray 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 := xray.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 X-Ray client XRay for more +// information on creating the service's client. +// https://docs.aws.amazon.com/sdk-for-go/api/service/xray/#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.BatchGetTraces(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("BatchGetTraces 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.BatchGetTracesWithContext(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 xray diff --git a/vendor/github.com/aws/aws-sdk-go/service/xray/service.go b/vendor/github.com/aws/aws-sdk-go/service/xray/service.go index 18b40434..12a8a295 100644 --- a/vendor/github.com/aws/aws-sdk-go/service/xray/service.go +++ b/vendor/github.com/aws/aws-sdk-go/service/xray/service.go @@ -11,11 +11,12 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) -// AWS X-Ray provides APIs for managing debug traces and retrieving service -// maps and other data created by processing those traces. -// 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/xray-2016-04-12 +// XRay provides the API operation methods for making requests to +// AWS X-Ray. See this package's package overview docs +// for details on the service. +// +// XRay methods are safe to use concurrently. It is not safe to +// modify mutate any of the struct's properties though. type XRay struct { *client.Client } |
